Formation Java WebServices

Accueil > Formations > WebServices

Preparation

Dans ce TD nous allons installer le serveur web Tomcat, le kit de developpement de webservice Axis et accessoirement l'utilitaire Ant.

Pour ces installations nous ne nous attarderons pas sur les details techniques et nous nous limiterons aux operations essentielles dans le but d'installer rapidement un environnement de developpement open source de Webservices.

Les instructions sont donnees pour Windows et Mac OS X.

Structure de repertoires

Pour commencer il faut creer l'architecture de repertoire suivante:

racine 
... 
 |-apache <-- repertoire de stockage des applications Apache/Jakarta 
 |-webservices <-- repertoire de stockage des TDs 
... 

Synopsis d'une installation

1. Telechargement de l'archive du logiciel (version binaire, les sources ne nous interesse pas ici)
2. Decompression de l'archive dans le repertoire apache
3. Renommage du repertoire nouvellement cree (par exemple renommer jakarta-ant-1.6.1 en ant)
4. Modification des fichiers de lancement de l'application en fonction de notre environnement
1. Mise en place de JAVA_HOME
2. Ajout eventuel des fichiers JARs aux chemins de classes
5. Test de l'application

Installation de Tomcat

Tomcat est un serveur web Java developpe par l'ApacheSoftwareFoundation. Il est utilise par Axis comme conteneur de webservices.

• Installation

Telecharger une version sur le site web de Jakarta, http://jakarta.apache.org/site/binindex.cgi. La version testee ici est la 4.1.30.

Decompresser l'archive dans le repertoire apache.

Dans l'exemple il s'agit du repertoire :

• d:\apache sous Windows
• /Users/lmaitre/apache/tomcat sous MacOSX

Renommer jakarta-tomcat-4.1.30 en tomcat.

Tomcat est maintenant installe dans le repertoire apache/tomcat.

• Configuration

Avant de lancer Tomcat, il faut le configurer pour notre environnement.

Pour cela, nous allons modifier le fichier de demarrage de Tomcat afin de lui preciser ou se trouve l'environnement Java sur notre machine et ou est installe Tomcat sur la machine.

Sous Windows, editer le fichier apache\tomcat\bin\catalina.bat et ajouter les lignes suivantes en debut de fichier:

@echo off 
rem Indique ou trouver l'executable Java et les classes de base 
set JAVA_HOME=c:\j2sdk1.4.1 
rem Indique l'emplacement d'installation de Tomcat - optionnel mais plus sur 
set CATALINA_HOME=d:\apache\tomcat 

Sous MacOSX, editer le fichier apache/tomcat/bin/catalina.sh et ajouter les lignes suivantes en debut de fichier:

# 
# Environment Variable Prequisites 
# 
JAVA_HOME=/Library/Java/home 
CATALINA_HOME=/Users/lmaitre/apache/tomcat 

• Test

Lancer tomcat :

• tomcat\bin\catalina.bat sous Windows,
• tomcat/bin/catalina.sh sous MacOSX.

Tester l'acces au serveur en allant a l'adresse http://127.0.0.1:8080 dans votre navigateur web. Effectuer quelques-uns des tests JSPs et servlets presentes sur la page d'accueil.

Installation de Axis

Axis est une boite a outils de classes Java pour les Websrvices developpee par l'ApacheSoftwareFoundation.

• Installation

Telecharger une version sur le site web d'Apache Webservices, http://ws.apache.org/axis/download.cgi. La version testee ici est la 1.1.

Decompresser l'archive dans le repertoire apache.

Renommer axis_1-1 en axis.

Il faut ensuite rendre Axis accessible sur le serveur Tomcat.

Modifier le fichier apache/axis/webapps/axis/WEB-INF/web.xml : enlever les commentaires autour de la servlet d'administration, qui permet d'installer les webservices a distance.

<!-- uncomment this if you want the admin servlet --> 
 
<!-- Enlever les commentaires autour de cette zone --> 
 
  <servlet-mapping> 
 
    <servlet-name>AdminServlet</servlet-name> 
 
    <url-pattern>/servlet/AdminServlet</url-pattern> 
 
  </servlet-mapping> 
 

Axis est maintenant installe dans le repertoire apache/axis et accessible a l'adresse http://127.0.0.1:8080/axis.

• Configuration

Pour compiler et executer des classes Java faisant appel a Axis il faut ajouter les archives Java suivantes au classpath :

