モジュール java.xml.ws
パッケージ 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のパラメータと戻り値の型のバインディングだけを確認することもできます。
    導入されたバージョン:
    1.6, JAX-WS 2.1
    関連項目:
    AddressingFeature

    • コンストラクタの詳細

      • RespectBindingFeature

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

      • RespectBindingFeature

        public RespectBindingFeature​(boolean enabled)
        RespectBindingFeatureを作成します
        パラメータ:
        enabled - この機能を有効にするかどうかを指定する。

    • メソッドの詳細

      • getID

        public String getID​()
        このWebServiceFeatureの一意の識別子を取得します。
        定義:
        getID、クラス: WebServiceFeature
        戻り値:
        この機能の一意の識別子。