weblogic参数

1、-作者xxxx-日期xxxxweblogic参数【精品文档】weblogic-ra.xml Schema本附录中的下面几部分介绍了可以在特定于 WebLogic Server 的部署描述符 weblogic-ra.xml 中定义的部署描述符元素。的 Schema 是。如果资源适配器归档文件（resource adapter archive，简称 RAR）不包含部署描述符，WebLogic Server 将自动选择部署描述符元素的默认值。 weblogic-connector work-manager security properties admin-objects outbound-reso

2、urce-adapterweblogic-connectorweblogic-connector元素是已部署资源适配器特定于 WebLogic 部署描述符的根元素。可以在weblogic-connector元素中定义下列元素。表 9-1weblogic-connector 子元素元素必需/可选描述native-libdir如果有本地库，则为必需。指定资源适配器所需的所有本地库所在的目录。jndi-name仅当指定资源适配器 bean 时为必需。指定资源适配器的 JNDI 名称。资源适配器 bean 使用该名称注册到 JNDI 树中。如果未指定资源适配器 bean，则它不是必需元素。如果为没有资

3、源适配器 bean 的资源适配器指定了 JNDI 名称，则它是一个不起作用的元素。enable-access-outside-app可选正如 J2CA 1.5 规范中所述，如果将资源适配器打包到某个应用程序中（换句话说，就是打包到 EAR 中），则只有该应用程序内的组件才有权访问该资源适配器。使用此元素可以改变这一功能。注意：此元素不适用于独立资源适配器。默认值：false当设置为 false 时，资源适配器只能由与该资源适配器驻留在同一应用程序中的客户端访问。注意：对于版本 1.0 资源适配器（受本版本中支持），此元素的默认值设置为true。enable-global-access-to-c

4、lasses可选当设置为true时（默认），可以全局访问资源适配器的类。work-manager可选此复杂元素用来指定用于创建将由资源适配器 bean 使用的工作管理器的所有可配置元素。work-manager元素是从Schema 中导入的。工作管理器可以动态调整工作线程的数量，以避免因并发限制导致的死锁并可获得最佳吞吐量。它还可以满足响应时间目标、共享和优先级等目标的需要。有关work-manager的子元素的信息，请参阅work-manager。security可选此复杂元素用来指定用于资源适配器操作的所有安全性参数。有关连接器容器将采用的安全性默认值的信息，请参阅security。pro

5、perties可选此复杂元素用来替换在文件中为资源适配器 bean 指定的任何属性。有关properties的子元素的信息，请参阅properties。admin-objects可选此复杂元素定义了资源适配器中的所有管理对象。与outbound-resource-adapter复杂元素一样，admin-objects复杂元素具有三个可以指定配置范围的层次属性级别：1. 全局级 - 在此级别可以使用default-properties元素来指定适用于资源适配器的所有管理对象的参数。请参阅default-properties。2. 组级 - 在此级别可以通过使用admin-object-group

6、元素，指定适用于所有域对象（属于部署描述符中指定的特定管理对象组）的参数。在该组中指定的属性将替换在全局级指定的任何参数。请参阅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元素，指定适用于所有出站连接（属于部署描述符中指定的特定连接工厂）的参数。中的连接工厂与中的连接定义组之间存在一一对应关系。在组中指定的属性将替换全局级别上指定的任何参数。请参阅conn

8、ection-definition-group。3. 实例级 - 在每个连接定义组下，都可以指定连接实例。它们与资源适配器的各个连接缓冲池相对应。也可以在此级别指定参数，且这些参数可以替换那些在组级和全局级提供的参数。请参阅connection-instance。有关outbound-resource-adapter子元素的信息，请参阅outbound-resource-adapter。work-managerwork-manager元素是一种复杂元素，用来指定用于创建资源适配器 bean 将使用的工作管理器的所有可配置元素。work-manager元素是从Schema 中导入的。下列子元素可

9、以在work-manager元素中配置。表 9-2 work-manager 子元素元素必需可选描述name必需指定工作管理器的名称。J2CA 1.5 规范描述了资源适配器如何向应用服务器提交工作线程。这些工作线程由 WebLogic Server 工作管理器管理。工作管理器可以动态调整工作线程的数量，以避免因并发限制导致的死锁并可获得最佳吞吐量。它还可以满足响应时间目标、共享和优先级等目标的需要。response-time-request-classfair-share-request-classcontext-request-classrequest-class-name可选work-ma

10、nager元素可以且仅可以包括以下四个元素中的一个：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-re

11、quest-class- 定义上下文类。上下文由将上下文信息（如当前用户或其角色、cookie 或工作区域字段）映射到已命名的服务类的多个案例定义。request-class-name- 定义请求类名称。min-threads-constraintmin-threads-constraint-name可选可以从以下两种元素之间选择一个：min-threads-constraint- 用来保证服务器向受约束工作集的请求分配的线程数，以避免死锁。默认值为零。例如，对于复制更新请求，最少线程值如果为一（可以从对等方同步调用），则该值非常有用。min-threads-constraint-name-

