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

.

Как выбрать одно из возможных представлений заданного ресурса? Есть два решения. Сервис может давать отдельный URI на каждое представление, как показано выше. Но две эти ссылки действительно очень разные и почти не напоминают друг друга. Ниже приведен более красивый набор ссылок:

• http://www.apress.com/java;

• http://www.apress.com/java/csv;

• http://www.apress.com/java/xml.

Первый URI по умолчанию используется для представления ресурса, а в дополнительных вариантах URI приведен формат соответствующего представления /csv (следует понимать: text/csv), /xml, /pdf и т. д.

Другое решение — предложить один URI для всех вариантов представления (например, http://www.apress.com/java) и задействовать механизм, называемый согласованием содержимого. Мы подробно поговорим о нем ниже в этой главе. Например, URI может существовать в виде человекочитаемого и машинно-обрабатываемого представлений.

Адресуемость

Важный принцип, которого следует придерживаться при проектировании веб-служб в стиле RESTful, — это адресуемость. Ваша веб-служба должна делать приложение максимально адресуемым. Это означает, что каждый значимый информационный элемент в вашем приложении должен быть ресурсом и иметь URI, по которому можно легко попасть к этому ресурсу. URI — единственный информационный фрагмент, который необходимо опубликовать для обеспечения доступа к ресурсу. В таком случае ваш бизнес-партнер сможет не гадать, где находится интересующая информация, а просто и быстро открыть нужный ресурс.

Допустим, вы пытаетесь справиться с ошибкой в вашем приложении. Вы провели кое-какие тесты и в результате пришли к строке 42 в коде класса CreditCardValidator.java — именно здесь и возникает ошибка. Поскольку вы не отвечаете за данную область приложения, то хотите переадресовать эту проблему квалифицированному коллеге, который сможет с ней справиться. Как вы укажете ему эту зловредную строку? Можно сказать: «посмотри строку 42 в классе CreditCardValidator», но если ваш исходный код адресуется через браузер репозитория, то вы можете сохранить URI этой строки и указать ее в отчете об ошибке. Здесь мы подходим к проблеме определения детализации ваших REST-ресурсов в приложении: адресуемость прослеживается на уровне строки, метода, класса, уровня и т. д.

Уникальные URI обеспечивают связываемость ваших ресурсов, а поскольку они предоставляются через единообразный интерфейс, все точно знают, как с ними взаимодействовать. Соответственно, пользователи вполне могут работать с вашим приложением таким образом, о котором вы даже не задумывались.

Связность

В теории графов граф называется связным, если между любой парой его вершин существует как минимум один путь. Граф называется сильно связным, если он содержит прямой путь от вершины u к v и от вершины v к u для любой пары вершин u, v. Согласно принципам REST ресурсы должны быть связаны максимально сильно.

Опять же это утверждение появилось в результате причин успеха Интернета. На всех веб-страницах есть ссылки для перехода на другие страницы, они расположены логичным и интуитивно понятным образом, и весь Интернет является очень хорошо связанным. Если между двумя ресурсами существует четкая взаимосвязь, то они должны быть соединены. REST постулирует, что веб-службы также должны пользоваться преимуществами гипермедийности, информируя клиента о том, какие ресурсы доступны и куда двигаться дальше. REST стимулирует легкую обнаруживаемость служб. Располагая единственным URI, пользовательский агент, который обращается к хорошо связанной веб-службе, может обнаружить все доступные действия, ресурсы, их различные представления и т. д.

Например, когда пользовательский агент (браузер) ищет представление CD (листинг 15.1), в этом представлении может содержаться не только имя исполнителя, но и ссылка на его биографию (в виде URI). Пользовательский агент определяет, переходить по этой ссылке или нет. Представление также может содержать и ссылки на другие представления ресурса или доступных действий.

Листинг 15.1. Представление CD, связанное с другими службами

··Элла и Луи
··1956
··Элла Фицжеральд
··Луи Армстронг
··
··
··

········href="http://music.com/album/789/comments"/>
··
Еще одна важнейшая особенность гипермедийности — это состояние приложения, которое определяется в контексте гипермедиа. Проще говоря, сам тот факт, что веб-служба предоставляет набор ссылок, позволяет клиенту переводить приложение из одного состояния в другое. И для этого достаточно просто перейти по ссылке.
В предыдущем фрагменте XML-кода клиент может изменить состояние приложения, оставив комментарий об альбоме. Список комментариев к альбому — это ресурс, адресуемый по URI http://music.com/album/789/comments