Wat is het resource-georiënteerde model (ROM)?

Het Resource-Georiënteerde Model (Resourse-Oriented Model) is een benadering voor het ontwerpen van API's waarbij de belangrijkste entiteiten van het systeem worden gepresenteerd als resources, waarmee standaardbewerkingen zoals maken, lezen, bijwerken en verwijderen (CRUD) kunnen worden uitgevoerd, met behulp van standaard HTTP-methoden.

Belangrijke principes:

• Resources: De belangrijkste componenten van het systeem, die een unieke identificator (URI) hebben. Bijvoorbeeld, "gebruiker", "bestelling", "product".
• Eenduidige interface: Gebruik van standaard HTTP-methoden (GET, POST, PUT, PATCH, DELETE) voor operaties op resources.
• Identificatie van resources: Elke resource heeft een unieke URI.
• Representaties: Resources kunnen verschillende representaties hebben (bijvoorbeeld JSON, XML), die worden overeengekomen tussen client en server.
• Hypermedia (verbindingen tussen resources): Resources kunnen links bevatten naar gerelateerde resources, waardoor de client door de API kan navigeren.

Voorbeeld:

// Verkrijg lijst van gebruikers
GET /users

// Verkrijg een specifieke gebruiker
GET /users/123

// Maak een nieuwe gebruiker
POST /users
Content-Type: application/json

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

// Werk een gebruiker bij
PUT /users/123
Content-Type: application/json

{
  "name": "Ivan Petrov"
}

// Deelwijziging van gebruiker
PATCH /users/123
Content-Type: application/json

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

// Verwijder gebruiker
DELETE /users/123

Voordelen:

• Eenvoud en standaardisatie: Gemakkelijk te begrijpen en te gebruiken dankzij het gebruik van standaard webtechnologieën.
• Schaalbaarheid: Geschikt voor het bouwen van gedistribueerde systemen.
• Caching: Mogelijkheid om representaties van resources te cachen voor betere prestaties.
• Onafhankelijkheid van client en server: Scheiding tussen datavoorstelling en opslag en verwerking.

Nadelen:

• Kan inefficiënt zijn voor complexe operaties die niet passen binnen CRUD.
• Is niet altijd geschikt voor stateful-services.

ROM vormt de basis voor het bouwen van RESTful API's.