javax.xml.ws

Annotation Type Action

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

所述Action注释允许一个WS寻址的显式关联Action与消息寻址属性input ， output和fault所映射的WSDL操作的消息。

可以在服务端点接口的每个方法上指定此注释。 对于这样的方法，在生成的WSDL的映射操作wsam:Action在WSDL属性input ， output和fault的WSDL的消息operation是基于哪些属性的的时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：用于指定显式值Action消息寻址属性仅对input消息。 使用JAX-WS规范中的算法计算WSDL output消息的wsam:Action值。

  @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> 

它是合法的，为指定一个明确的价值Action消息处理财产为output唯一的消息。 在这种情况下，使用JAX-WS规范中的算法来计算WSDL input消息的wsam:Action值。

实施例3：参见FaultAction注释有关如何用于指定一个明确的值的示例Action消息寻址属性为fault消息。

从以下版本开始：

JAX-WS 2.1

另请参见：

FaultAction

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
FaultAction[]	fault 所述的显式值的WS-Addressing Action消息寻址属性为 fault的操作的（多个）消息。
String	input 所述的显式值的WS-Addressing Action消息寻址属性为 input的操作的消息。
String	output 所述的显式值的WS-Addressing Action消息寻址属性为 output的操作的消息。

Element Detail

input

public abstract String input

所述的显式值的WS-Addressing Action消息寻址属性为 input的操作的消息。

Default:

“”

output

public abstract String output

所述的显式值的WS-Addressing Action消息寻址属性为 output的操作的消息。

Default:

“”

fault

public abstract FaultAction[] fault

所述的显式值的WS-Addressing Action消息寻址属性为fault的操作的（多个）消息。 映射到故障并需要显式WS-Addressing Action消息寻址属性的每个Action都需要使用FaultAction注释指定为此属性中的值。

Default:

{}