パッケージ jakarta.xml.ws
クラス RespectBindingFeature
- java.lang.ObjectSE
-
- jakarta.xml.ws.WebServiceFeature
-
- 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をスローすると、エンドポイントはデプロイに失敗する必要があります
- クライアント: ランタイムは、上記のメソッドの 1 つが呼び出されたときよりも早く、エンドポイント操作の最初の呼び出しまでに
- DISABLED: このモードでは、実装は
wsdl:bindingをインスペクションするかどうか、およびwsdl:bindingをインスペクションする程度を選択できます。例: ある実装では、この機能が有効になっているかのように動作することを選択できますが、別の実装では、SEI のパラメーター / 戻り値の型のバインディングのみを検証することを選択できます。
- 導入:
- 1.6、JAX-WS 2.1
- 関連事項:
AddressingFeature
- ENABLED: このモードでは、Jakarta XML Web Services ランタイムは、必要なすべての
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static StringSEIDRespectBindingFeature を識別する定数値クラス jakarta.xml.ws.WebServiceFeature から継承されたフィールド
enabled
コンストラクターの概要
コンストラクター コンストラクター 説明 RespectBindingFeature()RespectBindingFeatureを作成します。RespectBindingFeature(boolean enabled)RespectBindingFeature を作成します
メソッドの詳細
getID
public StringSE getID()
クラスからコピーされた説明:WebServiceFeatureこの WebServiceFeature の一意の識別子を取得します。- 次で指定:
- クラス
WebServiceFeatureのgetID - 戻り値:
- この機能の一意の識別子。