- 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
をスローし、端点の配備は失敗する必要があります
- クライアント: ランタイムは、上記のメソッドの1つが呼び出されたあと、ただし最初の端点操作呼出しの前に、
- 無効: このモードでは、
wsdl:binding
を検査するかどうか、およびwsdl:binding
をどの程度まで検査するかを、実装で選択することができます。 たとえば、実装ではこの機能が有効になっている場合と同様に動作することもできれば、SEIのパラメータと戻り値の型のバインディングだけを確認することもできます。
- 導入されたバージョン:
- 1.6, JAX-WS 2.1
- 関連項目:
AddressingFeature
- 有効: このモードの場合、JAX-WSランタイムでは、すべての必須の
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static String
ID
RespectBindingFeatureを識別する定数です-
クラス javax.xml.ws.WebServiceFeatureから継承されたフィールド
enabled
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 RespectBindingFeature()
RespectBindingFeature
を作成します。RespectBindingFeature(boolean enabled)
RespectBindingFeatureを作成します
-
-
-
メソッドの詳細
-
getID
public String getID()
このWebServiceFeatureの一意の識別子を取得します。- 定義:
getID
、クラス:WebServiceFeature
- 戻り値:
- この機能の一意の識別子。
-
-