Qu'est-ce que le modèle orienté ressources (ROM) ?

Le modèle orienté ressources (Resourse-Oriented Model) est une approche de conception d’API où les principales entités du système sont représentées comme des ressources, avec lesquelles on peut effectuer des opérations standard telles que créer, lire, mettre à jour et supprimer (CRUD), en utilisant des méthodes HTTP standard.

Principes clés :

• Ressources : Les composants principaux du système, qui ont un identifiant unique (URI). Par exemple, "utilisateur", "commande", "produit".
• Interface uniforme : Utilisation des méthodes HTTP standard (GET, POST, PUT, PATCH, DELETE) pour effectuer des opérations sur les ressources.
• Identification des ressources : Chaque ressource possède un URI unique.
• Représentations : Les ressources peuvent avoir différentes représentations (par exemple, JSON, XML), qui sont convenues entre le client et le serveur.
• Liens entre ressources (Hypermedia) : Les ressources peuvent contenir des liens vers des ressources liées, permettant au client de naviguer dans l’API.

Exemple :

// Obtenir la liste des utilisateurs
GET /users

// Obtenir un utilisateur spécifique
GET /users/123

// Créer un nouvel utilisateur
POST /users
Content-Type: application/json

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

// Mettre à jour un utilisateur
PUT /users/123
Content-Type: application/json

{
  "name": "Ivan Petrov"
}

// Mise à jour partielle de l’utilisateur
PATCH /users/123
Content-Type: application/json

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

// Supprimer un utilisateur
DELETE /users/123

Avantages :

• Simplicité et standardisation : Facile à comprendre et à utiliser grâce à l’utilisation des technologies web standard.
• Scalabilité : Convient pour la construction de systèmes distribués.
• Mise en cache : Possibilité de mettre en cache les représentations des ressources pour améliorer la performance.
• Indépendance du client et du serveur : Séparation entre la présentation des données et leur stockage et traitement.

Inconvénients :

• Peut être inefficace pour effectuer des opérations complexes qui ne rentrent pas dans le cadre du CRUD.
• N’est pas toujours adapté aux services avec état (stateful).

Le ROM est la base pour la construction d’API RESTful.