Guide d`utilisation de WTP (Web Tools Platform)

Guide d’utilisation de WTP
(Web Tools Platform)
Version : 1.0
Date : 7 juin 2006
Auteur : Denis MARCHAL
GUIDE D’UTILISATION DE WTP (WEB TOOLS PLATFORM)........................................................................... 1
1.1
1.2
1.3
1.3.1
1.3.2
1.3.3
1.3.4
1.3.5
1.4
1.4.1
1.4.2
1.4.3
1.4.4
1.4.5
1.5
1.5.1
1.5.2
DESCRIPTION ............................................................................................................................................................ 3
DECLARATION DES CONTENEURS ET SERVEURS D'APPLICATIONS ......................................................................... 3
CREATION D’UNE APPLICATION WEB DYNAMIQUE ................................................................................................ 3
COMMENT FAIRE ?.................................................................................................................................................. 4
LA PERSPECTIVE J2EE ............................................................................................................................................ 4
LA STRUCTURE D’UNE APPLICATION DYNAMIQUE SOUS WTP (PERSPECTIVE J2EE)............................................... 4
AJOUT D’UNE PAGE JSP .......................................................................................................................................... 4
AJOUT D’UNE SERVLET ........................................................................................................................................... 4
EXECUTION D’UNE APPLICATION WEB DYNAMIQUE SOUS TOMCAT ...................................................................... 4
DECLARATION D’UN SERVEUR D’APPLICATION ....................................................................................................... 4
PUBLICATION DE L’APPLICATION ............................................................................................................................ 5
ARRET-DEMARRAGE DU SERVEUR .......................................................................................................................... 5
CONFIGURATION AVANCEE D’UN SERVEUR D’APPLICATION TOMCAT..................................................................... 5
GESTION DES ESPACES DE PUBLICATION ................................................................................................................. 6
MIGRATION D’UN PROJET VERS WTP..................................................................................................................... 7
1IER CAS : UTILISATION DU PROJET AVEC WTP SANS MODIFICATION DE STRUCTURE .............................................. 7
2IEME CAS : MIGRATION DU PROJET AU FORMAT « DYNAMIC WEB PROJECT » .......................................................... 7
Guide d’utilisation de WTP
2/8
1.1 Description
Dans l’atelier de développement V2, Eclipse a été doté de la plate-forme WTP (Web Tools Platform). Cette
plate-forme a pour but d’enrichir Eclipse avec des outils permettant de développer des applications web
J2EE. Elle inclut :
• Des éditeurs pour les langages de pages web (HTML, CSS, Javascript)
• Des éditeurs pour des documents XML et associés (XML, DTD, XSD et WSDL)
• Le support de projet J2EE via des assistants
• Le support des services web via des assistants
• Le support des bases de données via SQL
La plate-forme WTP est composée de deux sous projets :
• Web Standard Tools (WST) : socle pour le développement d'applications web sous Eclipse.
• J2EE Standard Tools (JST) : plug-ins pour faciliter le développement d'applications respectant la
norme J2EE 1.4.
Le site officiel du projet WTP est à l'adresse http://www.eclipse.org/webtools/
1.2 Déclaration des conteneurs et serveurs d'applications
WTP supporte plusieurs conteneurs et serveurs d'applications : Tomcat, Jonas, Jboss, WebSphere,
Weblogic…
Les conteneurs et serveurs d’application que vous souhaitez utiliser doivent être déclarés dans les
propriétés d’Eclipse (Menu Fenêtre > Préférences > Server > Intalled runtimes). Cette opération est faite
automatiquement par l’atelier de développement lors de son lancement, en fonction des moteurs installés
sur le poste (moteur du socle Java exclusivement).
1.3 Création d’une application Web dynamique
WTP propose des fonctionnalités pour faciliter le développement d'applications Web (Java / JSP par
exemple).
Guide d’utilisation de WTP
3/8
Pour développer une application web, il est nécessaire de créer un projet de type « Dynamic Web project ».
Ce type de projet est un projet Java possédant une organisation particulière et configuré pour fonctionner
sur un serveur d’application (un de ceux qui ont été déclarés).
1.3.1 Comment faire ?
La création d’un nouveau projet dynamique Web est présentée dans cette vidéo
1.3.2 La perspective J2EE
WTP apporte une nouvelle perspective à Eclipse nommée J2EE. Cette perspective propose un explorateur
de projet classant les projets selon leur type (Application clientes, Web dynamique, EJB, Connecteur, …) et
quelques vues supplémentaires utiles au développement d’application J2EE.
1.3.3 La structure d’une application dynamique sous WTP (perspective J2EE)
Lien vers le descripteur
d’application
Dossier pour les sources Java
Dossier pour les
classes Java compilées
Bibliothèques de Tomcat
Bibliothèques de WEB-INF/lib
Dossiers contenant les
pages HTML et JSP, les
feuilles de style, les
images…
Descripteur d’application
Les noms des dossiers « src » et « WebContent » peuvent être modifiés via l’assistant de création du projet
ou ultérieurement.
1.3.4 Ajout d’une page JSP
L’ajout d’une page JSP dans le projet dynamique Web est présentée dans cette vidéo
1.3.5 Ajout d’une servlet
L’ajout d’une servlet dans le projet dynamique Web est présentée dans cette vidéo
1.4 Exécution d’une application Web dynamique sous Tomcat
1.4.1 Déclaration d’un serveur d’application
Pour exécuter une application Web dynamique, il faut la déployer sur un serveur d’application (Tomcat par
exemple).
Dans la perspective J2EE, la vue « Servers » affiche la liste des serveurs disponibles et permet de les gérer
(arrêt, démarrage, publication…).
Guide d’utilisation de WTP
4/8
Remarque : il ne faut pas confondre un serveur et un « moteur de serveur » (runtime server) : un serveur
s’appuie sur un moteur et contient une configuration qui lui est propre. Au besoin, on peut déclarer plusieurs
serveurs sur le même moteur.
La déclaration d’un nouveau serveur est présentée dans cette vidéo
1.4.2 Publication de l’application
La publication d’une application sur un serveur consiste à ajouter le projet de l’application dans la liste des
projets pris en compte par le serveur. Ceci peut se faire de différentes façons.
Une façon de publier une application sur un serveur Tomcat est présentée dans cette vidéo
1.4.3 Arrêt-Démarrage du serveur
Dans la vue « Servers », les icônes de droite permettent d’agir sur le serveur d’application.
Start mode
Debug
Start mode
normal
Restart
Stop
Publication des
applications
Dans la vue « Servers », la colonne « State » indique l’état de publication des applications et les besoins
d’intervention sur le serveur :
- synchronized = toutes les applications sont correctement publiée
- publish = vous devez publier manuellement les applications sur le serveur
- restart = vous devez redémarrer le server
Le changement d’état intervient en fonction des modifications faites sur l’application.
1.4.4 Configuration avancée d’un serveur d’application Tomcat
L’accès à la configuration du serveur d’application s’obtient en double-cliquant sur le serveur dans la vue
« servers ».
La fenêtre suivante apparaît :
Guide d’utilisation de WTP
5/8
Choix du
« runtime server »
Accès au propriétés
de lancement (1)
Choix du lieu de
publication (2)
Paramètres de
publication (3)
Gestion des
ports
Gestion des
types « MIME »
Accès à l’onglet
« Modules » (4)
(1) l’accès aux propriétés de lancement permet notamment d’ajouter des arguments pour la machine
virtuelle Java sous-jacente au serveur d’application.
(2) Par défaut, WTP ne publie pas les applications (modules) dans le répertoire « webapps » où est
installé Tomcat, mais il créé une arborescence de publication dans son workspace (voir ci-dessous)
dans laquelle il place une copie des fichiers de configuration de Tomcat et les applications. Ainsi, la
configuration initiale du Tomcat n’est pas modifiée par WTP.
Ceci n’est valable que si la case « Run modules directely from the workspace » est cochée. Ce qu’il
est fortement conseillée de faire.
(3) Les paramètres de publication par défaut sont aussi accessibles via les propriétés d’Eclipse (Menu
Fenêtre > Préférences > Server)
(4) L’onglet « Modules » est une autre façon de gérer les applications prises en compte par ce serveur
d’application. Il permet en outre d’ajouter des applications externes à Eclipse.
1.4.5 Gestion des espaces de publication
Comme on l’a vu ci-dessus, WTP créé une arborescence de publication dans son workspace. On retrouvera
cet espace sous
D:\[idep]\Données d'applications\eclipse_workspace\.metadata\.plugins\
org.eclipse.wst.server.core\tmpX
Où X est un numéro correspondant au serveur d’application.
On retrouvera dans cet espace les dossiers « conf », « logs », « temp », « webapps » et « work » dans le
cas d’un serveur d’application Tomcat.
Le dossier « conf » contient une copie des fichiers de configuration initiaux de Tomcat, mis ensuite à jour par
WTP pour y ajouter les contexte des applications déployées. Ces fichiers sont accessibles à partir d’Eclipse
dans un projet nommé « Servers » créé automatiquement.
Guide d’utilisation de WTP
6/8
Remarque : en cas d’incident lors de la publication d’une application dans un serveur depuis Eclipse, il est
conseillé de procéder de la façon suivante :
1) arrêter le server
2) retirer le projet de la liste des projets gérés par le serveur (attendre la fin de la phase de publication)
3) ajouter le projet dans la liste des projets gérés par le serveur (attendre la fin de la phase de
publication)
4) démarrer le serveur
Si le dysfonctionnement persiste, il faut supprimer manuellement l’arborescence de publication (dossier
tmpX) entre les étape 2 et 3.
1.5 Migration d’un projet vers WTP
Un projet développé avec une version antérieure de l’atelier de développement ou avec un autre outil ne
comprenant pas WTP ne sera pas reconnu dans l’atelier de développement V2 comme une application de
type « Dynamic Web Project ». Il ne bénéficiera pas des avantages liés à cette plate-forme.
Remarque : la version d’Eclipse fournie avec l’atelier de développement V2 offre de nombreuses possibilités
d’importation de projet. Cela permet d’importer dans le workspace des projets stockés à des endroits divers
(dans un autre workspace, sur le système de fichiers, sur ftp, etc) et dans des formats divers (projet eclipse
version antérieure, fichier WAR, fichier EAR, etc).
1.5.1 1ier cas : Utilisation du projet avec WTP sans modification de structure
On se place ici dans le cas où on souhaite simplement pouvoir exécuter le projet dans un serveur
d’application Tomcat, sans pour autant modifier la structure et l’organisation du projet. Cela est possible en
déclarant le projet dans le serveur d’application comme un module Web externe.
La déclaration d’un projet comme un module web externe est présentée dans cette vidéo
1.5.2 2ième cas : Migration du projet au format « Dynamic web Project »
Pour profiter pleinement de la plate-forme WTP et pour harmoniser l’organisation des projets web de
l’institut, il est recommandé de transformer le projet initial en un projet web dynamique.
La démarche à suivre est la suivante :
1) créer un nouveau projet de type « Dynamic Web Project » comme expliqué ci-dessus en prenant
soin de choisir le bon serveur d’application.
2) Copier-coller les éléments de l’ancien projet vers les dossiers adéquats dans le projet Web
dynamique :
a. Les librairies complémentaires Æ WebContent/WEB-INF/lib
b. Les sources java et divers fichiers de propriétés Æ src
c. Les éléments de présentation (jsp, image, css…) Æ WebContent
d. Le descripteur d’application (web.xml) et les autres ressources (librairies de tags…) Æ
WebContent/WEB-INF
3) Vérifier le bon fonctionnement de votre application en la déployant sur le serveur d’application
Guide d’utilisation de WTP
7/8
4) Déconnecter l’ancien projet du référentiel CVS
5) Partager le nouveau projet sur le référentiel CVS
La migration d’un projet en un projet web dynamique est présentée dans cette vidéo
Guide d’utilisation de WTP
8/8