Fichier web.xml
Le fichier web.xml fournit des informations de configuration et de déploiement pour les composants d'une application Web.
La spécification Java™ Servlet définit le fichier du descripteur de déploiement web.xml sous forme d'un document de schéma XML. Pour la rétrocompatibilité, tout fichier web.xml écrit par rapport à la spécification Servlet version 2.2 ou ultérieure, qui fonctionnait dans les précédentes versions de WebSphere Application Server, est pris en charge par le conteneur Web.
<taglib id="PortletTLD">
<taglib-uri>http://java.sun.com/portlet</taglib-uri>
<taglib-location>/WEB-INF/tld/std-portlet.tld</taglib-location>
</taglib>
Emplacement
Le fichier web.xml doit résider dans le répertoire WEB-INF sous le contexte de la hiérarchie de répertoires de l'application Web à laquelle il est associé.
Par exemple, si l'application s'appelle client.war, le fichier web.xml réside dans le répertoire racine_installation/client war/WEB-INF.
Par exemple, si l'application est client.war, le fichier web.xml est placé
dans le répertoire
racine_profil/installedApps/cellName/client.ear/client.war/WEB-INF
(dans une installation par défaut), en fonction de l'édition utilisée : édition de base ou WebSphere
Application Server, Network Deployment.
Remarques d'utilisation
- Ce fichier est-il en lecture seule ?
Non
- Ce fichier est-il mis à jour par un composant produit ?
Ce fichier est mis à jour par l'outil d'assemblage.
- Auquel cas, qu'est-ce qui déclenche sa mise à jour ?
L'outil d'assemblage met à jour le fichier web.xml lors de l'assemblage des composants Web dans un module Web, ou lorsque vous modifiez les propriétés des composants Web ou du module Web.
- Comment et quand le contenu de ce fichier est-il utilisé ?
Les fonctions de WebSphere Application Server utilisent les informations contenues dans ce fichier pendant les phases de configuration et de déploiement du développement des applications Web.
Exemple de fichier
Configurations prises en charge: Le fichier web.xml ne représente pas la totalité de la configuration disponible pour
l'application Web.
D'autres filtres de servlet et écouteurs peuvent être définis à l'aide de
configurations programmées, d'annotations et de fragments Web. sptcfg
Eviter les incidents: Le fait de marquer
les métadonnées d'une application Web comme complètes (metadata-complete) empêche la configuration de ses composants par des annotations ou des
fragments Web.gotcha<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_9" version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
<display-name>Servlet 3.0 application</display-name>
<filter>
<filter-name>ServletMappedDoFilter_Filter</filter-name>
<filter-class>tests.Filter.DoFilter_Filter</filter-class>
<init-param>
<param-name>attribute</param-name>
<param-value>tests.Filter.DoFilter_Filter.SERVLET_MAPPED</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>ServletMappedDoFilter_Filter</filter-name>
<url-pattern>/DoFilterTest</url-pattern>
<dispatcher>REQUEST</dispatcher>
</filter-mapping>
<filter-mapping>
<filter-name>ServletMappedDoFilter_Filter</filter-name>
<url-pattern>/IncludedServlet</url-pattern>
<dispatcher>INCLUDE</dispatcher>
</filter-mapping>
<filter-mapping>
<filter-name>ServletMappedDoFilter_Filter</filter-name>
<url-pattern>ForwardedServlet</url-pattern>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
<listener>
<listener-class>tests.ContextListener</listener-class>
</listener>
<listener>
<listener-class>tests.ServletRequestListener.RequestListener</listener-class>
</listener>
<servlet>
<servlet-name>welcome</servlet-name>
<servlet-class>WelcomeServlet</servlet-class>
</servlet>
<servlet>
<servlet-name>ServletErrorPage</servlet-name>
<servlet-class>tests.Error.ServletErrorPage</servlet-class>
</servlet>
<servlet>
<servlet-name>IncludedServlet</servlet-name>
<servlet-class>tests.Filter.IncludedServlet</servlet-class>
</servlet>
<servlet>
<servlet-name>ForwardedServlet</servlet-name>
<servlet-class>tests.Filter.ForwardedServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>welcome</servlet-name>
<url-pattern>/hello.welcome</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>ServletErrorPage</servlet-name>
<url-pattern>/ServletErrorPage</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>IncludedServlet</servlet-name>
<url-pattern>/IncludedServlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>ForwardedServlet</servlet-name>
<url-pattern>/ForwardedServlet</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>hello.welcome</welcome-file>
</welcome-file-list>
<error-page>
<exception-type>java.lang.ArrayIndexOutOfBoundsException</exception-type>
<location>/ServletErrorPage</location>
</error-page>
<error-page>
<error-code>404</error-code>
<location>/error404.html</location>
</error-page>
</web-app>
Pratiques recommandées: Pour chaque déclaration <error-page>, sélectionnez <exception-type> ou <error-code>, mais pas les deux. La balise <location> est obligatoire.bprac
Rubrique de référence