javax.xml.soap

Interface SOAPHeaderElement

All Superinterfaces:

Element ， Node ， SOAPElement

public interface SOAPHeaderElement
extends SOAPElement

表示SOAP信封SOAP头部分内容的对象。 一个SOAPHeader对象的直接子项只能被表示为SOAPHeaderElement对象。

一个SOAPHeaderElement对象可以有其他SOAPElement对象作为其子项。

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
String	getActor() 返回此 SOAPHeaderElement的 actor属性的uri。
boolean	getMustUnderstand() 返回此 SOAPHeaderElement的mustUnderstand属性的布尔值。
boolean	getRelay() 返回此 SOAPHeaderElement的 中继属性的布尔值
String	getRole() 返回此 SOAPHeaderElement的“ 角色”属性的值。
void	setActor(String actorURI) 将与此 SOAPHeaderElement对象关联的actor设置为指定的actor。
void	setMustUnderstand(boolean mustUnderstand) 将此 SOAPHeaderElement对象的 SOAPHeaderElement属性设置为true或false。
void	setRelay(boolean relay) 设置此 继电器属性 SOAPHeaderElement是真或假。
void	setRole(String uri) 设置 Role与此相关 SOAPHeaderElement对象到指定的 Role 。

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

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

方法详细信息

setActor

void setActor(String actorURI)

将与此SOAPHeaderElement对象关联的actor设置为指定的actor。 演员的默认值为： SOAPConstants.URI_SOAP_ACTOR_NEXT

如果这个SOAPHeaderElement支持SOAP 1.2，那么这个调用相当于setRole(String)

参数

actorURI - 一个 String给出演员的URI设置

异常

IllegalArgumentException - 如果设置演员有问题。

另请参见：

getActor()

setRole

void setRole(String uri)
      throws SOAPException

将与此 SOAPHeaderElement对象 Role Role设置为指定的 Role 。

参数

uri - - 的URI为 Role

异常

SOAPException - 如果设置角色有错误

UnsupportedOperationException - 如果此消息不支持“故障角色”的SOAP 1.2概念。

从以下版本开始：

SAAJ 1.3

getActor

String getActor()

返回此SOAPHeaderElement的actor属性的uri。

如果这个SOAPHeaderElement支持SOAP 1.2，那么这个调用就相当于getRole()

结果

一个 String给了演员的URI

另请参见：

setActor(java.lang.String)

getRole

String getRole()

返回此 SOAPHeaderElement的 Role属性的值。

结果

一个 String给出的URI为 Role

异常

UnsupportedOperationException - 如果此消息不支持“故障角色”的SOAP 1.2概念。

从以下版本开始：

SAAJ 1.3

setMustUnderstand

void setMustUnderstand(boolean mustUnderstand)

将此SOAPHeaderElement对象的SOAPHeaderElement属性设置为true或false。

如果mustUnderstand属性打开，则接收SOAPHeaderElement的演员必须正确处理。 这确保了，例如，如果SOAPHeaderElement对象修改消息，那么该消息正在被正确修改。

参数

mustUnderstand - true将mustUnderstand属性设置为true; false将其设置为false

异常

IllegalArgumentException - 如果在设置mustUnderstand属性时出现问题

另请参见：

getMustUnderstand() ， setRelay(boolean)

getMustUnderstand

boolean getMustUnderstand()

返回此 SOAPHeaderElement的mustUnderstand属性的布尔值。

结果

true如果此SOAPHeaderElement对象的SOAPHeaderElement属性已打开; false否则

setRelay

void setRelay(boolean relay)
       throws SOAPException

设置此继电器属性SOAPHeaderElement是真或假。

SOAP中继属性设置为true，表示SOAP头块必须由头块目标的任何节点进行中继，但实际上不处理它。 对于其mustUnderstand属性设置为true或针对最终接收者（这是默认值）的标头块，此属性将被忽略。 此属性的默认值为false 。

参数

relay - 中继属性的新值

异常

SOAPException - 如果设置继电器属性有问题。

UnsupportedOperationException - 如果此消息不支持中继属性的SOAP 1.2概念。

从以下版本开始：

SAAJ 1.3

另请参见：

setMustUnderstand(boolean) ， getRelay()

getRelay

boolean getRelay()

返回此 SOAPHeaderElement的 中继属性的布尔值

结果

true如果继电器属性打开; false否则

异常

UnsupportedOperationException - 如果此消息不支持中继属性的SOAP 1.2概念。

从以下版本开始：

SAAJ 1.3

另请参见：

getMustUnderstand(), setRelay(boolean)