Pré-requis
Tiles pour pouvoir
être installer sur un serveur d'application nécessite un
certain nombre de composants pré-installés. Il faut
savoir
que tiles est au meme titre que Struts et les JSP (Java Server Page);
un système qui marche sur JAVA. Il faudra donc en premier lieu
un J2SDK
(Java Standard Developpement kit). Les autres composants sont les
suivants :
- Servlet Container compatible servlet v 2.2 et
JSP 1.1
- Un parseur XML vérifiant la norme JAXP
- (Struts)
Struts est entre parentèses car il est d'une part
nécessaire et non nécessaire. La partie de Struts
qui est nécessaire est le noyau "commons" de Struts. Le reste
n'est pas forcement à utiliser.
Enfin le principal reste de télécharger les
bibliothèques de Tiles soit sur le site officiel ou sur le
mirroir.
n
L'installation en Stand Alone
Fichiers
requis :
tiles.jar – dans WEB-INF/lib/
tiles.tld – dans WEB-INF/
commons-digester.jar – dans WEBINF/lib/
commons-collections.jar – dans WEBINF/lib/
commons-beanutils.jar – dans WEBINF/lib/ |
Tous ces
fichiers doivent venir de la distribution de Tiles. Ils sont
normalement situés dans le répertoire WEBINF/lib/ pour
les .JAR et dans WEBINF/ pour les fichiers .TLD.
Configuration
de Tiles :
Tiles peut
être utilisé sans Struts. Pour initialiser l'usine
à
définition de Tiles (le moteur), il faut configurer la servlet
fournit avec la distribution de Tiles. Cette configuration doit se
trouver dans le fichier web.xml de l'application web.
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>org.apache.struts.tiles.TilesServlet</servlet-class>
<init-param>
<param-name>definitions-config</param-name>
<param-value>/WEB-INF/tiles-defs.xml</param-value>
</init-param>
<init-param>
<param-name>definitions-parser-validate</param-name>
<param-value>true</param-value>
</init-param>
... |
Les
options de configurations de la servlet de controle de Tiles sont les
suivants :
- definitions-factory-class: (optionel)
- Nom de la classe
utilisé pour le moteur de Tiles. En effet il est possible de
développer son propre moteur et de le spécifier ici. Si
cette option n'est pas spécifié alors le moteur par
défaut est utilisé (appeler "I18N factory" par son
concepteur, I18N etant la contraction Internationnalisation - commence
par un 'I' fini par un 'N' et contient 18 lettre entre - )
- definitions-config: (optionel)
- Spécifie le
nom du ou des fichiers de configuration. Dans le cas où
plusieurs fichiers de configuration sont utilisés, il faut
utiliser des virgules pour séparer les fichiers.
- moduleAware: (optionel)
- Spécifie si
Tiles est utilisé dans un contexte de module. Si cette option
est mise a "true" alors pour chaque module de Struts et Tiles, une
instance du moteur sera initialisé. Dans le cas inverse, Il y
aura un moteur unique qui gerera chaque modules Struts / Tiles. Dans le
dernier cas, il est tout de meme nécessaire de déclarer
un plugin par module mais le moteur sera initialiser avec les
parametres du premier module qui est consideré comme module par
défaut.
- definitions-parser-validate:
(optionel)
- Spécifie si
un parseur XML doit être utilisé afin de valider le
fichier de configuration de Tiles. Si la valeur est a "true" alors la
DTD doit être spécifié dans l'entete du fichier de
configuration. Sinon il n'y aura pas de validation.
Les chemins
contenus dans le fichier de configuration sont relatif par rapport au
contexte de l'application internet.
L'installation de Tiles avec
Struts 1.0.X
Fichiers
requis :
tilesForStruts1.0.jar
– dans WEB-INF/lib/
tiles.tld
– dans WEB-INF/
struts.jar - dans WEB-INF/
commons-digester.jar – dans WEB-INF/lib/
commons-collections.jar – dans WEB-INF/lib/
commons-beanutils.jar – dans WEB-INF/lib/
et les fichiers propres à Struts 1.0
|
Les fichiers
tilesForStruts1.0.jar et tiles.tld sont disponibles dans la
distribution de tiles. Les autres sont disponible depuis l'archive
distribution de Struts 1.0.
Configuration
de Tiles :
Pour faire
fonctionner Tiles avec la version 1.0.X de Struts il faut utiliser une
version spéciale du moteur de Struts. Dans tous les cas il faut
effectuer cette déclaration dans le fichier web.xml de
l'application.
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>org.apache.struts.tiles.ActionComponentServlet</servlet-class>
<init-param>
<param-name>definitions-config</param-name>
<param-value>/WEB-INF/tiles-defs.xml</param-value>
</init-param>
<init-param>
<param-name>definitions-parser-validate</param-name>
<param-value>true</param-value>
</init-param>
...
</servlet> |
L'installation de Tiles avec
Struts 1.1.X
Tiles est maintenant
intégré aux versions Struts 1.1.X remplacant l'ancien
système de template. Il n'y a donc pas vraiment d'installation
de Tiles mais plutot une définition / activation du pluggin
Tiles dans Struts.
Fichiers
requis :
struts.jar
– dans WEB-INF/lib/
tiles.tld – dans WEB-INF/
Tous les fichiers commons-*.jar de Struts – dans WEB-INF/lib/
|
Tous
ces fichiers doivent venir de la distribution de Struts 1.1.X.
Configuration
de Tiles :
Voici un exemple de
configuration qui doit se trouver dans le
fichier web.xml de l'application web pour permettre le fonctionnement
de Tiles dans Struts 1.1.
<plug-in
className="org.apache.struts.tiles.TilesPlugin" >
<set-property property="definitions-config"
value="/WEB-INF/tiles-defs.xml,
/WEB-INF/tiles-tests-defs.xml,/WEB-INF/tiles-tutorial-defs.xml,
/WEB-INF/tiles-examples-defs.xml" />
<set-property property="moduleAware" value="true" />
<set-property property="definitions-parser-validate" value="true"
/>
</plug-in> |
|
