weblogic.xml 部署描述符元素

转载自http://edocs.weblogicfans.net/wls/docs92/webapp/weblogic_xml.html

resolve 表示操作。

?

context-root

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

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

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

在 application.xml 中检查上下文根；如果找到，则将其用作 Web 应用程序的上下文根。 如果 application.xml 中未设置上下文根，且 Web 应用程序是作为 EAR 的一部分部署的，则检查 weblogic.xml 中是否定义了上下文根。如果找到，则将其用作 Web 应用程序的上下文根。如果 Web 应用程序是独立部署的，则 application.xml 不参与该过程，而仅从 weblogic.xml 开始 context-root 的确定，如果其中没有定义，则默认使用 URI。 如果 weblogic.xml 或 application.xml 中没有定义上下文根，则将从 URI 中推断上下文路径，将 URI 中定义的值减去 WAR 后缀作为其名称。例如，如果 URI 为 MyWebApp.war，则上下文根的名称为 MyWebApp。

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

?

wl-dispatch-policy

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

?

servlet-descriptor

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

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

元素 必需/
可选 描述 <servlet-name> 必需 将 servlet 名称指定为 web.xml 部署描述符文件的 servlet 元素中定义的 servlet 名称。 <run-as-principal-name> 可选 包含针对 web.xml 部署描述符中所定义的 run-as-role-name 的委托人名称。 <init-as-principal-name> 可选 相当于 servlet 的 init 方法的 run-as-principal-name。此处指定的标识应为系统内的有效用户名。如果未指定 init-as-principal-name，则容器将使用 run-as-principal-name 元素。 <destroy-as-principal-name> 可选 相当于 servlet 的 destroy 方法的 run-as-principal-name。此处指定的标识应为系统内的有效用户名。如果未指定 destroy-as-principal-name，则容器将使用 run-as-principal-name 元素。 <dispatch-policy> 可选 不赞成使用此元素。用于通过标识执行队列名称来向某个已配置的执行队列分配给定的 servlet。该设置将替代 wl-dispatch-policy 定义的 Web 应用程序级别调度策略。

?

?

work-manager

work-manager 元素是 <weblogic-web-app> 元素的子元素。可以在 work-manager 元素中定义下列元素。

元素 必需
可选 描述 name 必需 指定工作管理器的名称。 response-time-request-class / fair-share-request-class / context-request-class / request-class-name 可选 可以从以下四个元素之间选择一个： response-time-request-class – 定义应用程序的响应时间请求类。响应时间（毫秒）由特性 goal-ms 定义。增量为 ((目标 - T) Cr)/R，其中 T 指平均线程使用时间，R 指达到率，Cr 指确定响应时间目标优先于公平共享的系数。 fair-share-request-class – 定义公平共享请求类。公平共享由默认共享的属性百分比定义。因此，默认值为 100。增量为 Cf/(P R T)，其中 P 指百分比，R 指达到率，T 指平均线程使用时间，Cf 指公平共享优先级低于响应时间目标的系数。 context-request-class – 定义上下文类。上下文由将上下文信息（如当前用户或其角色、cookie 或工作区域字段）映射到已命名的服务类的多个案例定义。 request-class-name – 定义请求类名称。 min-threads-constraint / min-threads-constraint-name 可选 可以从以下两个元素之间选择一个： min-threads-constraint - 用来保证服务器向受约束工作集的请求分配的线程数，以避免死锁。默认值为零。例如，对于复制更新请求，最少线程值如果为一（可以从对等方同步调用），则该值非常有用。 min-threads-constraint-name - 定义 min-threads-constraint 元素的名称。 max-threads-constraint / max-threads-constraint-name 可选 可以从以下两个元素之间选择一个： max-threads-constraint - 限制执行来自受约束工作集的请求的并发线程数量。默认值为无限制。例如，假设约束被定义为最多具有 10 个线程，并且由 3 个入口点共享。调度逻辑可确保执行来自三个入口点组合的请求的线程不超过 10 个。 max-threads-constraint-name - 定义 max-threads-constraint 元素的名称。 capacity / capacity-name 可选 可以从以下两个元素之间选择一个： capacity - 可以定义约束并将其应用于入口点集（称为受约束的工作集）。只有达到该容量时服务器才开始拒绝请求。默认值为零。请注意，容量包括受约束的工作集中已经排队或正在执行的所有请求。此约束主要用于像 JMS 之类的子系统，这些子系统执行自己的流控制。此约束与全局队列阈值无关。 capacity-name – 定义 capacity 元素的名称。

