weblogic参数

1、weblogic-ra.xmlSchema本附录中的下面几局部介绍了可以在特定于WebLogicServer的部署描述符weblogic-ra.xml中定义的部署描述符元素。weblogic-ra.xmlSchema是.bea./ns/weblogic/90/weblogic-ra.xsd。如果资源适配器归档文件resourceadapterarchive简称RAR不包含weblogic-ra.xm甑署描述符，WebLogicServer将自动选择部署描述符元素的默认值。?weblogic-connector?work-manager?security?properties?admin-obj

2、ects?outbound-resource-adapterweblogic-connectorweblogic-connecto优素是已部署资源适配器特定于WebLogic部署描述符的根元素。可以在weblogic-connecto阮素中定义以下元素表9-1weblogic-connector子元素儿系必需/可选描述native-libdir如果有本地库，指定资源适配器所需的所有本地库所在的目录。那么为必需。jndi-name仅当指定资源适配W.希bean时为必需。指定资源适配器的JNDI名称。资源适配器bean使用该名称注册到JNDI树中。如果未指定资源适配器bean,那么它不是必需元素。

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

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

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

6、oup元素，指定适用于所有域对象属于ra.xml部署描述符中指定的特定管理对象组的参数。在该组中指定的属性将替换在全局级指定的任何参数。请参阅admin-object-group。3 .实例级-在每个管理对象组下，都可以使用admin-object-instanc玩素来指定管理对象实例。它们与资源适配器的管理对象实例相对应。可以在实例级别指定属性，并替换那些在组级和全局级提供的属性。请参阅admin-object-instance。有关admin-objects子元素的信息，请参阅admin-objectsooutbound-resource-adapter可选此复杂元素用来描述资源适配器的出

7、站组件。与admin-objects复杂儿素一样，此兀素具有二个层次属性级别，可以指定配置围用以定义出站连接缓冲池：1 .全局级-在此级别，可以使用default-connection-propertiese素指定适用于资源适配器中的所有出站连接缓冲池的参数。请参阅default-connection-properties。2 .组级-在此级别可以通过使用connection-definition-group元素，指定适用于所有出站连接属于ra.xml部署描述符中指定的特定连接工厂的参数。ra.xml中的连接工厂与weblogic-ra.xml中的连接定义组之间存在一一对应关系。在组中指定的属

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

9、weblogic-j2ee.xsdchema中导入的。以下子元素可以在work-manage阮素中配置。表9-2work-manager子元素儿系必需可选描述name必指定工作管理器的名称。需J2CA1.5规描述了资源适配器如何向应用效劳器提交工作线程。这些工作线程由WebLogicServer工作管理器管理。工作管理器可以动态调整工作线程的数量，以防止因并发限制导致的死锁并可胀得最正确吞吐量。它还可以满足响应时间目标、共享和优先级等目标的需要。response-time-request-class可work-manage阮素可以且仅可以包括以下四个元素fair-share-request-c

10、lass选context-request-classrequest-class-name中的一个：response-time-request-classt义应用程序的响应时间请求类。响应时间毫妙由特性goal-ms定义。增量为(目标-T)Cr)/R,其中T指平均线程使用时间，R指到达率，Cr指确定响应时间目标优先于公平共享的系数。fair-share-request-class定义公平共享请求类。公平共享由默认共享的属性百分比定义。因此，默认值是100。增量是Cf/(PRT),其中P指百分比，R指到达率，T指平均线程使用时间，Cf指公平共享优先级低于响应时间目标的系数。context-requ

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

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

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

14、等同于没有平安标识。有关此元素的子元素的信息，请参阅default-principal-name。manage-as-principal-name可指定将用来运行各种资源适配器管理任务的平安ID,选这些任务包括启动、关闭、测试、收缩和事务管理。如果未指定，那么默认值为default-principal-name如果未指定default-principal-name那么默认为anonymous!。有关此元素的子元素的信息，请参阅manage-as-principal-namerun-as-principal-name可指定在连接请求期间，从连接器容器到资源适配器代码选的所有调用所使用的平安IDo

15、此元素当前仅适用于出站功能。如果未指定，那么默认值为default-principal-name如果未指定default-principal-name将使用请求倜用程序的标识。有关此元素的子元素的信息，请参阅run-as-principal-name。run-work-as-principal-name可选指定用来运行由该资源适配器启动的所有工作实例的平安IDo如果未指定，那么默认值为default-principal-name如果未指定default-principal-name那么将使用用来启动该工作的标识。有关此元素的子元素的信息，请参阅run-work-as-principal-nam

