Arquivo web.xml

O arquivo web.xml fornece informações de configuração e de implementação para os componentes da Web que compreendem um aplicativo da Web.

A especificação Java™ Servlet define o arquivo do descritor de implementação web.xml em termos de um documento de esquema XML. Para compatibilidade com versões anteriores, qualquer arquivo web.xml gravado no Servlet 2.2 ou posterior que funcionava em versões anteriores do WebSphere Application Server é suportado pelo contêiner da web.

Ao usar o Rational Application Developer Versão 6 para criar portlets, deve-se remover a seguinte referência a std-portlet.tld do arquivo 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>

Local

O arquivo web.xml deve residir no diretório WEB-INF no contexto da hierarquia de diretórios que existe para um aplicativo da Web.

[AIX Solaris HP-UX Linux Windows][z/OS]Por exemplo, se o aplicativo for client.war, então, o arquivo web.xml será colocado no diretório install_root/client war/WEB-INF.

[IBM i]Por exemplo, se o aplicativo for client.war, o arquivo web.xml será colocado no diretório profile_root/installedApps/cellName/client.ear/client.war/WEB-INF (uma instalação padrão), no qual a edição será base ou WebSphere Application Server, Network Deployment, dependendo da edição que estiver sendo usada.

Notas sobre a Utilização

  • Este arquivo é somente leitura?

    NÃO

  • Este produto é atualizado por um componente do produto?

    Esse arquivo é atualizado pela ferramenta de montagem.

  • Se sim, quais acionadores ele atualiza?

    A ferramenta de conjunto atualiza o arquivo web.xml quando você monta componentes da Web em um módulo da Web ou quando você modifica as propriedades dos componentes da Web ou do módulo da Web.

  • Como e quando os conteúdos deste arquivo são utilizados?

    As funções do WebSphere Application Server usam informações nesse arquivo durante as fases de configuração e de implementação para o desenvolvimento de aplicativo da Web.

Entrada de Arquivo de Amostra

Configurações suportadas Configurações suportadas: O arquivo web.xml não representa a configuração inteira que está disponível para o aplicativo da Web. Há outros filtros de servlets e listeners que podem ser definidos usando configurações programáticas, anotações e fragmentos da Web. sptcfg
Evitar Problemas Evitar Problemas: Marcar os metadados de aplicativo da Web como concluídos impedirá que anotações e fragmentos da Web possam 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>
Boas Práticas Boas Práticas: Para cada declaração <error-page>, selecione <exception-type> ou <error-code>, mas não os dois. A tag <location> é obrigatória.bprac

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_webxf
Nome do arquivo: rweb_webxf.html