属性文件 weblogic.xml

说明

WebLogic Server 允许通过设置 weblogic 应用程序扩展描述符（weblogic.xml）配置 jsp 容器，该文件通常位于 web 应用程序的 web-inf 目录下。可配置的元素包含在根节点下。

可配置的属性详解

1.description

description 元素是 Web 应用程序的文字描述。

2.weblogic-version

weblogic-version 元素表示该 Web 应用程序（在根元素  下定 义）即将部署至的 WebLogic Server 的版本。该元素仅表示版本信息，WebLogic Server 并不使用该元素。

3.security-role-assignment

security-role-assignment 元素声明 Web 应用程序安全角色与 WebLogic Server 中 一个或多个委托人之间的映射，如以下示例所示。

<security-role-assignment>
  <role-name>PayrollAdmin</role-name>
  <principal-name>Tanya</principal-name>
  <principal-name>Fred</principal-name>
  <principal-name>system</principal-name>
</security-role-assignment>

还可以使用它将给定角色标记为外部定义的角色，如以下示例所示：

<security-role-assignment>
  <role-name>roleadmin</role-name>
  <externally-defined/>
</security-role-assignment>

注意：在 <security-role-assignment> 元素中，必须定义 <principal-name> 或 <externally-defined>，不能两者都忽略。

下表描述了在 <security-role-assignment> 元素中定义的元素

注意：

• 如果您不定义 security-role-assignment 元素及其子元素，则 Web 应用程序容 器会将该角色名隐式映射为委托人名称，并记录一条警告。如果不定义映射，则EJB 容器不部署该模块。如果在 weblogic.xml 中将“role_xyz”映射至用户 “joe”，则 role_xyz 成为本地角色。 如果将 role_xyz 指定为外部定义的角色，则它成为全局角色（它指领域级别上定义的角色）。

• 如果不定义 security-role-assignment 元素，role_xyz 成为本地角色，且 Web 应用程序容器创建其隐式映射，并记录一条警告。

4.run-as-role-assignment

run-as-role-assignment 元素将 web.xml 中的 run-as 角色名（servlet 元素的子 元素）映射为系统中的有效用户名。对于给定 servlet，该值将被 servlet-descriptor 中的 run-as-principal-name 元素替代。如果给定角色名中没有指定 run-as-role- assignment，则 Web 应用程序容器使用 security-role-assignment 中定义的第一个 principal-name。

以下示例说明如何使用 run-as-role-assignment 元素：

<run-as-role-assignment>
<role-name>RunAsRoleName</role-name>
<run-as-principal-name>joe</run-as-principal-name>
</run-as-role-assignment>

下表描述了可在run-as-role-assignmen元素中定义的元素

5.resource-description

resource-description 元素用于将服务器资源的 JNDI 名映射至 WebLogic Server 中的 EJB 资源引用。

下表描述了resource-description元素中定义的元素

6.resource-env-description

resource-env-description 元素将 ejb-jar.xml 部署描述符中声明的 resource- env-ref 映射至其代表的服务器资源的 JNDI 名。

下表描述了resource-env-description元素中定义的元素

7.ejb-reference-description

下表描述了ejb-reference-description元素中定义的元素

8.service-reference-description

下表描述了service-reference-description元素中定义的元素

9.session-descriptor

session-descriptor元素定义Servlet会话的参数

10.jsp-descriptor

jsp-descriptor 元素指定 JSP 编译器的配置参数列表。

下表描述可在 jsp-descriptor 元素中定义的元素：

11.auth-filter

auth-filter 元素指定身份验证筛选器 HttpServlet 类。

注意：有些版本中不赞成使用该元素。而改用 servlet 身份验证筛选器。

12.charset-params

<charset-params>元素用于定义非 unicode 操作的代码集行为。例如：

