SOAPBody (Java Platform SE 8 )

All Superinterfaces:

Element ， Node ， SOAPElement
```
public interface SOAPBody
extends SOAPElement
```
表示SOAP消息中SOAP主体元素内容的对象。 SOAP主体元素由影响应用程序特定内容处理方式的XML数据组成。
一个SOAPBody对象包含SOAPBodyElement对象，它们具有SOAP主体的内容。甲SOAPFault对象，其携带状态和/或错误信息，是一个的例子SOAPBodyElement对象。

另请参见：

SOAPFault

Field Summary
- Fields inherited from interface org.w3c.dom.Node
  ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`SOAPBodyElement`	`addBodyElement(Name name)` 创建一个具有指定名称的新的 `SOAPBodyElement`对象，并将其添加到此 `SOAPBody`对象。
`SOAPBodyElement`	`addBodyElement(QName qname)` 使用指定的QName创建一个新的 `SOAPBodyElement`对象，并将其添加到此 `SOAPBody`对象。
`SOAPBodyElement`	`addDocument(Document document)` 将DOM `Document`添加到此 `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 `Document`并设置这个 `SOAPBody`的第一个孩子作为它的文档元素。
`SOAPFault`	`getFault()` 返回此 `SOAPFault`对象中的 `SOAPBody`对象。
`boolean`	`hasFault()` 指示此 `SOAPFault`对象中是否存在 `SOAPBody`对象。

Methods inherited from interface javax.xml.soap.Node
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue

Methods inherited from interface org.w3c.dom.Element
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS

Methods inherited from interface org.w3c.dom.Node
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

- 方法详细信息
  - addFault
```
SOAPFault addFault()
            throws SOAPException
```
    创建一个新的SOAPFault对象，并将其添加到此SOAPBody对象。新的SOAPFault将为强制子元素设置默认值。 SOAPFault的类型将是SOAP 1.1或SOAP 1.2 SOAPFault ， protocol取决于创建MessageFactory实例时指定的MessageFactory 。
    A SOAPBody可能包含一个SOAPFault子元素。
    
    结果
    
    新的 SOAPFault对象
    
    异常
    
    SOAPException - 如果存在SOAP错误
  - addFault
```
SOAPFault addFault(Name faultCode,
                   String faultString,
                   Locale locale)
            throws SOAPException
```
    创建一个新的SOAPFault对象，并将其添加到此SOAPBody对象。 SOAPFault的类型将是SOAP 1.1或SOAP 1.2 SOAPFault ， protocol取决于创建MessageFactory实例时指定的MessageFactory 。
    对于SOAP faultCode参数是Fault / Code / Value元素的值， faultString参数是Fault / Reason / Text元素的值。对于SOAP faultCode参数是faultcode元素的值， faultString参数是faultstring元素的值。
    
    A SOAPBody可以包含一个SOAPFault子元素。
    
    参数
    
    faultCode - 提供要设置的故障代码的Name对象; 必须是在使用的SOAP规范版本中定义的故障代码之一
    
    faultString - String给出了故障的解释
    
    locale - 一个Locale对象，表示母语faultString
    
    结果
    
    新的 SOAPFault对象
    
    异常
    
    SOAPException - 如果存在SOAP错误
    
    从以下版本开始：
    
    SAAJ 1.2
    
    另请参见：
    
    SOAPFault.setFaultCode(javax.xml.soap.Name) ， SOAPFault.setFaultString(java.lang.String)
  - addFault
```
SOAPFault addFault(QName faultCode,
                   String faultString,
                   Locale locale)
            throws SOAPException
```
    创建一个新的SOAPFault对象，并将其添加到此SOAPBody对象。 SOAPFault的类型将是SOAP 1.1或SOAP 1.2 SOAPFault ， protocol取决于创建MessageFactory实例时指定的MessageFactory 。
    对于SOAP faultCode参数是Fault / Code / Value元素的值， faultString参数是Fault / Reason / Text元素的值。对于SOAP faultCode参数是faultcode元素的值， faultString参数是faultstring元素的值。
    
    A SOAPBody可能包含一个SOAPFault子元素。
    
    参数
    
    faultCode - 给出要设置故障代码的QName对象; 必须是在使用的SOAP规范版本中定义的故障代码之一。
    
    faultString - String给出了故障的解释
    
    locale - 一个Locale对象，表示母语faultString
    
    结果
    
    新的 SOAPFault对象
    
    异常
    
    SOAPException - 如果存在SOAP错误
    
    从以下版本开始：
    
    SAAJ 1.3
    
    另请参见：
    
    SOAPFault.setFaultCode(javax.xml.soap.Name) ， SOAPFault.setFaultString(java.lang.String) ， addFault(Name faultCode, String faultString, Locale locale)
  - addFault
```
SOAPFault addFault(Name faultCode,
                   String faultString)
            throws SOAPException
