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 の使用を明確にします。

この機能は、WSDL が関連付けられている Web サービスでのみ役立ちます。この機能が有効になっている場合、JAX-WS 実装では、実行時に端点の wsdl:binding を検査して、required 属性が true に設定されているすべての wsdl:extensions が認識され使用されていることを確認する必要があります。

この機能を有効または無効にした場合の影響は次のとおりです。

• 有効:このモードの場合、JAX-WS ランタイムでは、すべての必須の wsdl:binding 拡張機能がランタイムで認識され使用されていること、あるいは Web サービスアプリケーションによって明示的に無効にされていることを確認する必要があります。Web サービスアプリケーションでは、既知の WebServiceFeature を持つ特定の拡張機能を、その WebServiceFeature に関連付けられた適切な注釈をサーバーで使用するか、次のいずれかのメソッドをクライアントで使用することによって、無効にすることができます。
  • Service.getPort(QName,Class,WebServiceFeature...)
  • Service.getPort(Class,WebServiceFeature...)
  • Service.getPort(EndpointReference,Class,WebServiceFeature...)
  • Service.createDispatch(QName,Class,Service.Mode mode,WebServiceFeature...)
  • Service.createDispatch(EndpointReference,Class,Service.Mode,WebServiceFeature...)
  • Service.createDispatch(QName,JAXBContext,Service.Mode,WebServiceFeature...)
  • Service.createDispatch(EndpointReference,JAXBContext,Service.Mode,WebServiceFeature...)
  • EndpointReference.getPort(Class,WebServiceFeature...)
  • 生成された Service の getXXXPort(WebServiceFeatures...) メソッドの 1 つ
  ランタイムでは、SEI のパラメータと戻り値のバインディングで wsdl:binding が遵守されていることも確認する必要があります。この機能が有効になっている場合、JAX-WS ランタイムでサポートされない必須の (wsdl:required="true") wsdl:binding 拡張機能が WSDL に含まれていて、それが Web サービス開発者によって明示的にオフにされていないとき、JAX-WS ランタイムはクライアントかサーバーかに応じて適切に動作する必要があります。
  • Client:ランタイムは、上記のメソッドの 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 の一意の識別子を取得します。

定義:

クラス WebServiceFeature 内の getID

戻り値:

この機能の一意の識別子