<charset-params>
<input-charset>
<resource-path>/*</resource-path>
<java-charset-name>UTF-8</java-charset-name>
</input-charset>

13.input-charset

使用<input-charset>元素定义用于读取 GET 和 POST 请求数据的字符集。例如：

<input-charset> 
  <resource-path>/foo</resource-path>
   <java-charset-name>SJIS</java-charset-name>
</input-charset>

下表描述了可在 <input-charset>元素中定义的元素

14.charset-mapping

使用<charset-mapping>元素将 IANA 字符集名称映射至 Java 字符集名称。例如：

<charset-mapping>
  <iana-charset-name>Shift-JIS</iana-charset-name>
  <java-charset-name>SJIS</java-charset-name>
</charset-mapping>

下表描述了可在 <charset-mapping>元素中定义的元素

15.virtual-directory-mapping

使用 virtual-directory-mapping 元素指定文档根，取代某些特定请求（例如图像请 求）的 Web 应用程序的默认文档根。

一组 Web 应用程序的所有图像可以存储于一个位置上，不需要复制到使用这些图像的每 个 Web 应用程序的文档根中。对于传入的请求，如果已经指定虚拟目录，则 servlet 容器 将首先在该虚拟目录中搜索所请求的资源，然后再在 Web 应用程序的原始文档根下搜索。 这定义了两个位置上具有同一文档时的搜索优先级。

示例：

<virtual-directory-mapping>
  <local-path>c:/usr/gifs</local-path>
  <url-pattern>/images/*</url-pattern>
  <url-pattern>*.jpg</url-pattern>
</virtual-directory-mapping>
<virtual-directory-mapping>
  <local-path>c:/usr/common_jsps.jar</local-path>
  <url-pattern>*.jsp</url-pattern>
</virtual-directory-mapping>

下表描述了可在virtual-directory-mapping元素中定义的元素

WebLogic Server 的虚拟目录映射实现要求您的目录匹配该映射的 URL 模式，这允许servlet 容器在设定对应目录下找到适用于多个 Web 应用程序的图像。

16.url-match-map

使用该元素指定用于 URL 模式匹配的类。WebLogic Server 默认 URL 匹配映射类是基 于 J2EE 标准的 weblogic.servlet.utils.URLMatchMap。WebLogic Server 中包含的另外 一个实现是 SimpleApacheURLMatchMap，可以通过使用 url-match-map 元素将该实现用作 插件。

SimpleApacheURLMatchMap 的规则：

如果将 *.jws 映射至 JWSServlet，则

http://foo.com/bar.jws/baz 将解析为路径信息为 baz 的 JWSServlet。

按照如下示例在 weblogic.xml 中配置要使用的 URLMatchMap：

<url-match-map>
weblogic.servlet.utils.SimpleApacheURLMatchMap
</url-match-map>

17.security-permission

security-permission 元素根据安全策略文件语法指定单个安全权限，放弃可选的 codebase 和 signedBy 子句。

例如：

<security-permission-spec>
grant { permission java.net.SocketPermission "*", "resolve" };
</security-permission-spec>

其中：

permission java.net.SocketPermission 是权限类名。

"*" 表示目标名称。

resolve 表示操作。

18.context-root

context-root 元素定义该独立 Web 应用程序的根路径。如果 Web 应用程序不是独立 的，而属于某 EAR 的一部分，请在该 EAR 的 META-INF/application.xml 文件中指定 context-root 。 application.xml 中 的 context-root 设 置 优 先 于 weblogic.xml 中 的 context-root 设置。

resolve 表示操作。

注意，该 weblogic.xml 元素仅用于使用两阶段部署模型进行部署时。

确定 Web 应用程序的根路径的优先级顺序如下：

1.  在 application.xml 中检查 context-root；如果找到，则将其用作 Web 应用程序的 根路径。

2.  如果 application.xml 中未设置 context-root，且 Web 应用程序是作为 EAR 的一部 分部署的，则检查 weblogic.xml 中是否定义了 context-root。如果找到，则将其用 作 Web 应用程序的根路径。如果 Web 应用程序是独立部署的，则 application.xml 不 参与该过程，而仅从 weblogic.xml 开始 context-root 的确定，如果其中没有定义， 则默认使用 URI。。

3.  如果 weblogic.xml 或 application.xml 中没有 context-root，则将从 URI 中推断 上下文路径，将 URI 中定义的值减去 WAR 后缀作为其名称。例如，如果 URI 为 MyWebApp.war，则其根路径为 /MyWebApp。

注意：不能为 EAR 库中的各个 Web 应用程序分别设置 context-root 元素。只能针 对 Web 应用程序库进行设置。

19.wl-dispatch-policy

使用 wl-dispatch-policy 元素，通过标识执行队列名称，从而将 Web 应用程序分配 至已配置的执行队列。可以使用 per-servlet-dispatch-policy 元素在单个 servlet 或 jsp 级别上替代该 Web 应用程序级别参数。

20.servlet-descriptor

使用 servlet-descriptor 元素聚合 servlet 特定的元素。

下表描述了可在 servlet-descriptor 元素中定义的元素：

21.work-manager

work-manager 元素是<weblogic-web-app>元素的子元素。

下表描述了可在work-manager元素中定义的元素：

22.logging

logging 元素是<weblogic-web-app>元素的子元素。

下表描述了可在logging元素中定义的元素：

23.library-ref

library-ref 元素引用计划用作当前 Web 应用程序中的 Web 应用程序库的一个库模块。

示例：

<library-ref>
<library-name>WebAppLibraryFoo</library-name>
<specification-version>2.0</specification-version>
<implementation-version>8.1beta</implementation-version>
<exact-match>false</exact-match>
</library-ref>

只有下列子元素与 Web 应用程序相关： library-name、specification-version、 implementation-version 以及 exact-match。

可以在 library-ref 元素中定义下列元素：

24.Backwards Compatibility Flags

有些新版本中增添了若干向后兼容性标志，允许您恢复 WebLogic Server 9.0 之前的 版本中所见的行为。

25.Web Container Global Configuration

要在全局级别上配置 Web 容器，请使用 WebAppContainerMBean。