```
    创建一个新的SOAPFault对象，并将其添加到此SOAPBody对象。 SOAPFault的类型将是SOAP 1.1或SOAP 1.2 SOAPFault ， protocol取决于创建MessageFactory实例时指定的MessageFactory 。
    对于SOAP faultCode参数是Fault / Code / Value元素的值， faultString参数是Fault / Reason / Text元素的值。对于SOAP faultCode参数是faultcode元素的值， faultString参数是faultstring元素的值。
    
    在发生SOAP 1.2故障的情况下， Fault / Reason / Text元素上的强制xml:lang属性的默认值将设置为java.util.Locale.getDefault()
    
    A SOAPBody可能包含一个SOAPFault子元素。
    
    参数
    
    faultCode - 给出要设置的故障代码的Name对象; 必须是在使用的SOAP规范版本中定义的故障代码之一
    
    faultString - a String给出了故障的解释
    
    结果
    
    新的 SOAPFault对象
    
    异常
    
    SOAPException - 如果存在SOAP错误
    
    从以下版本开始：
    
    SAAJ 1.2
    
    另请参见：
    
    SOAPFault.setFaultCode(javax.xml.soap.Name) ， SOAPFault.setFaultString(java.lang.String)
  - addFault
```
SOAPFault addFault(QName faultCode,
                   String faultString)
            throws SOAPException
```
    创建一个新的SOAPFault对象，并将其添加到此SOAPBody对象。 SOAPFault的类型将是SOAP 1.1或SOAP 1.2 SOAPFault ， protocol取决于创建MessageFactory实例时指定的MessageFactory 。
    对于SOAP faultCode参数是Fault / Code / Value元素的值， faultString参数是Fault / Reason / Text元素的值。对于SOAP faultCode参数是faultcode元素的值， faultString参数是faultstring元素的值。
    
    在发生SOAP 1.2故障的情况下， Fault / Reason / Text元素上的强制性xml:lang属性的默认值将设置为java.util.Locale.getDefault()
    
    A SOAPBody可能包含一个SOAPFault子元素
    
    参数
    
    faultCode - 给出要设置的故障代码的QName对象; 必须是在使用的SOAP规范版本中定义的故障代码之一
    
    faultString - String给出了故障的解释
    
    结果
    
    新的 SOAPFault对象
    
    异常
    
    SOAPException - 如果存在SOAP错误
    
    从以下版本开始：
    
    SAAJ 1.3
    
    另请参见：
    
    SOAPFault.setFaultCode(javax.xml.soap.Name) ， SOAPFault.setFaultString(java.lang.String) ， addFault(Name faultCode, String faultString)
  - hasFault
```
boolean hasFault()
```
    指示此 SOAPFault对象中是否存在 SOAPBody对象。
    
    结果
    
    true如果一个SOAPFault对象存在于这个SOAPBody对象中; false否则
  - getFault
```
SOAPFault getFault()
```
    返回此 SOAPFault对象中的 SOAPBody对象。
    
    结果
    
    这个 SOAPFault对象中的 SOAPBody对象如果存在，否则为空。
  - addBodyElement
```
SOAPBodyElement addBodyElement(Name name)
                        throws SOAPException
```
    创建一个具有指定名称的新的 SOAPBodyElement对象，并将其添加到此 SOAPBody对象。
    
    参数
    
    name - 一个 Name对象，其名称为新的 SOAPBodyElement对象
    
    结果
    
    新的 SOAPBodyElement对象
    
    异常
    
    SOAPException - 如果发生SOAP错误
    
    另请参见：
    
    addBodyElement(javax.xml.namespace.QName)
  - addBodyElement
```
SOAPBodyElement addBodyElement(QName qname)
                        throws SOAPException
```
    使用指定的QName创建一个新的 SOAPBodyElement对象，并将其添加到此 SOAPBody对象。
    
    参数
    
    qname - 一个 QName对象与新的 SOAPBodyElement对象的qname
    
    结果
    
    新的 SOAPBodyElement对象
    
    异常
    
    SOAPException - 如果发生SOAP错误
    
    从以下版本开始：
    
    SAAJ 1.3
    
    另请参见：
    
    addBodyElement(Name)
  - addDocument
```
SOAPBodyElement addDocument(Document document)
                     throws SOAPException
```
    将DOM Document添加到此SOAPBody对象。
    调用此方法使document参数无效。客户端应用程序应丢弃所有引用此Document及其内容的电话addDocument 。继续使用这些引用的应用程序的行为是未定义的。
    
    参数
    
    document - 其根节点将添加到此 SOAPBody的 Document对象。
    
    结果
    
    表示添加的根节点的 SOAPBodyElement 。
    
    异常
    
    SOAPException - 如果 Document无法添加
    
    从以下版本开始：
    
    SAAJ 1.2
  - extractContentAsDocument
```
Document extractContentAsDocument()
                           throws SOAPException
```
    创建一个新的DOM Document并设置这个SOAPBody的第一个孩子作为它的文档元素。孩子SOAPElement被删除作为过程的一部分。
    
    结果
    
    Document的 SOAPBody内容的表示。
    
    异常
    
    SOAPException - 如果没有一个孩子 SOAPElement的 SOAPBody.
    从以下版本开始： SAAJ 1.3

Interface SOAPBody

Field Summary

Fields inherited from interface org.w3c.dom.Node

方法摘要

Methods inherited from interface javax.xml.soap.SOAPElement

Methods inherited from interface javax.xml.soap.Node

Methods inherited from interface org.w3c.dom.Element

Methods inherited from interface org.w3c.dom.Node

方法详细信息

addFault

addFault

addFault

addFault

addFault

hasFault

getFault

addBodyElement

addBodyElement

addDocument

extractContentAsDocument