Installation de Tomcat et plugin pour Eclipse

Tomcat est un moteur de servlets qui a été conçu en suivant le guide de référence officiel de l'implémentation des technologies Java Servlet et Java Server Pages (JSP).

Tomcat est l'un des composants du projet Jakarta, dont le but est de fournir des solutions "serveur" basées sur la plate-forme Java, de qualité identique aux applications commerciales mais développées avec l'esprit d'ouverture du logiciel libre. C'est un moteur de servlets qui a été conçu en suivant le guide de référence officiel de l'implémentation des technologies Java Servlet et Java Server Pages (JSP). Les spécifications de ces dernières sont élaborées par Sun selon le processus établi par la Java Community. Les JSP sont des pages contenant du code Java imbriqué dans du HTML.

Tomcat est indépendant de tout autre serveur. Le seul pré requis à son installation et à son utilisation est de disposer d'une machine virtuelle Java. (JVM)

Installation de Apache Tomcat 4.1

Commencez par télécharger le fichier d'installation. La dernière version stable est la 4.1.24.
Elle existe sous deux formes de package:

• Une version légère conçue pour être utilisé avec le JDK 1,4. Elle n'inclut aucun binaire facultatif ou parseur XML (pas nécessaire car ils sont inclus dans le JDK 1,4). Cette release peut être utilisée avec un JDK 1,2+ en ajoutant un parser XML. Ce package ne contient pas JavaMail, Java Activation Framework, Xerces, JNDI ou JDBC Standard Extension.
• la version standard inclut toutes les bibliothèques facultatives et un parser XML (Xerces 2,0,1), et peut être utilisé avec un JDK 1,2+.

Exécutez le programme d'installation. Celui-ci spécifie le JDK qu'il va utiliser

Nous laisserons les options d'installations par défaut.

Celle-ci inclut Tomcat, des raccourcis dans le menu démarrer, des documentations et des exemples. Par défaut le répertoire d'installation sera C:\Program Files\Apache Group\Tomcat 4.1 Il vous est ensuite demandé un numéro de port TCP, un nom d'utilisateur et un mot de passe.

Cette étape n'est pas nécessaire. Le port par défaut (comme vous pouvez le remarquer) sera 8080. L'installation étant terminée, vous pouvez d'ores et déjà démarrer votre serveur Tomcat. Pour cela cliquez sur Démarrer -> Programmes -> Apache Tomcat 4.1 -> Start Tomcat. Cela va lancer la console qui affichera les logs. Si vous fermez cette fenêtre, vous arrêterez (brutalement) le serveur. Ayant installé les exemples, vous pouvez déjà accéder à l'adresse http://localhost:8080 qui contient ces exemples et de nombreuses documentations. Pour arrêter le serveur (proprement) cliquez sur Démarrer -> Programmes -> Apache Tomcat 4.1 -> Stop Tomcat.

L'installation de Tomcat a crée plusieurs sous-dossiers dans le répertoire Tomcat 4.1. Voici les principaux:

• bin: Contient les exécutables
• conf: Contient les fichiers de configurations du serveur
• logs: Contient les fichiers de logs
• temp: Répertoire utilisé par la JVM pour les fichiers temporaires
• webapps: Répertoire contenant vos applications web chargées automatiquement
• work: Répertoire de travail temporaire pour les applications web

Si vous mettez vos applications dans le dossier webapp (utilisation standard), les URLs de vos applications suivront l'arborescence de ce dossier. Si par exemple vous créez un dossier mon_application, vous pourrez accéder à son contenu (web) via l'adresse http://localhost:8080/mon_application. Il est toutefois possible de configurer Tomcat pour qu'il fasse la jonction entre un autre dossier et une URL. Pour cela, il faudra éditer le fichier "config\server.xml" qui est le fichier de configuration le plus important. Il faudra rajouter par exemple : <Context path="/mon_application" reloadable="true" docBase="C:\developpement\mon_appplication_web" workDir="C:\developpement\mon_appplication_web\work\org\apache\jsp"/> entre les balises <Host> et </Host>

Installation du plugin Sysdeo

Le premier plugin que nous allons ajouter est celui de sysdeo spécifique pour Tomcat et dont les principales fonctionnalités sont les suivantes:

