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.

Si vous utilisez Rational Application Developer Version 6 pour créer vos portlets, vous devez supprimer la référence suivante au fichier std-portlet.tld du fichier web.xml :
<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é.

[AIX Solaris HP-UX Linux Windows][z/OS]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.

[IBM i]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 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 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 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

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_webxf
Nom du fichier : rweb_webxf.html