TP4 : Services Web REST

 -
Page 1
TP4 : Services Web REST
 -       
1
2
es instructions suivantes :
 VMap Geocoding. Vous allez vous rendre sur le
site suivant : https://developers.google.com/maps/documentation/javascript/get-api-key et
bien suivre les instructions pour la création de la clé. Sauvegardez la clé obtenue, vous
en aurez besoin.
 Créer un nouveau projet de type Java Application et vérifier que la classe main est bien
créée.
 Ajouter le service Google Map Geocoding 
GoogleGeocoding Service.
 Faire un drag et drop de « geocode » dans la méthode « main» . Vous pouvez modifier les
paramètres par défaut qui apparaissent dans le pop-up comme suit :
q = "vieux port, marseilles";
output = "xml"; // ou en json
 Modifier votre main comme suit :
 Votre projet a été modifié. En effet, 4 classes ont été créées :
o GoogleGeocodingServiceAuthenticator.java : permet de vérifier la clé dans le
fichier properties.
o RestConnection.java : 
o RestResponse.java : récupère les données retournées par Google.
1 https://developers.google.com/maps/documentation/geocoding/intro?hl=fr
2 https://netbeans.org/kb/docs/websvc/zillow.html
Google Maps Geocoding API

 -
Page 2
o GoogleGeocodingService: représente la classe utilisée par votre servlet pour
interagir avec les autres classes et Google
 Modifier le fichier « googlegeocodingserviceauthenticator.properties» qui se trouve sous
le package « org.netbeans.saas.google » en ajoutant la clé que vous avez récupérée.
 Ouvrir la classe « GoogleGeocodingService.java »  et modifier la méthode
« geocode » comme suit :
public static RestResponse geocode(String q, String output) throws
IOException {
String apiKey =
GoogleGeocodingServiceAuthenticator.getApiKey();
String[][] pathParams = new String[][]{};
String[][] queryParams = new String[][]{{"address", q},
{"key", "" + apiKey + ""},
{"output", output}};
RestConnection conn = new
RestConnection("https://maps.googleapis.com/maps/api/geocode/xml",
pathParams, queryParams);
sleep(1000);
return conn.get(null);
}
 Créer une base de données 
 Créer les services web REST à partir de la base de données
 Déployer les services web 
 Tester les services développés
 Créer un client pour consommer le service web
1. Création de de base de données
     --
--
Développement d’un service REST pour la réservation d’un hôtel

 -
Page 3
2. Génération des entités grâce à JPA
 Créer une classe entité (New Entity Class) que vous nommerez « Hotel » représentant
les hôtels par leur identifiant (idHotel), leur nom (nom_Hotel), leur adresse (adresse), leur
code postal (code_postal), leur ville (ville), le nombre NbreEtoiles) et le prix (prix)
 .         choisir EclipseLink comme
Fournisseur de persistence3 (Persistence Provider). Vous sélectionnerez ensuite comme
Data Source la base de données que vous venez de créer. Vous nommerez le package
ENTITE.
 Ajouter les attributs ainsi que les méthodes manquantes (constructeurs, les getters et les
setters) dans la classe Hotel.java.
 Quelle est la différence entre une classe Java et une classe entité ?
3. Création, déploiement et test du service de recherche d’hôtels
 Créer un service web REST à partir de la classe entité « Hotel ». Pour cela, vous allez
