SOAPHeader (Java Platform SE 8 )

All Superinterfaces:

Element， Node， SOAPElement
```
public interface SOAPHeader
extends SOAPElement
```
一个肥皂头元素的表示。SOAP头元素由影响应用程序特定内容的方式处理的XML数据组成的消息提供者。例如，事务语义，认证信息，等等，可以被指定为一个 SOAPHeader对象的内容。
一个SOAPEnvelope对象包含默认的空SOAPHeader对象。如果SOAPHeader对象，这是可选的，是不需要的，它可以检索和删除下面这行代码。变东南方是SOAPEnvelope对象。
```
硒。getheader()。detachnode()；
```
一 SOAPHeader对象与 SOAPEnvelope方法 addHeader创造。这种方法，以创建一个新的头，将它添加到的信封，可能只有在现有的头部已被称为。
```
硒。getheader()。detachnode()；soapheader SH = addheader() SE；
```
一个SOAPHeader对象只能有SOAPHeaderElement对象作为其直系子女。方法addHeaderElement创建一个新的HeaderElement对象并将其添加到SOAPHeader对象。在下面的代码行，论证的方法addHeaderElement是Name对象是新HeaderElement对象的名称。
```
soapheaderelement shelement = sh.addheaderelement（名称）；
```
另请参见：

SOAPHeaderElement

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
`SOAPHeaderElement`	`addHeaderElement(Name name)` 创建一个新的 `SOAPHeaderElement`对象指定名称初始化并将它添加到该 `SOAPHeader`对象。
`SOAPHeaderElement`	`addHeaderElement(QName qname)` 创建一个新的 `SOAPHeaderElement`对象的指定属性初始化并将它添加到该 `SOAPHeader`对象。
`SOAPHeaderElement`	`addNotUnderstoodHeaderElement(QName name)` 创建一个新对象缺乏 `SOAPHeaderElement`具有指定名称的初始化，并将它添加到该 `SOAPHeader`对象。
`SOAPHeaderElement`	`addUpgradeHeaderElement(Iterator supportedSOAPURIs)` 创建一个新的升级 `SOAPHeaderElement`对象和指定的名单支持SOAP的URI初始化并将它添加到该 `SOAPHeader`对象。
`SOAPHeaderElement`	`addUpgradeHeaderElement(String supportedSoapUri)` 创建一个新的升级 `SOAPHeaderElement`对象的指定支持SOAP URI初始化并将它添加到该 `SOAPHeader`对象。
`SOAPHeaderElement`	`addUpgradeHeaderElement(String[] supportedSoapUris)` 创建一个新的升级 `SOAPHeaderElement`对象和指定的数组初始化支持SOAP的URI并将它添加到该 `SOAPHeader`对象。
`Iterator`	`examineAllHeaderElements()` 在这 `SOAPHeader`返回对象的所有 `SOAPHeaderElement`对象 `Iterator`。
`Iterator`	`examineHeaderElements(String actor)` 在这 `SOAPHeader`返回对象，指定演员所有 `SOAPHeaderElement`对象 `Iterator`。
`Iterator`	`examineMustUnderstandHeaderElements(String actor)` 在这 `SOAPHeader`返回对象，指定演员和有MustUnderstand属性的值相当于 `true`所有 `SOAPHeaderElement`对象 `Iterator`。
`Iterator`	`extractAllHeaderElements()` 在这 `SOAPHeader`返回对象的所有 `SOAPHeaderElement`对象 `Iterator`和将他们从这 `SOAPHeader`对象。
`Iterator`	`extractHeaderElements(String actor)` 在这 `SOAPHeader`返回对象，指定演员所有 `SOAPHeaderElement`对象 `Iterator`和将他们从这 `SOAPHeader`对象。

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

- 方法详细信息
  - addHeaderElement
```
SOAPHeaderElement addHeaderElement(Name name)
                            throws SOAPException
```
    创建一个新的 SOAPHeaderElement对象指定名称初始化并将它添加到该 SOAPHeader对象。
    
    参数
    
    name -随着新 SOAPHeaderElement对象的名称 Name对象
    
    结果
    
    新 SOAPHeaderElement对象插入到这 SOAPHeader对象
    
    异常
    
    SOAPException如果SOAP错误发生
    
    另请参见：
    
    addHeaderElement(javax.xml.namespace.QName)
  - addHeaderElement
```
SOAPHeaderElement addHeaderElement(QName qname)
                            throws SOAPException
```
    创建一个新的 SOAPHeaderElement对象的指定属性初始化并将它添加到该 SOAPHeader对象。
    
    参数
    
    qname -随着新 SOAPHeaderElement对象将 QName对象
    
    结果
    
    新 SOAPHeaderElement对象插入到这 SOAPHeader对象
    
    异常
    
    SOAPException如果SOAP错误发生
    
    从以下版本开始：
    
    SAAJ 1.3
    
    另请参见：
    
    addHeaderElement(Name)
  - examineMustUnderstandHeaderElements
```
Iterator examineMustUnderstandHeaderElements(String actor)
```
    在这 SOAPHeader返回对象，指定演员和有MustUnderstand属性的值相当于 true所有 SOAPHeaderElement Iterator
    在SOAP 1.2的环境：演员属性由环境取代：作用属性，但本质上是相同的语义。
    对象。
    
    参数
    
    actor - String给予其 actor / role URI搜索
    
    结果
    
    在所有的 SOAPHeaderElement对象包含指定 actor / role和标记为MustUnderstand Iterator对象
    
    从以下版本开始：
    
    SAAJ 1.2
    
    另请参见：
    
    examineHeaderElements(java.lang.String)， extractHeaderElements(java.lang.String)， SOAPConstants.URI_SOAP_ACTOR_NEXT
  - examineHeaderElements