?

?

logging

logging 元素是 <weblogic-web-app> 元素的子元素。可以在 logging 元素中定义下列元素。

元素 必需
可选 描述 log-filename 必需

指定日志文件的名称。需要提供该文件名的完整地址。

logging-enabled 可选

指定是否为 ManagedConnectionFactory 或 ManagedConnection 设置了日志编写器。如果将此元素设置为 true，则从 ManagedConnectionFactory 或 ManagedConnection 中生成的输出将发送到由 log-filename 元素指定的文件。

如果不指定此值，则 WebLogic Server 将使用其定义的默认值。

值范围：true | false

默认值：false rotation-type 可选 设置文件滚动类型。 值为 bySize、byName 或 none

bySize - 当日志文件大小达到在 file-size-limit 中指定的大小时，服务器将把该文件重命名为 FileName.n。 byName - 按照在 file-time-span 中指定的时间间隔，服务器将该文件重命名为 FileName.n。在服务器重命名某个文件之后，后续的消息会累积在一个名称在 log-filename 中指定的新文件中。 none - 消息累积在单个文件中。当文件体积过大时，必须清除它的内容。 默认值：bySize number-of-files-limited 可选 指定是否应该对该服务器实例为存储旧消息而创建的文件数进行限制。（需要指定 bySize 的滚动类型）。服务器达到此限制后，它将覆盖最旧的文件。如果不启用此选项，服务器将无限制地创建新文件，这样就必须在需要时清除这些文件。 如果通过将 number-of-files-limited 设置为 true 启用该选项，则服务器将参考 rotationType 变量来决定如何滚动该日志文件。滚动意味着替换现有文件而不是创建新文件。如果将 number-of-files-limited 指定为 false，则服务器将创建大量日志文件而不是替换同一个日志文件。

值范围：true | false

默认值：false file-count 可选 服务器在滚动日志时创建的日志文件的最大数量。该数目不包括服务器用于存储当前消息的文件。（需要启用 number-of-files-limited。） 默认值：7 file-size-limit 可选 触发服务器将日志消息移动到单个文件的大小。（需要指定 bySize 的滚动类型。）日志文件达到指定的最小大小之后，服务器会在下次检查文件大小时将当前的日志文件重命名为 FileName.n，并新建一个用来存储后续消息的文件。 默认值：500 rotate-log-on-startup 可选 指定服务器在其启动周期内是否滚动其日志文件。 值范围：true | false 默认值：true log-file-rotation-dir 可选 指定将存储滚动日志文件的目录的路径。 rotation-time 可选 日志文件基于时间滚动顺序的开始时间的格式为 k:mm，其中 k 为 1-24。（需要指定 byTime 的滚动类型。）在到达指定时间时，服务器会重命名当前的日志文件。之后，服务器将按照在 file-time-span 中指定的间隔重命名日志文件。 如果指定的时刻已过，服务器会立即开始其文件滚动。 默认情况下，滚动周期会立即开始。 file-time-span 可选 服务器将旧的日志消息保存到另一个文件的时间间隔（小时）。（需要指定 byTime 的滚动类型。） 默认值：24

?

?

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 元素中定义下列元素。

元素 必需
可选 描述 library-name 必需 提供用于库模块引用的库名称。默认值为 null。 specification-version 必需 提供用于库模块引用的规范版本。默认值为 0。（为浮点型。） implementation-version 必需 提供用于库模块引用的实现版本。默认值为 null。 exact-match 必需 默认值为 false。

?

?

向后兼容性标志

本版本中增添了若干向后兼容性标志，允许您恢复 WebLogic Server 9.0 之前的版本中所见的行为。有关这些标志的完整列表和描述，以及有关 Web 应用程序、JSP 和 Servlet 向后兼容性的所有信息，请参阅 Upgrading WebLogic Application Environments 中的 Compatibility with Previous Releases。

?

Web 容器全局配置

要在全局级别上配置 Web 容器，请使用 WebAppContainerMBean。有关 WebAppContainerMBean 特性以及如何使用它们为所有 Web 应用程序指定域范围内的默认值的信息，请参阅位于 http://e-docs.bea.com/wls/docs90/wlsmbeanref/mbeans/WebAppContainerMBean.html 的 WebAppContainerMBean。