Энтони Гонсалвес - Изучаем Java EE 7

····ClientBuilder.newClient(). target("http://www.myserver.com/book") 

·····························.request(). get();

String body = response.readEntity(String.class);

Но в методе GET предусмотрен сокращенный вариант записи, позволяющий указать желаемый тип и получить объект всего в одной строке кода (без использования объекта Response в качестве посредника):

String body =

····ClientBuilder.newClient(). target("http://www.myserver.com/book") 

·····························.request(). get(String.class);

Структура потребителя REST

В отличие от JAX-WS, встроенного в Java SE и обеспечивающего вызов готовых веб-служб SOAP при наличии одного лишь JDK, при работе с JAX-RS необходимо указывать в пути к классу клиентский API. Но это единственное ограничение. В отличие от применения SOAP здесь вам не придется генерировать никаких артефактов. Поэтому потребители веб-служб в стиле REST могут происходить откуда угодно — как из любого класса Java, работающего на виртуальной машине JVM (основной класс, интеграционный тест, пакетная обработка), так и из любого компонента Java EE, работающего в контейнере (сервлет, EJB, управляемый компонент).

Разумеется, одна из сильных сторон веб-служб в стиле REST — их интероперабельность. Так, если вы разместите в Интернете набор ресурсов, то сможете обращаться к ним и с мобильных устройств (смартфоны, планшеты), и с помощью других веб-технологий (скажем, JavaScript).

Все вместе

Объединим все концепции, разобранные выше в этой главе, напишем веб-службу в стиле REST для работы с информацией о книгах, упакуем ее и развернем в GlassFish. Затем протестируем, воспользовавшись для этого cURL и интеграционным тестом (применим новый клиентский API). Наша цель — получить JAXB-компонент Books, представляющий собой список JPA-сущностей Book, отображаемых на базу данных. Служба BookRestService обеспечивает выполнение CRUD-операций над информацией о книге. Несмотря на то что это веб-служба с передачей состояния представления, она также является сеансовым компонентом и допускает разграничение транзакций (с применением менеджера сущностей). Выполнив развертывание, вы сможете создавать, получать или удалять записи о книгах, пользуясь HTTP-методами с помощью cURL и клиентского API JAX-RS. Благодаря JAXB и расширению Jersey вы сможете получить по два варианта представления этих книг — в XML и в JSON.

В данном примере структура каталогов строится по принципу, принятому в Maven. Все классы упаковываются в архив WAR (chapter15-service-1.0.war). Классы, показанные на рис. 15.4, должны находиться в следующих каталогах и файлах:

• src/main/java — каталог для Books, сущности Book и BookRestService, а также для классов, используемых для конфигурирования среды времени исполнения (подробнее о ApplicationConfig мы поговорим ниже);

• src/main/resources — включает файл persistence.xml, используемый ресурсом, отображающим объект Book на базу данных Derby;

• src/test/java — каталог для интеграционного теста BookRestServiceIT;

• pom.xml — объектная модель проекта Maven (POM), описывающая проект и его зависимости.

Рис. 15.4. Все вместе

Написание сущности Book

Теперь вы уже понимаете код сущности Book, но остается отметить еще один важный момент: данная сущность также сопровождается аннотацией JAXB @XmlRootElement (листинг 15.20). Благодаря этому сущность может иметь XML-представление книги.

Листинг 15.20. Сущность Book с аннотацией JAXB

@Entity

@XmlRootElement

@NamedQuery(name = Book.FIND_ALL, query = "SELECT b FROM Book b")

public class Book {

··public static final String FIND_ALL = "Book.findAll";

··@Id

··@GeneratedValue

··private String id;

··@Column(nullable = false)

··private String title;

··private Float price;

··@Column(length = 2000)

··private String description;

··private String isbn;

··private Integer nbOfPage;

··private Boolean illustrations;

··// Конструкторы, геттеры, сеттеры

}

Эта сущность также может быть упакована с файлом persistence.xml (здесь он опущен ради упрощения примера).

Написание JAXB-компонента Books

Один из методов, которым обладает веб-служба в стиле REST, получает все книги из базы данных. Этот метод мог бы вернуть List<Book>, но в таком случае не --">