©
Dokumen ini menggunakan Manual laman web PHP Cina Lepaskan
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
public interface SOAPHeader
SOAP 头元素的表示形式。SOAP 头元素由能影响消息提供者处理特定于应用程序内容的方式的 XML 数据组成。例如,事务语义、验证信息等,都可以被指定为 SOAPHeader
对象的内容。
SOAPEnvelope
对象默认包含一个空 SOAPHeader
对象。如果不需要 SOAPHeader
对象(可选),则可以使用以下代码行检索和删除该对象。变量 se 是一个 SOAPEnvelope
对象。
se.getHeader().detachNode();
SOAPHeader
对象是使用 SOAPEnvelope
的 addHeader
方法创建的。只有在移除现有的头之后,才能调用此方法创建新头并将其添加到信封中。
se.getHeader().detachNode(); SOAPHeader sh = se.addHeader();
SOAPHeader
对象只能将 SOAPHeaderElement
对象作为其直接子级。方法 addHeaderElement
创建一个新 HeaderElement
对象并将其添加到 SOAPHeader
对象。在以下代码行中,方法 addHeaderElement
的参数是一个 Name
对象,该对象是新 HeaderElement
对象的名称。
SOAPHeaderElement shElement = sh.addHeaderElement(name);
SOAPHeaderElement
字段摘要 |
---|
从接口 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 |
方法摘要 | |
---|---|
SOAPHeaderElement |
addHeaderElement(Name name)
创建使用指定名称初始化的新的 SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。 |
SOAPHeaderElement |
addHeaderElement(QName qname)
创建使用指定 qname 初始化的新的 SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。 |
SOAPHeaderElement |
addNotUnderstoodHeaderElement(QName name)
创建使用指定名称初始化的新的 NotUnderstood SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。 |
SOAPHeaderElement |
addUpgradeHeaderElement(Iterator supportedSOAPURIs)
创建使用指定的 SOAP URI 支持列表初始化的新的 Upgrade SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。 |
SOAPHeaderElement |
addUpgradeHeaderElement(String supportedSoapUri)
创建使用指定受支持 SOAP URI 初始化的新的 Upgrade SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。 |
SOAPHeaderElement |
addUpgradeHeaderElement(String[] supportedSoapUris)
创建使用指定 SOAP URI 支持数组初始化的新的 Upgrade SOAPHeaderElement 对象,并将其添加到此 SOAPHeader 对象。 |
Iterator |
examineAllHeaderElements()
返回可在此 SOAPHeader 对象中所有 SOAPHeaderElement 对象上进行迭代的 Iterator 。 |
Iterator |
examineHeaderElements(String actor)
返回可在此 SOAPHeader 对象中具有指定的 actor 的 SOAPHeaderElement 对象上进行迭代的 Iterator 。 |
Iterator |
examineMustUnderstandHeaderElements(String actor)
返回可在此 SOAPHeader 对象中所有符合以下条件的 SOAPHeaderElement 对象上进行迭代的 Iterator :具有指定的 actor 以及一个值等于 true 的 MustUnderstand 属性。 |
Iterator |
extractAllHeaderElements()
返回可在此 SOAPHeader 对象中所有 SOAPHeaderElement 对象上进行迭代的 Iterator ,并将这些 SOAPHeaderElement 对象从此 SOAPHeader 对象中分离出来。 |
Iterator |
extractHeaderElements(String actor)
返回可在此 SOAPHeader 对象中所有具有指定 actor 的 SOAPHeaderElement 对象上进行迭代的 Iterator ,并将这些 SOAPHeaderElement 对象从此 SOAPHeader 对象中分离出来。 |
从接口 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 |
从接口 javax.xml.soap.Node 继承的方法 |
---|
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue |
从接口 org.w3c.dom.Element 继承的方法 |
---|
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS |
从接口 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 |
方法详细信息 |
---|
SOAPHeaderElement addHeaderElement(Name name) throws SOAPException
SOAPHeaderElement
对象,并将其添加到此 SOAPHeader
对象。
name
- 带有新 SOAPHeaderElement
对象名称的 Name
对象
SOAPHeader
对象的新的 SOAPHeaderElement
对象
SOAPException
- 如果发生 SOAP 错误addHeaderElement(javax.xml.namespace.QName)
SOAPHeaderElement addHeaderElement(QName qname) throws SOAPException
SOAPHeaderElement
对象,并将其添加到此 SOAPHeader
对象。
qname
- 带有新 SOAPHeaderElement
对象 qname 的 QName
对象
SOAPHeader
对象的新的 SOAPHeaderElement
对象
SOAPException
- 如果发生 SOAP 错误addHeaderElement(Name)
Iterator examineMustUnderstandHeaderElements(String actor)
SOAPHeader
对象中所有符合以下条件的 SOAPHeaderElement
对象上进行迭代的 Iterator
:具有指定的 actor 以及一个值等于 true
的 MustUnderstand 属性。
在 SOAP 1.2 中,env:actor 属性应替换为 env:role 属性,但实质上语义是相同的。
actor
- 一个 String
,给出要搜索的 actor
/role
的 URI
Iterator
对象,可在所有符合以下条件的 SOAPHeaderElement
对象上进行迭代:包含指定的 actor
/ role
并标记为 MustUnderstandexamineHeaderElements(java.lang.String)
,
extractHeaderElements(java.lang.String)
,
SOAPConstants.URI_SOAP_ACTOR_NEXT
Iterator examineHeaderElements(String actor)
SOAPHeader
对象中具有指定的 actor 的 SOAPHeaderElement
对象上进行迭代的 Iterator
。actor 是一个全局属性,指示消息到达其最终接收者之前应对该消息进行处理的中间参与方。actor 接收并处理消息,然后将该消息发送到下一个 actor。默认 actor 是消息的最终预定接收方,所以如果 SOAPHeader
对象中没有包括 actor 属性,那么 message 将与消息正文一起发送到最终接收者。
在 SOAP 1.2 中,env:actor 属性应替换为 env:role 属性,但实质上语义是相同的。
actor
- 一个 String
,给出要搜索的 actor
/ role
的 URI
Iterator
对象,可在所有包含指定的 actor
/ role
的 SOAPHeaderElement
对象上进行迭代extractHeaderElements(java.lang.String)
,
SOAPConstants.URI_SOAP_ACTOR_NEXT
Iterator extractHeaderElements(String actor)
SOAPHeader
对象中所有具有指定 actor 的 SOAPHeaderElement
对象上进行迭代的 Iterator
,并将这些 SOAPHeaderElement 对象从此 SOAPHeader
对象中分离出来。
此方法允许 actor 处理并移除适用于它的 SOAPHeader
对象部分,然后将该消息发送到下一个 actor。
在 SOAP 1.2 中,env:actor 属性应替换为 env:role 属性,但实质上语义是相同的。
actor
- 一个 String
,给出要搜索的 actor
/ role
的 URI
Iterator
对象,可在所有包含指定 actor
/ role
的 SOAPHeaderElement
对象上进行迭代examineHeaderElements(java.lang.String)
,
SOAPConstants.URI_SOAP_ACTOR_NEXT
SOAPHeaderElement addNotUnderstoodHeaderElement(QName name) throws SOAPException
SOAPHeaderElement
对象,并将其添加到此 SOAPHeader
对象。只有 SOAP 1.2 支持此操作。
name
- 带有不可理解的 SOAPHeaderElement
对象名称的 QName
对象。
SOAPHeader
对象的新的 SOAPHeaderElement
对象
SOAPException
- 如果发生 SOAP 错误。
UnsupportedOperationException
- 如果这是一个 SOAP 1.1 Header。SOAPHeaderElement addUpgradeHeaderElement(Iterator supportedSOAPURIs) throws SOAPException
SOAPHeaderElement
对象,并将其添加到此 SOAPHeader
对象。SOAP 1.1 头和 SOAP 1.2 头上都支持此操作。
supportedSOAPURIs
- 带有受支持 SOAP 版本 URI 的 Iterator
对象。
SOAPHeader
对象的新的 SOAPHeaderElement
对象
SOAPException
- 如果发生 SOAP 错误。SOAPHeaderElement addUpgradeHeaderElement(String[] supportedSoapUris) throws SOAPException
SOAPHeaderElement
对象,并将其添加到此 SOAPHeader
对象。SOAP 1.1 头和 SOAP 1.2 头上都支持此操作。
supportedSoapUris
- 受支持 SOAP 版本的 URI 数组
SOAPHeader
对象的新的 SOAPHeaderElement
对象
SOAPException
- 如果发生 SOAP 错误。SOAPHeaderElement addUpgradeHeaderElement(String supportedSoapUri) throws SOAPException
SOAPHeaderElement
对象,并将其添加到此 SOAPHeader
对象。SOAP 1.1 头和 SOAP 1.2 头上都支持此操作。
supportedSoapUri
- 受支持 SOAP 版本的 URI。
SOAPHeader
对象的新的 SOAPHeaderElement
对象
SOAPException
- 如果发生 SOAP 错误。Iterator examineAllHeaderElements()
SOAPHeader
对象中所有 SOAPHeaderElement
对象上进行迭代的 Iterator
。
Iterator
对象,可在此 SOAPHeader
对象包含的所有 SOAPHeaderElement
对象上进行迭代extractAllHeaderElements()
Iterator extractAllHeaderElements()
SOAPHeader
对象中所有 SOAPHeaderElement
对象上进行迭代的 Iterator
,并将这些 SOAPHeaderElement 对象从此 SOAPHeader
对象中分离出来。
Iterator
对象,可在此 SOAPHeader
对象包含的所有 SOAPHeaderElement
对象上进行迭代examineAllHeaderElements()
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。