UNIVERSITE GASTON BERGER Master 2ITIC en ligne

DE SAINT-LOUIS
Introduction aux Services Web

cheikh.ba.
ba.sn@gmail.com

TP Services Web
SOAP (Apache-Axis)
(Apache & REST (JAX-RS - Jersey)
Séance 1 – WS-*:
Mise en place de l’Environnement de travail

RAPPEL :
Il y a deux classes majeures de services web : (1) Les services web de type REST
(Representational
Representational State Transfer)
Transfer) qui exposent des fonctionnalités comme un ensemble de
ressources (URI) identifiables et accessibles par la syntaxe et la sémantique du protocole
HTTP. (2) Les Services Web étendus (WS-*) qui exposent ces mêmes fonctionnalités sous la
forme de services exécutables à distance, et reposent sur les standards SOAP et WSDL avec
un objectif d’interopérabilité.

Les toutes premières séances de TP concerneront les services Web étendus. Les services Web
REST seront abordés par la suite. Il faut noter que les contenus dess TPs ne sont pas
strictement liés aux (blocs de) chapitres dans lesquels ils sont enregistrés.

PREAMBULE Séance 1 – WS-*:

L’objectif de cette première séance de TP est de mettre en place l’environnement de travail, à
savoir l’installation et la configuration de la plateforme Apache-Axis. Le serveur Axis est
installé comme une application Web au sein du moteur de Servlets/Jsp Tomcat.
Tomcat Vous devez,
pour accéder aux fonctionnalités
fonctionnalité d’Axis, activer préalablement
alablement le serveur web Tomcat.

Pour cette séance de TP, vous aurez besoin de ressources qui se situent dans le dossier
« Ressources TP 1 – Environnement de travail » du bloc du chapitre 2 : SOAP. Les
fichiers sont axis.zip, Jars.zip et tomcat.zip. Vous dézipperai les contenus de ce dossier
quelque part sur votre machine.
La figure suivante est une illustration des différentes étapes suivies lors d’une requête/réponse
(XML/)SOAP(/http):

OBJECTIFS Séance 1 – WS-*: Installation de Java, de Tomcat et d’Axis.

PREREQUIS : Notions de moteur de servlet (ici Tomcat), de configuration système

(variables d’environnement), d’archives java (.jar).

I. INSTALLATION DE L’ENVIRONNEMENT DE TRAVAIL

Toutes les séances de TP peuvent se faire sous n’importe quel Système d’Exploitation :
Linux, Windows ou Mac. Cependant les instructions données ici ne concerneront que le
Système d’Exploitation Windows XP Service Pack 3. La différence avec les autres systèmes
se trouve tout simplement sur la manière de configurer les variables d’environnement. Pour
les autres versions de Windows, vous devez aussi savoir comment créer des variables
d’environnement. Les instructions pour créer des variables d’environnement sous Windows
XP Service Pack 3 sont celles qui sont données dans ce TP. La procédure doit être à peu près
similaire pour ces autres versions de Windows.

I.1 Installation de Java

Vous devez disposer d’un environnement de programmation Java, c’est à dire, du JDK 1.5 ou
supérieur. Cet environnement vous permettra de compiler vos classes Java qui feront office de
services web. Donc il vous faut installer le JDK si toutefois vous ne l’avez pas déjà sur votre
machine.

2/6
L’environnement de développement intégré Eclipse ou tout autre IDE n’est pas nécessaire,
mais peut s’avérer utile.

A ce stade, nous supposons que vous avez un JDK 1.5 ou supérieur

installé sur votre machine

I.2 Variables d’environnement JAVA_HOME et PATH

Après avoir installé Java, il vous faut configurer deux variables d’environnement, à savoir
JAVA_HOME et PATH. Pour rappel, JAVA_HOME sera utilisé par Tomcat, et PATH
servira à pouvoir lancer les commandes javac et java à partir d’un terminal, quel que soit le
répertoire dans lequel nous nous trouvons.

En supposant que «C:\Java\jdk1.6» est le dossier d’installation de java, vous ajouterez ces
variables d’environnement en faisant :

a. Menu Démarrer Bouton droit sur Poste de travail Propriétés Avancé

