javax.xml.ws.soap

クラスAddressingFeature

java.lang.Object

javax.xml.ws.WebServiceFeature

javax.xml.ws.soap.AddressingFeature

public final class AddressingFeature
extends WebServiceFeature

AddressingFeatureは、SOAP 1.1/HTTPまたはSOAP 1.2/HTTPバインディングでのWS-Addressingの使用を表します。ほかのバインディングでのこの機能の使用は定義されていません。

この機能は、SEIプロキシ、クライアント側のDispatchインスタンスおよびサーバー側のEndpointインスタンスの作成時に使用できます。この機能はクライアント側のServiceインスタンスの作成には使用できません。

この機能を有効または無効にした場合の影響は次のとおりです。

• 有効: このモードでは、WS-Addressingが有効になります。端点はWS-Addressingをサポートしますが、WS-Addressingの使用が必要となるわけではありません。送信側は、WS-Addressingヘッダー付きのメッセージを送信することも、WS-Addressingヘッダーのないメッセージを送信することもできます。ただし、受信側はどちらのタイプのメッセージも消費する必要があります。
• 無効: このモードでは、WS-Addressingが無効になります。送信側も受信側も、実行時にWS-Addressingヘッダーを使用してはいけません。

この機能が有効な場合、requiredプロパティは端点でWS-Addressingが必要であるかどうかを判別します。trueに設定されている場合、インバウンド・メッセージとアウトバウンド・メッセージにWS-Addressingヘッダーが含まれている必要があります。デフォルトでは、requiredプロパティはfalseです。

Webサービス開発者がこの機能を明示的に有効にしていない場合、WSDLのwsam:Addressingポリシー・アサーションを使用してWS-Addressingの用途を探します。アプリケーションは、この機能を明示的に使用することで、WSDLによって示されたWS-Addressingの用途をオーバーライドします。場合によっては、これが実際に必要となることがあります。たとえば、アプリケーションがWS-Addressingそのものを実装している場合は、この機能を使用してアドレス指定を無効にできます。つまり、JAX-WSの実装がWS-Addressingヘッダーを消費することも、生成することもないということです。

アドレス指定が有効になると、3.1 WS-Policy Assertionsに準じて、WSDLに対応するwsam:Addressingポリシー・アサーションを生成する必要があります。

例1: 生成されたWSDLで可能なポリシー・アサーション@Addressing

   <wsam:Addressing wsp:Optional="true">
     <wsp:Policy/>
   </wsam:Addressing>
 

例2: 生成されたWSDLで可能なポリシー・アサーション@Addressing(required=true)

   <wsam:Addressing>
     <wsp:Policy/>
   </wsam:Addressing>
 

例3: 生成されたWSDLで可能なポリシー・アサーション@Addressing(required=true, responses=Responses.ANONYMOUS)

   <wsam:Addressing>
      <wsp:Policy>
        <wsam:AnonymousResponses/>
      </wsp:Policy>
   </wsam:Addressing>
 

WS-Addressingの詳細については、Web Services Addressing - Core、Web Services Addressing 1.0 - SOAP Binding、およびWeb Services Addressing 1.0 - Metadataを参照してください。

導入されたバージョン:

JAX-WS 2.1

関連項目:

Addressing

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	AddressingFeature.Responses アドレス指定が有効な場合、このプロパティは端点で匿名応答のみ、非匿名応答のみ、またはすべての使用を必要とするかどうかを判別します。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static String	ID AddressingFeatureを識別する定数です
protected boolean	required アドレス指定が有効な場合、このプロパティはエンド・ポイントでWS-Addressingが必要であるかどうかを判別します。

クラス javax.xml.ws.WebServiceFeatureから継承されたフィールド

enabled

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
AddressingFeature() アドレス指定要件を使用して、AddressingFeatureを作成し、構成します。
AddressingFeature(boolean enabled) アドレス指定要件を使用して、AddressingFeatureを作成し、構成します。
AddressingFeature(boolean enabled, boolean required) アドレス指定要件を使用して、AddressingFeatureを作成し、構成します。
AddressingFeature(boolean enabled, boolean required, AddressingFeature.Responses responses) アドレス指定要件を使用して、AddressingFeatureを作成し、構成します。

