|
JavaTM 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
メソッドへの引数は、新しい HeaderElement
オブジェクトの名前である Name
オブジェクトです。
SOAPHeaderElement shElement = sh.addHeaderElement(name);
SOAPHeaderElement
フィールドの概要 |
---|
メソッドの概要 | |
---|---|
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 オブジェクトから切り離します。 |
インタフェース javax.xml.soap.Node から継承されたメソッド |
---|
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue |
メソッドの詳細 |
---|
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()
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。