扫一扫
分享文章到微信
扫一扫
关注官方公众号
至顶头条
在每一个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。
下列部分描述根元素
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 元素中定义的元素。
元素 必需/可选 描述
--------------------------------------------------------------------------------
display-name
可选的 display-name 元素指定 Web 应用程序的显示名称(可以由 GUI 工具显示的简短名称)。
元素 必需/可选 描述
--------------------------------------------------------------------------------
description
可选的 description 元素提供关于 Web 应用程序的描述性文本。
元素 必需/可选 描述
--------------------------------------------------------------------------------
distributable
WebLogic Server 不使用 distributable 元素。
元素 必需/可选 描述
--------------------------------------------------------------------------------
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 元素中定义的元素。
元素 必需/可选 描述
当前 WebLogic Server 尚不使用此元素。
每个特性使用独立的一组
--------------------------------------------------------------------------------
filter-mapping
下表描述可在 filter-mapping元素中定义的元素。
元素 必需/可选 描述
示例模式:
/soda/grape/*
/foo/*
/contents
*.foo
URL 必须遵循 Servlet 2.3 规范中指定的规则。
--------------------------------------------------------------------------------
listener
使用 listener 元素定义应用程序监听器。
元素 必需/可选 描述
有关详细信息,请参阅配置事件监听器类。
--------------------------------------------------------------------------------
servlet
servlet 元素中包含 servlet 的声明性数据。
如果指定了 jsp-file 且存在
下表描述可在 servlet 元素中定义的元素。
元素 必需/可选 描述
当前 WebLogic Server 尚不使用此元素。
file>) servlet 的完全限定类名。 在 servlet 正文中仅使用 class>) Web 应用程序中的 JSP 文件相对于 Web 应用程序根目录的完整路径。 在 servlet 正文中仅使用 每个特性使用独立的一组 ref> ref> 可选 用于将 icon 这是 Servlet 内的元素。 icon 元素指定用于在 GUI 工具中表示 servlet 的大小图像在 Web 应用程序中的位置。 下表描述可以在 icon 元素中定义的元素。 元素 必需/可选 描述 当前 WebLogic Server 尚不使用此元素。 当前 WebLogic Server 尚不使用此元素。 init-param 这是 Servlet 内的元素。 可选的 init-param元素中包含用作 servlet 的初始化特性的名/值对。每个特性使用独立的一组 init-param 标记。 您可以使用 javax.servlet.ServletConfig.getInitParameter() 方法访问这些特性。 下表描述可在 init-param元素中定义的元素。 元素 必需/可选 描述 security-role-ref 这是 Servlet 内的元素。 security-role-ref 元素将 下表描述可在 security-role-ref元素中定义的元素。 元素 必需/可选 描述 -------------------------------------------------------------------------------- servlet-mapping servlet-mapping 元素定义 servlet 和 URL 模式之间的映射。 下表描述可在 servlet-mapping元素中定义的元素。 元素 必需/可选 描述 示例模式: /soda/grape/* /foo/* /contents *.foo URL 必须遵循 Servlet 2.3 规范中指定的规则。 有关 Servlet 映射的其他示例,请参阅 Servlet 映射。 -------------------------------------------------------------------------------- session-config session-config 元素为此 Web 应用程序定义会话特性。 下表描述可在 session-config 元素中定义的元素。 元素 必需/可选 描述 默认值:-2 最大值:Integer.MAX_VALUE ? 特殊值: -2 表示使用 weblogic.xml的 -1 表示会话永不超时。将忽略 weblogic.xml 的 有关详细信息,请参阅 session-descriptor。 -------------------------------------------------------------------------------- mime-mapping mime-mapping 元素定义扩展名和 mime 类型之间的映射。 下表描述可在 mime-mapping元素中定义的元素。 元素 必需/可选 描述 -------------------------------------------------------------------------------- welcome-file-list 可选的 welcome-file-list 元素中包含 welcome-file 元素的有序列表。 当 URL 请求是一个目录名时,WebLogic Server 将提供此元素中指定的第一个文件。如果找不到该文件,则服务器会尝试列表中的下一个文件。 有关详细信息,请参阅配置欢迎文件。 下表描述可在 welcome-file-list 元素中定义的元素。 元素 必需/可选 描述 -------------------------------------------------------------------------------- error-page 可选的 error-page 元素指定错误代码或异常类型与 Web 应用程序中资源路径之间的映射。 WebLogic Server 响应 HTTP 请求的过程中发生错误或由于 Java 异常而发生错误时,WebLogic Server 会返回一个 HTML 页面,其中显示 HTTP 错误代码或包含 Java 错误信息的页面。可以定义显示自己的 HTML 页面,而不显示这些默认错误页面,或响应 Java 异常。 有关详细信息,请参阅自定义 HTTP 错误响应。 下表描述可以在 error-page 元素中定义的元素。 注意: 定义 元素 必需/可选 描述 -------------------------------------------------------------------------------- taglib 可选的 taglib 元素描述 JSP 标记库。 该元素将 JSP 标记库描述符(Tag Library Descriptor,简称 TLD)与 URI 模式关联起来。尽管您可以在相对于 WEB-INF 目录的 JSP 中指定 TLD,但部署您的 Web 应用程序时,您仍可以使用 下表描述可在 taglib元素中定义的元素。 元素 必需/可选 描述 如果该 URI 匹配 JSP 页面上 taglib 指令中使用的 URI 字符串,则使用此 taglib。 -------------------------------------------------------------------------------- resource-env-ref resource-env-ref 元素包含 Web 应用程序对 Web 应用程序环境中的资源所关联的受管理对象的引用的声明。它包括可选的描述、资源环境引用名,还指明了 Web 应用程序代码所预期的资源环境引用类型。 例如: 元素 必需/可选 描述 -------------------------------------------------------------------------------- resource-ref 可选的 resource-ref 元素定义外部资源的引用查找名。这使得 servlet 代码能够通过“虚拟”名称查找资源,该虚拟名称将映射至部署时的实际位置。 使用独立的 下表描述可在 resource-ref元素中定义的元素。 元素 必需/可选 描述 如果设置为 APPLICATION,则表明应用程序组件代码将以编程方式执行资源登录。如果设置为 CONTAINER,则 WebLogic Server 将使用随 login-config 元素建立的安全上下文。请参阅 login-config。 有效值: Shareable(可共享) Unshareable(不可共享) -------------------------------------------------------------------------------- security-constraint security-constraint 元素定义对 有关在 Web 应用程序中配置安全的详细说明和示例,请参阅“确保 WebLogic 资源安全”。另外,有关 WebLogic 安全的详细信息,请参阅WebLogic 安全性编程。 下表描述可在 security-constraint 元素中定义的元素。 元素 必需/可选 描述 collection> collection> 必需 定义应用此安全约束的 Web 应用程序的组件。 constraint> constraint> 可选 定义客户端如何与服务器进行通信。 另请参阅 user-data-constraint web-resource-collection 每个 这是 security-constraint 内的元素。 下表描述可在 web-resource-collection 元素中定义的元素。 元素 必需/可选 描述 name> name> 必需 此 Web 资源集合的名称。 auth-constraint 这是 security-constraint 内的元素。 可选的 auth-constraint 元素定义哪些组或委托人有权访问在此安全约束中定义的 Web 资源集合。 下表描述可以在 auth-constraint 元素中定义的元素。 元素 必需/可选 描述 user-data-constraint 这是 security-constraint 内的元素。 user-data-constraint元素定义客户端如何与服务器进行通信。 下表描述可在 user-data-constraint元素中定义的元素。 元素 必需/可选 描述 guarantee> guarantee> 必需 指定客户端和服务器之间的通信。 当使用 INTEGRAL 或 CONFIDENTIAL 传输保证对用户进行身份验证时,WebLogic Server 会建立安全套接口层 (SSL) 连接。 值范围: NONE- 应用程序不需要任何传输保证。 INTEGRAL- 应用程序要求数据在客户端和服务器之间传输的过程中不会被更改。 CONFIDENTIAL- 应用程序要求传输数据以防止其他实体观察到传输的内容。 -------------------------------------------------------------------------------- login-config 使用可选的 login-config 元素配置如何对用户进行身份验证;应用于此应用程序的领域名称;表单登录机制所需要的特性。 如果使用此元素,则用户必须经过身份验证才能访问受 Web 应用程序中所定义的 下表描述可在 login-config元素中定义的元素。 元素 必需/可选 描述 BASIC - 使用浏览器身份验证。(这是默认值。) FORM - 使用用户编写的 HTML 表单。 CLIENT-CERT 注意: 您可以通过逗号分隔列表定义多个身份验证方法,以便提供应变机制。将按照在 auth-method 列表中定义值的顺序尝试进行身份验证。请参阅“WebLogic 安全性编程”中的为身份验证方法提供应变机制。 注意: config> config> 可选 如果您在 FORM 中配置 form-login-config 这是 login-config 内的元素。 如果您在 FORM 中配置 . 元素 必需/可选 描述 -------------------------------------------------------------------------------- security-role 下表描述可在 security-role元素中定义的元素。 元素 必需/可选 描述 -------------------------------------------------------------------------------- env-entry 可选的 env-entry 元素声明用于应用程序的环境条目。每个环境条目使用独立的元素。 下表描述可以在 env-entry 元素中定义的元素。 元素 必需/可选 描述 可以设置为下列 Java 类型之一: java.lang.Boolean java.lang.String java.lang.Integer java.lang.Double java.lang.Float -------------------------------------------------------------------------------- ejb-ref 可选的 ejb-ref 元素定义对 EJB 资源的引用。通过在 WebLogic 特定的部署描述符文件 weblogic.xml 中定义映射,将该引用映射至部署时的 EJB 实际位置。使用独立的 下表描述可以在 ejb-ref 元素中定义的元素。 元素 必需/可选 描述 -------------------------------------------------------------------------------- ejb-local-ref ejb-local-ref 元素用于声明对企业 Bean 本地主目录的引用。声明包括: 可选的描述 用于在 Web 应用程序代码中引用企业 Bean 的 EJB 引用名称。所引用的企业 Bean 的预期类型 所引用的企业 Bean 的预期本地主目录和本地接口 可选的 ejb-link 信息,用于指定所引用的企业 Bean 下表描述可以在 ejb-local-ref 元素中定义的元素。 元素 必需/可选 描述 例如: ejb-link 元素中的名称包括一个路径名。该路径名指定包含所引用 EJB 的 ejb-jar,且追加了目标 Bean 的 ejb-name 并通过 # 与路径名隔开。 该路径名相对于包含引用 EJB 的 Web 应用程序的 WAR 文件。因此能够唯一标识具有相同 ejb-name 的多个 EJB。 用于:ejb-local-ref 和 ejb-ref 元素。 示例: -------------------------------------------------------------------------------- web-app Servlet 2.4 部署描述符的 XML Schema。WebLogic Server 完全支持 HTTP Servlet,如 Sun Microsystems 的 Servlet 2.4 specification 所定义。但是,version 特性必须设置为 2.4,才能执行 2.4 行为。 下表描述可以在 web-app 元素中定义的元素。 元素 必需/可选 描述
如果您非常迫切的想了解IT领域最新产品与技术信息,那么订阅至顶网技术邮件将是您的最佳途径之一。
现场直击|2021世界人工智能大会
直击5G创新地带,就在2021MWC上海
5G已至 转型当时——服务提供商如何把握转型的绝佳时机
寻找自己的Flag
华为开发者大会2020(Cloud)- 科技行者