webxml2.txt

用java编写的程序

在每一个Web应用程序路径的WEB-INF下和conf下存在一个Web.xml配置文件，

　　用来设定Web应用程序的配置。在Web.xml中的设定非常多，

　　接下来分段来说明它的各项设定：

　　

　　 

PUBLIC"-//Sun Microsystems,Inc.//DTD Web Application 2.2//EN"

"http://java.sun.com/j2ee/dtds/Web-app_2_2.dtd">　　PUBLIC"-//Sun Microsystems,Inc.//DTD Web Application 2.2//EN"

　　"http://java.sun.com/j2ee/dtds/Web-app_2_2.dtd">

　　这是一般XML所需要做的声明，包含定义XML的版本、编码格式dtd来源。

　　Web.xml的dtd是由Sun Microsystems公司所制定的，可以在下列的网址获得详细的信息：

　　http://java.sun.com/j2ee/dtds/Web-app_2_2.dtd。

　　下列部分描述根元素 下的 web.xml Schema 中定义的部署描述符元素。 

　　context-param 

　　description 

　　display-name 

　　distributable 

　　ejb-ref 

　　ejb-local-ref 

　　env-entry 

　　error-page 

　　filter 

　　filter-mapping 

　　icon 

　　listener 

　　login-config 

　　mime-mapping 

　　resource-env-ref 

　　resource-ref 

　　security-constraint 

　　security-role 

　　Servlet 

　　servlet-mapping 

　　session-config 

　　taglib 

　　web-app 

　　welcome-file-list 

　　--------------------------------------------------------------------------------

　　icon 

　　icon 元素指定用于在 GUI 工具中表示 Web 应用程序的大小图像在 Web 应用程序中的位置。（servlet 元素中也有一个名为 icon 的元素，用于提供在 GUI 工具中表示 servlet 的图标。） 

　　下表描述可以在 icon 元素中定义的元素。

　　元素 必需/可选 描述 

　　可选 用于在 GUI 工具中表示 Web 应用程序的 .gif 或 .jpg 小图像（16x16 像素）的位置。当前 WebLogic Server 尚不使用此元素。 

　　可选 用于在 GUI 工具中表示 Web 应用程序的 .gif 或 .jpg 大图像（32x32 像素）的位置。当前 WebLogic Server 尚不使用此元素。 

　　--------------------------------------------------------------------------------

　　display-name 

　　可选的 display-name 元素指定 Web 应用程序的显示名称（可以由 GUI 工具显示的简短名称）。 

　　元素 必需/可选 描述 

　　可选 当前 WebLogic Server 尚不使用此元素。 

　　--------------------------------------------------------------------------------

　　description 

　　可选的 description 元素提供关于 Web 应用程序的描述性文本。 

　　元素 必需/可选 描述 

　　可选 当前 WebLogic Server 尚不使用此元素。 

　　--------------------------------------------------------------------------------

　　distributable 

　　WebLogic Server 不使用 distributable 元素。

　　元素 必需/可选 描述 

　　可选 当前 WebLogic Server 尚不使用此元素。 

　　--------------------------------------------------------------------------------

　　context-param 

　　可选的 context-param 元素中包含 Web 应用程序的 Servlet 上下文初始化参数的声明。下表描述 Web 应用程序容器所使用的保留上下文参数，在 weblogic.xml 中已不赞成使用这些参数，而提供了替换参数。

　　不赞成使用的参数 描述 weblogic.xml 中的替换元素 

　　weblogic.httpd.inputCharset 定义非 unicode 操作的代码集行为。 weblogic.xml 中的 input-charset（在 charset-param 内定义）。请参阅 input-charset。 

　　weblogic.httpd.servlet.reloadCheckSecs 定义 WebLogic Server 检查 servlet 是否发生修改的频率，如果已修改，则重新加载。值为 -1 则永不重新加载，值为 0 则始终重新加载。默认设置为 1 秒。 weblogic.xml 中的 servlet-reload-check-secs（在 container-descriptor 中定义）。请参阅 container-descriptor。 

　　weblogic.httpd.servlet.classpath 设置此值后，容器会将此路径追加到 Web 应用程序类路径上。不建议采用此方法，对于此方法的支持仅为向后兼容。 无替换。使用其他方法，例如清单类路径或 WEB-INF/lib 或 WEB-INF/classes 或虚拟目录。 

　　weblogic.httpd.defaultServlet 设置 Web 应用程序的默认 servlet。不建议采用此方法，

