-
@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メッセージのアドレス指定プロパティ
- デフォルト:
- {}
-
-