--- old/src/java.xml.ws/share/classes/javax/xml/ws/FaultAction.java 2015-04-21 17:20:18.000098474 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/FaultAction.java 2015-04-21 17:20:17.912098474 +0400
@@ -32,28 +32,28 @@
import java.lang.annotation.Target;
/**
- * The FaultAction
annotation is used inside an {@link Action}
+ * The {@code FaultAction} annotation is used inside an {@link Action}
* annotation to allow an explicit association of a WS-Addressing
- * Action
message addressing property with the fault
+ * {@code Action} message addressing property with the {@code fault}
* messages of the WSDL operation mapped from the exception class.
*
- * The wsam:Action
attribute value in the fault
- * message in the generated WSDL operation mapped for className
- * class is equal to the corresponding value in the FaultAction
.
- * For the exact computation of wsam:Action
values for the
+ * The {@code wsam:Action} attribute value in the {@code fault}
+ * message in the generated WSDL operation mapped for {@code className}
+ * class is equal to the corresponding value in the {@code FaultAction}.
+ * For the exact computation of {@code wsam:Action} values for the
* fault messages, refer to the algorithm in the JAX-WS specification.
*
*
- * Example 1: Specify explicit values for Action
message addressing
- * property for the input
, output
and fault
message
+ * Example 1: Specify explicit values for {@code Action} message addressing
+ * property for the {@code input}, {@code output} and {@code fault} message
* if the Java method throws only one service specific exception.
*
*
- * @WebService(targetNamespace="http://example.com/numbers") - * public class AddNumbersImpl { - * @Action( + * {@literal @}WebService(targetNamespace="http://example.com/numbers") + * public class AddNumbersImpl { + * {@literal @}Action( * fault = { - * @FaultAction(className=AddNumbersException.class, value="http://example.com/faultAction") + * {@literal @}FaultAction(className=AddNumbersException.class, value="http://example.com/faultAction") * }) * public int addNumbers(int number1, int number2) * throws AddNumbersException { @@ -64,86 +64,86 @@ * * The generated WSDL looks like: * - *- * <definitions targetNamespace="http://example.com/numbers" ...> + *{@code + ** ** ... - * <portType name="AddNumbersPortType"> - * <operation name="AddNumbers"> + * } *+ * * ... - * </definitions> + ** ... - * <fault message="tns:AddNumbersException" name="AddNumbersException" - * wsam:Action="http://example.com/faultAction"/> - * </operation> - * </portType> + * + *wsam:Action="http://example.com/faultAction"{@code /> + * - * Example 2: Here is an example that shows if the explicit value for
Action
+ * Example 2: Here is an example that shows if the explicit value for {@code Action} * message addressing property for the service specific exception is not present. * *- * @WebService(targetNamespace="http://example.com/numbers") - * public class AddNumbersImpl { + * {@literal @}WebService(targetNamespace="http://example.com/numbers") + * public class AddNumbersImpl { * public int addNumbers(int number1, int number2) * throws AddNumbersException { * return number1 + number2; * } - * } + * } ** * The generated WSDL looks like: * - *- * <definitions targetNamespace="http://example.com/numbers" ...> + ** *{@code + *+ * + * }* ... - * <portType name="AddNumbersPortType"> - * <operation name="AddNumbers"> + * + * * ... - * </definitions> - ** ... - * <fault message="tns:addNumbersFault" name="InvalidNumbers" - * wsam:Action="http://example.com/numbers/AddNumbersPortType/AddNumbers/Fault/AddNumbersException"/> - * </operation> - * </portType> + * + *wsam:Action="http://example.com/numbers/AddNumbersPortType/AddNumbers/Fault/AddNumbersException"{@code /> + * - * Example 3: Here is an example that shows how to specify explicit values for
Action
+ * Example 3: Here is an example that shows how to specify explicit values for {@code Action} * message addressing property if the Java method throws more than one service specific exception. * *- * @WebService(targetNamespace="http://example.com/numbers") - * public class AddNumbersImpl { - * @Action( + * {@literal @}WebService(targetNamespace="http://example.com/numbers") + * public class AddNumbersImpl { + * {@literal @}Action( * fault = { - * @FaultAction(className=AddNumbersException.class, value="http://example.com/addFaultAction"), - * @FaultAction(className=TooBigNumbersException.class, value="http://example.com/toobigFaultAction") + * {@literal @}FaultAction(className=AddNumbersException.class, value="http://example.com/addFaultAction"), + * {@literal @}FaultAction(className=TooBigNumbersException.class, value="http://example.com/toobigFaultAction") * }) * public int addNumbers(int number1, int number2) * throws AddNumbersException, TooBigNumbersException { * return number1 + number2; * } - * } + * } ** * The generated WSDL looks like: * - *- * <definitions targetNamespace="http://example.com/numbers" ...> + ** * @since 1.6, JAX-WS 2.1 */ @@ -158,7 +158,7 @@ Class extends Exception> className(); /** - * Value of WS-Addressing{@code + *+ * + * }* ... - * <portType name="AddNumbersPortType"> - * <operation name="AddNumbers"> + * + * * ... - * </definitions> - ** ... - * <fault message="tns:addNumbersFault" name="AddNumbersException" - * wsam:Action="http://example.com/addFaultAction"/> - * <fault message="tns:tooBigNumbersFault" name="TooBigNumbersException" - * wsam:Action="http://example.com/toobigFaultAction"/> - * </operation> - * </portType> + * + *wsam:Action="http://example.com/addFaultAction"{@code /> + * wsam:Action="http://example.com/toobigFaultAction"{@code /> + * Action
message addressing property for the exception + * Value of WS-Addressing {@code Action} message addressing property for the exception */ String value() default ""; }