Изучаем Java EE 7 - [246]

Листинг 15.16. Поставщик, порождающий специальное представление Customer

@Provider
@Produces("custom/format")
public class CustomCustomerWriter implements MessageBodyWriter {
··@Override

··public boolean isWriteable(Class type, Type genericType, 

······Annotation[] annotations, MediaType mediaType) {
····return Customer.class.isAssignableFrom(type);
··}
··@Override

··public void writeTo(Customer customer, Class type, Type gType, 

······Annotation[] annotations, MediaType mediaType, 

······MultivaluedMap httpHeaders, 

··OutputStream outputStream) throws IOException, WebApplicationException {

····outputStream.write(customer.getId(). getBytes());
····outputStream.write('/');
····outputStream.write(customer.getFirstName(). getBytes());
····outputStream.write('/');
····outputStream.write(customer.getLastName(). getBytes());
··}

··@Override

··public long getSize(Customer customer, Class type, Type genericType, 

······Annotation[] annotations, MediaType mediaType) {

····return customer.getId(). length() + 1 + customer.getFirstName(). length() 

········+ 1 + customer.getLastName(). length();
··}
}

С другой стороны, для отображения тела запроса на тип Java класс должен реализовывать интерфейс javax.ws.rs.ext.MessageBodyReader и сопровождаться аннотацией @Provider. По умолчанию предполагается, что такая реализация должна применять все медиатипы (*/*). Аннотация @Consumes в листинге 15.17 используется для указания нашего специального медиатипа. Метод readFrom принимает поток данных ввода, размечает его с помощью разделительного символа / и преобразует в объект Customer. Реализации MessageBodyReader и MessageBodyWriter могут генерировать исключение WebApplicationException, если они не способны создать какое-либо представление.

Листинг 15.17. Поставщик, использующий специальный поток данных и создающий объект Customer

@Provider
@Consumes("custom/format")
public class CustomCustomerReader implements MessageBodyReader {
··@Override

··public boolean isReadable(Class type, Type genericType, 

······Annotation[] annotations, MediaType mediaType) {
····return Customer.class.isAssignableFrom(type);
··}

··@Override

··public Customer readFrom(Class type, Type gType, 

······Annotation[] annotations, MediaType mediaType, 

······MultivaluedMap httpHeaders, InputStream inputStream)

······throws IOException, WebApplicationException {
····String str = convertStreamToString(inputStream);
····StringTokenizer s = new StringTokenizer(str, "/");

····Customer customer = new Customer();
····customer.setId(s.nextToken());
····customer.setFirstName(s.nextToken());
····customer.setLastName(s.nextToken());

····return customer;
··}
}

Имея CustomCustomerWriter и CustomCustomerReader, мы можем обмениваться данными, представленными в нашем специальном формате. Обмен идет в обоих направлениях между службой и потребителем. Веб-службы в стиле REST должны просто объявлять верный медиатип, а среда времени исполнения JAX-RS сделает остальное:

@GET
@Produces("custom/format")
public Customer getCustomCustomer () {
··return new Customer("1234", "Джон", "Смит");
}

Наш пользовательский формат представляет собой особый случай, но при работе с обычными медиатипами реализация JAX-RS применяет несколько стандартных поставщиков объектов (табл. 15.7). Поэтому в наиболее распространенных случаях вам не придется реализовывать собственные механизмы для считывания и записи.

Таблица 15.7. Поставщики, применяемые в реализации JAX-RS по умолчанию

Тип	Описание
byte[]	Все медиатипы (*/*)
java.lang.String	Все медиатипы (*/*)
java.io.InputStream	Все медиатипы (*/*)
java.io.Reader	Все медиатипы (*/*)
java.io.File	Все медиатипы (*/*)
javax.activation.DataSource	Все медиатипы (*/*)
javax.xml.transform.Source	XML-типы (text/xml, application/xml)
javax.xml.bind.JAXBElement	Медиатипы для XML, относящиеся к классу JAXB (text/xml, application/xml)
MultivaluedMap	Содержимое формы (application/x-www-form-urlencoded)
javax.ws.rs.core StreamingOutput	Все медиатипы (*/*), только с MessageBodyWriter

Обработка исключений

До сих пор мы обсуждали идеальный код, который исправно выполняется всегда и везде и не требует обработки исключений. К сожалению, жизнь не так хороша и рано или поздно вам придется столкнуться со сбоями, происходящими в ресурсах либо из-за получения невалидных данных, либо из-за ненадежности участков сети.

Метод ресурса может генерировать любое проверяемое или непроверяемое исключение. Непроверяемые исключения могут генерироваться повторно, а также проникать в базовый контейнер. Напротив, проверяемые исключения не могут генерироваться непосредственно и должны обертываться в исключения, специфичные для того или иного контейнера (ServletException, WebServiceException или WebApplicationException). Но вы также можете выдавать javax.ws.rs.WebApplicationException или его подклассы (BadRequestException, ForbiddenException, NotAcceptableException, NotAllowedException, NotAuthorizedException, NotFoundException, NotSupportedException). Исключение будет отлавливаться реализацией JAX-RS и преобразовываться в HTTP-ответ. Стандартная ошибка имеет код 500 и соответствует пустому сообщению. Но класс javax.ws.rs.WebApplicationException предлагает различные конструкторы, позволяющие выбрать конкретный код состояния (этот код определяется в перечислении javax.ws.rs.core.Response.Status) или объект. В листинге 15.18 метод getCustomer генерирует непроверяемое исключение (IllegalArgumentException), если идентификатор пользователя меньше 1000, либо код 404 — Не найдено, если запись, соответствующая определенному пользователю, не будет найдена в базе данных. Вместо этого можно было бы также выдать NotFoundException.