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, 2014, Oracle and/or its affiliates. All rights reserved.