Module  java.xml.ws
软件包  javax.xml.ws

Annotation Type Action


  • @Documented
@Retention(RUNTIME)
@Target(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" <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：用于指定显式值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" <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>
    它是合法的，为指定一个明确的价值Action消息处理财产为output唯一的消息。 在这种情况下，使用JAX-WS规范中的算法来计算WSDL input消息的wsam:Action值。

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

    从以下版本开始：
    1.6，JAX-WS 2.1
    另请参见：
    FaultAction

    • Optional Element Summary

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

    • Element Detail

      • input

        String input
        操作的 input消息的WS-Addressing Action消息寻址属性的显式值。
        结果
        Action消息寻址属性为 input消息
        Default:
        “”

      • output

        String output
        操作的 output消息的WS-Addressing Action消息寻址属性的显式值。
        结果
        Action消息寻址属性为 output消息
        Default:
        “”

      • fault

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