web.xml 文件

web.xml 文件提供有关包含 Web 应用程序的 Web 组件的配置和部署信息。

Java™ Servlet 规范根据 XML 模式文档来定义 web.xml 部署描述符文件。为了获取向后兼容性,Web 容器支持任何写入 Servlet 2.2 或更高版本且在 WebSphere® Application Server 的先前版本中工作的 web.xml 文件。

如果使用 Rational® Application Developer V6 来创建 portlet,则必须从 web.xml 文件中除去对 std-portlet.tld 的以下引用:
<taglib id="PortletTLD">
  <taglib-uri>http://java.sun.com/portlet</taglib-uri>
  <taglib-location>/WEB-INF/tld/std-portlet.tld</taglib-location>
</taglib>

位置

web.xml 文件必须位于 Web 应用程序所在的目录层次结构上下文下的 WEB-INF 目录。

[AIX Solaris HP-UX Linux Windows][z/OS]例如,如果应用程序是 client.war,那么 web.xml 文件放置在 install_root/client war/WEB-INF 目录。

[IBM i]例如,如果应用程序是 client.war,那么 web.xml 文件将放在 profile_root/installedApps/cellName/client.ear/client.war/WEB-INF 目录中(这是缺省安装中的情况),其中版本是 base 或 WebSphere Application Server Network Deployment,具体情况取决于您所使用的版本。

使用说明

  • 该文件是只读的吗?

  • 该文件是由产品组件更新的吗?

    此文件由组装工具更新。

  • 如果是,什么触发其更新?

    当您将 Web 组件组装到 Web 模块,或者当您修改 Web 组件或 Web 模块的属性时,组装工具会更新 web.xml 文件。

  • 如何及何时使用该文件的内容?

    WebSphere Application Server 功能在 Web 应用程序开发的配置和部署阶段期间使用此文件中的信息。

样本文件条目

支持的配置 支持的配置: web.xml 文件并不代表可用于 Web 应用程序的整个配置。存在其他 Servlet 过滤器以及可以使用程序式配置、注释和 Web 片段进行定义的侦听器。sptcfg
避免故障 避免故障: 将 Web 应用程序标记为 metadata-complete 将使注释和 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>
最佳实践 最佳实践: 对于每个 <error-page> 声明,请选择 <exception-type> 或者 <error-code>,但是不要同时选择这两者。<location> 标记是必需的。bprac

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_webxf
文件名:rweb_webxf.html