TP1 : Architecture Orientée Services

Ce TP vous guide dans la création et la consommation de services web à l’aide de l’IDE NetBeans et du serveur d’applications GlassFish. Vous apprendrez à développer un service web simple qui transforme une chaîne de caractères en majuscules, à le déployer, puis à créer un client Java capable d’interagir avec ce service. Ce TP nécessite un environnement Java EE avec NetBeans et GlassFish installés et configurés.

Objectifs

• Créer un service web simple avec NetBeans.
• Déployer un service web sur le serveur GlassFish.
• Consulter et tester un service web via son URL et son contrat WSDL.
• Générer automatiquement un client Java à partir d’un contrat WSDL.
• Utiliser un client Java pour appeler un service web et afficher les résultats.

Prérequis et configuration

• NetBeans IDE (version compatible avec GlassFish 4.1).
• Serveur d’applications GlassFish 4.1 installé et configuré.
• Connaissances de base en Java et développement web.
• Accès à un système Windows avec un répertoire utilisateur standard (exemple : C:\Utilisateurs\[votre login]\Documents\NetBeansProjects).
• Création préalable du dossier "NetBeansProjects" si absent.

Prise en main du serveur d’applications GlassFish

Cette étape permet de démarrer et de gérer le serveur GlassFish depuis NetBeans, ainsi que d’accéder à sa console d’administration.

1. Lancez NetBeans.
2. Dans l’onglet Services, développez Servers puis faites un clic droit sur GlassFish Server 4.1 et sélectionnez Start.
3. Une fois le serveur démarré, vous pouvez accéder à la console d’administration en faisant un clic droit sur GlassFish Server 4.1 et en choisissant View Admin Console.
4. La console s’ouvre dans un navigateur web et affiche une interface JSF pour gérer le serveur (applications déployées, maintenance, suivi, etc.).
5. Dans la console, cliquez sur Applications pour voir la liste des applications déployées.
6. Sélectionnez une application pour obtenir des informations détaillées, puis cliquez sur View Endpoint pour accéder au lien vers la page WSDL et à la page de test du service.

Un démarrage correct du serveur et l’accès à la console confirment que l’environnement est prêt.

Création d’un projet web « MajusculeAppli »

Vous allez créer un projet web Java qui servira de base au développement du service web.

1. Dans NetBeans, allez dans File > New Project.
2. Sélectionnez la catégorie Java Web puis Web Application.
3. Dans l’écran Name and Location, nommez le projet MajusculeAppli et enregistrez-le dans C:\Utilisateurs\[votre login]\Documents\NetBeansProjects.
4. Si le dossier NetBeansProjects n’existe pas, créez-le impérativement avant de continuer.
5. Dans l’écran Server and Settings, laissez les valeurs par défaut (GlassFish Server 4.1).
6. Dans l’écran Frameworks, laissez également les valeurs par défaut.
7. Cliquez sur Terminer pour créer le projet.

Le projet contient désormais la structure minimale d’une application web Java.

Développement du service web « MajusculeWS »

Vous allez créer un service web capable de transformer une chaîne de caractères en majuscules.

1. Dans le projet MajusculeAppli, faites un clic droit puis New > Others.
2. Dans la catégorie Web Services, sélectionnez Web Service et nommez-le MajusculeWS.
3. Placez ce service dans un package nommé resources.
4. Une fois le service créé, faites un clic droit sur MajusculeWS puis Add Operation.
5. Nommer l’opération Maj avec un type de retour String.
6. Dans le corps de la méthode Maj, ajoutez le code suivant pour convertir la chaîne en majuscules :

public String Maj(String txt) {
    return txt.toUpperCase();
}

7. Déployez l’application sur GlassFish en faisant un clic droit sur le projet puis Deploy.
8. Dans l’onglet GlassFish Server, notez l’URL à laquelle le service est accessible.
9. Accédez à cette URL dans un navigateur, ajoutez ?Tester à la fin pour afficher la page de test du service.
10. Vérifiez que la page affiche correctement le service et permet de tester l’opération Maj.

Un déploiement réussi et une page de test fonctionnelle confirment que le service est opérationnel.

Création d’un client Java pour le service web

Vous allez générer automatiquement un client Java capable d’appeler le service MajusculeWS.

1. Créez un nouveau projet Java Application nommé MajWebServiceClient dans le même répertoire C:\Users\[votre login]\Documents\NetBeansProjects.
2. Dans ce projet, lancez l’assistant de création de client web service via File > New File > Web Services > Web Service Client.
3. Dans l’écran WSDL and Client Location, sélectionnez WSDL URL et saisissez l’URL du contrat WSDL de votre service MajusculeWS.
4. Indiquez un nom de package Java pour les classes générées automatiquement, puis cliquez sur Finish.
5. Observez les ressources créées automatiquement dans le projet, notamment le dossier Web Service References contenant les classes proxy et les opérations disponibles.

Le client est maintenant prêt à être utilisé pour invoquer le service.

Utilisation du client dans une application Java

Vous allez écrire une classe Java avec une méthode main qui appelle l’opération Maj du service via le client généré.

1. Dans le projet MajWebServiceClient, créez une nouvelle classe Java.
2. Faites apparaître le contenu du dossier Web Service References pour voir les opérations disponibles.
3. Sélectionnez l’opération Maj et glissez-la dans la classe Java, sous la méthode main. Cela génère une méthode statique pour appeler le service.
4. Dans la méthode main, appelez cette méthode en lui passant une chaîne de caractères en minuscules, puis affichez le résultat retourné.
5. Exemple de code :

public class Client {
    public static void main(String[] args) {
        String resultat = MajusculeWS.Maj("bonjour");
        System.out.println("Résultat : " + resultat);
    }
}

6. Faites un Clean and Build puis Run sur le projet.
7. Vérifiez dans l’onglet de sortie que la chaîne est bien convertie en majuscules.

Résultats attendus

• Le serveur GlassFish démarre sans erreur et la console d’administration est accessible.
• Le projet MajusculeAppli est créé dans le bon répertoire et déployé avec succès.
• Le service web MajusculeWS expose une opération Maj qui transforme une chaîne en majuscules.
• La page de test du service affiche un formulaire permettant de saisir une chaîne et d’obtenir sa version en majuscules.
• Le client Java MajWebServiceClient contient les classes proxy générées automatiquement à partir du WSDL.
• La méthode Maj appelée depuis le client retourne bien la chaîne en majuscules, par exemple "bonjour" devient "BONJOUR".

Pièges courants

• Répertoire de projet incorrect : Ne pas créer le projet dans le dossier NetBeansProjects empêche le déploiement sur GlassFish.
• Serveur GlassFish non démarré : Le service ne sera pas accessible et le déploiement échouera.
• URL WSDL incorrecte : Lors de la création du client, une URL erronée empêche la génération des classes proxy.
• Oubli de déployer le projet après modification : Les changements dans le service ne seront pas pris en compte.
• Mauvaise gestion des packages : Le service web et le client doivent utiliser les bons packages pour éviter des erreurs de compilation.
• Ne pas tester le service via la page de test GlassFish : Cela permet de valider rapidement le fonctionnement avant de créer le client.