Installation d'un serveur XML

Temps 1h30 - 2h

Installation des parsers XML, d'un serveur Java et d'un système de publication XML.

Pour générer du XML, plusieurs techniques existent :

L'une de ces techniques consiste à envoyer des données XML brutes au navigateur, qui efffectue alors les transformations nécessaires (en HTML, en image, en voix...) avant de présenter l'information à l'utilisateur.
Une autre technique consiste à transformer les données sur le serveur avant de les envoyer dans un format directement affichable par le navigateur de l'utilisateur.

Dans le cadre de ce TP c'est la seconde solution qui a été retenue car il n'y a pas de navigateurs comprenant tous les ensembles et fonctionnalités de XML présentés.

Même si cette situation change (de plus en plus de navigateursd comprennent des sous-ensembles de XML, XSL, SVG et RDF en particulier) il est pour l'instant plus facile d'ajouter des mécanismes pour comprendre un dialecte de XML sur un serveur que sur une multitude de clients.

Bien sûr, il est toujours possible de mélanger les deux techniques dans une application utilisant XML.

Parsers xml

Les parsers XML sont des classes toutes prêtes pour lire des documents XML. Les parsers XML récents gèrent les XML schémas et permettent de valider un document.

Copier ou télécharger le Java XML Pack Fall 2001 et l'extraire dans le répertoire D:\xml.

http://java.sun.com/xml

Les archives qui contiennent les parsers XMl sont situées dans le répertoire D:\xml\java_xml_pack-fall01\jaxp-1.1.3

Pour pouvoir ensuite importer les classes Java pour parser du XML, ajouter les fichiers crimson.jar, xalan.jar à la variable d'environnement %CLASSPATH%.

Clic droit sur "Poste de travail" -> Propriétés -> Avancées -> Variables d'environnement

Créer la variable utilisateur CLASSPATH, valeur :

 set CLASSPATH=%CLASSPATH%;D:\xml\java_xml_pack-fall01\jaxp-1.1.3\crimson.jar;D:\xml\java_xml_pack-fall01\jaxp-1.1.3\xalan.jar

Noter la réutilisation d'une variable CLASSPATH existante, par l'utilisation de %CLASSPATH%.

La page installatation

Tomcat 4.0

Installer un serveur web (HTTP) qui utilise les servlets Java et les Java Server Pages.

Créer le répertoire D:\tomcat.

Copier ou télécharger Tomcat dans un répertoire temporaire.

http://jakarta.apache.org/tomcat

Il faut récupérer le fichier jakarta-tomcat-4.0.2-LE-jdk14.exe qui contient une version facilement installable de Tomcat 4.

Cette version nécessite le JDK v1.4, car elle utilise les parsers XML inclus dans le jdk depuis cette version. Les parsers XML installés a l'étape précedente permettent d'utiliser Tomcat 4 avec un jdk 1.3.

Installer Tomcat dans le répertoire D:\tomcat.

Régler les variables d'environnement

Vérifier que les variables d'environnement sont correctement positionnées :

D:\>echo %JAVA_HOME%
D:\jdk
D:\>echo %CLASSPATH%
D:\jdk\lib
D:\>echo %PATH%
D:\Perl\bin\;D:\WINNT\system32;D:\WINNT;D:\WINNT\System32\Wbem;D:\jdk\bin

Si besoin est configurer les variables conformément aux chemins d'installation des produits sur votre station :

D:\>set PATH=%PATH%;D:\jdk\bin

La notation utilisée dans cette partie pour positionner les variables d'environnement est celle à utiliser dans des scripts / fichiers batchs.

Copier les fichiers D:\xml\java_xml_pack-fall01\jaxp-1.1.3\crimson.jar (parser XML) et D:\xml\java_xml_pack-fall01\jaxp-1.1.3\xalan.jar (moteur de transformation xsl) dans le répertoire D:\tomcat\server\lib. Ces classes seront automatiquement chargées au démarrage de Tomcat.

Démarrer Tomcat :

D:\>cd tomcat\bin
D:\tomcat\bin>startup

