javax.xml.ws

Тип аннотации FaultAction

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

FaultAction аннотация используется в Action аннотация, чтобы разрешить явную ассоциацию Адресации WS Action свойство адресации сообщения с fault сообщения работы WSDL, отображенной от исключения class.

wsam:Action значение атрибута в fault сообщение в сгенерированной работе WSDL, отображенной для className class равен соответствующему значению в FaultAction. Для точного вычисления wsam:Action значения для сообщений отказа, обратитесь к алгоритму в спецификации JAX-WS.

Пример 1: Определите явные значения для Action свойство адресации сообщения для input, output и fault обменивайтесь сообщениями, если метод Java бросает только одну службу определенное исключение.

 @WebService(targetNamespace="http://example.com/numbers")
 public class AddNumbersImpl {
     @Action(
         fault = {
             @FaultAction(className=AddNumbersException.class, value="http://example.com/faultAction")
         })
     public int addNumbers(int number1, int number2)
         throws AddNumbersException {
         return number1 + number2;
     }
 }
 

Сгенерированный WSDL похож:

   <definitions targetNamespace="http://example.com/numbers" ...>
     ...
     <portType name="AddNumbersPortType">
       <operation name="AddNumbers">
         ...
         <fault message="tns:AddNumbersException" name="AddNumbersException"
           wsam:Action="http://example.com/faultAction"/>
       </operation>
     </portType>
     ...
   </definitions>
 

Пример 2: Вот пример, который показывает если явное значение для Action свойство адресации сообщения для службы определенное исключение не присутствует.

 @WebService(targetNamespace="http://example.com/numbers")
 public class AddNumbersImpl {
     public int addNumbers(int number1, int number2)
         throws AddNumbersException {
         return number1 + number2;
     }
 }
 

Сгенерированный WSDL похож:

   <definitions targetNamespace="http://example.com/numbers" ...>
     ...
     <portType name="AddNumbersPortType">
       <operation name="AddNumbers">
         ...
         <fault message="tns:addNumbersFault" name="InvalidNumbers"
           wsam:Action="http://example.com/numbers/AddNumbersPortType/AddNumbers/Fault/AddNumbersException"/>
       </operation>
     </portType>
     ...
   </definitions>
 

Пример 3: Вот пример, который показывает, как определить явные значения для Action свойство адресации сообщения, если метод Java бросает больше чем одну службу определенное исключение.

 @WebService(targetNamespace="http://example.com/numbers")
 public class AddNumbersImpl {
     @Action(
         fault = {
             @FaultAction(className=AddNumbersException.class, value="http://example.com/addFaultAction"),
             @FaultAction(className=TooBigNumbersException.class, value="http://example.com/toobigFaultAction")
         })
     public int addNumbers(int number1, int number2)
         throws AddNumbersException, TooBigNumbersException {
         return number1 + number2;
     }
 }
 

Сгенерированный WSDL похож:

   <definitions targetNamespace="http://example.com/numbers" ...>
     ...
     <portType name="AddNumbersPortType">
       <operation name="AddNumbers">
         ...
         <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>
     ...
   </definitions>
 

С тех пор:

JAX-WS 2.1

Необходимая Сводка Элемента

Необходимые Элементы

Модификатор и Тип	Необходимый Элемент и Описание
Class<? extends Exception>	имя класса Имя исключения class

Дополнительная Сводка Элемента

Дополнительные Элементы

Модификатор и Тип	Дополнительный Элемент и Описание
Строка	значение Значение Адресации WS Action свойство адресации сообщения для исключения

Деталь элемента

имя класса

public abstract Class<? extends Exception> className

Имя исключения class

значение

public abstract String value

Значение Адресации WS Action свойство адресации сообщения для исключения

Значение по умолчанию:

""