• axis-1_1/lib/axis.jar : classes specifiques a Axis (implementation des suivantes)
• axis-1_1/lib/jaxrpc.jar : API Java API for XML Remote Procedure Call, api pour les appels de procedures distantes en encapsules en XML)
• axis-1_1/lib/saaj.jar : API SOAP with Attachments API for Java, api pour la manipulation de messages SOAP (messages en XML echanges lors des appels XML-RPC)
• axis-1_1/lib/commons-logging.jar : logging
• axis-1_1/lib/commons-discovery.jar : composants Apache pour les services de nommage et de decouverte
• axis-1_1/lib/wsdl4j.jar : utilitaires open source IBM pour transformer des fichiers Java en Webservice (generation de WSDL) et creer des squelettes de classes Java pour des webservices (generation de code source Java a partir de WSDL)

Vous pouvez ajouter ces fichiers dans votre classpath, dans un fichier appele run-ws.bat par exemple:

@echo off 
rem Set java home 
set JAVA_HOME=c:\jdk 
rem Set classpath 
set AXIS_LIB=d:/apache/axis/lib 
set CP=%CP%;%AXIS_LIB%/axis.jar 
set CP=%CP%;%AXIS_LIB%/jaxrpc.jar 
set CP=%CP%;%AXIS_LIB%/saaj.jar 
set CP=%CP%;%AXIS_LIB%/commons-logging.jar 
set CP=%CP%;%AXIS_LIB%/commons-discovery.jar 
set CP=%CP%;%AXIS_LIB%/wsdl4j.jar 
 
rem Launch java with the arguments given on the commad line 
rem %* contain all the arguments 
%JAVA_HOME%\java -classpath %CP% %* 

Pour compiler, creer un script du meme nom mais lancer javac et pas java a la derniere ligne.

Scripts pour Unix (MacOSX) : run-ws.sh compile-ws.sh

• Test

Pour tester l'installation d'Axis, acceder a la page de test d'Axis a l'adresse http://127.0.0.1:8080/axis/happyaxis.jsp.

Une page de diagnostics doit s'afficher, avec eventuellement quelques avertissements sans gravite.

Cette page peut indiquer xmlsec manquant par exemple, il s'agit d'un composant dedie a la securite (chiffrage des communications, signatures...) que nous n'emploierons pas dans le debut du TD.

Installation de Ant (optionnel)

Ant est un outil de support developpe par l'ApacheSoftwareFoundation. Il permet d'automatiser certaines taches fastidieuses telles que la recompilation du code, l'archivage en fichiers JARs,etc.

On peut ajouter de nouvelles taches a Ant, par exemple pour deployer une application web sur un serveur Tomcat ou generer des descripteurs de deploiements pour un webservice.

• Installation

Telecharger une version sur le site web de Ant, http://ant.apache.org/bindownload.cgi. La version testee ici est la 1.6.1.

Decompresser l'archive dans le repertoire apache.

Renommer apache-ant-1.6.1 en ant.

Ant est maintenant installe dans le repertoire apache/tomcat.

• Configuration

Avant d'utiliser Ant, il faut le configurer pour notre environnement.

Pour cela, nous allons modifier le fichier de lancement de Ant afin de lui preciser ou se trouve l'environnement Java sur notre machine et ou est installe Ant sur la machine.

Sous Windows, editer le fichier apache\ant\bin\ant.bat et ajouter les lignes suivantes en debut de fichier:

@echo off 
rem Indique ou trouver l'executable Java et les classes de base 
set JAVA_HOME=c:\j2sdk1.4.1 
rem Indique l'emplacement d'installation de Ant - optionnel mais plus sur 
set ANT_HOME=d:\apache\ant 

Sous MacOSX, editer le fichier apache/ant/bin/ant.sh et ajouter les lignes suivantes en debut de fichier:

# 
# Environment Variable Prequisites 
# 
JAVA_HOME=/Library/Java/home 
ANT_HOME=/Users/lmaitre/apache/ant 

Ensuite il faut ajouter le chemin vers le fichier ant.bat (ou ant.sh) dans les chemins examines par le systeme pour trouver les commandes executables.

Dans chaque console MS-DOS ou shells devant utiliser Ant, il faudra mettre a jour la variable d'environnement PATH pour qu'elle contiennent le chemin vers le repertoire des executables de ant.

Sous Windows taper a l'invite de commande :

set PATH=%PATH%;d:\apache\ant\bin 

set PATH=${PATH}:/Users/lmaitre/apache/ant/bin 

• Test

Lancer Ant :

ant 

Normalement le message suivant devrait s'afficher:

Buildfile: build.xml does not exist! 
Build failed 

Cela est normal car Ant utilise des fichiers, appeles conventionnellement build.xml, pour connaitre les taches qu'il doit effectuer dans un repertoire. Ant cherche donc ce fichier build.xml dans le repertoire courant et normalement n'en trouve pas, d'ou le message d'erreur.

A present, Ant, Axis et Tomcat sont installes sur notre machine, nous pouvons commencer a developper des Webservices.