(ou utiliser les commandes dans le menu Démarrer -> Programmes-> Apache Tomcat 4.0

Vérifier que l'installation de Tomcat a réussie :

http://localhost:8080/

Si ca ne marche pas du premier coup :

Il faut alors lancer Tomcat dans une fenêtre ms-dos :

D:\>cd tomcat\bin
D:\tomcat\bin>catalina run

Si Tomcat plante l'erreur est dans ce cas affichée dans la denêtre ms-dos.

La page d'accueil de Tomcat doit s'afficher.

Eteindre Tomcat

Utiliser CTRL+C dans la fenêtre d'exécution (console) Tomcat ou :

D:\tomcat\bin>shutdown

Cocoon 1.8 sous Win32

Cocoon est un système de publication XML. Avec Cocoon on peut utiliser, même sans programmer, les sous-ensembles de XML : XSP, XSL, XInclude, FO, SVG,...

Copier ou télécharger le fichier auto-extractible de Cocoon à l'adresse :

http://xml.apache.org/cocoon

On travaille avec la version 1.8.2 de Cocoon (téléchargeable dans le répertoire old du site apache).

Extraire Cocoon dans un répertoire temporaire. Ce répertoire sera appelé %COCOON% dans la suite de l'atelier

Suivre les étapes suivantes (il est possible qu'une erreur se soit glissée dans l'énoncé, penser à lire avant de copier-coller)

Compiler Cocoon
```
cd xml\cocoon
build
```
Créer le répertoire %TOMCAT_HOME%/webapps/cocoon
Créer le sous répertoire %TOMCAT_HOME%/webapps/cocoon/WEB-INF
Copier l'archive de cocoon (%COCOON%/bin/cocoon.jar ) et les librairies associées (%COCOON%/lib/*.jar) dans le répertoire %TOMCAT_HOME%/common/lib
Copier les bibliothèques de balises de Cocoon (%COCOON%/build/classes/*) dans le répertoire %TOMCAT_HOME%/common/classes

Copier le fichier de propriété de Cocoon (%COCOON%/cocoon.properties) et le fichier de description de l'application web.xml dans le répertoire WEB-INF
Modifier le fichier WEB-INF/web.xml en ajustant l'emplacement du fichier de propriété de Cocoon

<param-name>properties</param-name>
<param-value>/WEB-INF/cocoon.properties</param-value>

Modifier le fichier WEB-INF/cocoon.properties en ajustant l'emplacement des logicsheet de Cocoon :


processor.xsp.logicsheet.context.java  = file:///D:/tomcat/common/classes/org/apache/cocoon/processor/xsp/library/java/context.xsl
processor.xsp.logicsheet.cookie.java   = file:///D:/tomcat/common/classes/org/apache/cocoon/processor/xsp/library/java/cookie.xsl
processor.xsp.logicsheet.global.java   = file:///D:/tomcat/common/classes/org/apache/cocoon/processor/xsp/library/java/global.xsl
processor.xsp.logicsheet.request.java  = file:///D:/tomcat/common/classes/org/apache/cocoon/processor/xsp/library/java/request.xsl
processor.xsp.logicsheet.response.java = file:///D:/tomcat/common/classes/org/apache/cocoon/processor/xsp/library/java/response.xsl
processor.xsp.logicsheet.session.java  = file:///D:/tomcat/common/classes/org/apache/cocoon/processor/xsp/library/java/session.xsl
processor.xsp.logicsheet.util.java     = file:///D:/tomcat/common/classes/org/apache/cocoon/processor/xsp/library/java/util.xsl
processor.xsp.logicsheet.sql.java    = file:///D:/tomcat/common/classes/org/apache/cocoon/processor/xsp/library/sql/sql.xsl
processor.xsp.logicsheet.esql.java    = file:///D:/tomcat/common/class/org/apache/cocoon/processor/xsp/library/sql/esql.xsl
processor.xsp.logicsheet.fp.java     = file:///D:/tomcat/common/classes/org/apache/cocoon/processor/xsp/library/fp/fp.xsl

Ne pas hésiter à lire ces logicsheet a tête reposée; elles sont très instructives.

Ajouter le contexte Cocoon au serveur Tomcat.

Editer le fichier %TOMCAT_HOME%/conf/server.xml et ajouter :
```
 <Context path="/cocoon" docBase="cocoon" debug="0" reloadable="true">
</Context>
```
(au même niveau que les autres déclarations de contexte)

Démarrer Tomcat.

Vérifier que Cocoon est bien installé en tapant l'URL :

http://localhost:8080/cocoon/Cocoon.xml (attention c'est case sensitive)

La page de statut de cocoon doit s'afficher.

L'installation du serveur XML est terminée.

Post scriptum

L'installation de Cocoon comporte un répertoire samples qui contient des exemples d'utilisation de Cocoon.

Copier ce répertoire dans la webapplication Cocoon et tester les différents exemples.

D:\> copy -R %COCOON%/samples %TOMCAT%/webapps/cocoon

Certains exemples sont inopérants car les connections aux bases de données et annuaires LDAP n'ont pas étées configurées.