public interface SOAPBody
表示 SOAP 消息中 SOAP 正文元素内容的对象。SOAP 正文元素由能影响特定于应用程序内容的处理方式的 XML 数据组成。
SOAPBody
对象包含了 SOAPBodyElement
对象,后者具有 SOAP 正文的内容。携带状态和/或错误信息的 SOAPFault
对象是 SOAPBodyElement
对象的一个示例。
SOAPFault
字段摘要 |
---|
方法摘要 | |
---|---|
SOAPBodyElement |
addBodyElement(Name name) 使用指定名称创建新的 SOAPBodyElement 对象,并将其添加到此 SOAPBody 对象。 |
SOAPBodyElement |
addBodyElement(QName qname) 使用指定 QName 创建新的 SOAPBodyElement 对象,并将其添加到此 SOAPBody 对象。 |
SOAPBodyElement |
addDocument(Document document) 将 DOM 的根节点添加到此 SOAPBody 对象。 |
SOAPFault |
addFault() 创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。 |
SOAPFault |
addFault(Name faultCode, String faultString) 创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。 |
SOAPFault |
addFault(Name faultCode, String faultString, Locale locale) 创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。 |
SOAPFault |
addFault(QName faultCode, String faultString) 创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。 |
SOAPFault |
addFault(QName faultCode, String faultString, Locale locale) 创建新的 SOAPFault 对象,并将其添加到此 SOAPBody 对象。 |
Document |
extractContentAsDocument() 创建新的 DOM ,并将此 SOAPBody 的第一个子元素设置为它的文档元素。 |
SOAPFault |
getFault() 返回此 SOAPBody 对象中的 SOAPFault 对象。 |
boolean |
hasFault() 指示此 SOAPBody 对象中是否存在 SOAPFault 对象。 |
从接口 javax.xml.soap.Node 继承的方法 |
---|
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue |
方法详细信息 |
---|
SOAPFault addFault() throws SOAPException
SOAPFault
对象,并将其添加到此
SOAPBody
对象。新的
SOAPFault
会将强制性 (mandatory) 子元素设置为默认值。
SOAPFault
的类型可以是 SOAP 1.1 或 SOAP 1.2
SOAPFault
,这取决于创建
MessageFactory
实例时指定的
protocol
。
一个 SOAPBody
最多只能包含一个 SOAPFault
子元素。
SOAPFault
对象
SOAPException
- 如果存在 SOAP 错误
SOAPFault addFault(Name faultCode, String faultString, Locale locale) throws SOAPException
SOAPFault
对象,并将其添加到此
SOAPBody
对象。
SOAPFault
的类型可以是 SOAP 1.1 或 SOAP 1.2
SOAPFault
,这取决于创建
MessageFactory
实例时指定的
protocol
。
对于 SOAP 1.2,faultCode
参数是 Fault/Code/Value 元素的值,faultString
参数是 Fault/Reason/Text 元素的值。对于 SOAP 1.1,faultCode
参数是 faultcode
元素的值,faultString
参数是 faultstring
元素的值。
一个 SOAPBody
最多只能包含一个 SOAPFault
子元素。
faultCode
-
Name
对象,给出要设置的错误代码;必须是正使用的 SOAP 规范的版本中定义的错误代码之一
faultString
-
String
,给出错误的解释
locale
-
Locale
对象,指示
faultString
的本地语言
SOAPFault
对象
SOAPException
- 如果存在 SOAP 错误
SOAPFault.setFaultCode(javax.xml.soap.Name)
,
SOAPFault.setFaultString(java.lang.String)
SOAPFault addFault(QName faultCode, String faultString, Locale locale) throws SOAPException
SOAPFault
对象,并将其添加到此
SOAPBody
对象。
SOAPFault
的类型可以是 SOAP 1.1 或 SOAP 1.2
SOAPFault
,这取决于创建
MessageFactory
实例时指定的
protocol
。
对于 SOAP 1.2,faultCode
参数是 Fault/Code/Value 元素的值,faultString
参数是 Fault/Reason/Text 元素的值。对于 SOAP 1.1,faultCode
参数是 faultcode
元素的值,faultString
参数是 faultstring
元素的值。
一个 SOAPBody
最多只能包含一个 SOAPFault
子元素。
faultCode
-
QName
对象,给出要设置的错误代码;必须是正使用的 SOAP 规范的版本中定义的错误代码之一。
faultString
-
String
,给出错误的解释
locale
-
Locale
对象,指示
faultString
的本地语言
SOAPFault
对象
SOAPException
- 如果存在 SOAP 错误
SOAPFault.setFaultCode(javax.xml.soap.Name)
,
SOAPFault.setFaultString(java.lang.String)
,
addFault(Name faultCode, String faultString, Locale locale)
SOAPFault addFault(Name faultCode, String faultString) throws SOAPException
SOAPFault
对象,并将其添加到此
SOAPBody
对象。
SOAPFault
的类型可以是 SOAP 1.1 或 SOAP 1.2
SOAPFault
,这取决于创建
MessageFactory
实例时指定的
protocol
。
对于 SOAP 1.2,faultCode
参数是 Fault/Code/Value 元素的值,faultString
参数是 Fault/Reason/Text 元素的值。对于 SOAP 1.1,faultCode
参数是 faultcode 元素的值,faultString
参数是 faultstring 元素的值。
如果是 SOAP 1.2 错误,Fault/Reason/Text 元素上强制性 xml:lang
属性的默认值将设置为 java.util.Locale.getDefault()
一个 SOAPBody
最多只能包含一个 SOAPFault
子元素。
faultCode
-
Name
对象,给出要设置的错误代码;必须是正使用的 SOAP 规范的版本中定义的错误代码之一
faultString
-
String
,给出错误的解释
SOAPFault
对象
SOAPException
- 如果存在 SOAP 错误
SOAPFault.setFaultCode(javax.xml.soap.Name)
,
SOAPFault.setFaultString(java.lang.String)
SOAPFault addFault(QName faultCode, String faultString) throws SOAPException
SOAPFault
对象,并将其添加到此
SOAPBody
对象。
SOAPFault
的类型可以是 SOAP 1.1 或 SOAP 1.2
SOAPFault
,这取决于创建
MessageFactory
实例时指定的
protocol
。
对于 SOAP 1.2,faultCode
参数是 Fault/Code/Value 元素的值,faultString
参数是 Fault/Reason/Text 元素的值。对于 SOAP 1.1,faultCode
参数是 faultcode 元素的值,faultString
参数是 faultstring 元素的值。
如果是 SOAP 1.2 错误,Fault/Reason/Text 元素上强制性 xml:lang
属性的默认值将设置为 java.util.Locale.getDefault()
一个 SOAPBody
最多只能包含一个 SOAPFault
子元素
faultCode
-
QName
对象,给出要设置的错误代码;必须是正使用的 SOAP 规范的版本中定义的错误代码之一
faultString
-
String
,给出错误的解释
SOAPFault
对象
SOAPException
- 如果存在 SOAP 错误
SOAPFault.setFaultCode(javax.xml.soap.Name)
,
SOAPFault.setFaultString(java.lang.String)
,
addFault(Name faultCode, String faultString)
boolean hasFault()
SOAPBody
对象中是否存在
SOAPFault
对象。
SOAPBody
对象中存在
SOAPFault
对象,则返回
true
;否则返回
false
SOAPFault getFault()
SOAPBody
对象中的
SOAPFault
对象。
SOAPBody
对象中的
SOAPFault
对象(如果存在);若不存在,则返回 null。
SOAPBodyElement addBodyElement(Name name) throws SOAPException
SOAPBodyElement
对象,并将其添加到此
SOAPBody
对象。
name
-
Name
对象,带有新
SOAPBodyElement
对象的名称
SOAPBodyElement
对象
SOAPException
- 如果发生 SOAP 错误
addBodyElement(javax.xml.namespace.QName)
SOAPBodyElement addBodyElement(QName qname) throws SOAPException
SOAPBodyElement
对象,并将其添加到此
SOAPBody
对象。
qname
-
QName
对象,带有新
SOAPBodyElement
对象的名称
SOAPBodyElement
对象
SOAPException
- 如果发生 SOAP 错误
addBodyElement(Name)
SOAPBodyElement addDocument(Document document) throws SOAPException
Document
的根节点添加到此
SOAPBody
对象。
调用此方法会使 document
参数失效。在调用 addDocument
时,客户端应用程序应丢弃所有对此 Document
及其内容的引用。继续使用此类引用的应用程序将产生不确定的行为。
document
-
Document
对象,该对象的根节点将被添加到此
SOAPBody
。
SOAPBodyElement
。
SOAPException
- 如果无法添加
Document
Document extractContentAsDocument() throws SOAPException
Document
,并将此
SOAPBody
的第一个子元素设置为它的文档元素。子
SOAPElement
作为进程的一部分被移除。
SOAPBody
内容的
Document
表示形式。
SOAPException
- 如果不存在任何
SOAPBody
的子
SOAPElement
。