アノテーション型 Addressing
@TargetSE({TYPESE,METHODSE,FIELDSE}) @RetentionSE(RUNTIMESE) @DocumentedSE @WebServiceFeatureAnnotation(id="http://www.w3.org/2005/08/addressing/module", bean=AddressingFeature.class) public @interface Addressing
このアノテーションは、SOAP 1.1/HTTP または SOAP 1.2/HTTP バインディングのいずれかでの WS-Addressing の使用を表します。このアノテーションを他のバインディングとともに使用することは未定義です。このアノテーションは、
jakarta.jws.WebService
、WebServiceProvider
、WebServiceRef
アノテーションと組み合わせてのみ使用する必要があります。jakarta.jws.WebService
アノテーションとともに使用する場合、このアノテーションはサービスエンドポイント実装クラスでのみ使用する必要があります。WebServiceRef
アノテーションとともに使用する場合、このアノテーションはプロキシインスタンスが作成される場合にのみ使用する必要があります。注入された SEI プロキシとエンドポイントは、Addressing
アノテーションの値を尊重しなければなりません。このアノテーションの動作は、対応する機能
AddressingFeature
によって定義されます。- 導入:
- 1.6、JAX-WS 2.1
オプション要素のサマリー
オプション要素 修飾子と型 オプションの要素 説明 boolean
enabled
この機能を有効にするか無効にするかを指定します。boolean
required
アドレス指定が有効になっている場合、このプロパティはエンドポイントに WS-Addressing が必要かどうかを決定します。AddressingFeature.Responses
responses
アドレス指定が有効な場合、このプロパティは、エンドポイントが匿名レスポンス、非匿名レスポンス、すべての使用を必要とするかどうかを決定します。
要素の詳細
enabled
boolean enabled
この機能が有効か無効かを指定します。有効になっている場合、エンドポイントは WS-Addressing をサポートしていますが、WS-Addressing を使用する必要がないことを意味します。生成された WSDL に対応する 3.1.1 アサーションへの対処を生成する必要があります。- 戻り値:
- エンドポイントが WS-Addressing をサポートする場合は
true
、それ以外の場合はfalse
- デフォルト:
- true
required
boolean required
アドレス指定が有効な場合、このプロパティは、エンドポイントが WS-Addressing を必要とするかどうかを決定します。required が true の場合、エンドポイントは WS-Addressing を必要とし、WS-Addressing ヘッダーは受信メッセージに存在する必要があります。対応する 3.1.1 アサーションへの対処を WSDL で生成する必要があります。- 戻り値:
- エンドポイントが WS-Addressing を必要とする場合は
true
、それ以外の場合はfalse
- デフォルト:
- false
responses
AddressingFeature.Responses responses
アドレス指定が有効な場合、このプロパティは、エンドポイントが匿名レスポンス、非匿名レスポンス、すべての使用を必要とするかどうかを決定します。AddressingFeature.Responses.ALL
はすべてのレスポンス型をサポートし、これがデフォルト値です。AddressingFeature.Responses.ANONYMOUS
では、匿名のレスポンスのみを使用する必要があります。生成された WSDL の 3.1.2 AnonymousResponses アサーションで指定されているように、wsam:AnonymousResponses ネストされたアサーションになります。AddressingFeature.Responses.NON_ANONYMOUS
では、匿名でないレスポンスのみを使用する必要があります。生成された WSDL の 3.1.3 NonAnonymousResponses アサーションで指定されているように、wsam:NonAnonymousResponses ネストされたアサーションになります。- 戻り値:
- サポートされているレスポンス型
- 導入:
- 1.7、JAX-WS 2.2
- デフォルト:
- jakarta.xml.ws.soap.AddressingFeature.Responses.ALL