Institut Supérieur d'Informatique
Architecture Orientée
de Mahdia
Service
Classes : Mastère ASSR-1
Enseignant : Wael sellami TP 2
2019/2020
Services Web avec REST
Partie 1 : Création d’un service Web RESTful « HelloWorld »
1- Créez un nouveau projet web dynamique nommé helloREST sans oublier de générer le
fichier « web.xml »
2- Créez une nouvelle classe Java nommée HelloWorldResource qui représente notre
ressource REST.
3- Ajoutez les annotations JAX-RS suivantes :
- @Path("/MyRESTApplication") permet de définir un chemin pour associer la ressource
HelloWorldResource à un URI
- @GET lecture de la ressource HelloWorldResource via une requête HTTP de type GET
- @Produces("text/plain") indique le type de représentation retournée par la requête GET.
1
4- Apporter les modifications suivantes au fichier « web.xml » de l’application.
Dans le servlet suivant, remplacer le nom de servlet par votre nom de servlet unique. En outre,
remplacer le sous élément <param-value> sous l'élément <init-param> par le nom du package
Java complet.
5- Déployez le projet web dans le serveur Tomcat
6- Tester du service REST en tapant l’url
http://localhost:8080/helloREST/MyRESTApplication
On envoie une requête HTTP de type GET demandant la lecture de la ressource
HelloWorldResource.
Partie 2 : Création d’un service web RESTful paramétré
2
Maintenant, nous allons changer le comportement de notre service web RESTful pour qu’il
utilise des paramètres.
@PathParam
L’annotation @PathParam récupère des arguments passés dans le chemin de l’URI.
On ajoute la méthode suivante à la classe HelloWorldRessource.
Testez l’url suivante :
http://localhost:8080/helloREST/MyRESTApplication/helloto1/foulen
@QueryParam
L’annotation @QueryParam récupère les valeurs des paramètres de la requête.
Testez l’url suivante :
http://localhost:8080/helloREST/MyRESTApplication/helloto2?name=foulen
Partie 3 : Création d’un client du service RESTful
3
Rappelons que JAX-RS est une spécification décrivant le développement des services web
REST côté serveur, mais aussi une autre implémentation côté client afin de consommer un
service web REST.
- Créez un nouveau projet java
- Ajoutez au projet les jars suivants :
- Créez une classe java et ajoutez le code suivant :