Изучаем Java EE 7 - [221]
• аннотации связывания SOAP — относятся к пакету javax.jws.soap и позволяют настроить связывание SOAP (@SoapBinding и @SOAPMessageHandler).
Как и все другие спецификации Java EE 7, аннотации веб-служб могут быть переопределены в необязательном дескрипторе развертывания XML (webservices.xml). Внимательнее посмотрим на аннотации преобразования WSDL.
@WebService
Аннотация @javax.jws.WebService помечает класс Java или интерфейс как веб-службу. Если аннотация использована непосредственно для класса (как во всех примерах выше), то процессор аннотаций контейнера сгенерирует интерфейс, так что следующие фрагменты кода эквивалентны. Вот пример аннотации для класса:
>@WebService
>public class CardValidator {…}
А следующий фрагмент кода показывает аннотацию на интерфейсе, который реализует класс. Как вы можете видеть, реализация должна определить полное имя интерфейса в атрибуте endpointInterface:
>@WebService
>public interface Validator {…}
>@WebService (endpointInterface = "org.agoncal.book.javaee7.chapter14.Validator")
>public class CardValidator implements Validator {…}
Аннотация @WebService имеет набор атрибутов (листинг 14.8), которые позволяют настроить имя веб-службы в файле WSDL (элементы
>@Retention(RUNTIME) @Target(TYPE)
>public @interface WebService {
>··String name() default "";
>··String targetNamespace() default "";
>··String serviceName() default "";
>··String portName() default "";
>··String wsdlLocation() default "";
>··String endpointInterface() default "";
>}
Поэтому, когда правила преобразования WSDL по умолчанию не подходят для вашей веб-службы SOAP, просто используйте необходимые атрибуты. Приведенный ниже код изменяет порт и имя службы:
>@WebService(portName = "CreditCardValidator",
>············serviceName = "ValidatorService")
>public class CardValidator {…}
Если вы сравните этот код со стандартным WSDL, описанным в листинге 14.1, то увидите следующие изменения:
>
>··
>··
>··
>
Когда вы используете аннотацию @WebService, будут предоставлены все общедоступные методы веб-служб, за исключением случаев, когда применяется аннотация @WebMethod.
@WebMethod
По умолчанию все общедоступные методы веб-служб SOAP попадают в WSDL и используют все правила отображения по умолчанию. Чтобы настроить некоторые элементы этого преобразования, вы можете добавить аннотацию @javax.jws.WebMethod для методов. API этой аннотации достаточно прост: он позволяет переименовать метод или исключить его из WSDL. В листинге 14.9 показано, как в веб-службе CardValidator переименовываются два первых метода и исключается последний.
>@WebService
>public class CardValidator {
>··@WebMethod(operationName = "ValidateCreditCard")
>··public boolean validate(CreditCard creditCard) {
>····// Бизнес-логика
>··}
>··@ WebMethod(operationName = "ValidateCreditCardNumber")
>··public void validate(String creditCardNumber) {
>····// Бизнес-логика
>··}
>··@WebMethod(exclude = true)
>··public void validate(Long creditCardNumber) {
>····// Бизнес-логика
>··}
>}
Как вы можете видеть во фрагменте WSDL, описанном в листинге 14.10, определены только два метода: ValidateCreditCard и ValidateCreditCardNumber. Последний был исключен из WSDL.
>
>··
>
>
>··
>
>
>···
>
>
>··
>
>
>··
>····
>····
>··
>··
>····
>····
>··
>
@WebResult
Аннотация @javax.jws.WebResult управляет сгенерированным именем сообщения, возвратившего значение в WSDL. В листинге 14.11 возвращаемый результат метода validate() переименован в IsValid.
>@WebService
>public class CardValidator {
>··@WebResult(name = "IsValid")
>··public boolean validate(CreditCard creditCard) {
>····// Бизнес-логика
>··}
>}
По умолчанию имя возвращаемого значения в WSDL — return. Но с помощью аннотации @WebResult вы можете быть конкретнее и иметь более выразительный контракт:
>
>