　　对于此方法的支持仅为向后兼容。 无替换。而是使用 web.xml 中的 servlet 和 servlet-mapping 元素定义默认 servlet。默认 servlet 的 URL 模式应该是“/”。请参阅 servlet-mapping。有关 servlet 映射的其他示例，请参阅 Servlet 映射。 

　　以下 context-param 参数仍有效。 

　　元素 必需/可选 描述 

　　weblogic.httpd.

　　clientCertProxy optional 此特性指定 Web 应用程序客户端的证书由代理插件或 HttpClusterServlet所发送的特殊 WL-Proxy-Client-Cert 头提供。 

　　如果在代理服务器上执行用户身份验证，则此设置适用 – 设置 clientCertProxy 会使代理服务器在特殊的头 WL-Proxy-Client-Cert中将证书传递给群集。 

　　WL-Proxy-Client-Cert 头可以由能够访问 WebLogic Server 的任意客户端提供。WebLogic Server 从该头中获取证书信息，信任它来自安全来源（该插件）并使用该信息来对用户进行身份验证。 

　　出于此原因，如果您设置 clientCertProxy，请使用连接筛选器确保 WebLogic Server 仅接受来自正在运行该插件的计算机的连接。 

　　除为单个 Web 应用程序设置此特性外，您还可以定义此特性： 

　　在管理控制台中的“服务器”-->“配置”-->“常规”页面上，为服务器示例承载的所有 Web 应用程序设置该特性 

　　在“群集”-->“配置”-->“常规”页面上，为群集中服务器实例所承载的所有 Web 应用程序设置该特性 

　　--------------------------------------------------------------------------------

　　filter 

　　filter 元素定义筛选器类及其初始化特性。有关筛选器的详细信息，请参阅配置筛选器。 

　　下表描述可在 filter 元素中定义的元素。

　　元素 必需/可选 描述 

　　可选 指定用于在 GUI 工具中表示筛选器的大小图像在 Web 应用程序中的位置。包含小图标和大图标元素。 

　　当前 WebLogic Server 尚不使用此元素。 

　　必需 定义筛选器的名称，用于在部署描述符中的其他位置上引用筛选器定义。 

　　可选 希望由 GUI 工具显示的简短名称。 

　　可选 筛选器的文字描述。 

　　必需 筛选器的完全限定类名。 

　　可选 包含名/值对并用作筛选器的初始化特性。 

　　每个特性使用独立的一组 标记。 

　　--------------------------------------------------------------------------------

　　filter-mapping 

　　下表描述可在 filter-mapping元素中定义的元素。

　　元素 必需/可选 描述 

　　必需 要将 URL 模式或 servlet 映射至的筛选器的名称。该名称对应于使用 元素在 元素中分配的名称。 

　　必需 - 或由 映射 描述用于解析 URL 的模式。将 http://host:port+ ContextPath 之后的 URL 部分与 WebLogic Server 的 进行比较。如果模式匹配，则将调用该元素中映射的筛选器。 

　　示例模式： 

