Изучаем Java EE 7 - [224]
>
>···············xmlns: cc="http://chapter14.javaee7.book.agoncal.org/">
>··
>··
>····
>······
>···················control_number="544" type="Visa"/>
>····
>··
>
В листинге 14.20 показан ответ SOAP, который отправляется обратно потребителю. Он указывает, что кредитная карта, переданная в запросе, действительна (
>
>···············xmlns: cc="http://chapter14.javaee7.book.agoncal.org/">
>··
>····
>······
>····
>··
>
Обработка исключений
До этого момента все работало хорошо: обмен данными между потребителем и поставщиком был корректным, веб-служба не пропадала, а сеть работала надежно. Но так бывает не всегда. В Java, когда что-то идет не так, генерируется исключение и некоторые классы внутри JVM должны разобраться с ним. Для веб-служб SOAP этот механизм не работает, поскольку потребитель и служба могут быть написаны на разных языках и находиться в разных сетях. Таким образом, возникла идея использовать SOAP Fault в сообщении SOAP. Среда выполнения JAX-WS автоматически преобразует исключения Java в сообщения SOAP Fault, которые возвращаются клиенту. Эта функция позволяет сэкономить много времени и энергии, которые вы затратите на написание кода, преобразующего ваши исключения в сообщения SOAP Fault.
Если вы посмотрите на метод validate веб-службы CardValidator, определенный в листинге 14.5, то заметите, что, когда параметр CreditCard пуст, проверка прекращается и генерируется исключение NullPointerException. В этом случае среда выполнения JAX-WS ловит исключение NullPointerException на сервере, создает сообщение SOAP Fault (листинг 14.21) и отправляет его обратно потребителю.
>
>··
>····
>······
>······
>····
>··
>
Как вы можете видеть в листинге 14.21, среда выполнения JAX-WS автоматически устанавливает значение параметра faultstring, соответствующее имени исключения в Java. Спецификация также предоставляет механизм различения типов неисправностей с использованием элемента faultCode. В этом случае он имеет значение soap: Server, указывая, что за неисправности отвечает сервер (другой вариант — soap: Client).
Еще один способ возвращения SOAP Fault — генерация исключения приложения (листинг 14.22). Здесь веб-служба генерирует проверенное исключение (но тот же самый механизм относится и к непроверенным исключениям), если кредитная карта имеет нечетный номер. Это исключение приложения будет автоматически преобразовано в соответствующее сообщение soap: Fault, обернуто в тело SOAP и возвращено клиенту.
>@WebService
>public class CardValidator throws CardValidatorException {
>public boolean validate(CreditCard creditCard) {
>···Character lastDigit = creditCard.getNumber(). charAt(
>·························creditCard.getNumber(). length() — 1);
>····if (Integer.parseInt(lastDigit.toString()) % 2 == 0) {
>······return true;
>····}··else {
>······throw new CardValidatorException("Неверный номер кредитной карты");
>····}
>··}
>}
Исключение приложения может наследовать от типов Exception, RuntimeException или исключений веб-служб SOAP, таких как javax.xml.ws.WebServiceException или один из его подклассов (например, javax.xml.ws.soap.SOAPFaultException). Эти исключения также могут поддерживать аннотацию @WebFault, чтобы создать более подробный конверт SOAP (листинг 14.23).
>@WebFault(name = "CardValidationFault")
>public class CardValidatorException extends Exception {
>··public CardValidatorRTException() {
>····super();
>··}
>··public CardValidatorRTException(String message) {
>····super(message);
>··}
>}
Когда веб-служба SOAP генерирует исключение, определенное в листинге 14.23, среда выполнения JAX-WS генерирует сообщение об ошибке SOAP, определенное в листинге 14.24.
>
>··
>····
>······
>······
>······
>········
>·········xmlns: ns2="http://chapter14.javaee7.book.agoncal.org/">
>··········
>········
>······
