INSTITUTO POLITCNICO NACIONAL

Ingeniera y Ciencias Fsico Matemticas

Escuela Superior de Computo

Ingeniera en Sistemas Computacionales

TAREA 5
Elementos y atributos del archivo web.xml

GRUPO: 3CM6
WEB APPLICATION DEVELOPMENT
PROFESORA:
ENRIQUEZ ZARATE JOSE ASUNCION

ALUMNO:
CUNJAM TORRES MAURICIO YEUDIEL

Elementos y atributos del archivo web.xml

Descriptor de despliegue
Un descriptor de despliegue (en ingls Deployment Descriptor) (DD) es un componente de
aplicaciones J2EE que describe cmo se debe desplegar (o implantar) una aplicacin web.
Esto dirige una herramienta de despliegue (o publicacin) para desplegar un mdulo o
aplicacin con opciones de contenedor especficas y describe requisitos de configuracin
especficos que puede resolver un desplegador.
En aplicaciones J2EE, XML se usa para la sintaxis del fichero descriptor de despliegue. Debe
ser llamado web.xml, y debe ser colocado en un subdirectorio llamado WEB-INF, directamente
debajo de la raz de la aplicacin web.
El trmino descriptor de despliegue tambin se usa como referencia general a un fichero de
configuracin para un artefacto que es desplegado en algn contenedor/motor (e.g. descriptor
de despliegue de proceso para el BPEL-Engine ActiveBPEL).

Ejemplo sencillo de un Descriptor de despliegue[editar]

<?xml version="1.0" encoding="UTF-8"?>
<web-app 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">
<servlet>
<servlet-name>HolaMundoServlet</servlet-name>
<servlet-class>org.prueba.servlet.HolaMundoServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>HolaMundoServlet</servlet-name>
<url-pattern>/HolaMundoServlet</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>30</session-timeout>
</session-config>
</web-app>

El archivo web.xml proporciona la configuracin y el despliegue de informacin para los

componentes web que conforman una aplicacin.

Este archivo debe residir en el directorio WEB-INF dentro del contexto de la jerarqua de
directorios que existen para una aplicacin Web. Por ejemplo, si la aplicacin esta
empaquetada en el archivo WAR "dukechile.war", el archivo web.xmlse debe colocar
en el directorio dukechile/ WEB-INF.
Como todos los archivos de configuracin xml, este contiene un esquema que describe
el contenido del fichero xml y la descripcin de las propiedades que va a utilizar. Dentro
de este archivo definiremos la configuracin de la aplicacin web que estemos
desarrollando.
Los elementos del web.xml son:
<web-app>: Es el elemento raz del fichero xml.
<icon>: Define la ruta para las imgenes asociadas a los iconos pequeo y grande que
representan a la aplicacin.
<display-name>: Es el nombre que representar a la aplicacin dentro de las
herramientas del servidor de aplicaciones, no es un nombre funcional.
<description>: Texto descriptivo de la aplicacin, que al igual que las dos anteriores
propiedades, slo es representativo.
<context-param>: Permite configurar parmetros de inicializacin del contexto de
nuestra aplicacin web.
<context-param>
<param-name>nombrehost</param-name>
<param-value>localhost</param-value>
<description> Nombre del host en cual se esta ejecutando la
aplicacion</description> </context-param>

<filter>: Permite definir un filtro en la aplicacin.

<filter>
<filter-name>LogSolicitudes</filter-name>
<filter-class>cl.bee.dukechile.LogSolicitudes</filter-class>
<init-param>

<param-name>nombrearchivo</param-name>
<param-value>registrolog</param-value>
</init-param>
</filter>
<filter-mapping>: Define un mapeo para aplicar las reglas de un determinado filtro a
una URL.

