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

new Customer("Джон", "Смит", "jsmith@gmail.com", 

························"12 34565"). toString();

··}

··@GET

··@Path("maxbonus")

··public Long getMaximumBonusAllowed() {

····return 1234L;

··}

··@GET

··@Produces(MediaType.APPLICATION_XML)

··public Customer getAsXML() {

····return new Customer("Джон", "Смит", "jsmith@gmail.com", "12 34565");

··}

··@GET

··@Produces(MediaType.APPLICATION_JSON)

··public Response getAsJson() {

····return Response.ok(new Customer("Джон", "Смит", "jsmith@gmail.com", 

··························"12 34565"), MediaType.APPLICATION_JSON). build();

··}

}

Метод getAsPlainText возвращает строковое представление потребителя, а метод getMaximumBonusAllowed — числовую константу. Будут применяться настройки, заданные по умолчанию, поэтому код состояния для обоих методов при возврате будет равен 200 — Хорошо, если не произойдет исключения. Метод getAsXML возвращает объект Customer JAXB POJO. Это означает, что среда времени исполнения выполнит маршалинг объекта в XML-представление.

Метод getAsJson возвращает не HTML-объект, а объект javax.ws.rs.core.Response. Response оборачивает HTML-объект, возвращаемый потребителю, и инстанцируется с помощью класса ResponseBuilder, используемого в качестве фабрики. В данном примере мы по-прежнему хотим вернуть JAXB-объект (Customer) с кодом состояния 200 — Хорошо (метод ok()), но также собираемся указать JSON в качестве MIME-типа. При вызове метода ResponseBuilder.build() создается конечный экземпляр Response.

Рекомендуется возвращать пользовательский Response для всех запросов, а не для самого HTML-объекта (при необходимости вы можете затем задать нужный код состояния). В табл. 15.6 показано подмножество Response API.

Таблица 15.6. Response API

Метод Описание accepted() Создает новый объект ResponseBuilder с состоянием 202 — Принято created() Создает новый объект ResponseBuilder для созданного ресурса (с его URI) noContent() Создает новый объект ResponseBuilder для пустого ответа notModified() Создает новый объект ResponseBuilder с состоянием 304 — Не изменялось Метод Описание ok() Создает новый объект ResponseBuilder с состоянием 200 — Хорошо serverError() Создает новый объект ResponseBuilder с состоянием 500 — Серверная ошибка status() Создает новый объект ResponseBuilder с предоставленным состоянием temporaryRedirect() Создает новый объект ResponseBuilder с временным перенаправлением getCookies() Получает cookie из сообщения ответа getHeaders() Получает заголовки из сообщения ответа getLinks() Получает ссылки, прикрепленные к сообщению в заголовке getStatus() Получает код состояния, ассоциированный с ответом readEntity() Получает объект сообщения как экземпляр указанного типа Java. При этом используется интерфейс MessageBodyReader, поддерживающий отображение сообщения на запрошенный тип
Response и ResponseBuilder следуют шаблону проектирования «текучий интерфейс». Это означает, что вы вполне можете написать ответ, воспользовавшись конкатенацией методов. В таком случае код также становится более удобочитаемым. Вот примеры кода, который мы можем написать с помощью этого API:

Response.ok(). build();

Response.ok(). cookie(new NewCookie("SessionID", "5G79GDIFY09")). build();

Response.ok("Plain Text"). expires(new Date()). build();

Response.ok(new Customer ("Джон", "Смит"), MediaType.APPLICATION_JSON). 

build();

Response.noContent(). build();

Response.accepted(new Customer("Джон", "Смит", "jsmith@gmail.com", 

"12 34565")). build();

Response.notModified(). header("Браузер", "Mozilla"). build();

Сопоставление HTTP-методов

Итак, мы рассмотрели, как протокол HTTP работает со своими запросами, ответами и операциями (GET, POST, PUT и т. д.) JAX-RS определяет эти распространенные HTTP-методы с помощью аннотаций @GET, @POST, @PUT, @DELETE, @HEAD и @OPTIONS. В качестве методов ресурсов могут предоставляться только общедоступные методы. В листинге 15.13 показана пользовательская веб-служба в стиле REST, предоставляющая методы из разряда CRUD: @GET для получения ресурсов, @POST для создания нового ресурса, @PUT для обновления --">