パッケージ 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 StringSE
ID
RespectBindingFeature を識別する定数値クラス jakarta.xml.ws.WebServiceFeature から継承されたフィールド
enabled
コンストラクターのサマリー
コンストラクター コンストラクター 説明 RespectBindingFeature()
RespectBindingFeature
を作成します。RespectBindingFeature(boolean enabled)
RespectBindingFeature を作成します
メソッドの詳細
getID
public StringSE getID()
クラスからコピーされた説明:WebServiceFeature
この WebServiceFeature の一意の識別子を取得します。- 次で指定:
- クラス
WebServiceFeature
のgetID
- 戻り値:
- この機能の一意の識別子。