<filter-mapping>
<filter-name> LogSolicitudes </filter-name>
<url-pattern>/cl/jug/dukechile/*</url-pattern>
</filter-mapping>

<listener>: Permite definir una clase oyente, la que puede escuchar eventos
relacionados al clico de vida de la aplicacin o modificaciones de un objeto.

<listener>
<listener-class>cl.jug.dukechile.ListenerDeContexto</listener-class>
</listener>

<session-timeout>30</session-timeout>

<servlet>: Permite definir la configuracin de nuestros servlets.

<servlet>
<servlet-class>cl.jug.dukechile.MiServlet</servlet-class>
<init-param>
<param-name>configuracion</param-name>
<param-value>/WEB-INF/dukechile-config.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>: Permite relacionar los servlets que hemos declarado con las
URL que van a escuchar.
<servlet-mapping>
<servlet-name>DukeChile</servlet-name>
<url-pattern>*.jsp</url-pattern>
</servlet-mapping>

<session-config>: Permite definir el timeout de la sesin en minutos.

<session-config>
<session-timeout>10</session-timeout>
</session-config>

<mime-mapping>: Permite definir una relacin entre las extensiones y los tipos
mime.

<mime-mapping>
<extension>doc</extension>
<mime-type>application/vnd.ms-word</mime-type>
</mime-mapping>
<mime-mapping>
<extension>dsp</extension>
<mime-type>text/html</mime-type>
</mime-mapping>

<welcome-file-list>: Permite definir los ficheros de bienvenida de la aplicacion.

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
</welcome-file-list>

<tag-lib>: Permite definir las libreras de etiquetas de los ficheros JSP.

<jsp-config>
<taglib>
<taglib-uri>/tags/struts-bean</taglib-uri>
<taglib-location>/WEB-INF/struts-bean.tld</taglib-location>
</taglib>
</jsp-config>

<jsp-property-group<: Permite definir propiedades para un conjunto de JSP que

cumplan un patrn.

<jsp-config>
<jsp-property-group>
<url-pattern>*.jsp</url-pattern>
<include-prelude>/cabecera.jsp</include-prelude>
<include-coda>/pie.jsp</include-coda>
</jsp-property-group>
</jsp-config>

<error-page<: Permite asociar errores HTML y excepciones lanzadas por nuestra

aplicacin a pginas de error personalizadas para la aplicacin.
<error-page>
<error-code>404</error-code>
<location>/noEncontrado.jsp</location>
</error-page>
<error-page>
<exception-type>java.lang.Throwable</exception-type>
<location>/error.jsp</location>
</error-page>

<resource-ref<: Permite declarar recursos externos que nuestra aplicacin va a

utilizar. Por ejemplo, una conexin a una base de datos.

<resource-ref>
<description>Conexion BD</description>
<res-ref-name>jdbc/ConexionMySQL</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Container</res-auth>
</resource-ref>

<resource-env-ref<: Permite declarar recursos externos que nuestra aplicacin va a

utilizar. Este elemento es una nueva variacin del elemento aadido en Servlet 2.4 que es

ms simple de configurar para recursos que no necesitan informacin de autenticacin.

<resource-env-ref>
<resource-env-ref-name>jms/StockQueue</resource-env-ref-name>
<resource-env-ref-type>javax.jms.Queue</resource-env-ref-type>
</resource-env-ref>

<security-constraint<: Permite proteger reas de la aplicacin (o la aplicacin

completa), asocindolas a roles que deben tener los usuarios para poder acceder.
Estos usuarios y roles son los declarados en tomcat-users.xml(para el caso de
Tomcat).
<security-constraint>
<web-resource-collection>
<web-resource-name>Seguridad Duke Chile</web-resource-name>
<url-pattern>/*</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>duke</role-name>
</auth-constraint>
</security-constraint>

<login-config<: Permite configurar el tipo de login que se requerir al entrar en un

rea protegida previamente declarada.
<login-config>
<auth-method>FORM</auth-method>
<realm-name>Login por formulario</realm-name>
<form-login-config>
<form-login-page>/login.jsp</form-login-page>
<form-error-page>/error.jsp</form-error-page>
</form-login-config>
</login-config>

<security-role<: Permite definir los roles de usuarios que se van a utilizar en la

aplicacin.
security-role>
<role-name>duke</role-name>
</security-role>

<env-entry<: Permite declarar una posible entrada al entorno (environment) de la

aplicacin.
< env-entry>
<description>Mensaje de bienvenida</description>
<env-entry-name>bienvenida</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>Bienvenido al sistema DukeChile</env-entry-value>
</env-entry>

<ejb-ref<: Permite definir una referencia a un EJB.

<ejb-ref>
<description>EJB DukeChile</description>
<ejb-ref-name>ejb/DukeChileHome</ejb-ref-name>
<ejb-ref-type>Entity</ejb-ref-type>
<home>cl.jug.dukechile.DukeChileHome</home>
<remote>cl.jug.dukechile.DukeChile</remote>
</ejb-ref>

<ejb-local-ref<: Permite definir una referencia a un EJB Local.

<ejb-local-ref>
<ejb-ref-name>ejb/DukeChile</ejb-ref-name>
<ejb-ref-type>Session</ejb-ref-type>
<local-home> cl.jug.dukechile.DukeChileHome</local-home>
<local>cl.jug.dukechile.DukeChile</local>
<ejb-link>DukeChile</ejb-link>
</ejb-local-ref>

<distributable<: Permite definir que la aplicacin puede correr en un ambiente

cluster.
web-app>
<distributable/>
</web-app>