Bouton Variables d’environnement.

3/6
 b. Créer (bouton Nouveau) les nouvelles variables JAVA_HOME (valeur
C:\Java\jdk1.6) et PATH (valeur C:\Java\jdk1.6\bin) dans la partie Variables
utilisateur. Valider par OK après chaque ajout de variable.
c. Valider (bouton ”OK”) pour sortir de la zone de variables d’environnement.

Je rappelle que nous avons supposé que «C:\Java\jdk1.6» est le dossier d’installation de
java. Si vous avez un autre répertoire d’installation, il vous faudra bien évidemment adapter
les valeurs données aux variables PATH et JAVA_HOME.

d. Pour vérifier que tout s’est bien passé, au moins pour la variable PATH, ouvrez un
terminal DOS et lancer les commandes « java -version » et « javac -version »
décrites dans l’image suivante. ATTENTION : les variables d’environnement ne
sont visibles qu’avec les terminaux ouverts (lancés) après leurs créations !

A ce stade, nous supposons que Java est bien configuré.

4/6
 I.3 Installation de Tomcat
Comme cela a été annoncé, nous allons utiliser Tomcat pour héberger l’application Axis.
Dans notre cas, l’installation de Tomcat consistera tout simplement à copier un dossier et à
créer une variable d’environnement CATALINA_HOME.

a. Crée un dossier de travail nommé TPWS. Pour la suite, je suppose que vous avez
créé ce dossier sur la racine C:\, et donc le chemin à considérer est C:\TPWS.
b. Copiez le dossier « tomcat » dans le répertoire C:\TPWS. Bien sûr, pour obtenir
le dossier « tomcat » il faut dézipper le fichier tomcat.zip du dossier de ressource.
c. Créez la variable d’environnement CATALINA_HOME en lui donnant la valeur
C:\TPWS\tomcat. Voir la partie I.2 pour la création de variables d’environnement

Encore une fois, la valeur de la variable dépend de l’emplacement de TPWS.

d. Pour lancer le serveur tomcat, allez dans le dossier C:\TPWS\tomcat\bin et

double-cliquez sur le fichier « statup.bat ».
e. Lancez un navigateur (Firefox, Internet Explorer, Google Chrome, etc..) et chargez
la page d’adresse « http://localhost:8080/ ». Si tout a été bien fait, vous devrez voir
apparaître la page d’accueil de Tomcat.

f. Arrêtez le serveur tomcat en double-cliquant sur le fichier « shutdown.bat ».

NOTE: Le serveur tomcat écoute donc par défaut sur le port 8080. En faisant les
manipulations du TP, vous ne devez pas avoir un autre serveur qui écoute sur le port
8080, au risque de devoir changer un des ports.

5/6
II. INSTALLATION ET TEST DE L’APPLICATION WEB AXIS
Dans cette partie, nous allons installer Axis, c'est-à-dire, nous allons dire à Tomcat d’héberger
l’application web Axis. Cela consiste simplement à copier le répertoire du projet Axis à un
endroit particulier de tomcat

a. Copiez le répertoire « axis » dans le répertoire C:\TPWS\tomcat\webapps.

b. Relancez le serveur Tomcat (voir I.3.d pour un rappel sur comment lancer tomcat)
c. Chargez la page d’adresse « http://localhost:8080/axis/ ». Vous devrez voir
apparaître le message de bienvenue d’Axis.

En fait, Axis a besoin d’un certain nombre de packages java (fichier .jar) pour le traitement
de requêtes SOAP. Ces packages doivent être dans le dossier « lib » de l’application web
(c'est-à-dire dans « C:\TPWS\tomcat\webapps\axis\WEB-INF\lib »). Vous pouvez vérifier
qu’ils y sont déjà. Vous pouvez aussi vérifier que Axis a bien retrouvé ces composants, en
cliquant sur le lien « Validation » de la page d’accueil Axis. Plus tard, lors des autres
séances de TP, vous aurez besoin de mettre des liens vers ces fichiers .jar dans une variable
d’environnement « CLASSPATH » pour la création d’applications clientes.

Fin de la fiche de TP 1.

6/6