16、e。default-principal-namedefault-principal-nam航素包含以下子元素表9-4default-principal-name子元素儿系必需可选描述use-anonymous-identity必需指定应使用匿名标识。principal-name必需指定应使用委托人名称。该名称必须与已定义的WebLogicServer用户名称匹配。manage-as-principal-namemanage-as-principal-name素包括以下子元素。表9-5manage-as-principal-namef元素儿系必需可选描述use-anonymous-identit

17、y必需指定应使用匿名标识。principal-name必需指定应使用委托人名称。该名称必须与已定义的WebLogicServer用户名称匹配。run-as-principal-namerun-as-principal-nam沅素包含以下子元素。表9-6run-as-principal-name?元素儿系必需可选描述use-anonymous-identity必需指定应使用匿名标识。principal-name必需指定应使用委托人名称。该名称必须与已定义的WebLogicServer用户名称匹配。use-caller-identity必需指定应使用调用程序的标识。run-work-as-prin

18、cipal-namerun-work-as-principal-nam沅素包含以下子元素。表9-7run-work-as-principal-name子元素儿系必需可选描述use-anonymous-identity必需指定应使用anonymous。principal-name必需指定应使用委托人名称。该名称必须与已定义的WebLogicServer用户名称匹配。use-caller-identity必需指定应使用调用程序的标识。propertiesproperties元素是weblogic-connector勺子元素，它是在ra.xml中为资源适配器bean指定的属性的容器。它拥有一个或多个

19、property元素。可以在properties元素定义如下property元素表9-8properties子元素儿系必需可选描述property必需property元素用来替换在ra.xml文件中为资源适配器bean指定的属性。它拥有以卜两个子元素：name-指定与config-property-nam航素ra.xml部署描述符中的con巾g-property的子元素一样的名称。设置此参数会导致替换ra.xml中相关的config-property-value素。这是必需的元素。value-指定替换con巾g-property-valu航素ra.xml部署描述符中的con巾g-propert

20、y的子元素的值。这是可选元素。admin-objectsadmin-objects复杂元素定义了资源适配器中的所有管理对象。与outbound-resource-adapterM杂元素一样，admin-objects复杂元素具有可以指定的三个层次属性级别。admin-objects元素是weblogic-connecto玩素的子元素。可以在admin-objectse素中定义以下元素。表9-9admin-objects子元素儿系必需可选描述default-properties可选指定适用于资源适配器中所有管理对象全局级的默认属性。default-properties素可以包含一个或多个属性元素

21、，每个属性元素都有name和value对。请参阅properties。admin-object-group一个指定适用于所有管理对象属于在ra.xml部署描述符中指或多个定的特定管理对象组的默认参数。在该组中指定的属性将替换在全局级指定的任何参数。有关admin-object-group?元素的信息，请参阅admin-object-group。admin-object-groupadmin-object-group素用来定义管理对象组。在组级别指定适用于所有管理对象属于ra.xml部署描述符中指定的特定管理对象组的参数。在该组中指定的属性将替换在全局级指定的任何参数。admin-object-

22、interfac沅素admin-object-grou丽素的子元素将作为每个admin-object-group的唯一必备元素关键字。weblogic-ra.xmladmin-object-interfacee素和ra.xmladminobject-interfac比素之间必须是一一对应的关系admin-object-group素是weblogic-connecto玩素的子元素。可以在admin-object-group素中定义以下元素。表9-10admin-object-group儿系必需可选描述admin-object-interface必需admin-object-interfac所素是

23、每个admin-object-group的唯一必备元素关键字。weblogic-ra.xmladmin-object-interfacee素和ra.xmladminobject-interfacee素之间必须是对应的关系。default-properties可指定适用于此管理对象组中的所有管理对象的默认属性。选default-propertiesytX以包括一个或多个property元素，每个兀素都有name和value对。请参阅properties。admin-object-instance个指定该管理对象组中的一个或多个管理对象实例，它们与资源适配器的管理对象实例相对应。可以在实例级别指定

