《weblogic参数》由会员分享，可在线阅读，更多相关《weblogic参数（19页珍藏版）》请在金锄头文库上搜索。
1、weblogic-ra.xml Schema本附录中的下面几部分介绍了可以在特定于 WebLogic Server 的部署描述符 weblogic-ra.xml 中定义的部署描述符元素。weblogic-ra.xml的 Schema 是http:/ adapter archive，简称 RAR）不包含weblogic-ra.xml部署描述符，WebLogic Server 将自动选择部署描述符元素的默认值。 weblogic-connector work-manager security properties admin-objects outbound-resource-adapterweb
2、logic-connectorweblogic-connector元素是已部署资源适配器特定于 WebLogic 部署描述符的根元素。可以在weblogic-connector元素中定义下列元素。表 9-1weblogic-connector 子元素元素必需/可选描述native-libdir如果有本地库，则为必需。指定资源适配器所需的所有本地库所在的目录。jndi-name仅当指定资源适配器 bean 时为必需。指定资源适配器的 JNDI 名称。资源适配器 bean 使用该名称注册到 JNDI 树中。如果未指定资源适配器 bean，则它不是必需元素。如果为没有资源适配器 bean 的资源适配
3、器指定了 JNDI 名称，则它是一个不起作用的元素。enable-access-outside-app可选正如 J2CA 1.5 规范中所述，如果将资源适配器打包到某个应用程序中（换句话说，就是打包到 EAR 中），则只有该应用程序内的组件才有权访问该资源适配器。使用此元素可以改变这一功能。注意：此元素不适用于独立资源适配器。默认值：false当设置为 false 时，资源适配器只能由与该资源适配器驻留在同一应用程序中的客户端访问。注意：对于版本 1.0 资源适配器（受本版本中支持），此元素的默认值设置为true。enable-global-access-to-classes可选当设置为tru
4、e时（默认），可以全局访问资源适配器的类。work-manager可选此复杂元素用来指定用于创建将由资源适配器 bean 使用的工作管理器的所有可配置元素。work-manager元素是从weblogic-j2ee.xsdSchema 中导入的。工作管理器可以动态调整工作线程的数量，以避免因并发限制导致的死锁并可获得最佳吞吐量。它还可以满足响应时间目标、共享和优先级等目标的需要。有关work-manager的子元素的信息，请参阅work-manager。security可选此复杂元素用来指定用于资源适配器操作的所有安全性参数。有关连接器容器将采用的安全性默认值的信息，请参阅security。p
5、roperties可选此复杂元素用来替换在ra.xml文件中为资源适配器 bean 指定的任何属性。有关properties的子元素的信息，请参阅properties。admin-objects可选此复杂元素定义了资源适配器中的所有管理对象。与outbound-resource-adapter复杂元素一样，admin-objects复杂元素具有三个可以指定配置范围的层次属性级别：1. 全局级 - 在此级别可以使用default-properties元素来指定适用于资源适配器的所有管理对象的参数。请参阅default-properties。2. 组级 - 在此级别可以通过使用admin-obje
6、ct-group元素，指定适用于所有域对象（属于ra.xml部署描述符中指定的特定管理对象组）的参数。在该组中指定的属性将替换在全局级指定的任何参数。请参阅admin-object-group。3. 实例级 - 在每个管理对象组下，都可以使用admin-object-instance元素来指定管理对象实例。它们与资源适配器的管理对象实例相对应。可以在实例级别指定属性，并替换那些在组级和全局级提供的属性。请参阅admin-object-instance。有关admin-objects子元素的信息，请参阅admin-objects。outbound-resource-adapter可选此复杂元素用
7、来描述资源适配器的出站组件。与admin-objects复杂元素一样，此元素具有三个层次属性级别，可以指定配置范围用以定义出站连接缓冲池：1. 全局级 - 在此级别，可以使用default-connection-properties元素指定适用于资源适配器中的所有出站连接缓冲池的参数。请参阅default-connection-properties。2. 组级 - 在此级别可以通过使用connection-definition-group元素，指定适用于所有出站连接（属于ra.xml部署描述符中指定的特定连接工厂）的参数。ra.xml中的连接工厂与weblogic-ra.xml中的连接定义组之
8、间存在一一对应关系。在组中指定的属性将替换全局级别上指定的任何参数。请参阅connection-definition-group。3. 实例级 - 在每个连接定义组下，都可以指定连接实例。它们与资源适配器的各个连接缓冲池相对应。也可以在此级别指定参数，且这些参数可以替换那些在组级和全局级提供的参数。请参阅connection-instance。有关outbound-resource-adapter子元素的信息，请参阅outbound-resource-adapter。work-managerwork-manager元素是一种复杂元素，用来指定用于创建资源适配器 bean 将使用的工作管理器的所
9、有可配置元素。work-manager元素是从weblogic-j2ee.xsdSchema 中导入的。下列子元素可以在work-manager元素中配置。表 9-2 work-manager 子元素元素必需可选描述name必需指定工作管理器的名称。J2CA 1.5 规范描述了资源适配器如何向应用服务器提交工作线程。这些工作线程由 WebLogic Server 工作管理器管理。工作管理器可以动态调整工作线程的数量，以避免因并发限制导致的死锁并可获得最佳吞吐量。它还可以满足响应时间目标、共享和优先级等目标的需要。response-time-request-classfair-share-req
10、uest-classcontext-request-classrequest-class-name可选work-manager元素可以且仅可以包括以下四个元素中的一个：response-time-request-class- 定义应用程序的响应时间请求类。响应时间（毫妙）由特性 goal-ms 定义。增量为 (目标 - T) Cr)/R，其中 T 指平均线程使用时间，R 指达到率，Cr 指确定响应时间目标优先于公平共享的系数。fair-share-request-class- 定义公平共享请求类。公平共享由默认共享的属性百分比定义。因此，默认值是 100。增量是 Cf/(P R T)，其中 P
11、 指百分比，R 指达到率，T 指平均线程使用时间，Cf 指公平共享优先级低于响应时间目标的系数。context-request-class- 定义上下文类。上下文由将上下文信息（如当前用户或其角色、cookie 或工作区域字段）映射到已命名的服务类的多个案例定义。request-class-name- 定义请求类名称。min-threads-constraintmin-threads-constraint-name可选可以从以下两种元素之间选择一个：min-threads-constraint- 用来保证服务器向受约束工作集的请求分配的线程数，以避免死锁。默认值为零。例如，对于复制更新请求，最
12、少线程值如果为一（可以从对等方同步调用），则该值非常有用。min-threads-constraint-name- 定义min-threads-constraint元素的名称。max-threads-constraintmax-threads-constraint-name可选可以从以下两种元素之间选择一个：max-threads-constraint- 限制执行来自受约束工作集的请求的并发线程数量。默认值是无限制。例如，假设约束被定义为最多具有 10 个线程，并且由 3 个入口点共享。调度逻辑可确保执行来自三个入口点组合的请求的线程不超过 10 个。max-threads-constrain
13、t-name- 定义max-threads-constraint元素的名称。capacitycapacity-name可选可以从以下两种元素之间选择一个：capacity- 可以定义约束并将其应用于入口点集（称为受约束的工作集）。只有达到该容量时服务器才开始拒绝请求。默认值为零。请注意，容量包括受约束的工作集中已经排队或正在执行的所有请求。此约束主要用于像 JMS 之类的子系统，它们执行自己的流控制。此约束与全局队列阈值无关。capacity-name- 定义capacity元素的名称。securitysecurity 复杂元素包括对连接器容器配置的默认安全性信息。有关详细信息，请参阅为资源适
14、配器配置安全标识。表 9-3 安全子元素元素必需可选描述default-principal-name可选指定用来调用资源适配器的默认安全 ID。如果未指定此值，则默认值为anonymous标识，这等同于没有安全标识。有关此元素的子元素的信息，请参阅default-principal-name。manage-as-principal-name可选指定将用来运行各种资源适配器管理任务的安全 ID，这些任务包括启动、关闭、测试、收缩和事务管理。如果未指定，则默认值为default-principal-name。如果未指定default-principal-name，则默认为anonymous标识。有
15、关此元素的子元素的信息，请参阅manage-as-principal-name。run-as-principal-name可选指定在连接请求期间，从连接器容器到资源适配器代码的所有调用所使用的安全 ID。（此元素当前仅适用于出站功能。）如果未指定，则默认值为default-principal-name。如果未指定default-principal-name，将使用请求调用程序的标识。有关此元素的子元素的信息，请参阅run-as-principal-name。run-work-as-principal-name可选指定用来运行由该资源适配器启动的所有工作实例的安全 ID。如果未指定，则默认值为default-principal-name。如果未指定default-principal-name，则将使用用来启动该工作的标识。有关
