Création d'un service Web JAX-RS
Avant de commencer
- WebSphere Application Server version 7.0 ou version 8.0, en sélectionnant d'installer Feature Pack for Web 2.0 AND MOBILE et les outils de développement WebSphere Application Server
Si vous choisissez d'effectuer le déploiement sur un serveur autre que WebSphere Application Server, vous ne pouvez pas utiliser la bibliothèque IBM® JAX-RS et vous devez installer et configurer vos propres bibliothèque JAX-RS via la page de préférences Facettes de projet > JAX-RS.
Pour des informations détaillées sur l'utilisation de services Web JAX-RS dans WebSphere Application Server, voir le centre de documentation de WebSphere Application Server.
Créer un projet Web compatible JAX-RS
Pourquoi et quand exécuter cette tâche
[WebSphere Application Server Traditional] WebSphere Application Server Traditional version 9 prend en charge JAX-RS 1.1 et 2.0. La version de JAX-RS que vous utilisez dans votre projet doit correspondre à la version de JAX-RS que vous employez dans votre installation de WebSphere Application Server Traditional version 9. Si ces versions ne correspondent pas, les outils affichent un avertissement lorsque vous déployez votre projet sur le serveur. Si vous créez un projet JAX-RS sans indiquer de niveau de facette, les outils utilisent JAX-RS 2.0 par défaut.
com.ibm.ws.jaxrs.jar
com.ibm.ws.prereq.jaxrs.jar
javax.j2ee.jaxrs.jar
com.ibm.ws.jaxrs20.jar
com.ibm.ws.prereq.jaxrs20.jar
javax.ws.rs-api-2.0.jar
Procédure
Créer un service Web JAX-RS
Procédure
- Dans votre projet Web, créez un package (cliquez avec le bouton droit sur et sélectionnez ). Importez les classes pour le service Web dans le package.
- Ouvrez WebContent/WEB-INF/web.xml. Dans la vue Conception, sélectionnez le servlet JAX-RS, cliquez sur Ajouter et ajoutez un paramètre d'initialisation au servlet, en laissant les zones de nom et de valeur vides. Enregistrez web.xml en ignorant les erreurs éventuelles affichées.
- Dans la vue Marqueurs, sélectionnez l'erreur de web.xml sur le nom de paramètre, cliquez avec le bouton droit et sélectionnez Correction rapide. Naviguez jusqu'à l'application et sélectionnez-la.
- Ajoutez le fichier EAR contenant le projet JAX-RS au serveur et démarrez celui-ci.
Résultats
Toute application Web doit avoir une racine de contexte pour pourvoir se déployer. Une racine de contexte est définie pour chaque module Web dans le descripteur de déploiement de l'application au cours de l'assemblage de l'application ou de son déploiement. La racine de contexte est combinée au mappage de servlet défini issu du fichier WAR pour composer l'URL complète que tapent les utilisateurs pour accéder au servlet. La racine de contexte de chaque application Web déployée doit être unique sur le serveur. Elle peut également être vide.
Par exemple, si une application Web utilise comme racine de contexte sample/application/, l'URL de demande de l'application commence par http://<nomhôte>:<port>/sample/application/. Le modèle d'URL d'un servlet est ajouté à la racine de contexte de l'application Web. Par exemple, si la racine de contexte est sample/application/ et que le mappage d'URL du servlet est rest/api/*, l'URI de base pour l'application Web JAX-RS est http://<nomhôte>:<port>/sample/application/rest/api.
Edition d'un projet JAX-RS
- le type de bibliothèque
- le nom du servlet JAX-RS
- le nom de classe du servlet JAX-RS
- les modèles de mappage d'URL