24、属或性，并替换在组级和全局级别提供的那些属性。有关子元素多的桁息，请参阅admin-object-instance。个admin-object-instance可以在admin-object-instancer定义以下子元素表9-11admin-object-instance?元素儿系必描述需可选jndi-name/resource-link必需定义管理对象实例引用名称的管理对象组。可以将引用名称指定为连接实例的JNDI名称或资源。如果指定了jndi名称通过指定jndi-name元素，将把连接缓冲池绑定到客户端在应用程序之外可以看到的JNDI中。注息：为了使止匕设置生效，enable-acce

25、ss-outside-apM素必须设置为true。对于那些不需要从外部对其他应用程序可视的资源适配器，需要指定resource-link1。admin-object-properties可选定义适用于管理对象实例的所有属性。admin-object-propertiese素可以包括一个或多个property元素，每个元素者B有name和value对。请参1阅properties。outbound-resource-adapteroutbound-resource-adapter素是weblogic-connecto玩素的子元素。可以在outbound-resource-adapter素中定义以

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

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

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

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

30、di制类型必须支持javax.resource.spi.security.PasswordCredernfial口。reauthentication-support可是布尔值，用来指定特定连接工厂是否支持对现选有ManagedConnection例重新进展身份验证。它提供了替换在ra.xml部署描述符中指定的reauthentication-supportt的能力，该值本来是资源适配器的所有连接工厂的默认值。properties可选properties兀素包拒L个或多个property九素，后者正义了适用于默认连接的子元素的名称和值。res-auth可选指定是否使用容器或应用程序管理的平安性。

31、此元素的值可以是Application或Container默认值是Containeropool-paramspool-params素是default-connection-propertiesfi素的子元素。可以在pool-params素中定义以下元素。表9-14pool-params子元素儿系必需可选描述initial-capacity可选指定部署期间WebLogicServer尝试创立的ManagedConnections的初始数量。默认值：1max-capacity可选指定WebLogicServer允许的ManagedConnections最大数量。如果新分配ManagedConnec

32、tions的请求超出此限制，那么会导致将ResourceAllocationExceptio帼回给调用程序。默认值：10capacity-increment可选指定在重新调整保存的连接缓冲池期间，WebLogicServer尝试创立的附加ManagedConnections的最大数量。默认值：1shrinking-enabled可选指定是否销毁未使用的ManagedConnections并将其从连接缓冲池中删除，这是一种控制系统资源的手段。默认值：trueshrink-frequency-seconds可选指定ConnectionPoolManagement在连续两次尝试销毁未使用的Manag

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

34、-timeout-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，那么WebLogicServer将在连接请求期间绕过此方法调用。默认值：truelogginglogging兀素是default-connection-propertiesc素的子兀素。可以

36、在logging兀素中定乂以下元素表9-15logging子元素儿系必需可选描述log-filename可指定日志文件的名称，根据此日志发送选从ManagedConnectionFactoryManagedConnection生成的输出。需要提供该文件名的完整地址。logging-enabled可选指定是否为ManagedConnectionFactoryManagedConnection设置了日志编写器。如果将此元素设置为true,那么从ManagedConnectionFactoryManagedConnection中生成的输出将发送到由log-filename元素指定的文件。默认值：fa

37、lserotation-type可选设置文件滚动类型。可能值包括bySizebyName和nonebySize-当日志文件大小到达在file-size-limit中指定的大小时，效劳器将把该文件重命名为FileName.rtbyName-按照在file-time-span中指定的时间间隔，效劳器将该文件重命名为FileName.n）在效劳器重命名某个文件之后，后续的消息会累积在一个名称在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勺滚动类型。日志文件到达指定的最小大小之后，效劳器会在下次检查文件大小时将当前的日志文件重命名为FileName.n并新建一个用来存储后续消息的文件。默认值：500rotate-log-on-startup可选指定效劳器在其启动周期是否滚动其日志文件。默认值：truelog-file-rotation-dir可选指定将存储滚动日志文件的目录的路径。rotation-time可选日志文件基于时间滚动顺序的开场时间的格式为k:mm,其中k是1-24。需要指定byTime的滚动类型。在到达指定时间时，效劳器会重命名当前的日志文件。之后，效劳器将按照在file-time-span中指定的间隔重命名日志文件。如果指定的时刻已过，效劳器会立即开场其文件滚动。默认情况下，滚动周期会立即开场。fil