JavaTM Platform
Standard Ed. 6

类 javax.xml.soap.SOAPException
的使用

使用 SOAPException 的软件包
javax.xml.soap 提供用于创建和构建 SOAP 消息的 API。 
 

javax.xml.soapSOAPException 的使用
 

抛出 SOAPExceptionjavax.xml.soap 中的方法
 SOAPElement SOAPElement.addAttribute(Name name, String value)
          将带有指定名称和值的属性添加到此 SOAPElement 对象。
 SOAPElement SOAPElement.addAttribute(QName qname, String value)
          将带有指定名称和值的属性添加到此 SOAPElement 对象。
 SOAPBody SOAPEnvelope.addBody()
          创建一个 SOAPBody 对象,并将其设置为此 SOAPEnvelope 对象的 SOAPBody 对象。
 SOAPBodyElement SOAPBody.addBodyElement(Name name)
          使用指定名称创建新的 SOAPBodyElement 对象,并将其添加到此 SOAPBody 对象。
 SOAPBodyElement SOAPBody.addBodyElement(QName qname)
          使用指定 QName 创建新的 SOAPBodyElement 对象,并将其添加到此 SOAPBody 对象。
 SOAPElement SOAPElement.addChildElement(Name name)
          创建使用给定 Name 对象初始化的新 SOAPElement 对象,并将该新元素添加到此 SOAPElement 对象。
 SOAPElement SOAPElement.addChildElement(QName qname)
          创建使用给定 QName 对象初始化的新 SOAPElement 对象,并将该新元素添加到此 SOAPElement 对象。
 SOAPElement SOAPElement.addChildElement(SOAPElement element)
          将 SOAPElement 作为此 SOAPElement 实例的子级添加。
 SOAPElement SOAPElement.addChildElement(String localName)
          创建使用指定本地名称初始化的新 SOAPElement 对象,并将该新元素添加到此 SOAPElement 对象。
 SOAPElement SOAPElement.addChildElement(String localName, String prefix)
          创建使用指定本地名称和前缀初始化的新 SOAPElement 对象,并将该新元素添加到此 SOAPElement 对象。
 SOAPElement SOAPElement.addChildElement(String localName, String prefix, String uri)
          创建使用指定本地名称、前缀和 URI 初始化的新 SOAPElement 对象,并将该新元素添加到此 SOAPElement 对象。
 Detail SOAPFault.addDetail()
          创建可选的 Detail 对象,并将其设置为此 SOAPFault 对象的 Detail 对象。
 DetailEntry Detail.addDetailEntry(Name name)
          使用给定名称创建新的 DetailEntry 对象,并将其添加到此 Detail 对象。
 DetailEntry Detail.addDetailEntry(QName qname)
          使用给定 QName 创建新的 DetailEntry 对象,并将其添加到此 Detail 对象。
 SOAPBodyElement SOAPBody.addDocument(Document document)
          将 DOM Document 的根节点添加到此 SOAPBody 对象。
 SOAPFault SOAPBody.addFault()
          创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。
 SOAPFault SOAPBody.addFault(Name faultCode, String faultString)
          创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。
 SOAPFault SOAPBody.addFault(Name faultCode, String faultString, Locale locale)
          创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。
 SOAPFault SOAPBody.addFault(QName faultCode, String faultString)
          创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。
 SOAPFault SOAPBody.addFault(QName faultCode, String faultString, Locale locale)
          创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。
 void SOAPFault.addFaultReasonText(String text, Locale locale)
          追加或替换包含指定文本消息的 Reason Text 项,以及从 locale 派生的 xml:lang
 SOAPHeader SOAPEnvelope.addHeader()
          创建一个 SOAPHeader 对象,并将其设置为此 SOAPEnvelope 对象的 SOAPHeader 对象。
 SOAPHeaderElement SOAPHeader.addHeaderElement(Name name)
          创建使用指定名称初始化的新的 SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。
 SOAPHeaderElement SOAPHeader.addHeaderElement(QName qname)
          创建使用指定 qname 初始化的新的 SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。
 SOAPElement SOAPElement.addNamespaceDeclaration(String prefix, String uri)
          将带有指定前缀和 URI 的名称空间声明添加到此 SOAPElement 对象。
 SOAPHeaderElement SOAPHeader.addNotUnderstoodHeaderElement(QName name)
          创建使用指定名称初始化的新的 NotUnderstood SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。
 SOAPElement SOAPElement.addTextNode(String text)
          创建使用给定 String 初始化的新 Text 对象,并将其添加到此 SOAPElement 对象。
 SOAPHeaderElement SOAPHeader.addUpgradeHeaderElement(Iterator supportedSOAPURIs)
          创建使用指定的 SOAP URI 支持列表初始化的新的 Upgrade SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。
 SOAPHeaderElement SOAPHeader.addUpgradeHeaderElement(String supportedSoapUri)
          创建使用指定受支持 SOAP URI 初始化的新的 Upgrade SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。
 SOAPHeaderElement SOAPHeader.addUpgradeHeaderElement(String[] supportedSoapUris)
          创建使用指定 SOAP URI 支持数组初始化的新的 Upgrade SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。
 void SOAPFault.appendFaultSubcode(QName subcode)
          将 Subcode 添加到此 SOAPFault 包含的 Subcode 序列的末尾。
