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


<?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>
