--- 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" + * + * } *+ * * ... - * </definitions> + *+ * wsam:Action="http://example.com/inputAction"/> - * <output message="tns:AddNumbersOutput" name="bar" + * + *- * Example 2: Specify explicit value for
Action
message addressing property - * for only theinput
message. Thewsam:Action
values for the - * WSDLoutput
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" ...> + ** - * It is legitimate to specify an explicit value for{@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" + * + * * ... - * </definitions> - *+ * wsam:Action="http://example.com/inputAction"/> + * + *Action
message addressing property for - *output
message only. In this case,wsam:Action
value for the - * WSDLinput
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-AddressingAction
message addressing property for theinput
+ * 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-AddressingAction
message addressing property for theoutput
+ * 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-AddressingAction
message addressing property for thefault
+ * 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 { };