abstract  SOAPMessage SOAPConnection.call(SOAPMessage request, Object to)
          将给定消息发送到指定端点,在返回应答前将一直阻塞。
abstract  void SOAPConnection.close()
          关闭此 SOAPConnection 对象。
 SOAPElement SOAPElementFactory.create(Name name)
          已过时。 使用 javax.xml.soap.SOAPFactory.createElement(javax.xml.soap.Name) 替换
 SOAPElement SOAPElementFactory.create(String localName)
          已过时。 使用 javax.xml.soap.SOAPFactory.createElement(String localName) 替换
 SOAPElement SOAPElementFactory.create(String localName, String prefix, String uri)
          已过时。 使用 javax.xml.soap.SOAPFactory.createElement(String localName, String prefix, String uri) 替换
abstract  SOAPConnection SOAPConnectionFactory.createConnection()
          创建新的 SOAPConnection
abstract  Detail SOAPFactory.createDetail()
          创建充当 DetailEntry 对象容器的新 Detail 对象。
 SOAPElement SOAPFactory.createElement(Element domElement)
          根据现有的 DOM Element 创建 SOAPElement 对象。
abstract  SOAPElement SOAPFactory.createElement(Name name)
          创建使用给定 Name 对象初始化的 SOAPElement 对象。
 SOAPElement SOAPFactory.createElement(QName qname)
          创建使用给定 QName 对象初始化的 SOAPElement 对象。
abstract  SOAPElement SOAPFactory.createElement(String localName)
          创建使用给定本地名称初始化的 SOAPElement 对象。
abstract  SOAPElement SOAPFactory.createElement(String localName, String prefix, String uri)
          使用本地名称、前缀和 URI 创建新的 SOAPElement 对象。
abstract  SOAPFault SOAPFactory.createFault()
          创建一个新的默认 SOAPFault 对象
abstract  SOAPFault SOAPFactory.createFault(String reasonText, QName faultCode)
          创建使用给定 reasonTextfaultCode 初始化的新 SOAPFault 对象
abstract  SOAPMessage MessageFactory.createMessage()
          使用默认的 SOAPPartSOAPEnvelopeSOAPBodySOAPHeader 对象创建新的 SOAPMessage 对象。
abstract  SOAPMessage MessageFactory.createMessage(MimeHeaders headers, InputStream in)
          将给定 InputStream 对象的内容内部化到新的 SOAPMessage 对象,并返回该 SOAPMessage 对象。
 Name SOAPEnvelope.createName(String localName)
          创建使用给定本地名称初始化的新 Name 对象。
abstract  Name SOAPFactory.createName(String localName)
          创建使用给定本地名称初始化的新 Name 对象。
 Name SOAPEnvelope.createName(String localName, String prefix, String uri)
          创建使用给定本地名称、名称空间前缀和名称空间 URL 初始化的新 Name 对象。