sélectionner New
créée et générer le service. Que remarquez-vous ? .
 Déployer (clic droit sur le projetdeploy) et tester le web service Rest (clic droit sur le
projet Test Restful Web Services. Quel résultat obtenez-vous et pourquoi?
 Insérer des données dans la table de votre base de données et vérifier que votre contexte
de persistence (fichier « persistence.xml ») est en mode create. Refaire le test des services
web. Sélectionner GET (application/xml) et cliquer sur Test. Quel résultat obtenez-vous et
pourquoi?
 Tester les différentes méthodes HTTP :
- GET : pour récupérer tous les hôtels et rechercher les hôtels par leur id.
- POST : pour créer un nouvel hôtel
- PUT : pour modifier un hôtel
- DELETE : pour supprimer un hôtel
 Créer deux méthodes    : une méthode de recherche par ville et une
méthode de recherche par prix et tester le service. Pour cela vous allez suivre les
indications suivantes :
-         
grâce au langage JPQL4. Une requête nommée est déclarée dans une annotation
@NamedQuery. Cette annotation prend deux attributs : name, qui porte le nom de la
requête, et query, qui porte la requête JPQL. Plusieurs annotations @NamedQuery
peuvent être regroupées dans une annotation @NamedQueries, qui prend un tableau de
3 
4 http://docs.oracle.com/cd/E17904_01/apirefs.1111/e13946/ejb3_langref.html

 -
Page 4
@NamedQuery en attribut. Ces deux annotations doivent être posées sur la classe d'une
entité JPA. Exemple : Une requête pour déterminer tous les hôtels :
@NamedQuery( name="findAllHotels", query="select c from Hotel c")
- Définir dans la classe du service « HotelFacadeREST.java » les méthodes qui vont
respectivement retourner la liste des hôtels par leur prix et la ville. La méthode de
          hôtel grâce à
EntityManager.createNamedQuery() en lui passant le nom de la requ
dans les annotations. Cette méthode renvoie un objet Query.
Vous allez donc compléter le code suivant :
//compléter la méthode HTTP utilisée pour déclencher cette méthode
…………..
//spécifier le type MIME de la réponse du service
…………………………………….
//compléter le chemin
……………..
public List<Hotel> findHotelsByVille(@PathParam("ville") String ville) {
Query query = em.createNamedQuery("compléter par le nom de la requête
nommée");
query.setParameter("ville", ville); // La méthode setParameter()
permet de fournir une valeur à chaque paramètre.
return query.getResultList();
}
o Sauvegarder et tester le service.
4. Développement d’un service REST pour la réservation d’hôtels
 -
a) Définition des relations entre les entités
 Il faut  ociation entre les deux tables en définissant les annotations
@OnetoMany et ManytoOne.

 -
Page 5
Il faut gérer la cascade en définissant une cascade de type ALL. En effet, on souhaite que
quand on supprime un hôtel, sa réservation soit également supprimée.
b) Mapping des entités à XML grâce à JAXB
 @XmlRootElement pour chaque classe entité.
 @XmlTransient pour chaque les getters.
a) Création d’une application client pour l’invocation du service Hôtel
 Générer les classes entité à partir de la base de données : NewEntity Classes from
Databases. Vous sélectionnerez la base de données HotelsBD et ajouterez les tables de la
base de données. Vous nommerez le package « ENTITE ».
        du client. Pour cela, vous allez faire
NewOtherWeb ServicesRestful Java Client. Vous nommerez la classe
« HotelCreateClient » et vous sélectionnerez la ressource REST correspondante. L'API client
de Jersey permet l'interopérabilité avec des web services Rest. Que comporte la nouvelle
classe générée ?
 Ajouter une méthode main dans la classe « HotelCreateClient».
public static void main(String args[])throws UniformInterfaceException
{
HotelCreateClient client=new HotelCreateClient ();
ClientResponse response=client.findAll(ClientResponse.class);
GenericType<List<Hotel>> genericType = new GenericType<List<Hotel>>() {};
// Retourne un tableau d’hôtels à partir du service web
List<Hotel> data= new ArrayList<Hotel>();
data=(response.getEntity(genericType));
Hotel H=new Hotel();
//ajouter les données sur l’hôtel que vous allez insérer
H.setAdresse("…….");
p.setNomhotel("……");
…… ;
client.create(p);
 Invoquer les autres opérations du service : recherche de tous les hôtels, recherche des
 Invoquer le service de géocodage de google pour déterminer les coordonnées
géographiques de vos hôtels.
 Invoquer maintenant le service de Réservation pour 
s, etc.
Développement du client