　　/soda/grape/*

　　/foo/* 

　　/contents

　　*.foo 

　　URL 必须遵循 Servlet 2.3 规范中指定的规则。 

　　必需 - 或由 映射 Servlet 的名称，如果调用它，则会执行该筛选器。 

　　--------------------------------------------------------------------------------

　　listener 

　　使用 listener 元素定义应用程序监听器。

　　元素 必需/可选 描述 

　　可选 响应 Web 应用程序事件的类的名称。 

　　有关详细信息，请参阅配置事件监听器类。 

　　--------------------------------------------------------------------------------

　　servlet 

　　servlet 元素中包含 servlet 的声明性数据。 

　　如果指定了 jsp-file 且存在 元素，则将在 WebLogic Server 启动时预编译和加载该 JSP。 

　　下表描述可在 servlet 元素中定义的元素。

　　元素 必需/可选 描述 

　　可选 用于在 GUI 工具中表示 servlet 的大小图像在 Web 应用程序中的位置。包含小图标和大图标元素。 

　　当前 WebLogic Server 尚不使用此元素。 

　　必需 定义 servlet 的规范名称，用于在部署描述符中的其他位置上引用 servlet 定义。 

　　可选 希望由 GUI 工具显示的简短名称。 

　　可选 servlet 的文字描述。 

　　必需（或使用 

　　file>） servlet 的完全限定类名。 

　　在 servlet 正文中仅使用 标记或 标记中的任意一种。 

　　必需（或使用 

　　class>） Web 应用程序中的 JSP 文件相对于 Web 应用程序根目录的完整路径。 

　　在 servlet 正文中仅使用 标记或 标记中的任意一种。 

　　可选 包含名/值对并用作 servlet 的初始化特性。 

　　每个特性使用独立的一组 标记。 

　　可选 当 WebLogic Server 启动时，WebLogic Server 将初始化此 servlet。此元素内容可选，但必须是正整数，它指明 servlet 的加载顺序。指定了低整数的 servlet 将于高整数 servlet 之前加载。如果没有指定任何值，或如果所指定的值不是正整数，则在应用程序启动期间，WebLogic Server 可以以任意顺序加载 servlet。 

　　可选 指定将用于 Web 应用程序执行的 run-as 标识。该元素包含可选描述和安全角色的名称。 

　　 

ref>　　ref> 可选 用于将 所定义的安全角色名链接到使用 Servlet 逻辑进行硬编码的备用角色名。使用此附加提取层，可以在部署时配置 Servlet，且不必更改 Servlet 代码。 

　　icon 

　　这是 Servlet 内的元素。 

　　icon 元素指定用于在 GUI 工具中表示 servlet 的大小图像在 Web 应用程序中的位置。 

　　下表描述可以在 icon 元素中定义的元素。

　　元素 必需/可选 描述 

　　可选 指定用于在 GUI 工具中表示 servlet 的 .gif 或 .jpg 小图像（16x16 像素）在 Web 应用程序内的位置。 

　　当前 WebLogic Server 尚不使用此元素。 

　　可选 指定用于在 GUI 工具中表示 servlet 的 .gif 或 .jpg 小图像（32x32 像素）在 Web 应用程序内的位置。 

　　当前 WebLogic Server 尚不使用此元素。 

　　init-param 

　　这是 Servlet 内的元素。 

　　可选的 init-param元素中包含用作 servlet 的初始化特性的名/值对。每个特性使用独立的一组 init-param 标记。 

　　您可以使用 javax.servlet.ServletConfig.getInitParameter() 方法访问这些特性。 

　　下表描述可在 init-param元素中定义的元素。

　　元素 必需/可选 描述 

　　必需 定义此特性的名称。 

　　必需 为此特性定义一个 String 值。 

　　可选 初始化特性的文字描述。 

　　security-role-ref 

　　这是 Servlet 内的元素。 

　　security-role-ref 元素将 定义的安全角色名链接到使用 Servlet 逻辑进行硬编码的备用角色名。使用此附加提取层，可以在部署时配置 Servlet，且不必更改 Servlet 代码。 

　　下表描述可在 security-role-ref元素中定义的元素。

　　元素 必需/可选 描述 

　　可选 角色的文字描述。 

　　必需 定义在 Servlet 代码中使用的安全角色或委托人的名称。 

　　必需 定义稍后将在部署描述符中的 元素中定义的安全角色的名称。 

　　--------------------------------------------------------------------------------

　　servlet-mapping 

　　servlet-mapping 元素定义 servlet 和 URL 模式之间的映射。 

　　下表描述可在 servlet-mapping元素中定义的元素。

　　元素 必需/可选 描述 

　　必需 要将 URL 模式映射至的 servlet 的名称。该名称对应于您在 声明标记中为 servlet 分配的名称。 

　　必需 描述用于解析 URL 的模式。将 http://host:port+ WebAppName 之后的 URL 部分与 WebLogic Server 的 进行比较。如果模式匹配，则将调用该元素中映射的 servlet。 

　　示例模式： 

　　/soda/grape/*

　　/foo/* 

　　/contents

　　*.foo 

　　URL 必须遵循 Servlet 2.3 规范中指定的规则。 

　　有关 Servlet 映射的其他示例，请参阅 Servlet 映射。 

　　--------------------------------------------------------------------------------

　　session-config 

　　session-config 元素为此 Web 应用程序定义会话特性。 

　　下表描述可在 session-config 元素中定义的元素。

　　元素 必需/可选 描述 

　　可选 会话过期分钟数，该 Web 应用程序中的会话将在此时间后过期。除非输入此处列出的某个特殊值，否则此元素中设置的值将替代 WebLogic 特定部署描述符 weblogic.xml 中的 元素的 TimeoutSecs 特性中设置的值。 

　　默认值：-2 

　　最大值：Integer.MAX_VALUE ? 

　　特殊值： 

　　-2 表示使用 weblogic.xml的 元素中的 TimeoutSecs 设置的值。 

　　-1 表示会话永不超时。将忽略 weblogic.xml 的 元素中设置的值。 

　　有关详细信息，请参阅 session-descriptor。 

　　--------------------------------------------------------------------------------

　　mime-mapping