abstract  Name SOAPFactory.createName(String localName, String prefix, String uri)
          创建使用给定本地名称、名称空间前缀和名称空间 URI 初始化的新 Name 对象。
 QName SOAPElement.createQName(String localName, String prefix)
          创建一个 QName,其名称空间 URI 应与此 SOAPElement 上下文中的参数、prefix 相关联。
 Document SOAPBody.extractContentAsDocument()
          创建新的 DOM Document,并将此 SOAPBody 的第一个子元素设置为它的文档元素。
 SOAPMessage SOAPConnection.get(Object to)
          从特定端点获取消息,在收到消息前将一直阻塞。
abstract  AttachmentPart SOAPMessage.getAttachment(SOAPElement element)
          返回与此 SOAPElement 引用的附件关联的 AttachmentPart 对象,如果不存在此类附件,则返回 null
abstract  InputStream AttachmentPart.getBase64Content()
          以 Base64 编码字符数据的形式返回可用于获取 AttachmentPart 内容的 InputStream,此方法将对附件的原始字节进行 Base64 编码,然后返回该内容。
 SOAPBody SOAPEnvelope.getBody()
          返回与此 SOAPEnvelope 对象关联的 SOAPBody 对象。
abstract  Object AttachmentPart.getContent()
          以 Java 对象的形式获取此 AttachmentPart 对象的内容。
abstract  Source SOAPPart.getContent()
          以 JAXP Source 对象的形式返回 SOAPEnvelope 的内容。
abstract  DataHandler AttachmentPart.getDataHandler()
          获取针对此 AttachmentPart 对象的 DataHandler 对象。
abstract  SOAPEnvelope SOAPPart.getEnvelope()
          获取与此 SOAPPart 对象关联的 SOAPEnvelope 对象。
 Iterator SOAPFault.getFaultReasonLocales()
          返回一个 Iterator,它可以在与 Reason Text 项关联的 Locale 独特序列上进行迭代。
 String SOAPFault.getFaultReasonText(Locale locale)
          返回与给定 Locale 关联的 Reason Text。
 Iterator SOAPFault.getFaultReasonTexts()
          返回一个 Iterator,它可以在包含此 SOAPFault 所有 Reason Text 项的 String 对象序列上进行迭代。
 SOAPHeader SOAPEnvelope.getHeader()
          返回此 SOAPEnvelope 对象的 SOAPHeader 对象。
 Object SOAPMessage.getProperty(String property)
          检索指定属性的值。
abstract  InputStream AttachmentPart.getRawContent()
          以 InputStream 的形式获取此 AttachmentPart 对象的内容,等效于调用了 getContent 但没有为此 AttachmentPartcontent-type 注册 DataContentHandler
abstract  byte[] AttachmentPart.getRawContentBytes()
          以 byte[] 数组形式获取此 AttachmentPart 对象的内容,等效于调用了 getContent 但没有为此 AttachmentPartcontent-type 注册 DataContentHandler
abstract  int AttachmentPart.getSize()
          返回此 AttachmentPart 对象中的字节数。
 SOAPBody SOAPMessage.getSOAPBody()
          获取此 SOAPMessage 对象中包含的 SOAP Body。
 SOAPHeader SOAPMessage.getSOAPHeader()
          获取此 SOAPMessage 对象中包含的 SOAP Header。
static MessageFactory MessageFactory.newInstance()
          创建新的 MessageFactory 对象,该对象是默认实现 (SOAP 1.1) 的实例。
static SOAPConnectionFactory SOAPConnectionFactory.newInstance()
          创建默认 SOAPConnectionFactory 对象的实例。
static SOAPElementFactory SOAPElementFactory.newInstance()
          已过时。 创建新的 SOAPElementFactory 实例。
static SOAPFactory SOAPFactory.newInstance()
          创建新的 SOAPFactory 对象,该对象是默认实现 (SOAP 1.1) 的实例。