12、定义min-threads-constraint元素的名称。max-threads-constraintmax-threads-constraint-name可选可以从以下两种元素之间选择一个：max-threads-constraint- 限制执行来自受约束工作集的请求的并发线程数量。默认值是无限制。例如，假设约束被定义为最多具有 10 个线程，并且由 3 个入口点共享。调度逻辑可确保执行来自三个入口点组合的请求的线程不超过 10 个。max-threads-constraint-name- 定义max-threads-constraint元素的名称。capacitycapacity-nam

13、e可选可以从以下两种元素之间选择一个：capacity- 可以定义约束并将其应用于入口点集（称为受约束的工作集）。只有达到该容量时服务器才开始拒绝请求。默认值为零。请注意，容量包括受约束的工作集中已经排队或正在执行的所有请求。此约束主要用于像 JMS 之类的子系统，它们执行自己的流控制。此约束与全局队列阈值无关。capacity-name- 定义capacity元素的名称。securitysecurity 复杂元素包括对连接器容器配置的默认安全性信息。有关详细信息，请参阅为资源适配器配置安全标识。表 9-3 安全子元素元素必需可选描述default-principal-name可选指定用来调用

14、资源适配器的默认安全 ID。如果未指定此值，则默认值为anonymous标识，这等同于没有安全标识。有关此元素的子元素的信息，请参阅default-principal-name。manage-as-principal-name可选指定将用来运行各种资源适配器管理任务的安全 ID，这些任务包括启动、关闭、测试、收缩和事务管理。如果未指定，则默认值为default-principal-name。如果未指定default-principal-name，则默认为anonymous标识。有关此元素的子元素的信息，请参阅manage-as-principal-name。run-as-principal-n

15、ame可选指定在连接请求期间，从连接器容器到资源适配器代码的所有调用所使用的安全 ID。（此元素当前仅适用于出站功能。）如果未指定，则默认值为default-principal-name。如果未指定default-principal-name，将使用请求调用程序的标识。有关此元素的子元素的信息，请参阅run-as-principal-name。run-work-as-principal-name可选指定用来运行由该资源适配器启动的所有工作实例的安全 ID。如果未指定，则默认值为default-principal-name。如果未指定default-principal-name，则将使用用来启动

16、该工作的标识。有关此元素的子元素的信息，请参阅run-work-as-principal-name。default-principal-namedefault-principal-name元素包含下列子元素。表 9-4 default-principal-name 子元素元素必需可选描述use-anonymous-identity必需指定应使用匿名标识。principal-name必需指定应使用委托人名称。该名称必须与已定义的 WebLogic Server 用户名称匹配。manage-as-principal-namemanage-as-principal-name元素包括下列子元素。表 9

17、-5 manage-as-principal-name 子元素元素必需可选描述use-anonymous-identity必需指定应使用匿名标识。principal-name必需指定应使用委托人名称。该名称必须与已定义的 WebLogic Server 用户名称匹配。run-as-principal-namerun-as-principal-name元素包含下列子元素。表 9-6 run-as-principal-name 子元素元素必需可选描述use-anonymous-identity必需指定应使用匿名标识。principal-name必需指定应使用委托人名称。该名称必须与已定义的 Web

18、Logic Server 用户名称匹配。use-caller-identity必需指定应使用调用程序的标识。run-work-as-principal-namerun-work-as-principal-name元素包含下列子元素。表 9-7 run-work-as-principal-name 子元素元素必需可选描述use-anonymous-identity必需指定应使用anonymous标识。principal-name必需指定应使用委托人名称。该名称必须与已定义的 WebLogic Server 用户名称匹配。use-caller-identity必需指定应使用调用程序的标识。prop

19、ertiesproperties元素是weblogic-connector的子元素，它是在中为资源适配器 bean 指定的属性的容器。它拥有一个或多个property元素。可以在properties元素内定义如下property元素。表 9-8 properties 子元素元素必需可选描述property必需property 元素用来替换在文件中为资源适配器 bean 指定的属性。它拥有以下两个子元素：name- 指定与config-property-name元素（部署描述符中的config-property的子元素）相同的名称。设置此参数会导致替换中相关的config-property-va

20、lue元素。这是必需的元素。value- 指定替换config-property-value元素（部署描述符中的config-property的子元素）的值。这是可选元素。admin-objectsadmin-objects复杂元素定义了资源适配器中的所有管理对象。与outbound-resource-adapter复杂元素一样，admin-objects复杂元素具有可以指定的三个层次属性级别。admin-objects元素是weblogic-connector元素的子元素。可以在admin-objects元素中定义下列元素。表 9-9 admin-objects 子元素元素必需可选描述def

