Uklidňující objekty - Restful Objects - Wikipedia
Uklidňující objekty je standardní krytina Klidný rozhraní k modely doménových objektů. Specifikace je zveřejněna pod a Licence Creative Commons.
Zastoupení a zdroje definované standardem
Standard definuje malou sadu JSON reprezentace pokrývající obecné konstrukce v modelu doménového objektu, včetně následujících:
- Seznam odkazů na objekty domény
- Jeden objekt domény
- Vlastnost, kolekce patřící k objektu domény
- Akce, kterou lze vyvolat u objektu domény
- Výsledek akce (který obvykle zahrnuje objekt nebo seznam domény)
- Služba domény (v podstatě objekt bez státní příslušnosti)
- Malý počet velmi konkrétních reprezentací, jako je Domov, Verze a Uživatel.
Restful Objects také definuje standardní sadu prostředků pro přístup nebo manipulaci s těmito reprezentacemi. Specifikace definuje, které metody HTTP lze použít s každým prostředkem, a jejich význam. Níže uvedená tabulka ukazuje částečné shrnutí:
| Metoda HTTP | Objekt | Vlastnictví | Sbírka | Akce[vyjasnit ] | Akce Vyvolání[vyjasnit ] |
|---|---|---|---|---|---|
| DOSTAT | Souhrn objektů, souhrn členů, hodnoty vlastností | Vlastnost, podrobnosti a hodnota | Podrobnosti a obsah sbírky | Výzva k akci | Vyvolání (pouze v případě dotazu) |
| DÁT | Aktualizujte nebo vymažte více hodnot vlastností | Aktualizace nebo vymazání hodnoty | Přidat objekt (je-li nastavena sémantika) | N / A - chyba 405 | Vyvolat (pokud je idempotentní) |
| VYMAZAT | Odstranit objekt | Vymazat hodnotu | Odebrat objekt | N / A - chyba 405 | N / A - chyba 405 |
| POŠTA | N / A - chyba 405 | N / A - chyba 405 | Přidat objekt (je-li sémantika seznamu) | N / A - chyba 405 | Vyvolání (libovolné) |
Společně prostředky a reprezentace umožňují přístup ke kompletní funkčnosti modelu doménového objektu HTTP. Následující diagram, převzatý ze specifikace, ilustruje vztah mezi nejčastěji používanými prostředky a reprezentacemi:
Historie a stav
Specifikace Restful Objects verze 1.0.0 byla vydána v červnu 2012.
Implementace rámce
Existují tři známé implementace specifikace Restful Objects, všechny open source:
- Apache Isis (pro platformu Java)
- Nahé objekty pro .NET (pro platformu .NET)
- Uklidňující objekty pro Ruby (pro platformu Ruby)
Vztah k jiným myšlenkám
Specifikace Restful Objects uvádí, že pracuje na vyšší úrovni abstrakce než jiné klidné standardy, jako je JAX-RS specifikace pro platformu Java nebo WCF specifikace na .NET. Existuje několik koncepčních podobností Odata - ačkoli Restful Objects klade mnohem větší důraz na odhalení chování doménových objektů, nejen jejich dat.
Existuje překrytí s vzor nahých předmětů v tom, že oba se zabývají vytvářením obecných rozhraní k modelům doménových objektů. Ale zatímco druhý vytváří nějaký druh uživatelské rozhraní, Restful Objects vytvoří API - konkrétně Restful API. První dva rámce k implementaci standardu Restful Objects byly postaveny na vrcholu existujících rámců, které implementují vzor Naked Objects.