static MessageFactory MessageFactory.newInstance(String protocol)
          创建新的 MessageFactory 对象,该对象是指定实现的实例。
static SOAPFactory SOAPFactory.newInstance(String protocol)
          创建新的 SOAPFactory 对象,该对象是指定实现的实例,此方法使用 SAAJMetaFactory 来定位实现类并创建 SOAPFactory 实例。
protected abstract  MessageFactory SAAJMetaFactory.newMessageFactory(String protocol)
          创建给定 String 协议的 MessageFactory 对象。
protected abstract  SOAPFactory SAAJMetaFactory.newSOAPFactory(String protocol)
          创建给定 String 协议的 SOAPFactory 对象。
abstract  void SOAPMessage.saveChanges()
          使用对其所作的所有更改更新此 SOAPMessage 对象。
abstract  void AttachmentPart.setBase64Content(InputStream content, String contentType)
          根据 Base64 源 InputStream 设置此附件部分的内容,并将 Content-Type 头的值设置为 contentType 中包含的值,此方法将首先对 base64 输入流进行解码,然后将得到的原始字节写入附件。
abstract  void SOAPPart.setContent(Source source)
          使用取自给定 Source 对象的数据设置 SOAPEnvelope 对象的内容。
 SOAPElement SOAPElement.setElementQName(QName newName)
          如果可能,将此 Element 的名称更改为 newName
 void SOAPElement.setEncodingStyle(String encodingStyle)
          将此 SOAPElement 对象的编码样式设置为指定样式。
 void SOAPFault.setFaultActor(String faultActor)
          使用给定的错误参与者 (actor) 设置此 SOAPFault 对象。
 void SOAPFault.setFaultCode(Name faultCodeQName)
          使用给定的错误代码设置此 SOAPFault 对象。
 void SOAPFault.setFaultCode(QName faultCodeQName)
          使用给定的错误代码设置此 SOAPFault 对象。
 void SOAPFault.setFaultCode(String faultCode)
          使用给定的错误代码设置此 SOAPFault 对象。
 void SOAPFault.setFaultNode(String uri)
          创建或替换此 SOAPFault 对象的任何现有 Node 元素。
 void SOAPFault.setFaultRole(String uri)
          创建或替换此 SOAPFault 对象的任何现有 Role 元素。
 void SOAPFault.setFaultString(String faultString)
          将此 SOAPFault 对象的错误字符串设定为给定字符串。
 void SOAPFault.setFaultString(String faultString, Locale locale)
          将此 SOAPFault 对象的错误字符串设定为给定字符串,并本地化为给定语言环境。
 void Node.setParentElement(SOAPElement parent)
          将此 Node 对象的父节点设置为给定的 SOAPElement 对象。
 void SOAPMessage.setProperty(String property, Object value)
          将指定值与指定属性关联。
abstract  void AttachmentPart.setRawContent(InputStream content, String contentType)
          将此附件部分的内容设置为 InputStream content 所包含的内容,并将 Content-Type 头的值设置为 contentType 中包含的值。
abstract  void AttachmentPart.setRawContentBytes(byte[] content, int offset, int len, String contentType)
          将此附件部分的内容设置为 byte[] 数组 content 所包含的内容,并将 Content-Type 头的值设置为 contentType 中包含的值。
 void SOAPHeaderElement.setRelay(boolean relay)
          将此 SOAPHeaderElementrelay 属性设置为 true 或 false。
 void SOAPHeaderElement.setRole(String uri)
          将与此 SOAPHeaderElement 对象关联的 Role 设置为指定 Role
abstract  void SOAPMessage.writeTo(OutputStream out)
          将此 SOAPMessage 对象写入给定输出流。
 

抛出 SOAPExceptionjavax.xml.soap 中的构造方法
SAAJResult()
          创建一个 SAAJResult,此类将以支持默认 (SOAP 1.1) 协议的 SAAJ 树的形式显示结果。
SAAJResult(String protocol)
          创建一个 SAAJResult,它将以支持指定协议的 SAAJ 树的形式显示结果。
 


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策