javax.xml.ws

注釈型Action

@Documented
 @Retention(value=RUNTIME)
 @Target(value=METHOD)
public @interface Action

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

この注釈は、サービス端点インタフェースの各メソッドで指定できます。このようなメソッドでは、WSDL operationのWSDL input、output、および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"
           wsam:Action="http://example.com/inputAction"/>
         <output message="tns:AddNumbersOutput" name="bar"
           wsam:Action="http://example.com/outputAction"/>
       </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"
           wsam:Action="http://example.com/inputAction" />
         <output message="tns:AddNumbersOutput" name="bar"
           wsam:Action="http://example.com/numbers/AddNumbersPortType/AddNumbersResponse"/>
       </operation>
     </portType>
     ...
   </definitions>
 

outputメッセージにのみ対応する、Actionメッセージ指定プロパティの明示的な値を指定してもかまいません。このような場合、WSDL inputメッセージのwsam:Action値は、JAX-WS仕様のアルゴリズムを使用して計算されます。

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

導入されたバージョン:

JAX-WS 2.1

関連項目:

FaultAction

オプション要素のサマリー

オプションの要素

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

要素の詳細

input

public abstract String input

操作のinputメッセージに対応する、WS-AddressingのActionメッセージ・アドレス指定プロパティの明示的な値です。

デフォルト:

""

output

public abstract String output

操作のoutputメッセージに対応する、WS-AddressingのActionメッセージ・アドレス指定プロパティの明示的な値です。

デフォルト:

""

fault

public abstract FaultAction[] fault

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

デフォルト:

{}