パッケージ jakarta.xml.ws

クラス RespectBindingFeature


  • public final class RespectBindingFeature
    extends WebServiceFeature
    この機能は、Jakarta XML Web Services ランタイムでの wsdl:binding の使用を明確にします。この機能は、SEI プロキシ、クライアント側の Dispatch インスタンス、サーバー側の Endpoint インスタンスの作成中に使用できます。この機能は、クライアント側での Service インスタンスの作成には使用できません。

    この機能は、WSDL が関連付けられている Web サービスでのみ役立ちます。この機能を有効にするには、Jakarta XML Web Services 実装が実行時にエンドポイントの wsdl:binding をインスペクションして、required 属性が true に設定されているすべての wsdl:extensions が理解され、使用されていることを確認する必要があります。

    以下に、有効または無効に関するこの機能の影響について説明します。

    • ENABLED: このモードでは、Jakarta XML Web Services ランタイムは、必要なすべての wsdl:binding 拡張機能(ポリシーを含む)がランタイムによって理解および使用されるか、Web サービスアプリケーションによって明示的に無効化されることを保証する必要があります。対応する WebServiceFeature またはアノテーションがある場合、Web サービスは特定の拡張機能を無効にすることができます。同様に、Web サービスクライアントは、プロキシまたはディスパッチインスタンスの作成中に、対応する WebServiceFeature を使用して特定の拡張機能を無効にすることができます。ランタイムは、SEI パラメーター / 戻り値のバインディングが wsdl:binding を考慮していることも確認する必要があります。この機能を有効にすると、必要な(wsdl:required="true") wsdl:binding 拡張機能が WSDL にあり、Jakarta XML Web Services ランタイムでサポートされておらず、Web サービス開発者によって明示的にオフにされていない場合、その Jakarta XML Web Services ランタイムは次の条件に基づいて適切に動作する必要があります。クライアントまたはサーバー上にあります:
      • クライアント: ランタイムは、上記のメソッドの 1 つが呼び出されたときよりも早く、エンドポイント操作の最初の呼び出しまでに WebServiceException をスローする必要があります。
      • サーバー: WebServiceException をスローすると、エンドポイントはデプロイに失敗する必要があります
    • DISABLED: このモードでは、実装は 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 StringSE getID()
        クラスからコピーされた説明: WebServiceFeature
        この WebServiceFeature の一意の識別子を取得します。
        次で指定:
        クラス WebServiceFeaturegetID 
        戻り値:
        この機能の一意の識別子。