メソッドのサマリー

修飾子と型	メソッドと説明
String	getID() このWebServiceFeatureの一意の識別子を取得します。
AddressingFeature.Responses	getResponses() アドレス指定が有効な場合、このプロパティは端点で匿名応答または非匿名応答またはすべての応答の使用を必要とするかどうかを判別します。
boolean	isRequired() アドレス指定が有効な場合、このプロパティはエンド・ポイントでWS-Addressingが必要であるかどうかを判別します。

クラス javax.xml.ws.WebServiceFeatureから継承されたメソッド

isEnabled

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

ID

public static final String ID

AddressingFeatureを識別する定数です

関連項目:

定数フィールド値

required

protected boolean required

アドレス指定が有効な場合、このプロパティはエンド・ポイントでWS-Addressingが必要であるかどうかを判別します。requiredがtrueの場合、インバウンド・メッセージとアウトバウンド・メッセージにWS-Addressingヘッダーが含まれている必要があります。

コンストラクタの詳細

AddressingFeature

public AddressingFeature()

アドレス指定要件を使用して、AddressingFeatureを作成し、構成します。作成された機能により、ws-addressingが有効になります。つまり、ws-addressingがサポートされますが、その使用が必要となるわけではありません。さらに、すべての応答タイプを受け入れるように構成されます。

AddressingFeature

public AddressingFeature(boolean enabled)

アドレス指定要件を使用して、AddressingFeatureを作成し、構成します。enabledがtrueの場合、ws-addressingが有効になります。つまり、ws-addressingがサポートされますが、その使用が必要となるわけではありません。さらに、すべての応答タイプを受け入れるように構成します。

パラメータ:

enabled - trueはws-addressingを有効にする。つまり、ws-addressingがサポートされるが、それを使用する必要はない

AddressingFeature

public AddressingFeature(boolean enabled,
                         boolean required)

アドレス指定要件を使用して、AddressingFeatureを作成し、構成します。enabledおよびrequiredがtrueの場合、ws-addressingが有効になり、それを使用する必要がある。さらに、すべての応答タイプを受け入れるように構成します。

パラメータ:

enabled - trueはws-addressingを有効にする。つまり、ws-addressingがサポートされるが、それを使用する必要はない

required - trueはws-addressingの使用が必須であることを示す。

AddressingFeature

public AddressingFeature(boolean enabled,
                         boolean required,
                         AddressingFeature.Responses responses)

アドレス指定要件を使用して、AddressingFeatureを作成し、構成します。enabledおよびrequiredがtrueの場合、ws-addressingが有効になり、それを使用する必要がある。また、応答タイプはresponsesパラメータで構成できます。

パラメータ:

enabled - trueはws-addressingを有効にする。つまり、ws-addressingがサポートされるが、それを使用する必要はない

required - trueはws-addressingの使用が必須であることを示す。

responses - 必要な応答のタイプを指定します

導入されたバージョン:

JAX-WS 2.2

メソッドの詳細

getID

public String getID()

このWebServiceFeatureの一意の識別子を取得します。

定義:

getID、クラス: WebServiceFeature

戻り値:

この機能の一意の識別子。

isRequired

public boolean isRequired()

アドレス指定が有効な場合、このプロパティはエンド・ポイントでWS-Addressingが必要であるかどうかを判別します。requiredがtrueの場合、インバウンド・メッセージとアウトバウンド・メッセージにWS-Addressingヘッダーが含まれている必要があります。

戻り値:

requiredの現在の値

getResponses

public AddressingFeature.Responses getResponses()

アドレス指定が有効な場合、このプロパティは端点で匿名応答または非匿名応答またはすべての応答の使用を必要とするかどうかを判別します。

戻り値:

端点がすべてのタイプの応答をサポートする場合はAddressingFeature.Responses.ALL、端点で匿名の応答のみ使用する必要がある場合はAddressingFeature.Responses.ANONYMOUS、端点で匿名以外の応答のみ使用する必要がある場合はAddressingFeature.Responses.NON_ANONYMOUS

導入されたバージョン:

JAX-WS 2.2