パッケージ jakarta.xml.ws.soap

アノテーション型 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.WebServiceWebServiceProviderWebServiceRef アノテーションと組み合わせてのみ使用する必要があります。jakarta.jws.WebService アノテーションとともに使用する場合、このアノテーションはサービスエンドポイント実装クラスでのみ使用する必要があります。WebServiceRef アノテーションとともに使用する場合、このアノテーションはプロキシインスタンスが作成される場合にのみ使用する必要があります。注入された SEI プロキシとエンドポイントは、Addressing アノテーションの値を尊重しなければなりません。

    このアノテーションの動作は、対応する機能 AddressingFeature によって定義されます。

    導入:
    1.6、JAX-WS 2.1
    • オプション要素のサマリー

      オプション要素  
      修飾子と型 オプションの要素 説明
      booleanenabled
      この機能を有効にするか無効にするかを指定します。
      booleanrequired
      アドレス指定が有効になっている場合、このプロパティはエンドポイントに WS-Addressing が必要かどうかを決定します。
      AddressingFeature.Responsesresponses
      アドレス指定が有効な場合、このプロパティは、エンドポイントが匿名レスポンス、非匿名レスポンス、すべての使用を必要とするかどうかを決定します。
    • 要素の詳細

      • 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