Définition des ressources dans les applications RESTful

Vous pouvez utiliser Java™ API for RESTful Web Services (JAX-RS) pour développer des services qui suivent les principes REST (Representational State Transfer). Les services RESTful reposent sur la manipulation des ressources. Les ressources peuvent contenir des données statiques ou mises à jour dynamiquement. En identifiant les ressources dans l'application, vous améliorez l'utilité du service et facilitez son développement.

Avant de commencer

Après avoir identifié l'application à exposer comme service RESTful, vous devez définir préalablement les ressources de l'application RESTful. Après que vous avez défini les ressources de l'application, tenez compte du type de données à exposer. Peut-être disposez-vous déjà d'une base de données relationnelle qui contient des informations à présenter aux utilisateurs en utilisant la technologie REST. Disposez-vous réellement d'un groupe de classes Java défini pour accéder à ces données ?

Envisageons le cas d'une application définie pour prendre en charge une librairie. Cette application dispose d'une base de données contenant plusieurs tables qui définissent les divers éléments de la collection de livres et le stock de chaque livre. Dans cet exemple, il existe plusieurs manières de représenter les données dans la base de données dans une application RESTful. Une approche consiste à considérer chaque table comme une ressource pour que chacun des verbes dans la demande RESTful soit associé aux actions que prend en charge la base de données dans la table, telles que la sélection, l'insertion, la mise à jour et la suppression. Cet exemple est une méthode simple de création d'une application RESTful. La méthode dans l'exemple de librairie est également utilisée dans la documentation qui décrit la définition des modèles d'URL des ressources, les méthodes de ressource, les en-têtes HTTP, les codes de réponse, les types de supports et les paramètres des représentations des demandes dans les ressources.

Dans le cadre de l'application de librairie, il peut exister déjà du code qui permet d'accéder à la base de données et d'extraire les données de chaque table. Même si les lignes de chacune des tables représentent logiquement chaque ressource, des classes de programmes d'accès sont utilisées pour définir les ressources. La documentation relative à l'implémentation d'applications JAX-RS fournit des informations détaillées sur l'intégration de ces classes à votre application JAX-RS.

Vous pouvez également disposer d'un contenu plus statique qui ne réside pas dans une base de données, à distribuer comme ressources. Qu'il s'agisse d'une collection de documents dans divers formats ou d'une façade à base de ressources pour d'autres systèmes distants, lorsque vous utilisez JAX-RS, vous pouvez distribuer le contenu de plusieurs sources.

Pourquoi et quand exécuter cette tâche

Les ressources constituent les principaux blocs fonctionnels d'un service RESTful. Un manuel, une commande et une collection d'utilisateurs sont des exemples de ressources d'une application de librairie en ligne.

Les ressources sont adressables par des URL et des méthodes HTTP peuvent exécuter des opérations sur les ressources. Les ressources peuvent avoir plusieurs représentations utilisant différents formats, tels que XML et JSON. Vous pouvez utiliser des en-têtes HTTP et des paramètres pour envoyer des information supplémentaires associées à la demande et à la réponse.

Avec JAX-RS, vous pouvez annoter des objets Old Plain Java (POJO) existants ou nouveaux avec des annotations JAX-RS. Les classes de ressources annotées JAX-RS et les méthodes annotées sont démarrées en fonction des modèles d'identificateur URI.

Procédure

  1. Identifiez les types de ressources dans l'application.
  2. (Facultatif) Identifiez les classes Java existantes que vous pouvez utiliser comme classes de ressources.
  3. Créez des classes Java pour les ressources ne disposant pas d'une classe Java existante.

Résultats

Vous avez défini le contenu à exposer comme collection de ressources dans l'application.

Que faire ensuite

En fonction des ressources que vous avez définies, lisez les informations relatives à la définition des modèles d'URL des ressources, des méthodes de ressource, des en-têtes HTTP et des codes de réponse, des types de supports et des paramètres des représentations des demandes dans les ressources pour en savoir plus sur les étapes supplémentaires à exécuter pour définir les ressources de votre application JAX-RS.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxrs_defresource
Nom du fichier : twbs_jaxrs_defresource.html