-
@Documented @Retention(RUNTIME) @Target(METHOD) public @interface Action
Action
注釈を使用すると、WS-AddressingのAction
メッセージ・アドレス指定プロパティを、マッピングされたWSDL操作のinput
、output
、およびfault
メッセージに明示的に関連付けることができます。この注釈は、サービス端点インタフェースの各メソッドで指定できます。 このようなメソッドでは、WSDL
operation
のWSDLinput
、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" <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
メッセージ・アドレス指定プロパティの明示的な値を指定します。 WSDLoutput
メッセージの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
メッセージ指定プロパティの明示的な値を指定してもかまいません。 このような場合、WSDLinput
メッセージのwsam:Action
値は、JAX-WS仕様のアルゴリズムを使用して計算されます。例3:
fault
メッセージに対応するAction
メッセージ指定プロパティの明示的な値を指定する方法の例については、FaultAction
注釈を参照してください。- 導入されたバージョン:
- 1.6, JAX-WS 2.1
- 関連項目:
FaultAction
-
-
要素の詳細
-
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-AddressingAction
メッセージ・アドレス指定プロパティを必要とする例外は、それぞれFaultAction
注釈を使用してこのプロパティの値として指定される必要があります。- 戻り値:
Action
メッセージのfault
メッセージのアドレス指定プロパティ
- デフォルト:
- {}
-
-