Успокаивающие объекты - Википедия - Restful Objects
Успокаивающие объекты стандартное покрытие RESTful взаимодействует с объектные модели предметной области. Спецификация опубликована под Лицензия Creative Commons.
Представления и ресурсы, определенные стандартом
Стандарт определяет небольшой набор JSON представления, охватывающие общие конструкции в объектной модели предметной области, включая следующее:
- Список ссылок на объекты домена
- Единый доменный объект
- Свойство, коллекция, принадлежащая объекту домена
- Действие, которое может быть вызвано для объекта домена
- Результат действия (который обычно включает объект домена или список)
- Служба домена (по сути объект домена без сохранения состояния)
- Небольшое количество очень специфических представлений, таких как Home, Version и User.
Restful Objects также определяет стандартный набор ресурсов для доступа к этим представлениям или управления ими. Спецификация определяет, какие методы HTTP могут использоваться с каждым ресурсом, и их значение. В таблице ниже представлена частичная сводка:
| HTTP метод | Объект | Свойство | Коллекция | Действие[уточнить ] | Вызов действия[уточнить ] |
|---|---|---|---|---|---|
| ПОЛУЧАТЬ | Сводка по объекту, сводка по членам, значения свойств | Недвижимость, детали и стоимость | Детали и содержание коллекции | Подсказка к действию | Вызвать (только если запрос) |
| ПОЛОЖИТЬ | Обновить или очистить несколько значений свойств | Обновить или очистить значение | Добавить объект (если задана семантика) | Н / Д - ошибка 405 | Вызов (если идемпотентный) |
| УДАЛИТЬ | Удалить объект | Очистить значение | Удалить объект | Н / Д - ошибка 405 | Н / Д - ошибка 405 |
| ПОЧТОВЫЙ | Н / Д - ошибка 405 | Н / Д - ошибка 405 | Добавить объект (если семантика списка) | Н / Д - ошибка 405 | Вызов (любой) |
Взятые вместе ресурсы и представления позволяют получить доступ ко всей функциональности объектной модели предметной области через HTTP. Следующая диаграмма, взятая из спецификации, иллюстрирует взаимосвязь между наиболее часто используемыми ресурсами и представлениями:
История и статус
Версия 1.0.0 спецификации Restful Objects была выпущена в июне 2012 года.
Реализации фреймворка
Существует три известных реализации спецификации Restful Objects с открытым исходным кодом:
- Apache Isis (для платформы Java)
- Голые объекты для .NET (для платформы .NET)
- Успокаивающие объекты для Ruby (для платформы Ruby)
Отношение к другим идеям
В спецификации Restful Objects указано, что он работает на более высоком уровне абстракции, чем другие стандарты успокоения, такие как JAX-RS спецификации для платформы Java, или WCF спецификация на .NET. Есть некоторые концептуальные сходства с Odata - хотя Restful Objects уделяет гораздо больше внимания раскрытию поведения объектов домена, а не только их данных.
Пересечение с образец обнаженных предметов, в том, что оба связаны с созданием универсальных интерфейсов для моделей объектов предметной области. Но пока последний создает какие-то пользовательский интерфейс, Restful Objects создает API - в частности Restful API. Первые две платформы для реализации стандарта Restful Objects были построены на основе существующих платформ, реализующих шаблон Naked Objects.