javax.xml.ws

クラス RespectBindingFeature

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 をスローし、端点の配備は失敗する必要があります
• 無効:このモードでは、wsdl:binding を検査するかどうか、および wsdl:binding をどの程度まで検査するかを、実装で選択することができます。たとえば、実装ではこの機能が有効になっている場合と同様に動作することもできれば、SEI のパラメータと戻り値の型のバインディングだけを確認することもできます。

導入されたバージョン:

JAX-WS 2.1

関連項目:

AddressingFeature

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static String	ID RespectBindingFeature を識別する定数です

クラス javax.xml.ws.WebServiceFeature から継承されたフィールド

enabled

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
RespectBindingFeature() RespectBindingFeature を作成します。
RespectBindingFeature(boolean enabled) RespectBindingFeature を作成します

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
String	getID() この WebServiceFeature の一意の識別子を取得します。

クラス javax.xml.ws.WebServiceFeature から継承されたメソッド

isEnabled

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

ID

public static final String ID

RespectBindingFeature を識別する定数です

関連項目:

定数フィールド値

コンストラクタの詳細

RespectBindingFeature

public RespectBindingFeature()

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

RespectBindingFeature

public RespectBindingFeature(boolean enabled)

RespectBindingFeature を作成します

パラメータ:

enabled - この機能を有効にするかどうかを指定する。

メソッドの詳細

getID

public String getID()

この WebServiceFeature の一意の識別子を取得します。

定義:

getID、クラス: WebServiceFeature

戻り値:

この機能の一意の識別子。