Изучаем Java EE 7 - [222]
>
>
Эта аннотация также включает и другие элементы, предназначенные для настройки WSDL, такие как пространство имен XML для возвращенного значения, и выглядит как аннотация @WebParam, показанная в листинге 14.12.
>@Retention(RUNTIME) @Target(PARAMETER)
>public @interface WebParam {
>··String name() default "";
>··public enum Mode {IN, OUT, INOUT};
>··String targetNamespace() default "";
>··boolean header() default false;
>··String partName() default "";
>};
@WebParam
Аннотация @javax.jws.WebParam, показанная в листинге 14.12, похожа на аннотацию @WebResult, поскольку она настраивает параметры для методов веб-службы. Ее API позволяет изменить имя параметра в WSDL (листинг 14.13), пространство имен и тип. Допустимые типы: IN, OUT или INOUT (оба), которые определяют, является параметр входящим или возвращаемым (по умолчанию IN).
>@WebService
>public class CardValidator {
>··public boolean validate(@WebParam(name= "Credit-Card", mode = IN)
>··························CreditCard creditCard) {
>····// Бизнес-логика
>··}
>}
Опять же если вы сравните это со стандартным XSD, определенным в листинге 14.2, то заметите, что по умолчанию имя этого параметра — arg0. Аннотация @WebParam переопределяет это значение по умолчанию именем Credit-Card:
>
>
>
>
@OneWay
Аннотация @OneWay может быть использована для методов, которые не имеют возвращаемого значения, например возвращающих значение типа void. Эта аннотация не содержит элементов и может рассматриваться как интерфейс разметки, который информирует контейнер, что вызов может быть оптимизирован, поскольку нет возвращения (можно, например, использовать асинхронный вызов).
@SoapBinding
Связывание описывает, как веб-служба связана с протоколом обмена сообщениями, в частности с протоколом SOAP. Существует два стиля программирования для связывания SOAP, определенного в WSDL 1.1: RPC и документ (он же обмен сообщениями). От этого выбора зависит то, как будет структурировано тело содержимого SOAP.
• Документ — сообщение SOAP включает в себя документ. Оно посылается в виде одного документа в элементе
• RPC — сообщение SOAP содержит параметры и возвращаемые значения.
При связывании SOAP (независимо от того, какой стиль задан) следует выбрать один из двух различных форматов сериализации/десериализации.
• Буквальный — данные сериализуются в соответствии с XML-схемой.
• Закодированный — кодирование SOAP определяет, как должны быть сериализованы объекты, структуры, массивы и деревья объектов.
Это позволяет вам выбрать один из четырех вариантов пар «стиль/использование»:
• документ/буквальная сериализация (по умолчанию);
• документ/закодированная сериализация (не совместима с WS-*);
• RPC/буквальная сериализация;
• RPC/закодированная сериализация.
По умолчанию сгенерированная WSDL, которую вы видели ранее, использует первую модель (документ/буквальная сериализация). Применение аннотации @SoapBinding для класса, как показано в листинге 14.14, может изменить это.
>@WebService
>@SOAPBinding(style = RPC, use = LITERAL)
>public class CardValidator {
>··public boolean validate(CreditCard creditCard) {
>····// Бизнес-логика
>··}
>}
В листинге 14.14 переопределяется стандартное связывание, вместо документа используется стиль RPC. Это оказывает влияние на WSDL и XML-схему, которая генерируется для поставщика веб-служб SOAP и потребителя. В листинге 14.15 продемонстрированы эти различия.
>
>
>··
>
>
>··
>
>…
>
>··
>
>
>··
>
>
>··
>
>…
>
Собираем все преобразования воедино
Чтобы иметь более полное понимание того, какое влияние оказывают эти аннотации на веб-службы SOAP, соберем их вместе и посмотрим на различные артефакты. Я буду использовать простую веб-службу CardValidator, определенную в листинге 14.5, и добавлю большую часть рассмотренных аннотаций для преобразования (листинг 14.16).
