rest сервисы что это
Основы REST: теория и практика
REST, Representational State Transfer, является архитектурным стилем для обеспечения стандартов между компьютерными системами в сети, что облегчает для систем обмен данными друг с другом. Системы, отвечающие требованиям REST и часто называемые RESTful, характеризуются тем, что не имеют сохранения состояния и разделяют интересы клиента и сервера. Мы рассмотрим, что означают эти термины и почему они являются полезными для услуг в Интернете.
Разделение клиента и сервера
В архитектурном стиле REST реализация клиента и реализация сервера могут быть выполнены независимо друг от друга. Это означает, что код на стороне клиента может быть изменён в любое время без ущерба для работы сервера, а код на стороне сервера может быть изменён без влияния на работу клиента.
До тех пор, пока каждая сторона знает, какой формат сообщений следует направлять другой стороне, они могут храниться модульно и раздельно. Отделяя задачи пользовательского интерфейса от задач хранения данных, мы повышаем гибкость интерфейса между платформами и улучшаем расширяемость за счёт упрощения компонентов сервера. Кроме того, разделение позволяет каждому компоненту развиваться независимо.
Используя интерфейс REST, различные клиенты попадают в одни и те же конечные точки REST, выполняют те же действия и получают одинаковые ответы.
Отсутствие сохранения состояния
Системы, которые следуют парадигме REST, не имеют сохранения состояния, что означает, что серверу не нужно знать о состоянии клиента и наоборот. Таким образом, и сервер, и клиент могут понять любое полученное сообщение, даже не увидев предыдущих сообщений. Это отсутствие сохранения состояния обеспечивается за счёт использования ресурсов, а не команд. Они описывают любые объекты, документы или вещи, которые могут потребоваться для хранения или отправки в другие службы.
27–29 декабря, Онлайн, Беcплатно
Эти ограничения помогают RESTful-приложениям достигать надёжности, быстрой производительности и расширяемости, как компонентам, которые могут быть управляемы, обновлены и повторно использованы, не затрагивая систему в целом даже во время её работы.
Теперь мы изучим, как на самом деле происходит взаимодействие между клиентом и сервером, когда мы внедряем RESTful-интерфейс.
Взаимодействие между клиентом и сервером
В архитектуре REST клиенты отправляют запросы на поиск или изменение ресурсов, а серверы отправляют ответы на эти запросы. Давайте рассмотрим стандартные способы направления запросов и ответов.
Отправка запросов
REST требует, чтобы клиент сделал запрос на сервер для получения или изменения данных на сервере. Запрос обычно состоит из:
Существует 4 основных метода НТТР, которые мы используем в запросах для взаимодействия с ресурсами в системе REST:
В заголовке запроса клиент отправляет тип контента, который он может получить с сервера. Это поле называется Accept. Оно обеспечивает, что сервер не посылает данные, которые не могут быть поняты или обработаны клиентом. Параметры типов контента — это типы MIME (или Multipurpose Internet Mail Extensions, о которых вы можете прочитать больше в MDN Web Docs).
Типы MIME, используемые для указания типов контента в поле Accept, состоят из типа и подтипа. Они разделены слэшем (/).
Другие типы и часто используемые подтипы:
Например, клиент, имеющий доступ к ресурсу с идентификатором 123 в ресурсе статей на сервере, может отправить запрос GET следующим образом:
Запросы должны содержать путь к ресурсу, на котором должна выполняться операция. В RESTful API пути должны быть разработаны так, чтобы помочь клиенту понять, что происходит. Обычно первая часть пути должна быть множественной формой ресурса. Это позволяет легко читать и понимать вложенные пути.
Пути должны содержать информацию, необходимую для определения местоположения ресурса с необходимой степенью конкретности. При ссылке на список или коллекцию ресурсов не всегда необходимо добавлять идентификатор. Например, запрос POST на путь somesite.com/persons не будет нуждаться в дополнительном идентификаторе, так как сервер генерирует идентификатор для нового объекта.
В тех случаях, когда сервер отправляет клиенту полезную нагрузку, он должен включать тип контента в заголовок ответа. Это поле заголовка контента предупреждает клиента о типе данных, которые он посылает в теле ответа. Эти типы контента являются типами MIME, точно так же, как они находятся в поле Accept заголовка запроса. Тип контента, который сервер возвращает обратно в ответе, должен быть одним из параметров, указанных клиентом в поле принятия запроса.
Например, клиент получает доступ к ресурсу с идентификатором 123 в разделе статей с этим запросом GET:
Сервер должен отправить обратно контент с заголовком ответа:
Это означает, что запрашиваемый контент возвращается в тело ответа с text/html — типом контента, который клиент будет в состоянии принять.
Коды ответов
Ответы от сервера содержат коды состояния для оповещения клиента об успехе операции. Как разработчику вам не нужно знать каждый код состояния (их много), но вы должны знать самые распространённые и то, как они используются.
Для каждого метода НТТР ожидаются коды статуса, которые сервер должен вернуть в случае успеха:
Если операция не работает, вернётся наиболее конкретный код состояния, соответствующий возникшей проблеме.
Предположим, у нас есть приложение, которое позволяет вам просматривать, создавать, редактировать и удалять клиентов и заказы для небольшого магазина одежды, размещённого на сайте fashionboutique.com. Мы можем создать НТТР API, который позволит клиенту выполнять следующие функции.
Если бы мы хотели увидеть всех клиентов, запрос выглядел бы так:
Возможный заголовок ответа будет выглядеть следующим образом:
Создание нового клиента путем размещения данных:
Затем сервер генерирует идентификатор этого объекта и возвращает его клиенту с таким заголовком:
Для просмотра одного клиента мы используем метод GET, указывая идентификатор этого клиента:
Возможный заголовок ответа будет выглядеть следующим образом:
Мы можем обновить этого клиента, вставив новые данные с помощью метода PUT:
Мы также можем УДАЛИТЬ этого клиента, указав его идентификатор:
Практика с REST
Давайте представим, что мы создаём сайт для сбора фотографий. Мы хотим сделать API, чтобы отслеживать пользователей, места проведения и фотографии этих мест. Этот сайт имеет index.html и style.css. Каждый пользователь имеет имя пользователя и пароль. Каждая фотография имеет место проведения и владельца (т.е. пользователя, который сделал фотографию). Каждое место имеет название и адрес. Можете ли вы разработать систему REST, которая будет учитывать:
Для начала опишите:
Рельсы веб-интеграции. REST и SOAP
В каждой отрасли бизнеса, каждой компании, как правило, используется целый зоопарк ПО. Одни системы «из коробки» умеют взаимодействовать с «соседними» продуктами, другие же приходится дорабатывать. За десятилетия существования веба как отрасли сформировались следующие практики межсетевого взаимодействия:
Обмен файлами по FTP.
Неструктурированные HTTP-запросы, договорённости между разработчиками.
Экзотика: сокеты, порты, бинарные объекты.
В данной статье мы поговорим о веб-сервисах. Чем они отличаются от прочих способов и какие они бывают.
Что такое веб-сервисы?
Веб-сервисы (или веб-службы) — это технология, позволяющая системам обмениваться данными друг с другом через сетевое подключение. Обычно веб-сервисы работают поверх протокола HTTP или протокола более высокого уровня. Веб-сервис — просто адрес, ссылка, обращение к которому позволяет получить данные или выполнить действие.
Главное отличие веб-сервиса от других способов передачи данных: стандартизированность. Приняв решение использовать веб-сервисы, можно сразу переходить к структуре данных и доступным функциям. Например, в SOAP (как более строгом протоколе), уже решён вопрос уведомления об ошибках.
Самые известные способы реализации веб-сервисов:
XML-RPC (XML Remote Procedure Call) — протокол удаленного вызова процедур с использованием XML. Прародитель SOAP. Предельно прост в реализации.
SOAP (Simple Object Access Protocol) — стандартный протокол по версии W3C. Четко структурирован и задокументирован.
JSON-RPC (JSON Remote Procedure Call) — более современный аналог XML-RPC. Основное отличие — данные передаются в формате JSON.
REST (Representational State Transfer) — архитектурный стиль взаимодействия компьютерных систем в сети основанный на методах протокола HTTP.
Специализированные протоколы для конкретного вида задач, такие как GraphQL.
Менее распространенный, но более эффективный gRPC, передающий данные в бинарном виде и использующий HTTP/2 в качестве транспорта.
Остальные протоколы не так широко распространены. Подробно рассмотрены в статье будут SOAP и REST.
SOAP (Simple Object Access Protocol) — данные передаются в формате XML.
отраслевой стандарт по версии W3C;
наличие строгой спецификации;
широкая поддержка в продуктах Microsoft,
сложность/ресурсоемкость парсинга XML-данных.
Любое сообщение в протоколе SOAP — это XML документ, состоящий из следующих элементов (тегов):
Envelope. Корневой обязательный элемент. Определяет начало и окончание сообщения.
Header. Необязательный элемент — заголовок. Содержит элементы, необходимые для обработки самого сообщения. Например, идентификатор сессии.
Body. Основной элемент, содержит основную информацию сообщения. Обязательный.
Fault. Элемент, содержащий информацию об ошибках, возникающих в процессе обработки сообщения. Необязательный.
Пример SOAP запроса:
Пример SOAP ответа:
REST (Representational State Transfer) — на самом деле архитектурный стиль, а не протокол. В отличие от SOAP, REST не подкреплен официальным стандартом. Фактически, он основывается на соглашениях. Веб-сервис, построенный с учетом всех требований и ограничений архитектурного стиля, можно назвать RESTful веб-сервисом.
REST не использует конвертацию данных при передаче, данные передаются в исходном виде — это снижает нагрузку на клиент веб-сервиса, но увеличивает нагрузку на сеть. Управление данными происходит с помощью методов HTTP:
GET — получить данные;
POST — добавить данные;
PUT — изменить данные;
DELETE — удалить данные.
Использование этих методов позволяет реализовать типичный CRUD (Create/Read/Update/Delete) для любой информации. Но это лишь соглашение: часто используются только 2 метода: GET для получения и POST для всего остального. Разобраться поможет такое понятие, как REST-Patterns. Паттерны связывают HTTP методы с тем, что они делают.
экономичность в плане ресурсов;
не требует программных надстроек (json_decode есть почти в каждом языке).
неоднозначность методов управления данными.
Пример REST запроса:
Пример REST ответа:
Что же использовать?
Вопрос «Какой способ реализации использовать?» необходимо рассматривать в контексте реализуемой системы и ее ограничений. Обычно, SOAP используется в крупных корпоративных системах со сложной логикой, когда требуются четкие стандарты, подкрепленные временем. XML-RPC, пожалуй, устарел и не имеет смысла ввиду наличия собрата JSON-RPC. RPC-протоколы подойдут для совсем простых систем с малым количеством единиц информации и API-методов.
Если же вы разрабатываете публичное API и логика взаимодействия во многом покрывается четверкой методов CRUD — смело выбирайте REST. Он наиболее популярен в WEB. Яндекс, Google и другие используют именно его для своего API.
Веб-сервисы в живом производстве
Разработка веб-сервисов — типичная задача интеграции. ИНТЕРВОЛГА, как веб-интегратор, регулярно сталкивается с задачами разработки веб-сервисов и успешно с ними справляется. Наши сайты были и SOAP/REST серверами, и SOAP/REST клиентами.
Успешным примером внедрения веб-сервисов является проект Enterprise-уровня — Личный кабинет клиентов компании Евраз Металл Инпром. Все функции личного кабинета основываются на взаимодействии с удаленным SOAP веб-сервисом. Сайт выступает клиентом. В процессе эволюции в угоду безопасности сайт переквалифицировался в SOAP-сервер, а учетная система в SOAP-клиента.
Еще один личный кабинет для клиентов компании Евраз — еще один пример сайта в качестве клиента удаленного SOAP веб-сервиса.
Если у вас есть потребность организовать взаимодействие с веб-сервисом, сделать из сайта REST/SOAP/RPC клиент или сервер, пишите нам.
Подведем итог, выделив, два важных тезиса в пользу выбора веб-сервисов в качестве «рельс» для веб-интеграции.
Наш опыт неоднократно демонстрировал, что создание веб-сервисов, в реальном времени передающих необходимые данные между сайтом и другим ПО — лучшее решение, чем классические обмены по расписанию. Такой подход проще сопровождать, вести его отладку, это более эффективная трата времени программиста, чем проектирование и разработка сложного двунаправленного обмена с кучей сущностей.
Можно провести аналогию с эволюцией разработки сайтов. Когда-то, на заре сайтостроения, каждый разработчик делал сайт с нуля на той технологии, которую мог знать лишь он один. Это порождало проблемы в развитии таких сайтов. Как работали такие сайты — знал только автор кода. Со временем появлялись фреймворки и CMS. Разработку начинали не с нуля, а с известных широкой массе разработчиков «заготовок» — стандартных решений стандартных проблем с возможность расширения и углубления.
Также и с обменом данными. Не нужно тратить месяцы на объяснение новому сотруднику и самому себе, как работает обмен. Есть стандарт, обмен работает по нему.
Национальная библиотека им. Н. Э. Баумана
Bauman National Library
Персональные инструменты
REST (сокр. от англ. Representational State Transfer-«передача состояния представления»)— архитектурный стиль взаимодействия компонентов распределённого приложения в сети. REST представляет собой согласованный набор ограничений, учитываемых при проектировании распределённой гипермедиа-системы. В определённых случаях (интернет-магазины, поисковые системы, прочие системы, основанные на данных) это приводит к повышению производительности и упрощению архитектуры. В широком смысле[уточнить] компоненты в REST взаимодействуют наподобие взаимодействия клиентов и серверов во Всемирной паутине. REST является альтернативой RPC group: [Источник 1]
В сети Интернет вызов удалённой процедуры может представлять собой обычный HTTP-запрос (обычно «GET» или «POST»; такой запрос называют «REST-запрос»), а необходимые данные передаются в качестве параметров запроса group: [Источник 2] group: [Источник 3]
Для веб-служб, построенных с учётом REST (то есть не нарушающих накладываемых им ограничений), применяют термин «RESTful».
В отличие от веб-сервисов (веб-служб) на основе SOAP, не существует «официального» стандарта для RESTful веб-API. Дело в том, что REST является архитектурным стилем, в то время как SOAP является протоколом. Несмотря на то, что REST не является стандартом сам по себе, большинство RESTful-реализаций используют стандарты, такие как HTTP, URL, JSON и XML.
Содержание
История термина
Хотя данная концепция лежит в самой основе Всемирной паутины — термин «REST» был введён Роем Филдингом, одним из создателей протокола «HTTP», лишь в 2000 году. В своей диссертации «Архитектурные стили и дизайн сетевых программных архитектур» («Architectural Styles and the Design of Network-based Software Architectures»)group: [Источник 4]
Стиль «REST» развивался параллельно с «HTTP 1.1», разработанным в 1996—1999 годах, основываясь на существующем дизайне «HTTP 1.0», разработанном в 1996 году group: [Источник 5]
Свойства Архитектуры REST
Свойства архитектуры, которые зависят от ограничений, наложенных на REST-системы:
Рой Филдинг — один из главных авторов спецификации протокола HTTP, описывает влияние архитектуры REST на масштабируемость следующим образом:
Требования к архитектуре REST
Существует шесть обязательных ограничений для построения распределённых REST-приложений по Филдингу group: [Источник 6]
Выполнение этих ограничительных требований обязательно для REST-систем. Накладываемые ограничения определяют работу сервера в том, как он может обрабатывать и отвечать на запросы клиентов. Действуя в рамках этих ограничений, система приобретает такие желательные свойства как производительность, масштабируемость, простота, способность к изменениям, переносимость, отслеживаемость и надежность.
Если сервис-приложение нарушает любое из этих ограничительных условий, данную систему нельзя считать REST-системой.
Обязательными условиями-ограничениями являются:
Модель клиент-сервер
Первым ограничением применимым к нашей гибридной модели является приведение архитектуры к модели клиент-сервер, описанной в параграфе 3.4.1. Разграничение потребностей является принципом, лежащим в основе данного накладываемого ограничения. Отделение потребности интерфейса клиента от потребностей сервера, хранящего данные, повышает переносимость кода клиентского интерфейса на другие платформы, а упрощение серверной части улучшает масштабируемость. Наибольшее же влияние на всемирную паутину, пожалуй, имеет само разграничение, которое позволяет отдельным частям развиваться независимо друг от друга, поддерживая потребности в развитии интернета со стороны различных организаций.
Отсутствие состояния
Протокол взаимодействия между клиентом и сервером требует соблюдения следующего условия: в период между запросами клиента никакая информация о состоянии клиента на сервере не хранится. (Stateless protocol (англ.)русск.. Все запросы от клиента должны быть составлены так, чтобы сервер получил всю необходимую информацию для выполнения запроса. Состояние сессии при этом сохраняется на стороне клиента. Информация о состоянии сессии может быть передана сервером какому-либо другому сервису (например в службу базы данных) для поддержания устойчивого состояния, например с целью, и на период установления аутентификации. Клиент инициирует отправку запросов, когда он готов (возникает необходимость) перейти в новое состояние.
Во время обработки клиентских запросов считается, что клиент находится в переходном состоянии. Каждое отдельное состояние приложения представлено связями, которые могут быть задействованы при следующем обращении клиента.
Кэширование
Как и во Всемирной паутине, клиенты а также промежуточные узлы могут выполнять кэширование ответов сервера. Ответы сервера в свою очередь должны иметь явное или неявное обозначение как кэшируемые или некэшируемые с целью предотвращения получения клиентами устаревших или неверных данных в ответ на последующие запросы. Правильное использование кэширования способно полностью или частично устранить некоторые клиент-серверные взаимодействия, ещё более повышая производительность и расширяемость системы.
Единообразие интерфейса
Наличие унифицированного интерфейса являются фундаментальным требованием дизайна REST-сервисов. Унифицированные интерфейсы позволяют каждому из сервисов развиваться независимо.
К унифицированным интерфейсам предъявляются следующие четыре ограничительных условия:
Манипуляция ресурсами через представление
Гипермедиа, как средство изменения состояния приложения
Код по требованию (необязательное ограничение)
REST может позволить расширить функциональность клиента за счёт загрузки кода с сервера в виде апплетов или сценариев. Филдинг утверждает, что дополнительное ограничение позволяет проектировать архитектуру, поддерживающую желаемую функциональность в общем случае, но возможно за исключением некоторых контекстов.
Преимущества
Филдинг указывал, что приложения, не соответствующие приведённым условиям, не могут называться REST-приложениями. Если же все условия соблюдены, то, по его мнению, приложение получит следующие преимущества:
Web-сервисы RESTful
Основы
REST определяет ряд архитектурных принципов проектирования Web-сервисов, ориентированных на системные ресурсы, включая способы обработки и передачи состояний ресурсов по HTTP разнообразными клиентскими приложениями, написанными на различных языках программирования. За последние несколько лет REST стала преобладающей моделью проектирования Web-сервисов. Фактически REST оказала настолько большое влияние на Web, что практически вытеснила дизайн интерфейса, основанный на SOAP и WSDL, из-за значительного более простого стиля проектирования.
Технология REST не привлекла большого внимания в 2000 году, когда Рой Филдинг (Roy Fielding) впервые представил ее в Калифорнийском университете в Ирвайне в своей диссертации «Архитектурные стили и дизайн сетевых архитектур программного обеспечения», где анализировался набор принципов архитектуры программного обеспечения, использующей Web в качестве платформы распределенных вычислений. Однако сегодня, по прошествии многих лет, возникли и продолжают развиваться многочисленные инфраструктуры для REST, которую, среди прочего, планируется интегрировать в стандарт Java™ 6 JSR-311.
Конкретная реализация Web-сервисов REST следует четырем базовым принципам проектирования:
Явное использование HTTP-методов
Одной из ключевых характеристик Web-сервиса RESTful является явное использование HTTP-методов согласно протоколу, определенному в RFC 2616. Например, HTTP GET определяется как метод генерирования данных, используемый клиентским приложением для извлечения ресурса, получения данных с Web-сервера или выполнения запроса в надежде на то, что Web-сервер найдет и возвратит набор соответствующих ресурсов.
REST предлагает разработчикам использовать HTTP-методы явно в соответствии с определением протокола. Этот основной принцип проектирования REST устанавливает однозначное соответствие между операциями create, read, update и delete (CRUD) и HTTP-методами. Согласно этому соответствию:
Недостатком проектирования многих Web API является использование HTTP-методов не по прямому назначению. Например, URI запроса в HTTP GET обычно определяет один конкретный ресурс, либо же строка запроса в URI запроса содержит ряд параметров, определяющих критерии поиска сервером набора соответствующих ресурсов. По крайней мере именно так описан метод GET в HTTP/1.1 RFC. Однако часто встречаются непривлекательные Web API, использующие HTTP GET для выполнения разного рода транзакций на сервере (например, для добавления записей в базу данных). В таких случаях URI запроса GET используется некорректно или, по крайней мере, не используется в REST-стиле (RESTfully). Если Web API использует GET для запуска удаленных процедур, запрос может выглядеть примерно так:
Это неудачный дизайн, поскольку вышеупомянутый Web-метод поддерживает меняющую состояние операцию посредством HTTP-запроса GET. Иначе говоря, HTTP-запрос GET имеет побочные эффекты. В случае успешного выполнения запроса в хранилище данных будет добавлен новый пользователь (в нашем примере – Robert). Проблема здесь в основном семантическая. Web-серверы предназначены для ответов на HTTP-запросы GET путем извлечения ресурсов согласно URI запроса (или критерию запроса) и возврата их или их представления в ответе, а не для добавления записи в базу данных. С точки зрения предполагаемого использования и с точки зрения HTTP/1.1-совместимых Web-серверов такое использование GET является ненадлежащим.
Кроме семантики еще одной проблемой является то, что для удаления, изменения или добавления записи в базу данных или для изменения каким-либо образом состояния на стороне сервера GET привлекает различные средства Web-кэширования (роботы) и поисковые механизмы, которые могут выполнять непреднамеренные изменения на сервере путем простого обхода ссылки. Простым способом решения этой общей проблемы является помещение имен и значений параметров URI запроса в XML-теги. Эти теги (XML-представление создаваемого объекта) можно отправить в теле HTTP-запроса POST, URI которого является родителем объекта (см.образец RESTful-запроса 1(До) и 2(После)). образец 1(До)
Это образец RESTful-запроса: HTTP-запрос POST используется корректно, а тело запроса содержит полезную нагрузку. На принимающей стороне в запрос может быть добавлен содержащийся в теле ресурс, подчиненный ресурсу, определенному в URI запроса; в данном случае новый ресурс должен добавляться как потомок /users. Такое отношение включения (containment) между новым логическим объектом и его родителем, указанное в запросе POST, аналогично отношению подчинения между файлом и родительским каталогом. Клиентское приложение устанавливает отношение между логическим объектом и его родителем и определяет URI нового объекта в запросе POST.
Затем клиентское приложение может получить представление ресурса, используя новый URI, указывающий, что по крайней мере логически ресурс расположен в /users (см. образец 3). образец 3. HTTP-запрос GET
Это правильное применение запроса GET, поскольку он служит только для извлечения данных. GET – это операция, которая должна быть свободной от побочных эффектов. Данное свойство известно также под названием идемпотентность.
Аналогичный рефакторинг Web-метода необходимо выполнить в тех ситуациях, когда HTTP-запрос GET поддерживает операцию update (см. образец 4). образец 4. Операция update в HTTP-запросе GET
Это запрос меняет атрибут (или свойство) name ресурса. Хотя для такой операции можно использовать строку запроса и в листинге 4 приведена самая простая из них, модель «строка запроса как сигнатура метода» не работает для более сложных операций. Поскольку нашей целью является явное использование HTTP-методов, по указанным выше причинам более RESTful-совместимым является подход, при котором для обновления ресурса применяется HTTP-запрос PUT вместо HTTP-запроса GET (см. образец 5). образец 5. HTTP-запрос PUT
Использование запроса PUT для замены исходного ресурса обеспечивает гораздо более прозрачный интерфейс, совместимый с принципами REST и с определением HTTP-методов. Запрос PUT в листинге 5 является явным в том смысле, что он указывает на обновляемый ресурс, определяя его в URI запроса, и передает новое представление ресурса от клиента на сервер в теле запроса PUT, вместо того чтобы передавать атрибуты ресурса в виде слабо связанного набора имен и значений параметров в URI запроса. Запрос в листинге 5 переименовывает ресурс с Robert на Bob и меняет его URI на /users/Bob. В Web-сервисе REST использование старого URI в последующих запросах ресурса приведет к возникновению стандартной ошибки 404 Not Found.
Общепринятым подходом, соответствующим рекомендациям REST по явному применению HTTP-методов, является использование в URI имен существительных вместо глаголов. В Web-сервисе RESTful глаголы POST, GET, PUT и DELETE уже определены протоколом. В идеале для реализации обобщенного интерфейса и явного вызова операций клиентскими приложениями Web-сервис не должен определять дополнительные команды или удаленные процедуры, например /adduser или /updateuser. Этот общий принцип применим также к телу HTTP-запроса, которое предназначено для передачи состояния ресурса, а не имени вызываемых удаленного метода или удаленной процедуры.
Несохранение состояния
Для удовлетворения постоянно растущих требований к производительности Web-сервисы REST должны быть масштабируемыми. Для формирования топологии сервисов, позволяющей при необходимости перенаправлять запросы с одного сервера на другой с целью уменьшения общего времени реакции на вызов Web-сервиса, обычно применяют кластеры серверов с возможностью распределения нагрузки и аварийного переключения на резерв, прокси-серверы и шлюзы. Использование промежуточных серверов для улучшения масштабируемости требует, чтобы клиенты Web-сервисов REST отправляли полные самодостаточные запросы, содержащие все необходимые для их выполнения данные, чтобы компоненты на промежуточных серверах могли перенаправлять, маршрутизировать и распределять нагрузку без локального сохранения состояния между запросами.
При обработке полного самодостаточного запроса серверу не нужно извлекать состояние или контекст приложения. Приложение (или клиент) Web-сервиса REST включает в HTTP-заголовки и в тело запроса все параметры, контекст и данные, необходимые серверному компоненту для генерирования ответа. В этом смысле несохранение состояния (statelessness) улучшает производительность Web-сервиса и упрощает дизайн и реализацию серверных компонентов, поскольку отсутствие состояния на сервере устраняет необходимость синхронизации сеансовых данных с внешним приложением.
На рисунке 1 показан сохраняющий состояние сервис, в котором приложение может запросить следующую страницу в многостраничном наборе результатов, полагая, что сервер хранит последовательность переходов приложения по этому набору результатов. В этой модели с сохранением состояния сервис наращивает и сохраняет переменную previousPage, чтобы быть в состоянии отвечать на запросы следующих страниц.
Подобные сохраняющие состояние сервисы получаются сложными. На платформе Java EE (Java Platform, Enterprise Edition) сохраняющие состояние сервисы требуют большого количества предварительных соглашений по эффективному хранению и синхронизации сеансовых данных в кластере Java EE-контейнеров. В средах такого типа разработчики сервлетов/страниц JSP (JavaServer Pages) и EJB-компонентов (Enterprise JavaBeans) сталкиваются с типичной проблемой поиска причин возникновения исключительной ситуации java.io.NotSerializableException при репликации сеанса. Независимо от источника (контейнер сервлетов при репликации HttpSession или EJB-контейнер при репликации сохраняющего состояние EJB-компонента) такая проблема может стоить разработчикам нескольких дней поисков в сложном графе объектов, определяющих состояние сервера, того единственного объекта, в котором реализуется Serializable. Кроме того, синхронизация сеансов увеличивает накладные расходы, что отрицательно сказывается на производительности сервера.
В противоположность этому, не сохраняющие состояния серверные компоненты более просты в проектировании, написании и распределении между серверами со сбалансированной нагрузкой. Не сохраняющий состояния сервис не только лучше работает, но и возлагает основную ответственность за сохранение состояния на клиентское приложение. В Web-сервисе RESTful сервер отвечает за генерирование ответов и за предоставление интерфейса, позволяющего клиентскому приложению самому хранить свое состояние. Например, при запросе многостраничного набора результатов клиентское приложение должно включать в запрос номер конкретной страницы, а не просто запрашивать следующую страницу (см. рисунок 2).
Не сохраняющий состояния Web-сервис генерирует ответ, содержащий ссылку на номер следующей страницы в наборе и позволяющий клиенту самостоятельно позаботиться о сохранении этого значения. В самом общем виде этот аспект модели Web-сервисов RESTful можно разделить на две сферы ответственности, объясняющие суть функционирования не сохраняющего состояние сервиса:
Сервер
Клиентское приложение
Такая совместная работа клиентского приложения и сервиса очень важна для отказа от сохранения состояния в Web-сервисах RESTful. Результатом ее является рост производительности за счет уменьшения трафика и минимизации состояния серверного приложения.
Отображение URI, аналогичных структуре каталогов
С точки зрения обращения к ресурсам из клиентского приложения предоставляемые URI определяют, насколько интуитивным будет Web-сервис REST и будет ли он использоваться так, как предполагал разработчик. Третья характеристика Web-сервиса RESTful полностью посвящена URI.
URI-адреса Web-сервиса REST должны быть интуитивно понятными. Рассматривайте URI как некий самодокументирующийся интерфейс, почти не требующий пояснения или обращения к разработчику для его понимания и для получения соответствующих ресурсов. Поэтому структура URI должна быть простой, предсказуемой и понятной.
Один из способов достичь такого уровня удобства использования – построение URI по аналогии со структурой каталогов. Такого рода URI являются иерархическими, исходящим из одного корневого пути, ветвления которого отображают основные функции сервиса. Согласно этому определению, URI – это не просто строка со слэшами в качестве разделителей, а скорее дерево с вышележащими и нижележащими ветвями, соединенными в узлах. Например, в сервисе обсуждений различных тем (от Java до бумаги) можно определить структурированный набор URI следующего вида:
Приведем некоторые дополнительные рекомендации, на которые следует обратить внимание при обдумывании структуры URI для Web-сервисов RESTful:
URI также должны быть статичными, чтобы при изменениях ресурсов или реализации сервиса ссылка оставалась той же. Это позволяет сохранить закладки. Также важно, чтобы взаимосвязи между ресурсами, закодированными в URI, оставались независимыми от способа указания местоположения ресурсов в хранилище.
Передача XML, JSON или обоих
Представление ресурса, как правило, отражает текущее состояние ресурса (и его атрибутов) на момент его запроса клиентским приложением. Представления ресурсов в этом смысле являются просто снимками состояния в конкретные моменты времени. Эти представления должны быть такими же простыми, как представление записи в базе данных, состоящее из отображения между именами столбцов и XML-тегами, где значения элементов в XML содержат значения строк. Если система имеет модель данных, то согласно этому определению представление ресурса является снимком состояния атрибутов одного из объектов модели данных системы. Это те объекты, которые будет обслуживать Web-сервис REST.
Последний набор ограничений, тесно связанный с дизайном Web-сервисов RESTful, относится к формату данных, которыми обмениваются приложение и сервис при работе в режиме запрос/ответ или в теле HTTP-запроса. Здесь особенно важны простота, читабельность и связанность.
Объекты модели данных обычно как-то связаны, и эти отношения между объектами (ресурсами) модели данных должны отражаться в способе их представления для передачи клиентскому приложению. В сервисе обсуждений пример представлений связанных ресурсов может включать в себя корневую тему обсуждения и ее атрибуты, а также встроенные ссылки на ответы, отправленные в эту тему.
XML-представление ветки обсуждения
Наконец, чтобы предоставить клиентским приложениям возможность запрашивать конкретный наиболее подходящий им тип содержимого, проектируйте сервис так, чтобы он использовал встроенный HTTP-заголовок Accept, значение которого является MIME-типом. Некоторые общеупотребительные MIME-типы, используемые RESTful-сервисами, перечислены в таблице 1.
Это позволит использовать сервис клиентским приложениям, написанным на разных языках и работающим на различных платформах и устройствах. Использование MIME-типов и HTTP-заголовка Accept представляет собой механизм согласования содержимого (content negotiation), позволяющий клиентским приложениям выбирать подходящий для них формат данных и минимизировать связность данных между сервисом и приложениями, его использующими.
Заключение
Технология REST – это способ проектирования Web-сервисов, менее зависимый от закрытого промежуточного программного обеспечения (например, сервер приложений), чем модели SOAP и WSDL. В некотором смысле REST, благодаря акценту на ранние интернет-стандарты URI и HTTP, является возвратом к Web до появления больших серверов приложений. Как вы увидели из рассмотрения принципов проектирования RESTful-интерфейса, XML поверх HTTP является мощным интерфейсом, позволяющим внутренним приложениям (например, пользовательским интерфейсам, основанным на технологии Ajax (Asynchronous JavaScript + XML)), легко подключаться и обращаться к ресурсам и потреблять их. Фактически именно хорошая совместимость Ajax и REST стала причиной сегодняшней популярности REST.
Представление системных ресурсов через RESTful API – это гибкий способ обеспечения различных приложений данными в стандартном формате. Это помогает выполнить требования к интеграции, имеющие решающее значение для создания систем, позволяющих легко комбинировать данные (машапов), а также для построения на основе набора базовых RESTful-сервисов более крупных конструкций.