Изучаем Java EE 7 - [225]
>····
>··
>
Но если вы хотите создать более точное сообщение об ошибке SOAP с другим значением faultCode и т. д., то можете использовать API javax.xml.soap.SOAPFactory для создания объекта типа javax.xml.soap.SOAPFault (это показано в листинге 14.25).
>@WebService
>public class CardValidator {
>··public boolean validate(CreditCard creditCard) {
>····Character lastDigit = creditCard.getNumber(). charAt(
>··························creditCard.getNumber(). length() — 1);
>····if (Integer.parseInt(lastDigit.toString()) % 2 == 0) {
>······return true;
>····}··else {
>······SOAPFactory soapFactory = SOAPFactory.newInstance();
>······SOAPFault fault = soapFactory.createFault("Неверный номер
>············кредитной карты", new QName("ValidationFault"));
>······throw new CardValidatorException(fault);
>····}
>··}
>}
В листинге 14.25 создается объект типа SOAPFault с текстом Номер кредитной карты недействителен и кодом ошибки (ValidationFault), формирующим конверт SOAP (листинг 14.26).
>
>··
>····
>······
>······
>····
>··
>
Жизненный цикл и функции обратного вызова
Как вы можете видеть на рис. 14.4, веб-службы SOAP также имеют жизненный цикл, который напоминает управляемые компоненты. Такой жизненный цикл присущ компонентам, не хранящим состояния: либо они не существуют, либо готовы обрабатывать запрос. Этим жизненным циклом управляет контейнер.
Рис. 14.4. Жизненный цикл веб-службы SOAP
Конечные точки-сервлеты и EJB поддерживают внедрение зависимостей (потому что работают в контейнере) и методы жизненного цикла, такие как @PostConstruct и @PreDestroy. Контейнер вызывает метод обратного вызова @PostConstruct, если таковой существует, когда создает экземпляр веб-службы, и вызывает метод обратного вызова @PreDestroy при его разрушении. Одно из различий между типами конечных точек заключается в том, что могут использовать перехватчики (описанные в главе 2).
WebServiceContext
Веб-службы SOAP имеют контекст среды и могут получить доступ к нему при добавлении ссылки на javax.xml.ws.WebServiceContext с аннотацией @Resource. Внутри этого контекста веб-служба во время выполнения может получить информацию, такую как класс конечной реализации, контекст сообщения и информацию о безопасности относительно обслуживаемого запроса.
Спецификации JAX-WS и WS-Metadata не были обновлены в Java EE 7, поэтому, даже если ваше приложение использует CDI, вы не можете задавать аннотацию @Inject, чтобы внедрить WebServiceContext: вам все равно придется обратиться к аннотации @Resource.
Код в листинге 14.27 использует WebServiceContext, чтобы узнать, имеет ли вызывающая сторона роль Admin для проверки кредитной карты. В табл. 14.6 перечислены методы, определенные в интерфейсе javax.xml.ws.WebServiceContext.
>@WebService
>public class CardValidator {
>··@Resource
>··private WebServiceContext context;
>··public boolean validate(CreditCard creditCard) {
>····if (!context.isUserInRole("Admin"))
>······throw new SecurityException("Только администратор может проверить карту");
>····// Бизнес-логика
>····}
>··}
| Метод | Описание |
|---|---|
| getMessageContext | Возвращает MessageContext для запроса, обслуживаемого в момент вызова метода. Может быть использован для доступа к частям сообщения SOAP: к заголовку, телу и т. д. |
| getUserPrincipal | Возвращает Principal, идентифицирующий отправителя запроса, который обслуживается в данный момент |
| isUserInRole | Возвращает двоичное значение, указывающее, является ли аутентифицированный пользователь представителем определенной логической роли |
| getEndpointReference | Возвращает EndpointReference, связанный с заданной конечной точкой |
Дескриптор развертывания
Как и большинство технологий Java EE 7, веб-службы SOAP позволяют определить метаданные с использованием аннотаций (то, что мы делали во всех примерах), а также с помощью XML. Расположенный в каталоге WEB-INF файл webservices.xml замещает или дополняет аннотации. Как и большинство дескрипторов развертывания в Java EE 7, файл webservices.xml обязателен, поскольку аннотации могут быть использованы для указания большей части данных, заданных в этом дескрипторе развертывания. Например, в листинге 14.28 показано, как можно переопределить порт WSDL (OverriddenPort) для веб-службы CardValidator.
>
>·············xmlns: xsi="http://www.w3.org/2001/XMLSchema-instance"
>·············xsi: schemaLocation="http://java.sun.com/xml/ns/javaee
>·············http://java.sun.com/xml/ns/javaee/javaee_web_services_1_3.xsd"
>·············version="1.3">
>··
>····