```
Iterator examineHeaderElements(String actor)
```
    在这 SOAPHeader返回对象，指定演员所有 SOAPHeaderElement对象 Iterator。一个演员是一个全球性的属性表明它应该达到最终接收前一个消息处理中间党派。一个演员在把信息发送到下一个演员之前就收到了这个消息和处理过程。默认行为是最终的收件人的邮件，所以如果没有演员属性包含在 SOAPHeader对象，它被发送到随着消息体的最终接收者。
    在SOAP 1.2的环境：演员属性由环境取代：作用属性，但本质上是相同的语义。
    
    参数
    
    actor - String给予其 actor / role URI搜索
    
    结果
    
    在所有的 SOAPHeaderElement对象包含指定 actor / role一 Iterator对象
    
    另请参见：
    
    extractHeaderElements(java.lang.String)， SOAPConstants.URI_SOAP_ACTOR_NEXT
  - extractHeaderElements
```
Iterator extractHeaderElements(String actor)
```
    在这 SOAPHeader返回对象，指定演员所有 SOAPHeaderElement对象 Iterator和将他们从这 SOAPHeader对象。
    这种方法允许一个演员中的SOAPHeader对象适用于它和删除它们在传递消息到下一个演员的部分。
    
    在SOAP 1.2的环境：演员属性由环境取代：作用属性，但本质上是相同的语义。
    
    参数
    
    actor - String给予其 actor / role URI搜索
    
    结果
    
    在所有的 SOAPHeaderElement对象包含指定 actor / role一 Iterator对象
    
    另请参见：
    
    examineHeaderElements(java.lang.String)， SOAPConstants.URI_SOAP_ACTOR_NEXT
  - addNotUnderstoodHeaderElement
```
SOAPHeaderElement addNotUnderstoodHeaderElement(QName name)
                                         throws SOAPException
```
    创建一个新对象缺乏 SOAPHeaderElement具有指定名称的初始化，并将它添加到该 SOAPHeader对象。此操作只支持由1.2。
    
    参数
    
    name -在 SOAPHeaderElement对象不了解 QName对象名称。
    
    结果
    
    新 SOAPHeaderElement对象插入到这 SOAPHeader对象
    
    异常
    
    SOAPException如果SOAP错误发生。
    
    UnsupportedOperationException -如果这是一个SOAP 1.1头。
    
    从以下版本开始：
    
    SAAJ 1.3
  - addUpgradeHeaderElement
```
SOAPHeaderElement addUpgradeHeaderElement(Iterator supportedSOAPURIs)
                                   throws SOAPException
```
    创建一个新的升级 SOAPHeaderElement对象和指定的名单支持SOAP的URI初始化并将它添加到该 SOAPHeader对象。此操作在两个肥皂1.1和肥皂1.2头上的支持。
    
    参数
    
    supportedSOAPURIs -肥皂版本的URI的 Iterator对象支持。
    
    结果
    
    新 SOAPHeaderElement对象插入到这 SOAPHeader对象
    
    异常
    
    SOAPException如果SOAP错误发生。
    
    从以下版本开始：
    
    SAAJ 1.3
  - addUpgradeHeaderElement
```
SOAPHeaderElement addUpgradeHeaderElement(String[] supportedSoapUris)
                                   throws SOAPException
```
    创建一个新的升级 SOAPHeaderElement对象和指定的数组初始化支持SOAP的URI并将它添加到该 SOAPHeader对象。此操作在两个肥皂1.1和肥皂1.2头上的支持。
    
    参数
    
    supportedSoapUris -一系列的SOAP版本支持的URI。
    
    结果
    
    新 SOAPHeaderElement对象插入到这 SOAPHeader对象
    
    异常
    
    SOAPException如果SOAP错误发生。
    
    从以下版本开始：
    
    SAAJ 1.3
  - addUpgradeHeaderElement
```
SOAPHeaderElement addUpgradeHeaderElement(String supportedSoapUri)
                                   throws SOAPException
```
    创建一个新的升级 SOAPHeaderElement对象的指定支持SOAP URI初始化并将它添加到该 SOAPHeader对象。此操作在两个肥皂1.1和肥皂1.2头上的支持。
    
    参数
    
    supportedSoapUri -肥皂的版本，支持的URI。
    
    结果
    
    新 SOAPHeaderElement对象插入到这 SOAPHeader对象
    
    异常
    
    SOAPException如果SOAP错误发生。
    
    从以下版本开始：
    
    SAAJ 1.3
  - examineAllHeaderElements
```
Iterator examineAllHeaderElements()
```
    在这 SOAPHeader返回对象的所有 SOAPHeaderElement对象 Iterator。
    
    结果
    
    一个 Iterator对象全 SOAPHeaderElement包含的对象这 SOAPHeader
    
    从以下版本开始：
    
    SAAJ 1.2
    
    另请参见：
    
    extractAllHeaderElements()
  - extractAllHeaderElements
```
Iterator extractAllHeaderElements()
```
    在这 SOAPHeader返回对象的所有 SOAPHeaderElement对象 Iterator和将他们从这 SOAPHeader对象。
    
    结果
    
    一个 Iterator对象全 SOAPHeaderElement包含的对象这 SOAPHeader
    
    从以下版本开始：
    
    SAAJ 1.2
    
    另请参见：
    
    examineAllHeaderElements()

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface SOAPHeader

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

方法详细信息

addHeaderElement

addHeaderElement

examineMustUnderstandHeaderElements

examineHeaderElements

extractHeaderElements

addNotUnderstoodHeaderElement

addUpgradeHeaderElement

addUpgradeHeaderElement

addUpgradeHeaderElement

examineAllHeaderElements

extractAllHeaderElements