• Démarrer, arrêter et redémarrer Tomcat 4.x ou 3.3.
• Faire apparaître le processus Tomcat dans le débogueur d'Eclipse.
• Créer ou importer un projet WAR (mise à jour du fichier server.xml possible).
• Ajouter des projets Java au classpath de Tomcat.
• Paramétrer la machine virtuelle utilisée pour démarrer Tomcat : modifier les paramètres, le classpath et le bootclasspath.
• Exporter un projet Tomcat vers un fichier WAR.
• Choisir le fichier de configuration Tomcat à utiliser.

Choisissez votre version de Tomcat: dans notre cas, il s'agit de Version 4.1.x.
Spécifiez ensuite le répertoire contenant Tomcat (par défaut) C:\Program Files\Apache Group\Tomcat 4.1.
Le chemin du fichier de configuration server.xml sera alors automatiquement détecter.
Cliquer sur Apply puis OK.
Pour avoir les boutons de démarrage de Tomcat allez dans Window -> Customize Perspective... -> Other

Sélectionnez Tomcat puis OK
Vous devriez alors voir apparaître les icônes spécifiques à Tomcat. Ils servent respectivement à démarrer, arrêter et redémarrer votre serveur.

Installation du plugin Lomboz

Nous allons maintenant installer le plugin de Lomboz.
Lomboz est un plugin J2EE permettant de créer des applications Web. Il fournit un wizard pour la création de JSP. Il met en évidence les tags HTML et le code Java. Pour télécharger ce plugin, il vous sera demandé de vous enregistrer. Une fois téléchargé, décompressez le fichier lomboz.21_02.zip et placez le dossier com.objectlearn.jdt.j2ee qu'il contient dans votre dossier plugins d'Eclipse.
Vous n'avez qu'à redémarrer Eclipse pour profiter de ce nouveau plugin.

Utilisation concrète sous Eclipse

Nous allons commencer par créer un nouveau projet. Pour cela, cliquez sur File -> New -> Project..., choisissez Project Tomcat puis Next.
Donnez un nom à votre projet, par exemple appliweb et sélectionnez le répertoire à utiliser (par défaut ce sera le workspace d'Eclipse), puis Next.
Choisissez le nom du contexte. Il s'agit de l'adresse de votre application après le numéro de port. Par exemple : "http://localhost:8080/appliweb. Par défaut, ce sera le nom de votre projet. Vérifiez que Autoriser la mise à jour du fichier server.xml soit bien cochez.
Cliquez sur Finish

Un dossier appliweb a été crée (s'il n'existait pas déjà). Celui-ci contient un répertoire WEB-INF. C'est dans ce dossier que vous mettrez vos fichiers sources. Pour être plus exact, il faut mettre vos librairies (jar) dans WEB-INF\lib et vos fichiers sources dans WEB-INF\src. Vos JSP devrons se trouvez dans à la racine, surtout index.jsp qui sera appelée par défaut. Toutefois, pour une meilleure organisation vous devriez mettre les autres dans un dossier spécifique, par exemple appliweb\.
Si vous avez un problème de nom de package dans vos servlets du fait que vous les avez mis dans un dossier autre que la racine, sachez qu'il existe un patch fournit par Sysdeo. Il vous suffit de décompressez le zip dans le dossier common/classes de Tomcat.

Vous allez maintenant éditer votre première JSP.
Pour cela, faites un clic-droit sur le dossier racine de votre projet (appliweb) puis New -> Other..., développez Java -> Lomboz J2EE Wizards et sélectionnez Lomboz JSP Wizard. Attribuez-lui le nom index et cliquez sur Finish
A la place de Write your content here tapez:

Ouvrez un navigateur et tapez l'adresse http://localhost:8080/appliweb pour découvrir le résultat.

Quelques explications :
Dans une JSP le code Java doit être compris entre les balises <% et %>
Pour afficher le contenu d'une String, vous devez la placer entre les balises <%= et %>. Celle-ci peut très bien contenir du code HTML qui sera interpréter comme tel.
Pour importer un package, il faut utiliser <%@page import="chemin.nom_du_package.*" %>
Pour inclure une autre JSP, tapez <%jsp:include page="dossier/nom_jsp.jsp" />

Vous disposez maintenant des outils de base nécessaire pour développer une application Web en Java. Nous avons ici utiliser des plugins d'Eclipse, sachez que vous pouvez en trouver d'autres à l'adresse http://eclipse-plugins.2y.net/eclipse/plugins.jsp
Bon développement!