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

имеющегося ресурса и @DELETE для удаления ресурса.

Листинг 15.13. Ресурс Customer, предоставляющий CRUD-операции и возвращающий ответы

@Path("/customer")

@Produces(MediaType.APPLICATION_XML)

@Consumes(MediaType.APPLICATION_XML)

public class CustomerRestService {

··@GET

··public Response getCustomers() {

····//..

····return Response.ok(customers). build();

··}

··@GET

··@Path("{customerId}")

··public Response getCustomer(@PathParam("customerId") String customerId) {

····//..

····return Response.ok(customer). build();

··}

··@POST

··public Response createCustomer(Customer customer) {

····//..

····return Response.created(createdCustomerURI). build();

··}

··@PUT

··public Response updateCustomer(Customer customer) {

····//..

····return Response.ok(customer). build();

··}

··@DELETE

··@Path("{customerId}")

··public Response deleteCustomer(@PathParam("customerId") String customerId) {

····//..

····return Response.noContent(). build();

··}

}

В спецификации HTTP определяется, какие коды состояния HTTP должны выдаваться при успешном ответе. Вы можете быть уверены, что JAX-RS будет возвращать те же самые стандартные коды ответа.

• Методы GET получают (в виде объекта) любую информацию, на которую указывает запрошенный URI. GET должен возвращать код 200 — Хорошо.

• Метод PUT ссылается на уже существующий ресурс, который необходимо обновить. Если обновляется существующий ресурс, то должен быть возвращен один из следующих кодов состояния: 200 — Хорошо или 204 — Нет содержимого. Такие ответы означают успешное завершение запроса.

• Метод POST используется для создания нового ресурса, идентифицируемого URI запроса. В ответ должен возвращаться код 201 — Создано с URI нового ресурса или код 204 — Нет содержимого, если метод не создал ресурса, который можно было бы идентифицировать по URI.

• Метод DELETE требует, чтобы сервер удалил ресурс, на который указывает содержащийся в запросе URI. При успешном ответе должен возвращаться код 200 — Хорошо (если в ответе содержится объект), 202 — Принято (если действие пока не запущено) или 204 — Нет содержимого, если действие было запущено, но в ответе отсутствует объект.

Построение URI. Гиперссылки — центральная составляющая REST-приложений. Чтобы развиваться в процессе движения приложения между состояниями, веб-службы в стиле REST должны гибко управлять переходами и так же гибко строить URI. В JAX-RS предоставляется объект javax.ws.rs.core.UriBuilder, призванный заменить java.net.URI и упростить безопасное построение URI. Класс UriBuilder обладает набором методов, с помощью которых удобно строить новые URI с нуля или на основе уже существующих URI. В листинге 15.14 показаны примеры использования UriBuilder для создания любого URI с параметрами, указывающими путь, запрос или матрицу.

Листинг 15.14. Использование UriBuilder

public class URIBuilderTest {

··@Test

··public void shouldBuildURIs() {

····URI uri = 

····UriBuilder.fromUri("http://www.myserver.com"). path("book"). path("1234"). build();

····assertEquals("http://www.myserver.com/book/1234", uri.toString());

····uri = UriBuilder.fromUri("http://www.myserver.com"). path("book") 

··········.queryParam("author", "Goncalves"). build();

····assertEquals("http://www.myserver.com/book?author=Goncalves", 

·················uri.toString());

····uri = UriBuilder.fromUri("http://www.myserver.com"). path("book") 

·········.matrixParam("author", "Goncalves"). build();

····assertEquals("http://www.myserver.com/book;author=Goncalves", uri.toString());

····uri = UriBuilder.fromUri("http://www.myserver.com"). path("{path} ") 

·········.queryParam("author", "{value}"). build("book", "Goncalves");

····assertEquals("http://www.myserver.com/book?author=Goncalves", 

·················uri.toString());

····uri = UriBuilder.fromResource(BookRestService.class). path("1234"). build();

····assertEquals("/book/1234", uri.toString());

····uri = UriBuilder.fromUri("http://www.myserver.com"). fragment("book"). build ();

····assertEquals("http://www.myserver.com/#book", uri.toString());

··}

}

Контекстная информация

Когда происходит обработка --">