javax.xml.ws
注釈型 RespectBinding

@Target(value=TYPE)
@Retention(value=RUNTIME)
@Documented
@WebServiceFeatureAnnotation(id="javax.xml.ws.RespectBindingFeature",
                             bean=RespectBindingFeature.class)
public @interface RespectBinding

この機能は、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

関連項目:

RespectBindingFeature

任意要素の概要

boolean

enabled この機能を有効にするか無効にするかを指定します。

enabled

public abstract boolean enabled

この機能を有効にするか無効にするかを指定します。

デフォルト:

true