--- old/src/java.xml.ws/share/classes/javax/xml/ws/Action.java 2015-04-21 17:20:16.932098475 +0400 +++ new/src/java.xml.ws/share/classes/javax/xml/ws/Action.java 2015-04-21 17:20:16.840098475 +0400 @@ -32,89 +32,90 @@ import java.lang.annotation.Target; /** - * The Action annotation allows explicit association of a - * WS-Addressing Action message addressing property with - * input, output, and - * fault messages of the mapped WSDL operation. + * The {@code Action} annotation allows explicit association of a + * WS-Addressing {@code Action} message addressing property with + * {@code input}, {@code output}, and + * {@code fault} messages of the mapped WSDL operation. *

* This annotation can be specified on each method of a service endpoint interface. * For such a method, the mapped operation in the generated WSDL's - * wsam:Action attribute on the WSDL input, - * output and fault messages of the WSDL operation - * is based upon which attributes of the Action annotation have been specified. - * For the exact computation of wsam:Action values for the messages, refer + * {@code wsam:Action} attribute on the WSDL {@code input}, + * {@code output} and {@code fault} messages of the WSDL {@code operation} + * is based upon which attributes of the {@code Action} annotation have been specified. + * For the exact computation of {@code wsam:Action} values for the messages, refer * to the algorithm in the JAX-WS specification. *

- * Example 1: Specify explicit values for Action message addressing property - * for input and output messages. + * Example 1: Specify explicit values for {@code Action} message addressing property + * for {@code input} and {@code output} messages. * *

- * @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;
- *     }
- * }
+ * {@literal @}WebService(targetNamespace="http://example.com/numbers")
+ *  public class AddNumbersImpl {
+ *     {@literal @}Action(
+ *          input="http://example.com/inputAction",
+ *          output="http://example.com/outputAction")
+ *      public int addNumbers(int number1, int number2) {
+ *          return number1 + number2;
+ *      }
+ *  }
  * 
* * The generated WSDL looks like: - *
- *   <definitions targetNamespace="http://example.com/numbers" ...>
+ * 
 {@code
+ *   
  *     ...
- *     <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>
+ *   
+ * }
  * 
* *

- * Example 2: Specify explicit value for Action message addressing property - * for only the input message. The wsam:Action values for the - * WSDL output message are computed using the algorithm in the JAX-WS specification. + * Example 2: Specify explicit value for {@code Action} message addressing property + * for only the {@code input} message. The {@code wsam:Action} values for the + * WSDL {@code output} message are computed using the algorithm in the JAX-WS specification. * *

- * @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;
- *     }
- * }
+ * {@literal @}WebService(targetNamespace="http://example.com/numbers")
+ *  public class AddNumbersImpl {
+ *     {@literal @}Action(input="http://example.com/inputAction")
+ *      public int addNumbers(int number1, int number2) {
+ *          return number1 + number2;
+ *      }
+ *  }
  * 
* * The generated WSDL looks like: - *
- *   <definitions targetNamespace="http://example.com/numbers" ...>
+ * 
 {@code
+ *   
  *     ...
- *     <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/inputAction"/>
+ *         wsam:Action="http://example.com/numbers/AddNumbersPortType/AddNumbersResponse"/>
- *       </operation>
- *     </portType>
+ *       
+ *     
  *     ...
- *   </definitions>
- * 
+ * + * }
* - * It is legitimate to specify an explicit value for Action message addressing property for - * output message only. In this case, wsam:Action value for the - * WSDL input message is computed using the algorithm in the JAX-WS specification. + * It is legitimate to specify an explicit value for {@code Action} message addressing property for + * {@code output} message only. In this case, {@code wsam:Action} value for the + * WSDL {@code input} message is computed using the algorithm in the JAX-WS specification. * *

* Example 3: See {@link FaultAction} annotation for an example of - * how to specify an explicit value for Action message addressing property for the - * fault message. + * how to specify an explicit value for {@code Action} message addressing property for the + * {@code fault} message. * * @see FaultAction * @@ -126,21 +127,21 @@ @Target(ElementType.METHOD) public @interface Action { /** - * Explicit value of the WS-Addressing Action message addressing property for the input + * Explicit value of the WS-Addressing {@code Action} message addressing property for the {@code input} * message of the operation. */ String input() default ""; /** - * Explicit value of the WS-Addressing Action message addressing property for the output + * Explicit value of the WS-Addressing {@code Action} message addressing property for the {@code output} * message of the operation. */ String output() default ""; /** - * Explicit value of the WS-Addressing Action message addressing property for the fault + * Explicit value of the WS-Addressing {@code Action} message addressing property for the {@code fault} * message(s) of the operation. Each exception that is mapped to a fault and requires an explicit WS-Addressing - * Action message addressing property, needs to be specified as a value in this property + * {@code Action} message addressing property, needs to be specified as a value in this property * using {@link FaultAction} annotation. */ FaultAction[] fault() default { };