21、ault-properties可选指定适用于资源适配器中所有管理对象（全局级）的默认属性。default-properties元素可以包含一个或多个属性元素，每个属性元素都有name和value对。请参阅properties。admin-object-group一个或多个指定适用于所有管理对象（属于在部署描述符中指定的特定管理对象组）的默认参数。在该组中指定的属性将替换在全局级指定的任何参数。有关admin-object-group子元素的信息，请参阅admin-object-group。admin-object-groupadmin-object-group元素用来定义管理对象组。在组级别指

22、定适用于所有管理对象（属于部署描述符中指定的特定管理对象组）的参数。在该组中指定的属性将替换在全局级指定的任何参数。admin-object-interface元素（admin-object-group元素的子元素）将作为每个admin-object-group的唯一必备元素（关键字）。admin-object-interface元素和元素之间必须是一一对应的关系admin-object-group元素是weblogic-connector元素的子元素。可以在admin-object-group元素中定义下列元素。表 9-10 admin-object-group元素必需可选描述admin-o

23、bject-interface必需admin-object-interface元素是每个admin-object-group的唯一必备元素（关键字）。admin-object-interface元素和adminobject-interface元素之间必须是一一对应的关系。default-properties可选指定适用于此管理对象组中的所有管理对象的默认属性。default-properties元素可以包括一个或多个property元素，每个元素都有name和value对。请参阅properties。admin-object-instance一个或多个指定该管理对象组中的一个或多个管理对象实例

24、，它们与资源适配器的管理对象实例相对应。可以在实例级别指定属性，并替换在组级和全局级别提供的那些属性。有关子元素的信息，请参阅admin-object-instance。admin-object-instance可以在admin-object-instance下定义下列子元素。表 9-11 admin-object-instance 子元素元素必需可选描述jndi-name / resource-link必需定义管理对象实例引用名称的管理对象组。可以将引用名称指定为连接实例的 JNDI 名称或资源链接。如果指定了 JNDI 名称（通过指定jndi-name元素），将把连接缓冲池绑定到客户端在应

25、用程序之外可以看到的 JNDI 中。注意：为了使此设置生效，enable-access-outside-app元素必须设置为 true。对于那些不需要从外部对其他应用程序可视的资源适配器，需要指定resource-link值。admin-object-properties可选定义适用于管理对象实例的所有属性。admin-object-properties元素可以包括一个或多个property元素，每个元素都有name和value对。请参阅properties。outbound-resource-adapteroutbound-resource-adapter元素是weblogic-connec

26、tor元素的子元素。可以在outbound-resource-adapter元素中定义下列元素。表 9-12 outbound-resource-adapter 子元素元素必需可选描述default-connection-properties可选此复杂元素用来在全局级指定属性。在此级别，用户能够指定适用于该资源适配器中的所有出站连接缓冲池的参数。有关子元素的信息，请参阅default-connection-properties。connection-definition-group一个或多个此元素用来指定所有连接定义组。在部署描述符中的连接工厂和部署描述符中的组之间必须有一一对应关系。对于的每

27、个连接工厂，部署描述符中不一定存在组。但是，如果存在一个组，则该组中必须至少有一个连接实例。在组中指定的属性将替代使用default-connection-properties在全局级指定的所有参数。有关子元素的信息，请参阅connection-definition-group。default-connection-propertiesdefault-connection-properties元素是outbound-resource-adapter元素的子元素。可以在default-connection-properties元素中定义下列元素。表 9-13 default-connection

28、-properties 子元素元素必需可选描述pool-params可选用作为此连接工厂提供特定于连接缓冲池的参数的根元素。WebLogic Server 使用这些规范来控制 ManagedConnections 的保留缓冲池的行为。这是可选元素。指定此元素或其任何特定元素项失败将导致分配默认值。请参考对每个具体元素的描述，以了解指定的默认值。有关子元素的信息，请参阅pool-params。logging可选包含用于配置ManagedConnectionFactory的日志记录和资源适配器的ManagedConnection对象的参数。有关子元素的信息，请参阅logging。transacti

29、on-support可选指定特定连接工厂的事务支持的级别。它提供了替换在部署描述符中指定的事务支持值的能力，该值本来是资源适配器的所有连接工厂的默认值。事务支持的值必须为下列值之一：NoTransactionLocalTransactionXATransaction相关信息，请参阅连接管理。authentication-mechanism可选authentication-mechanism元素指定了资源适配器中特定连接工厂所支持的身份验证机制。它提供了替换在部署描述符中指定的authentication-mechanism值的能力，该值本来是资源适配器的所有连接工厂的默认值。请注意，Basic

