weblogic参数.docx
- 文档编号:22898879
- 上传时间:2023-04-28
- 格式:DOCX
- 页数:28
- 大小:23.87KB
weblogic参数.docx
《weblogic参数.docx》由会员分享,可在线阅读,更多相关《weblogic参数.docx(28页珍藏版)》请在冰豆网上搜索。
weblogic参数
weblogic-ra.xmlSchema
本附录中的下面几部分介绍了可以在特定于WebLogicServer的部署描述符weblogic-ra.xml中定义的部署描述符元素。
weblogic-ra.xml 的Schema是 adapterarchive,简称RAR)不包含 weblogic-ra.xml 部署描述符,WebLogicServer将自动选择部署描述符元素的默认值。
▪weblogic-connector
▪work-manager
▪security
▪properties
▪admin-objects
▪outbound-resource-adapter
weblogic-connector
weblogic-connector 元素是已部署资源适配器特定于WebLogic部署描述符的根元素。
可以在 weblogic-connector 元素中定义下列元素。
表9-1 weblogic-connector子元素
元素
必需/
可选
描述
native-libdir
如果有本地库,则为必需。
指定资源适配器所需的所有本地库所在的目录。
jndi-name
仅当指定资源适配器bean时为必需。
指定资源适配器的JNDI名称。
资源适配器bean使用该名称注册到JNDI树中。
如果未指定资源适配器bean,则它不是必需元素。
如果为没有资源适配器bean的资源适配器指定了JNDI名称,则它是一个不起作用的元素。
enable-access-outside-app
可选
正如J2CA1.5规范中所述,如果将资源适配器打包到某个应用程序中(换句话说,就是打包到EAR中),则只有该应用程序内的组件才有权访问该资源适配器。
使用此元素可以改变这一功能。
注意:
此元素不适用于独立资源适配器。
默认值:
false
当设置为false时,资源适配器只能由与该资源适配器驻留在同一应用程序中的客户端访问。
注意:
对于版本1.0资源适配器(受本版本中支持),此元素的默认值设置为 true。
enable-global-access-to-
classes
可选
当设置为 true 时(默认),可以全局访问资源适配器的类。
work-manager
可选
此复杂元素用来指定用于创建将由资源适配器bean使用的工作管理器的所有可配置元素。
work-manager 元素是从 weblogic-j2ee.xsd Schema中导入的。
工作管理器可以动态调整工作线程的数量,以避免因并发限制导致的死锁并可获得最佳吞吐量。
它还可以满足响应时间目标、共享和优先级等目标的需要。
有关 work-manager 的子元素的信息,请参阅 work-manager。
security
可选
此复杂元素用来指定用于资源适配器操作的所有安全性参数。
有关连接器容器将采用的安全性默认值的信息,请参阅 security。
properties
可选
此复杂元素用来替换在 ra.xml 文件中为资源适配器bean指定的任何属性。
有关 properties 的子元素的信息,请参阅 properties。
admin-objects
可选
此复杂元素定义了资源适配器中的所有管理对象。
与 outbound-resource-adapter 复杂元素一样,admin-objects 复杂元素具有三个可以指定配置范围的层次属性级别:
1.全局级-在此级别可以使用 default-properties 元素来指定适用于资源适配器的所有管理对象的参数。
请参阅 default-properties。
2.组级-在此级别可以通过使用 admin-object-group 元素,指定适用于所有域对象(属于 ra.xml 部署描述符中指定的特定管理对象组)的参数。
在该组中指定的属性将替换在全局级指定的任何参数。
请参阅 admin-object-group。
3.实例级-在每个管理对象组下,都可以使用 admin-object-instance 元素来指定管理对象实例。
它们与资源适配器的管理对象实例相对应。
可以在实例级别指定属性,并替换那些在组级和全局级提供的属性。
请参阅 admin-object-instance。
有关 admin-objects 子元素的信息,请参阅 admin-objects。
outbound-resource-adapter
可选
此复杂元素用来描述资源适配器的出站组件。
与 admin-objects 复杂元素一样,此元素具有三个层次属性级别,可以指定配置范围用以定义出站连接缓冲池:
1.全局级-在此级别,可以使用 default-connection-properties 元素指定适用于资源适配器中的所有出站连接缓冲池的参数。
请参阅 default-connection-properties。
2.组级-在此级别可以通过使用 connection-definition-group 元素,指定适用于所有出站连接(属于 ra.xml 部署描述符中指定的特定连接工厂)的参数。
ra.xml 中的连接工厂与 weblogic-ra.xml 中的连接定义组之间存在一一对应关系。
在组中指定的属性将替换全局级别上指定的任何参数。
请参阅 connection-definition-group。
3.实例级-在每个连接定义组下,都可以指定连接实例。
它们与资源适配器的各个连接缓冲池相对应。
也可以在此级别指定参数,且这些参数可以替换那些在组级和全局级提供的参数。
请参阅 connection-instance。
有关 outbound-resource-adapter 子元素的信息,请参阅 outbound-resource-adapter。
work-manager
work-manager 元素是一种复杂元素,用来指定用于创建资源适配器bean将使用的工作管理器的所有可配置元素。
work-manager 元素是从 weblogic-j2ee.xsd Schema中导入的。
下列子元素可以在 work-manager 元素中配置。
表9-2work-manager子元素
元素
必需
可选
描述
name
必需
指定工作管理器的名称。
J2CA1.5规范描述了资源适配器如何向应用服务器提交工作线程。
这些工作线程由WebLogicServer工作管理器管理。
工作管理器可以动态调整工作线程的数量,以避免因并发限制导致的死锁并可获得最佳吞吐量。
它还可以满足响应时间目标、共享和优先级等目标的需要。
response-time-request-class
fair-share-request-class
context-request-class
request-class-name
可选
work-manager 元素可以且仅可以包括以下四个元素中的一个:
response-time-request-class -定义应用程序的响应时间请求类。
响应时间(毫妙)由特性goal-ms定义。
增量为((目标-T)Cr)/R,其中T指平均线程使用时间,R指达到率,Cr指确定响应时间目标优先于公平共享的系数。
fair-share-request-class -定义公平共享请求类。
公平共享由默认共享的属性百分比定义。
因此,默认值是100。
增量是Cf/(PRT),其中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 元素的名称。
security
security复杂元素包括对连接器容器配置的默认安全性信息。
有关详细信息,请参阅为资源适配器配置安全标识。
表9-3安全子元素
元素
必需
可选
描述
default-principal-name
可选
指定用来调用资源适配器的默认安全ID。
如果未指定此值,则默认值为 anonymous 标识,这等同于没有安全标识。
有关此元素的子元素的信息,请参阅 default-principal-name。
manage-as-principal-name
可选
指定将用来运行各种资源适配器管理任务的安全ID,这些任务包括启动、关闭、测试、收缩和事务管理。
如果未指定,则默认值为 default-principal-name。
如果未指定 default-principal-name,则默认为 anonymous 标识。
有关此元素的子元素的信息,请参阅 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,则将使用用来启动该工作的标识。
有关此元素的子元素的信息,请参阅 run-work-as-principal-name。
default-principal-name
default-principal-name 元素包含下列子元素。
表9-4default-principal-name子元素
元素
必需
可选
描述
use-anonymous-identity
必需
指定应使用匿名标识。
principal-name
必需
指定应使用委托人名称。
该名称必须与已定义的WebLogicServer用户名称匹配。
manage-as-principal-name
manage-as-principal-name 元素包括下列子元素。
表9-5manage-as-principal-name子元素
元素
必需
可选
描述
use-anonymous-identity
必需
指定应使用匿名标识。
principal-name
必需
指定应使用委托人名称。
该名称必须与已定义的WebLogicServer用户名称匹配。
run-as-principal-name
run-as-principal-name 元素包含下列子元素。
表9-6run-as-principal-name子元素
元素
必需
可选
描述
use-anonymous-identity
必需
指定应使用匿名标识。
principal-name
必需
指定应使用委托人名称。
该名称必须与已定义的WebLogicServer用户名称匹配。
use-caller-identity
必需
指定应使用调用程序的标识。
run-work-as-principal-name
run-work-as-principal-name 元素包含下列子元素。
表9-7run-work-as-principal-name子元素
元素
必需
可选
描述
use-anonymous-identity
必需
指定应使用 anonymous 标识。
principal-name
必需
指定应使用委托人名称。
该名称必须与已定义的WebLogicServer用户名称匹配。
use-caller-identity
必需
指定应使用调用程序的标识。
properties
properties 元素是 weblogic-connector 的子元素,它是在 ra.xml 中为资源适配器bean指定的属性的容器。
它拥有一个或多个 property 元素。
可以在 properties 元素内定义如下 property 元素。
表9-8properties子元素
元素
必需
可选
描述
property
必需
property元素用来替换在 ra.xml 文件中为资源适配器bean指定的属性。
它拥有以下两个子元素:
name -指定与 config-property-name 元素(ra.xml 部署描述符中的 config-property 的子元素)相同的名称。
设置此参数会导致替换 ra.xml 中相关的 config-property-value 元素。
这是必需的元素。
value -指定替换 config-property-value 元素(ra.xml 部署描述符中的 config-property 的子元素)的值。
这是可选元素。
admin-objects
admin-objects 复杂元素定义了资源适配器中的所有管理对象。
与 outbound-resource-adapter 复杂元素一样,admin-objects 复杂元素具有可以指定的三个层次属性级别。
admin-objects 元素是 weblogic-connector 元素的子元素。
可以在 admin-objects 元素中定义下列元素。
表9-9admin-objects子元素
元素
必需
可选
描述
default-properties
可选
指定适用于资源适配器中所有管理对象(全局级)的默认属性。
default-properties 元素可以包含一个或多个属性元素,每个属性元素都有 name 和 value 对。
请参阅 properties。
admin-object-group
一个或多个
指定适用于所有管理对象(属于在 ra.xml 部署描述符中指定的特定管理对象组)的默认参数。
在该组中指定的属性将替换在全局级指定的任何参数。
有关 admin-object-group 子元素的信息,请参阅 admin-object-group。
admin-object-group
admin-object-group 元素用来定义管理对象组。
在组级别指定适用于所有管理对象(属于 ra.xml 部署描述符中指定的特定管理对象组)的参数。
在该组中指定的属性将替换在全局级指定的任何参数。
admin-object-interface 元素(admin-object-group 元素的子元素)将作为每个 admin-object-group 的唯一必备元素(关键字)。
weblogic-ra.xml admin-object-interface 元素和 ra.xmladminobject-interface 元素之间必须是一一对应的关系
admin-object-group 元素是 weblogic-connector 元素的子元素。
可以在 admin-object-group 元素中定义下列元素。
表9-10admin-object-group
元素
必需
可选
描述
admin-object-interface
必需
admin-object-interface 元素是每个 admin-object-group 的唯一必备元素(关键字)。
weblogic-ra.xml admin-object-interface 元素和 ra.xml adminobject-interface 元素之间必须是一一对应的关系。
default-properties
可选
指定适用于此管理对象组中的所有管理对象的默认属性。
default-properties 元素可以包括一个或多个 property 元素,每个元素都有 name 和 value 对。
请参阅 properties。
admin-object-instance
一个或多个
指定该管理对象组中的一个或多个管理对象实例,它们与资源适配器的管理对象实例相对应。
可以在实例级别指定属性,并替换在组级和全局级别提供的那些属性。
有关子元素的信息,请参阅 admin-object-instance。
admin-object-instance
可以在 admin-object-instance 下定义下列子元素。
表9-11admin-object-instance子元素
元素
必需
可选
描述
jndi-name/resource-link
必需
定义管理对象实例引用名称的管理对象组。
可以将引用名称指定为连接实例的JNDI名称或资源链接。
如果指定了JNDI名称(通过指定 jndi-name 元素),将把连接缓冲池绑定到客户端在应用程序之外可以看到的JNDI中。
注意:
为了使此设置生效,enable-access-outside-app 元素必须设置为true。
对于那些不需要从外部对其他应用程序可视的资源适配器,需要指定 resource-link 值。
admin-object-properties
可选
定义适用于管理对象实例的所有属性。
admin-object-properties 元素可以包括一个或多个 property 元素,每个元素都有 name 和 value 对。
请参阅 properties。
outbound-resource-adapter
outbound-resource-adapter 元素是 weblogic-connector 元素的子元素。
可以在 outbound-resource-adapter 元素中定义下列元素。
表9-12outbound-resource-adapter子元素
元素
必需
可选
描述
default-connection-properties
可选
此复杂元素用来在全局级指定属性。
在此级别,用户能够指定适用于该资源适配器中的所有出站连接缓冲池的参数。
有关子元素的信息,请参阅 default-connection-properties。
connection-definition-group
一个或多个
此元素用来指定所有连接定义组。
在 ra.xml 部署描述符中的连接工厂和 weblogic-ra.xml 部署描述符中的组之间必须有一一对应关系。
对于 ra.xml 的每个连接工厂,weblogic-ra.xml 部署描述符中不一定存在组。
但是,如果存在一个组,则该组中必须至少有一个连接实例。
在组中指定的属性将替代使用 default-connection-properties 在全局级指定的所有参数。
有关子元素的信息,请参阅 connection-definition-group。
default-connection-properties
default-connection-properties 元素是 outbound-resource-adapter 元素的子元素。
可以在 default-connection-properties 元素中定义下列元素。
表9-13default-connection-properties子元素
元素
必需
可选
描述
pool-params
可选
用作为此连接工厂提供特定于连接缓冲池的参数的根元素。
WebLogicServer使用这些规范来控制ManagedConnections的保留缓冲池的行为。
这是可选元素。
指定此元素或其任何特定元素项失败将导致分配默认值。
请参考对每个具体元素的描述,以了解指定的默认值。
有关子元素的信息,请参阅 pool-params。
logging
可选
包含用于配置 ManagedConnectionFactory 的日志记录和资源适配器的 ManagedConnection 对象的参数。
有关子元素的信息,请参阅logging。
transaction-support
可选
指定特定连接工厂的事务支持的级别。
它提供了替换在 ra.xml 部署描述符中指定的事务支持值的能力,该值本来是资源适配器的所有连接工厂的默认值。
事务支持的值必须为下列值之一:
NoTransaction
LocalTransaction
XATransaction
相关信息,请参阅连接管理。
authentication-mechanism
可选
authentication-mechanism 元素指定了资源适配器中特定连接工厂所支持的身份验证机制。
它提供了替换在 ra.xml 部署描述符中指定的 authentication-mechanism 值的能力,该值本来是资源适配器的所有连接工厂的默认值。
请注意,BasicPassword 机制类型必须支持 javax.resource.spi.security.PasswordCredential 接口。
reauth
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- weblogic 参数