Czym jest model zorientowany na zasoby (ROM)?

Model Zorientowany na Zasoby (Resourse-Oriented Model) to podejście do projektowania API, w którym główne encje systemu są reprezentowane jako zasoby, z którymi można wykonywać standardowe operacje, takie jak tworzenie, odczyt, aktualizacja i usuwanie (CRUD), przy użyciu standardowych metod HTTP.

Kluczowe zasady:

• Zasoby: Główne komponenty systemu, które mają unikalny identyfikator (URI). Na przykład "użytkownik", "zamówienie", "produkt".
• Jednolity interfejs: Użycie standardowych metod HTTP (GET, POST, PUT, PATCH, DELETE) do wykonywania operacji na zasobach.
• Identyfikacja zasobów: Każdy zasób ma unikalny URI.
• Reprezentacje: Zasoby mogą mieć różne reprezentacje (np. JSON, XML), które są uzgadniane między klientem a serwerem.
• Powiązania między zasobami (Hypermedia): Zasoby mogą zawierać odnośniki do powiązanych zasobów, co umożliwia klientowi nawigację po API.

Przykład:

// Pobierz listę użytkowników
GET /users

// Pobierz konkretnego użytkownika
GET /users/123

// Utwórz nowego użytkownika
POST /users
Content-Type: application/json

{
  "name": "Ivan",
  "email": "ivan@example.com"
}

// Zaktualizuj użytkownika
PUT /users/123
Content-Type: application/json

{
  "name": "Ivan Petrov"
}

// Częściowa aktualizacja użytkownika
PATCH /users/123
Content-Type: application/json

{
  "email": "ivan.petrov@example.com"
}

// Usuń użytkownika
DELETE /users/123

Zalety:

• Prostota i standaryzacja: Łatwe do zrozumienia i używania dzięki stosowaniu standardowych technologii webowych.
• Skalowalność: Odpowiedni do budowy rozproszonych systemów.
• Buforowanie: Możliwość buforowania reprezentacji zasobów w celu poprawy wydajności.
• Niezależność klienta i serwera: Rozdzielenie prezentacji danych od ich przechowywania i przetwarzania.

Wady:

• Może być nieefektywny dla złożonych operacji, które nie mieszczą się w CRUD.
• Nie zawsze jest odpowiedni dla usług z stanem (stateful).

ROM stanowi podstawę do budowy RESTful API.