Installation et test des outils
Table of Contents
Prérequis
Java 6
- Installer Java 6.
- Toutes plates-formes : http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u45-oth-JPR
- Les utilisateurs de Linux peuvent aussi utiliser OpenJDK (depuis leur gestionnaire de paquets).
- Noter le répertoire d'installation.
Eclipse (Luna) - version JEE
- Toutes plates-formes: http://www.eclipse.org/downloads/packages/release/luna/sr2
- Installer la même version (en termes 32/64-bits) que celle choisie pour Java.
- Utiliser Eclipse avec Java 6 (lancement, compilateur, environnement d'exécution) :
- configurer votre système pour qu'il lance java du JRE 6,
- configurer Eclipse pour travailler avec Java 6 (Window > Preferences > Java > Compiler et JRE).
Tomcat 7.0.65
- Toutes plates-formes: https://tomcat.apache.org/download-70.cgi
- Télécharger le ZIP (y compris pour Windows: ne pas utiliser l'installeur).
- Les utilisateurs de Mac/Linux peuvent utiliser la tarball.
- Extraire dans un dossier utilisateur. Eviter les espaces dans le nom du chemin.
CXF 2.7.18
- Toutes plates-formes: https://cxf.apache.org/cxf-2718-release-notes.html
- Extraire dans un dossier utilisateur. Eviter les espaces dans le nom du chemin.
Configuration
- Lancer Eclipse (double-clic sur eclipse (Unix) / eclipse.exe (Windows) devrait suffire).
- Quitter l'écran d'accueil (le cas échéant).
Serveur
- Dans la fenêtre du bas réservée à l'administration, ouvrir l'onglet Servers et créer un nouveau serveur.
- Sélectionner Tomcat v7.0 Server et configurer ce serveur (répertoire d'installation, JRE 6).
- Terminer.
À ce stade, lancer le serveur à blanc pour vérifier que tout fonctionne:
- dans la vue Servers, sélectionner Tomcat v7.0 Server at localhost et cliquer sur la flèche verte.
CXF
- Dans la barre de menus, Window puis Preferences.
- Dans la liste (gauche), Web Services puis CXF 2.x Preferences.
- À droite de la liste (vide par défaut) de l'onglet CXF Runtime (1er onglet), Add….
- Sélectionner le dossier où CXF a été extrait puis Finish.
- Cocher le nouvel élément dans la liste (2.7.18 | [dossier] | Apache CXF).
- Dans Server and Runtime, choisir Apache cxf 2.x pour WS runtime et Tomcat v7 pour Server runtime.
- Cliquer sur OK pour fermer les préférences.
Test
Création du projet
- Dans la barre de menus: File puis New puis Dynamic Web Project.
- Entrer le nom CxfExemple puis cliquer sur Finish.
Création d'un bean
- Déplier le projet dans la vue Project Explorer (par défaut à gauche de l'écran).
- Créer un package fr.emn.soc.example (clic-droit sur src, puis New puis Package).
- Déplier Java Resources.
- Créer une classe Personne (clic-droit sur fr.emn.soc.example puis New puis Class).
- Créer le champ private String nom.
- Générer le constructeur vide (dans la barre de menus: Source, Generate Constructors from Superclass, OK).
- Génerer les getters/setters (Source, Generate Getters and Setters, Select all, OK).
- Sauvegarder le fichier.
Code à obtenir
public class Personne { private String nom; public Personne() { super(); } public Personne(String nom) { super(); this.nom = nom; } public String getNom() { return nom; } public void setNom(String nom) { this.nom = nom; } }
Création d'un service
- Dans Project Explorer, clic-droit sur Personne.java puis Web Services puis Create Web Service.
- Placer les deux curseurs verticaux aux maximum pour génerer tout le code serveur et client.
- Vérifier la configuration 'server runtime et web services runtime) et l'ajuster si nécessaire.
- Cliquer sur Finish.
Test
Une fenêtre de test devrait s'afficher dans le navigateur par défaut. Elle n'est pas très utile à ce niveau, mais son existence prouve que le service est démarré.
- Personnaliser l'application cliente en modifiant la fonction principale de Personne_PersonnePort_Client, qui a été engendrée automatiquement.