-
- All Superinterfaces:
-
Element
,Node
,Node
,SOAPElement
public interface SOAPHeader extends SOAPElement
SOAP头元素的表示。 SOAP头元素由影响消息提供者处理应用程序特定内容的方式的XML数据组成。 例如,可以将事务语义,认证信息等指定为SOAPHeader
对象的内容。默认情况下,一个
SOAPEnvelope
对象包含一个空的SOAPHeader
对象。 如果SOAPHeader
对象(可选),则可以使用以下代码行检索和删除它。 变量se是一个SOAPEnvelope
对象。se.getHeader().detachNode();
SOAPEnvelope
方法addHeader
创建一个SOAPHeader
对象。 创建新标题并将其添加到信封的方法只能在现有标题已被删除后才能被调用。se.getHeader().detachNode(); SOAPHeader sh = se.addHeader();
一个
SOAPHeader
对象可以只有SOAPHeaderElement
对象作为其直接的孩子。 方法addHeaderElement
创建一个新的HeaderElement
对象,并将其添加到SOAPHeader
对象。 在以下代码行中,方法addHeaderElement
的参数是一个Name
对象,它是新的HeaderElement
对象的名称。SOAPHeaderElement shElement = sh.addHeaderElement(name);
- 从以下版本开始:
- 1.6
- 另请参见:
-
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 方法 描述 SOAPHeaderElement
addHeaderElement(QName qname)
创建一个新的SOAPHeaderElement
对象,使用指定的qname初始化并将其添加到此SOAPHeader
对象。SOAPHeaderElement
addHeaderElement(Name name)
创建一个新的SOAPHeaderElement
对象,并使用指定的名称进行初始化,并将其添加到此SOAPHeader
对象。SOAPHeaderElement
addNotUnderstoodHeaderElement(QName name)
创建一个新的NotUnderstoodSOAPHeaderElement
对象,并使用指定的名称进行初始化,并将其添加到此SOAPHeader
对象。SOAPHeaderElement
addUpgradeHeaderElement(String supportedSoapUri)
创建一个新的升级SOAPHeaderElement
对象,并使用指定的支持的SOAP URI进行初始化,并将其添加到此SOAPHeader
对象。SOAPHeaderElement
addUpgradeHeaderElement(String[] supportedSoapUris)
创建一个新的升级SOAPHeaderElement
对象,并使用指定的受支持的SOAP URI数组进行初始化,并将其添加到此SOAPHeader
对象。SOAPHeaderElement
addUpgradeHeaderElement(Iterator<String> supportedSOAPURIs)
创建一个新的升级SOAPHeaderElement
对象,并使用指定的支持SOAP URI的String Iterator进行初始化,并将其添加到此SOAPHeader
对象。Iterator<SOAPHeaderElement>
examineAllHeaderElements()
在此SOAPHeader
对象中的所有SOAPHeaderElement
对象中返回一个Iterator
。Iterator<SOAPHeaderElement>
examineHeaderElements(String actor)
返回一个Iterator
在所有SOAPHeaderElement
这个对象SOAPHeader
对象具有指定 演员 。Iterator<SOAPHeaderElement>
examineMustUnderstandHeaderElements(String actor)
返回一个Iterator
在所有SOAPHeaderElement
这个对象SOAPHeader
对象具有指定 演员 ,有一个mustUnderstand属性,其值等于true
。Iterator<SOAPHeaderElement>
extractAllHeaderElements()
返回一个Iterator
在所有SOAPHeaderElement
这个对象SOAPHeader
对象,并从该中分离出来SOAPHeader
对象。Iterator<SOAPHeaderElement>
extractHeaderElements(String actor)
返回一个Iterator
在所有SOAPHeaderElement
这个对象SOAPHeader
对象中具有指定 的actor并从此中分离出来SOAPHeader
对象。-
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 javax.xml.soap.Node
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue
-
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
-
Methods inherited from interface javax.xml.soap.SOAPElement
addAttribute, addAttribute, addChildElement, addChildElement, addChildElement, addChildElement, addChildElement, addChildElement, addNamespaceDeclaration, addTextNode, createQName, getAllAttributes, getAllAttributesAsQNames, getAttributeValue, getAttributeValue, getChildElements, getChildElements, getChildElements, getElementName, getElementQName, getEncodingStyle, getNamespacePrefixes, getNamespaceURI, getVisibleNamespacePrefixes, removeAttribute, removeAttribute, removeContents, removeNamespaceDeclaration, setElementQName, setEncodingStyle
-
-
-
-
方法详细信息
-
addHeaderElement
SOAPHeaderElement addHeaderElement(Name name) throws SOAPException
创建一个以指定名称初始化的新的SOAPHeaderElement
对象,并将其添加到此SOAPHeader
对象。- 参数
-
name
- 一个Name
对象,其名称为新的SOAPHeaderElement
对象 - 结果
-
新的
SOAPHeaderElement
对象被插入到这个SOAPHeader
对象中 - 异常
-
SOAPException
- 如果发生SOAP错误 - 另请参见:
-
addHeaderElement(javax.xml.namespace.QName)
-
addHeaderElement
SOAPHeaderElement addHeaderElement(QName qname) throws SOAPException
创建一个新的SOAPHeaderElement
对象,使用指定的qname初始化并将其添加到此SOAPHeader
对象。- 参数
-
qname
- 一个QName
对象与新的SOAPHeaderElement
对象的qname - 结果
-
新的
SOAPHeaderElement
对象被插入到这个SOAPHeader
对象中 - 异常
-
SOAPException
- 如果发生SOAP错误 - 从以下版本开始:
- 1.6,SAAJ 1.3
- 另请参见:
-
addHeaderElement(Name)
-
examineMustUnderstandHeaderElements
Iterator<SOAPHeaderElement> examineMustUnderstandHeaderElements(String actor)
返回一个Iterator
在所有SOAPHeaderElement
这个对象SOAPHeader
对象具有指定演员 ,有一个mustUnderstand属性,其值等于true
。在SOAP 1.2中, env:actor属性被env:role属性替换,但语义基本相同。
- 参数
-
actor
-一个String
赋予的URIactor
/role
要搜索 - 结果
-
一个
Iterator
对象,所有SOAPHeaderElement
对象包含指定的actor
role
标记为MustUnderstand - 从以下版本开始:
- 1.6,SAAJ 1.2
- 另请参见:
-
examineHeaderElements(java.lang.String)
,extractHeaderElements(java.lang.String)
,SOAPConstants.URI_SOAP_ACTOR_NEXT
-
examineHeaderElements
Iterator<SOAPHeaderElement> examineHeaderElements(String actor)
返回一个Iterator
在所有SOAPHeaderElement
这个对象SOAPHeader
对象具有指定演员 。 演员是一个全局属性,表示中间方在达到其最终接收者之前应处理消息。 一个演员收到消息并处理它,然后发送给下一个演员。 默认的演员是消息的最终目标接收者,因此,如果一个SOAPHeader
对象中没有actor属性,那么它将与消息体一起被发送到最终的接收者。在SOAP 1.2中, env:actor属性被env:role属性替换,但语义基本相同。
- 参数
-
actor
-一个String
赋予的URIactor
/role
要搜索 - 结果
-
一个
Iterator
对象在所有SOAPHeaderElement
包含指定的对象actor
/role
- 另请参见:
-
extractHeaderElements(java.lang.String)
,SOAPConstants.URI_SOAP_ACTOR_NEXT
-
extractHeaderElements
Iterator<SOAPHeaderElement> extractHeaderElements(String actor)
返回一个Iterator
在所有SOAPHeaderElement
这个对象SOAPHeader
对象中具有指定的actor并从此中分离出来SOAPHeader
对象。此方法允许actor处理适用于它的
SOAPHeader
对象的部分,并在将消息传递给下一个actor之前删除它们。在SOAP 1.2中, env:actor属性被env:role属性替换,但语义基本相同。
- 参数
-
actor
-一个String
赋予的URIactor
/role
要搜索 - 结果
-
一个
Iterator
对象在所有SOAPHeaderElement
包含指定的对象actor
/role
- 另请参见:
-
examineHeaderElements(java.lang.String)
,SOAPConstants.URI_SOAP_ACTOR_NEXT
-
addNotUnderstoodHeaderElement
SOAPHeaderElement addNotUnderstoodHeaderElement(QName name) throws SOAPException
创建一个新的NotUnderstoodSOAPHeaderElement
对象,并使用指定的名称进行初始化,并将其添加到此SOAPHeader
对象。 此操作仅由SOAP 1.2支持。- 参数
-
name
- 一个QName
对象,其名称为SOAPHeaderElement
对象。 - 结果
-
新的
SOAPHeaderElement
对象被插入到这个SOAPHeader
对象中 - 异常
-
SOAPException
- 如果发生SOAP错误。 -
UnsupportedOperationException
- 如果这是一个SOAP 1.1标题。 - 从以下版本开始:
- 1.6,SAAJ 1.3
-
addUpgradeHeaderElement
SOAPHeaderElement addUpgradeHeaderElement(Iterator<String> supportedSOAPURIs) throws SOAPException
创建一个新的升级SOAPHeaderElement
对象,并使用指定的支持SOAP URI的String Iterator进行初始化,并将其添加到此SOAPHeader
对象。 SOAP 1.1和SOAP 1.2头都支持此操作。- 参数
-
supportedSOAPURIs
- 支持的SOAP版本的URI字符串Iterator
。 - 结果
-
新的
SOAPHeaderElement
对象被插入到这个SOAPHeader
对象中 - 异常
-
SOAPException
- 如果发生SOAP错误。 - 从以下版本开始:
- 1.6,SAAJ 1.3
-
addUpgradeHeaderElement
SOAPHeaderElement addUpgradeHeaderElement(String[] supportedSoapUris) throws SOAPException
创建一个新的升级SOAPHeaderElement
对象,并使用指定的受支持的SOAP URI数组进行初始化,并将其添加到此SOAPHeader
对象。 SOAP 1.1和SOAP 1.2头都支持此操作。- 参数
-
supportedSoapUris
- 支持的SOAP版本的URI数组。 - 结果
-
新的
SOAPHeaderElement
对象被插入到这个SOAPHeader
对象中 - 异常
-
SOAPException
- 如果发生SOAP错误。 - 从以下版本开始:
- 1.6,SAAJ 1.3
-
addUpgradeHeaderElement
SOAPHeaderElement addUpgradeHeaderElement(String supportedSoapUri) throws SOAPException
创建一个新的升级SOAPHeaderElement
对象,并使用指定的支持的SOAP URI进行初始化,并将其添加到此SOAPHeader
对象。 SOAP 1.1和SOAP 1.2头都支持此操作。- 参数
-
supportedSoapUri
- SOAP的URI支持的版本。 - 结果
-
新的
SOAPHeaderElement
对象被插入到这个SOAPHeader
对象 - 异常
-
SOAPException
- 如果发生SOAP错误。 - 从以下版本开始:
- 1.6,SAAJ 1.3
-
examineAllHeaderElements
Iterator<SOAPHeaderElement> examineAllHeaderElements()
返回一个Iterator
在所有SOAPHeaderElement
这个对象SOAPHeader
对象。- 结果
-
一个
Iterator
对象,所有SOAPHeaderElement
对象包含在这个SOAPHeader
- 从以下版本开始:
- 1.6,SAAJ 1.2
- 另请参见:
-
extractAllHeaderElements()
-
extractAllHeaderElements
Iterator<SOAPHeaderElement> extractAllHeaderElements()
在此SOAPHeader
对象中的所有SOAPHeaderElement
对象中返回Iterator
,并将其从该SOAPHeader
对象中分离出来。- 结果
-
一个
Iterator
对象在所有SOAPHeaderElement
这个包含的对象SOAPHeader
- 从以下版本开始:
- 1.6,SAAJ 1.2
- 另请参见:
-
examineAllHeaderElements()
-
-