30、Password机制类型必须支持接口。reauthentication-support可选是布尔值，用来指定特定连接工厂是否支持对现有ManagedConnection实例重新进行身份验证。它提供了替换在部署描述符中指定的reauthentication-support值的能力，该值本来是资源适配器的所有连接工厂的默认值。properties可选properties 元素包括一个或多个 property 元素，后者定义了适用于默认连接的子元素的名称和值。res-auth可选指定是否使用容器或应用程序管理的安全性。此元素的值可以是Application或Container。默认值是 Contai

31、ner。pool-paramspool-params元素是default-connection-properties元素的子元素。可以在pool-params元素中定义下列元素。表 9-14 pool-params 子元素元素必需可选描述initial-capacity可选指定部署期间 WebLogic Server 尝试创建的 ManagedConnections 的初始数量。默认值：1max-capacity可选指定 WebLogic Server 允许的 ManagedConnections 最大数量。如果新分配 ManagedConnections 的请求超出此限制，则会导致将Reso

32、urceAllocationException返回给调用程序。默认值：10capacity-increment可选指定在重新调整保留的连接缓冲池期间，WebLogic Server 尝试创建的附加 ManagedConnections 的最大数量。默认值：1shrinking-enabled可选指定是否销毁未使用的 ManagedConnections 并将其从连接缓冲池中删除，这是一种控制系统资源的手段。默认值：trueshrink-frequency-seconds可选指定 Connection Pool Management 在连续两次尝试销毁未使用的 ManagedConnection

33、s 之间需要等待的时间（以秒为单位）。默认值：900 秒highest-num-waiters可选指定可以并发阻止等待的最大线程数，以保留与缓冲池的连接。默认值：0highest-num-unavailable可选指定应用程序在进行诸如刷新连接等操作时，缓冲池中不可用 ManagedConnections 的最大数。请注意，在后端系统不可用等情况下，由于存在一些缓冲池无法控制的因素，实际数可能会超出此指定值。默认值：0connection-creation-retry-frequency-seconds可选缓冲池创建连接重试尝试的周期。默认值：0connection-reserve-timeo

34、ut-seconds可选设置保留与缓冲池的连接的调用超时前持续的时间（以秒为单位）。默认值：-1（保留资源时不阻塞）test-frequency-seconds可选对缓冲池中的连接的测试频率。默认值：0test-connections-on-create可选启用对新建连接的测试。默认值：falsetest-connections-on-release可选启用将连接释放到缓冲池时对这些连接进行测试。默认值：falsetest-connections-on-reserve可选启用在保留连接时对它们进行测试。默认值：falseprofile-harvest-frequency-seconds可选指定

35、收集连接缓冲池的配置文件的频率。ignore-in-use-connections-enabled可选此元素用来指定关闭连接缓冲池时，忽略当时正在使用的连接是否可以接受。match-connections-supported可选指出资源适配器是否支持ManagedConnectionFactory.matchManagedConnections()方法。如果资源适配器不支持此方法（始终对此方法返回 null），则 WebLogic Server 将在连接请求期间绕过此方法调用。默认值：truelogginglogging元素是default-connection-properties元素的子元

36、素。可以在logging元素中定义下列元素。表 9-15 logging 子元素元素必需可选描述log-filename可选指定日志文件的名称，根据此日志发送从ManagedConnectionFactory或ManagedConnection生成的输出。需要提供该文件名的完整地址。logging-enabled可选指定是否为ManagedConnectionFactory或ManagedConnection设置了日志编写器。如果将此元素设置为 true，则从ManagedConnectionFactory或ManagedConnection中生成的输出将发送到由log-filename元素指

37、定的文件。默认值：falserotation-type可选设置文件滚动类型。可能值包括bySize、byName和nonebySize- 当日志文件大小达到在file-size-limit中指定的大小时，服务器将把该文件重命名为。byName- 按照在 file-time-span 中指定的时间间隔，服务器将该文件重命名为。在服务器重命名某个文件之后，后续的消息会累积在一个名称在log-filename中指定的新文件中。none- 消息累积在单个文件中。当日志文件太大而影响使用时，必须清除其内容。默认值：bySizenumber-of-files-limited可选指定是否限制此服务器实例为存

38、储旧日志消息而创建的文件的数量。（需要指定bySize的滚动类型）。服务器达到此限制后，它将覆盖最旧的文件。如果不启用此选项，服务器将无限制地创建新文件，这样就必须在需要时清除这些文件。如果通过将number-of-files-limited设置为 true 启用该选项，则服务器将参考rotationType变量来决定如何滚动该日志文件。滚动意味着替换现有文件而不是创建新文件。如果将number-of-files-limited指定为false，则服务器将创建大量日志文件而不是替换同一个日志文件。默认值：falsefile-count可选服务器在滚动日志时创建的日志文件的最大数量。该数目不包括

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