public interface SOAPHeader extends SOAPElement
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
メソッドへの引数は、新しい HeaderElement
オブジェクトの名前である Name
オブジェクトです。
SOAPHeaderElement shElement = sh.addHeaderElement(name);
SOAPHeaderElement
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)
指定された actor を持つこの
SOAPHeader オブジェクト内のすべての SOAPHeaderElement オブジェクトについての Iterator を返します。 |
Iterator |
examineMustUnderstandHeaderElements(String actor)
指定された actor を持ち、MustUnderstand 属性の値が
true と同じものを持つ SOAPHeader オブジェクト内のすべての SOAPHeaderElement オブジェクトについての Iterator を返します。 |
Iterator |
extractAllHeaderElements()
SOAPHeader オブジェクト内のすべての SOAPHeaderElement オブジェクトについての Iterator を返し、この SOAPHeader オブジェクトから切り離します。 |
Iterator |
extractHeaderElements(String actor)
指定された actor を持つこの
SOAPHeader オブジェクト内のすべての SOAPHeaderElement オブジェクトについての Iterator を返し、それらをこの SOAPHeader オブジェクトから切り離します。 |
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
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS
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)
true
と同じものを持つ SOAPHeader
オブジェクト内のすべての SOAPHeaderElement
オブジェクトについての Iterator
を返します。
SOAP 1.2 では、env:actor 属性は env:role 属性に置換されましたが、実質的には同じセマンティクスです。
actor
- 検索する actor
/ role
の URI を示す String
actor
/role
を含み MustUnderstand とマークされている、すべての SOAPHeaderElement
オブジェクトの Iterator
オブジェクトexamineHeaderElements(java.lang.String)
, extractHeaderElements(java.lang.String)
, SOAPConstants.URI_SOAP_ACTOR_NEXT
Iterator examineHeaderElements(String actor)
SOAPHeader
オブジェクト内のすべての SOAPHeaderElement
オブジェクトについての Iterator
を返します。
actor は、メッセージが最終的な受信者に届く前に処理する必要のある中間の相手を示す、グローバル属性です。アクターはメッセージを受信し、次のアクターに送信する前にメッセージを処理します。デフォルトのアクターはメッセージの意図された最終的な受信者であり、アクター属性が SOAPHeader
オブジェクトに含まれていない場合、最終的な受信者にメッセージ本体とともに送信されます。
SOAP 1.2 では、env:actor 属性は env:role 属性に置換されましたが、実質的には同じセマンティクスです。
actor
- 検索する actor
/ role
の URI を示す String
actor
/ role
を含んでいるすべての SOAPHeaderElement
オブジェクトの Iterator
オブジェクトextractHeaderElements(java.lang.String)
, SOAPConstants.URI_SOAP_ACTOR_NEXT
Iterator extractHeaderElements(String actor)
SOAPHeader
オブジェクト内のすべての SOAPHeaderElement
オブジェクトについての Iterator
を返し、それらをこの SOAPHeader
オブジェクトから切り離します。
このメソッドは、アクターが該当する SOAPHeader
オブジェクトの一部を処理し、次のアクターにメッセージを渡す前に削除できるようにします。
SOAP 1.2 では、env:actor 属性は env:role 属性に置換されましたが、実質的には同じセマンティクスです。
actor
- 検索する actor
/ role
の URI を示す String
actor
/ role
を含んでいるすべての SOAPHeaderElement
オブジェクトの Iterator
オブジェクト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
を返します。SOAPHeader
に含まれているすべての SOAPHeaderElement
オブジェクトの Iterator
オブジェクトextractAllHeaderElements()
Iterator extractAllHeaderElements()
SOAPHeader
オブジェクト内のすべての SOAPHeaderElement
オブジェクトについての Iterator
を返し、この SOAPHeader
オブジェクトから切り離します。SOAPHeader
に含まれているすべての SOAPHeaderElement
オブジェクトの Iterator
オブジェクトexamineAllHeaderElements()
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.