web.xml标签说明.docx

Web.xml 文件标签说明 Web.xml 文件是 Java Web 应用程序的配置文件，用于描述 Web 应用程序的结构和组件。在 Web.xml 文件中，我们可以找到许多重要的标签，下面将对这些标签进行详细的解释。 1. `<description>` 元素：用于为父元素提供一个文本描述。这个元素不仅可以在 `<web-app>` 元素中出现，还可以在其他多个元素中出现。他有一个可选的属性 `xml:lang`，用于指示在描述中使用的语言，该属性的默认值是 `en`（英语）。 2. `<display-name>` 元素：用于指定这个 Web 应用程序的简短名字，这个名字可以被一些工具所显示。他也有一个可选的属性 `xml:lang`，用于指示在描述中使用的语言，该属性的默认值是 `en`（英语）。 3. `<icon>` 元素：包含了 `<small-icon>` 和 `<large-icon>` 两个元素，用于指定大小图标（GIF 或 JPEG 格式的图标）的文件名。指定的图标在图形界面工具中将用于表示父元素。 4. `<distributable>` 元素：是一个空元素，用于指示这个 Web 应用程序可以被部署到分布式的 Servlet 容器中。 5. `<context-param>` 元素：用于声明 Web 应用程序 Servlet 上下文的初始化参数。他包含两个子元素 `<param-name>` 和 `<param-value>`。 `<param-name>` 用于指定参数的名字， `<param-value>` 用于指定参数的值。在 Servlet 中可以使用 `getServletContext().getInitParameter(“”);` 来获取初始化参数。 6. `<filter>` 元素：用于在 Web 应用程序中声明一个过滤器。包括 `<description>`, `<display-name>`, `<icon>`, `<filter-name>`, `<filter-class>`, `<init-param>`, `<param-name>`, `<param-value>`。 `<filter-name>` 为过滤器指定一个名字，该元素的内容不能为空。 `<filter-class>` 元素用于指定过滤器的完整的限定类名。 `<init-param>` 元素用于指定过滤器的初始化参数，他的子元素 `<param-name>` 指定参数的名字， `<param-value>` 指定参数的值。过滤器在运行时，通过 FilterConfig 接口对象访问初始化参数。 7. `<filter-mapping>` 元素：用于设置过滤器负责过滤的 URL 或者 Servlet。包括 `<filter-name>`, `<url-pattern>`, `<servlet-name>`, `<dispatcher>`。 `<filter-name>` 子元素的值必须在 `<filter>` 元素中已声明过的过滤器的名字。 `<url-pattern>` 元素和 `<servlet-name>` 元素可以选择一个， `<url-pattern>` 元素指定过滤器对应的 URL， `<servlet-name>` 元素指定过滤器对应的 Servlet。 `<dispatcher>` 元素指定过滤器对应的请求方式，可以是 REQUEST, INCLUDE, FORWARD, ERROR 四种之一，默认为 REQUEST。 8. `<listener>` 元素：用于指定 Web 应用程序的监听类。可以包含 0 个或多个 `<description>`, `<display-name>`, `<icon>` 元素，必须包含 `<listener-class>` 元素。 `<listener-class>` 元素指定监听器类的完整的限定类名。 9. `<servlet>` 元素：用于声明一个 Servlet。 `<servlet-name>` 指定 servlet 的名字，这个名字在同一个 Web 应用程序中必须是唯一的。 `<servlet-class>` 指定 servlet 类的完整限定名。 `<jsp-file>` 指定在 Web 应用程序中的 jsp 文件的完整路径，该路径以斜杠（/）开始。如果要一个 JSP 文件做 URL 映射，就会用到这个元素。在 `<servlet>` 元素中， `<servlet-class>` 元素和 `<jsp-file>` 元素只能选择其中之一。如果 `<servlet>` 元素包含了 `<jsp-file>` 元素和 `<load-on-startup>` 元素，则 jsp 文件将被预编译并加载。 `<init-param>` 元素用于指定 servlet 的初始化参数。 `<load-on-startup>` 元素指定当 Web 应用程序启动时，servlet 被加载的次序。元素的内容必须是一个整型值，如果这个值是一个负数，或者没有设定这个元素，servlet 容器将在客户端首次请求这个 servlet 时加载它；如果这个值是正数或者 0，容器将在 Web 应用程序部署时加载和初始化这个 servlet，并且先加载数值小的 servlet，后加载数值大的 servlet。