javax.xml.ws

クラスRespectBindingFeature

java.lang.Object

javax.xml.ws.WebServiceFeature

javax.xml.ws.RespectBindingFeature

public final class RespectBindingFeature
extends WebServiceFeature

この機能は、JAX-WSランタイムでのwsdl:bindingの使用を明確にします。この機能は、SEIプロキシ、クライアント側のDispatchインスタンスおよびサーバー側のEndpointインスタンスの作成時に使用できます。この機能はクライアント側のServiceインスタンスの作成には使用できません。

この機能は、WSDLが関連付けられているWebサービスでのみ役立ちます。この機能が有効になっている場合、JAX-WS実装では、実行時に端点のwsdl:bindingを検査して、required属性がtrueに設定されているすべてのwsdl:extensionsが認識され使用されていることを確認する必要があります。

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

• 有効: このモードの場合、JAX-WSランタイムでは、すべての必須のwsdl:binding拡張機能がランタイムで認識され使用されていること、あるいはWebサービス・アプリケーションによって明示的に無効にされていることを確認する必要があります。Webサービスでは、対応するWebServiceFeatureまたは注釈があれば、特定の拡張機能を無効にできます。同様に、Webサービス・クライアントでは、プロキシまたはDispatchインスタンスを作成中に対応するWebServiceFeatureを使用することによって、特定の拡張機能を無効にすることができます。ランタイムでは、SEIのパラメータと戻り値のバインディングでwsdl:bindingが遵守されていることも確認する必要があります。この機能が有効になっている場合、JAX-WSランタイムでサポートされない必須の(wsdl:required="true") wsdl:binding拡張機能がWSDLに含まれていて、それがWebサービス開発者によって明示的にオフにされていないとき、JAX-WSランタイムはクライアントかサーバーかに応じて適切に動作する必要があります。
  • クライアント: ランタイムは、上記のメソッドの1つが呼び出されたあと、ただし最初の端点操作呼出しの前に、WebServiceExceptionをスローする必要があります。
  • サーバー: WebServiceExceptionをスローし、端点の配備は失敗する必要があります
• 無効: このモードでは、wsdl:bindingを検査するかどうか、およびwsdl:bindingをどの程度まで検査するかを、実装で選択することができます。たとえば、実装ではこの機能が有効になっている場合と同様に動作することもできれば、SEIのパラメータと戻り値の型のバインディングだけを確認することもできます。

導入されたバージョン:

JAX-WS 2.1

関連項目:

AddressingFeature

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static String	ID RespectBindingFeatureを識別する定数です

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

enabled

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

コンストラクタ

コンストラクタと説明
RespectBindingFeature() RespectBindingFeatureを作成します。
RespectBindingFeature(boolean enabled) RespectBindingFeatureを作成します

メソッドのサマリー

修飾子と型	メソッドと説明
String	getID() このWebServiceFeatureの一意の識別子を取得します。

クラス 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

RespectBindingFeatureを識別する定数です

関連項目:

定数フィールド値

コンストラクタの詳細

RespectBindingFeature

public RespectBindingFeature()

RespectBindingFeatureを作成します。作成されたインスタンスは有効になります。

RespectBindingFeature

public RespectBindingFeature(boolean enabled)

RespectBindingFeatureを作成します

パラメータ:

enabled - この機能を有効にするかどうかを指定する。

メソッドの詳細

getID

public String getID()

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

定義:

getID、クラス: WebServiceFeature

戻り値:

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