Archivo web.xml

El archivo web.xml proporciona información sobre configuración y despliegue de los componentes web que componen una aplicación web.

La especificación Java™ Servlet define el archivo descriptor de despliegue web.xml en términos de documentos de esquema XML. Para la compatibilidad con versiones anteriores, cualquier archivo web.xml escrito en el servlet 2.2 o posterior que funcionaba en versiones anteriores de WebSphere Application Server está soportado por el contenedor web.

Si utiliza Rational Application Developer Versión 6 para crear los portlets, debe eliminar la siguiente referencia a std-portlet.tld del archivo 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>

Ubicación

El archivo web.xml debe residir en el directorio WEB-INF bajo el contexto de la jerarquía de directorios que existe para una aplicación web.

[AIX Solaris HP-UX Linux Windows][z/OS]Por ejemplo, si la aplicación es client.war, entonces el archivo web.xml se coloca en el directorio raíz_instalación/client war/WEB-INF.

[IBM i]Por ejemplo, si la aplicación es client.war, el archivo web.xml se coloca en el directorio raíz_perfil/installedApps/cellName/client.ear/client.war/WEB-INF (en una instalación predeterminada), donde la edición es base o WebSphere Application Server, Network Deployment, según la edición que esté utilizando.

Notas sobre la utilización

  • ¿Es este un archivo de sólo lectura?

    No

  • ¿Este archivo lo actualiza un componente del producto?

    La herramienta de ensamblaje actualiza este archivo.

  • Si es así, ¿qué activa su actualización?

    La herramienta de ensamblaje actualiza el archivo web.xml al ensamblar los componentes web en un módulo web, o si se modifican las propiedades de los componentes web o del módulo web.

  • ¿Cómo y cuándo se utiliza el contenido de este archivo?

    Las funciones de WebSphere Application Server utilizan la información de este archivo durante las fases de configuración y despliegue de desarrollo de la aplicación web.

Entrada de archivo de ejemplo

Supported configurations Supported configurations: El archivo web.xml no representa la configuración completa que está disponible para la aplicación web. Hay otros filtros de servlets y escuchas que se pueden definir utilizando las configuraciones mediante programación, anotaciones y fragmentos web. sptcfg
Avoid trouble Avoid trouble: Si se marca como completos los metadatos de la aplicación web, se impide que anotaciones y fragmentos web puedan configurar componentes.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>
Best practice Best practice: Para cada declaración <error-page>, seleccione <exception-type> o <error-code>, pero no ambos. La etiqueta <location> es necesaria.bprac

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_webxf
File name: rweb_webxf.html