em.find(Letter.class, new Integer(id)); if(letter == null)

return; em.remove(letter);

}

// Модифицировать объект в базе данных public void modLetter(Letter letter) {

if(letter == null) return;

Integer Id = letter.getId();

Letter l = em.find(Letter.class, Id);

if(l == null)

return;

//System.out.println("Letters: модифицирую №" + Id); l.setDate(letter.getDate()); l.setName(letter.getName()); l.setText(letter.getText());

}

}

Как видим, в класс Lets7 и его интерфейс RemoteLets не внесено никаких существенных изменений, кроме смены имен и названия пакета.

Таким образом, завершена полная подготовка EJB-приложения Lets7 для его преобразования в Web-сервис.

5.2.2 Аннотации поставщика Web-сервиса

Каждая Web-служба (Web-сервис) имеет определенную структуру.

Имеется набор общих требований, которым должна соответствовать каждая Web-служба [17]:

1)класс должен иметь аннотацию @javax.jws.WebService или XML-пред- ставление, описанное в дескрипторе развертывания webservices.xml;

2)класс может реализовать нуль или более интерфейсов, которые должны иметь аннотацию @WebService;

3)класс должен быть определен как public и не должен иметь спецификаторы final или abstract;

4)класс должен иметь public-конструктор по умолчанию;

5)класс не должен определять метод finalize();

6)для того чтобы преобразовать Web-службу SOAP в компонент-конечную точку, класс должен иметь аннотацию @javax.ejb.Stateless или

@javax.ejb.Singleton;

214

7)служба должна быть объектом, не сохраняющим состояние, и не должна сохранять характерное для клиента состояние во время вызовов методов.

Для того, чтобы превратить наше EJB-приложение в Web-службу SOAP, необходимо классу Lets7 добавить аннотацию @WebService.

Главной аннотацией Web-службы является @WebService, общее описание которой представлено на листинге 5.6.

Листинг 5.6 — Определение аннотации @WebService

@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 "";

}

Я не буду подробно описывать назначение каждого атрибута аннотации @WebService. Для этого необходимо очень хорошо знать язык WSDL. Отмечу лишь два момента:

1)аннотацию можно использовать без переопределения атрибутов, тогда система будет использовать значения по умолчанию;

2)атрибут serviceName позволяет изменить имя Web-сервиса, если это — необходимо.

По умочанию, когда аннотация @WebService используется без параметров, имя сервиса для пользователя будет складываться из имени класса Lets7 и слова Service.

Добавив аннотацию к классу Lets7, как показано на листинге 5.7, мы получим Web-сервис.

Листинг 5.7 — Преобразование EJB-компоненты Lets7.java в Web-сервис

@WebService

@Stateless

@LocalBean

public class Lets7 implements RemoteLets

{

@PersistenceContext(name = "lab4-unit2") private EntityManager em;

// Методы Web-сервиса ...

215

}

Чтобы наш Web-сервис стал доступным в сети, необходимо выполнить следующие действия:

а) запустить СУБД Apache Derby;

б) указать в дескрипторе web.xml класс Lets7 как сервлет (см. листинг 5.8); в) запустить сервер Apache TomEE.

Листинг 5.8 — Дескриптор развертывания проекта lab7 — файл web.xml

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" id="WebApp_ID" version="4.0">

<display-name>lab7</display-name>

<!-- Указание класса сервлета --> <servlet>

<servlet-name>lab7ws</servlet-name> <servlet-class>rsos.lab7.Lets7</servlet-class>

</servlet>

<!-- Указание каталога доступа к сервлету --> <servlet-mapping>

<servlet-name>lab7ws</servlet-name> <url-pattern>/*</url-pattern>

</servlet-mapping>

</web-app>

После того как сервер стартовал, следует проверить доступность Webсервиса. Для этого нужно запустить браузер и выполнить запрос к серверу по адресу: http://localhost:8080/lab7/Lets7?wsdl.

В результате такого запроса, сервер ответит достаточно длинным и непонятным для непосвященных описанием сервиса на языке WSDL, как это показано на рисунке 5.3. По этой причине не рекомендуется делать дополнительные настройки сервиса, пока не изучен язык описания сервисов.

При использовании только аннотации @WebService, сервер сделает доступными все методы класса Lets7, имеющими модификатор доступа public.

С помощью атрибута operationName аннотации @WebMetod можно изменять отображаемое имя метода, а использование логического атрибута exclude делает метод отображаемым или нет. По умолчанию excluse = false, что делает метод видимым.

216

Рисунок 5.3 — Начало описания WSDL для Web-сервиса Lets7Service

Имеются и другие полезные аннотации, например, @OneWay следует использовать, если метод не возвращает значение. Тогда обращение выполняется асинхронно, что оптимизирует работу самого метода.

5.2.3 Обработка исключений поставщика Web-сервиса

Ошибки всегда имеются не только в программном обесечении поставщиков сервиса, но и в запросах клиентов сервисов.

В любом программном обеспечении всегда должен быть и имеется инструментарий для работы над ошибками. Такой инструментарий имеется и у поставщиков сервисов.

Естественно, что базовая проверка на ошибки осуществляется контейнерами сервлетов и EJB-компонент. Например, если в результате запроса клиета происходит обращение к несуществующему объекту, то на сервере будет генерироваться исключение NullPointerException. В следствие этого, контейнер отправит клиенту специальный тип сообщения — SOAP Fault.

217

Поставщик сервиса может создать свои собственные исключения, которые он может использовать, чтобы более точно характеризовать ошибки клиента сервиса. Для этого необходимо использовать аннотацию @WebFault. Покажем использование таких исключений на примере класса Lets7. Для этого, создадим и аннотируем класс Lets7Exception, как показано на листинге 5.9.

Листинг 5.9 — Исходный текст класса Lets7Exception.java проекта lab7

package rsos.lab7;

import javax.xml.ws.WebFault;

@WebFault

public class Lets7Exception extends Exception

{

private static final long serialVersionUID = 1L;

// Пустой конструктор public Lets7Exception ()

{

super();

}

// Конструктор с сообщением

public Lets7Exception (String message)

{

super(message);

}

}

Обратите внимание, что второй конструктор этого класса имеет аргумент типа String, с помощью которого поставщик сервиса может формированть специальные индивидуальные сообщения в ответах типа Fault.

Допустим поставщик сервиса решил проверять в классе Lets7 аргумент метода метода getLetter(int id) и формировать ответ Fault, когда этот рагумент равен или меньше нуля. Тогда реализация этого метода может, например, быть такой, как показано на листинге 5.10.

Листинг 5.10 — Реализация метода getLetter(...) класса Lets7.java

// Получение объекта по ключу

public Letter getLetter(int id) throws Lets7Exception

{

// Проверка аргумента с генерацией исключения if(id <= 0)

throw new Lets7Exception(

"Идентификатор объекта Letter не может быть <=0");

Letter l =

em.find(Letter.class, new Integer(id));

return l;

}

218