モジュール java.xml.ws
パッケージ javax.xml.ws

注釈型Action


  • @Documented
    @Retention(RUNTIME)
    @Target(METHOD)
    public @interface Action
    Action注釈を使用すると、WS-AddressingのActionメッセージ・アドレス指定プロパティを、マッピングされたWSDL操作のinputoutput、およびfaultメッセージに明示的に関連付けることができます。

    この注釈は、サービス端点インタフェースの各メソッドで指定できます。 このようなメソッドでは、WSDL operationのWSDL inputoutput、およびfaultメッセージで生成されたWSDLのwsam:Action属性内にあるマッピングされた操作は、Action注釈のどの属性が指定されているかによって異なります。 メッセージのwsam:Action値の正確な計算については、JAX-WS仕様のアルゴリズムを参照してください。

    例1: inputおよびoutputメッセージに対応する、Actionメッセージ・アドレス指定プロパティの明示的な値を指定します。

     @WebService(targetNamespace="http://example.com/numbers")
      public class AddNumbersImpl {
         @Action(
              input="http://example.com/inputAction",
              output="http://example.com/outputAction")
          public int addNumbers(int number1, int number2) {
              return number1 + number2;
          }
      }
     
    生成されたWSDLは次のようになります。
     
       <definitions targetNamespace="http://example.com/numbers" ...>
         ...
         <portType name="AddNumbersPortType">
           <operation name="AddNumbers">
             <input message="tns:AddNumbersInput" name="foo"
               <b>wsam:Action="http://example.com/inputAction"</b>/>
             <output message="tns:AddNumbersOutput" name="bar"
               <b>wsam:Action="http://example.com/outputAction"</b>/>
           </operation>
         </portType>
         ...
       </definitions>
     
     

    例2: inputメッセージにのみ対応する、Actionメッセージ・アドレス指定プロパティの明示的な値を指定します。 WSDL outputメッセージのwsam:Action値は、JAX-WS仕様のアルゴリズムを使用して計算されます。

     @WebService(targetNamespace="http://example.com/numbers")
      public class AddNumbersImpl {
         @Action(input="http://example.com/inputAction")
          public int addNumbers(int number1, int number2) {
              return number1 + number2;
          }
      }
     
    生成されたWSDLは次のようになります。
     
       <definitions targetNamespace="http://example.com/numbers" ...>
         ...
         <portType name="AddNumbersPortType">
           <operation name="AddNumbers">
             <input message="tns:AddNumbersInput" name="foo"
               <b>wsam:Action="http://example.com/inputAction"</b>/>
             <output message="tns:AddNumbersOutput" name="bar"
               <b>wsam:Action="http://example.com/numbers/AddNumbersPortType/AddNumbersResponse"</b>/>
           </operation>
         </portType>
         ...
       </definitions>
     
    outputメッセージにのみ対応する、Actionメッセージ指定プロパティの明示的な値を指定してもかまいません。 このような場合、WSDL inputメッセージのwsam:Action値は、JAX-WS仕様のアルゴリズムを使用して計算されます。

    例3: faultメッセージに対応するActionメッセージ指定プロパティの明示的な値を指定する方法の例については、FaultAction注釈を参照してください。

    導入されたバージョン:
    1.6, JAX-WS 2.1
    関連項目:
    FaultAction
    • オプション要素のサマリー

      オプションの要素 
      修飾子と型 オプション要素 説明
      FaultAction[] fault
      操作のfaultメッセージに対応する、WS-AddressingのActionメッセージ・アドレス指定プロパティの明示的な値です。
      String input
      操作のinputメッセージに対応する、WS-AddressingのActionメッセージ・アドレス指定プロパティの明示的な値です。
      String output
      操作のoutputメッセージに対応する、WS-AddressingのActionメッセージ・アドレス指定プロパティの明示的な値です。
    • 要素の詳細

      • input

        String input
        操作のinputメッセージに対応する、WS-AddressingのActionメッセージ・アドレス指定プロパティの明示的な値です。
        戻り値:
        Actionメッセージのinputメッセージのアドレス指定プロパティ
        デフォルト:
        ""
      • output

        String output
        操作のoutputメッセージに対応する、WS-AddressingのActionメッセージ・アドレス指定プロパティの明示的な値です。
        戻り値:
        Actionメッセージのoutputメッセージのアドレス指定プロパティ
        デフォルト:
        ""
      • fault

        FaultAction[] fault
        操作のfaultメッセージに対応する、WS-AddressingのActionメッセージ・アドレス指定プロパティの明示的な値です。 フォルトにマッピングされ、明示的なWS-Addressing Actionメッセージ・アドレス指定プロパティを必要とする例外は、それぞれFaultAction注釈を使用してこのプロパティの値として指定される必要があります。
        戻り値:
        Actionメッセージのfaultメッセージのアドレス指定プロパティ
        デフォルト:
        {}