[8.5.5.2 或更高版本]Liberty Repository

JCA 配置元素的概述

Java Platform, Enteprise Edition 连接器体系结构 (JCA) 功能部件提供了配置元素来定义连接工厂、受管对象和激活规范的实例,并将这些实例与安装的资源适配器关联。每个 JCA 配置元素都包含两个基本部分:顶级元素和子元素,对于已配置的实例,需要这两个部分。

顶级元素用于配置 Liberty 概要文件服务器提供的一般功能,例如,JNDI 名称、连接管理和容器认证。子元素用于将实例与安装的资源适配器绑定,并使您可指定供应商定义的配置属性。
通用 JCA 预定义顶级配置元素:
  • connectionFactory
  • adminObject
  • activationSpec
如果启用了 JMS 功能部件,那么还具有 JMS 的预定义通用配置元素:
  • jmsConnectionFactory
  • jmsQueueConnectionFactory
  • jmsTopicConnectionFactory
  • jmsDestination
  • jmsQueue
  • jmsTopic
  • jmsActivationSpec

子元素是在安装资源适配器时从资源适配器部署描述符和注释生成的。您不会在可用服务器配置元素的静态文档中看到可用子元素的任何文档。

使用以下规则来生成服务器配置子元素的名称:

  • 如果资源适配器仅提供其中一个列出类别中的一个接口,例如,connectionFactory 或 adminObject,那么子元素为:properties.<rar_identifier>
  • 如果接口名称是唯一的,且不具有软件包名称,那么子元素为:properties.<rar_identifier>.<InterfaceName>
  • 如果实现名称是唯一的,且不具有软件包名称,那么子元素为:properties.<rar_identifier>.<ImplementationName>
  • 在其他情况下,子元素名称为 properties.<rar_identifier>.<fully.qualified.InterfaceName>properties.<rar_identifier>.<fully.qualified.ImplementationName>

以下示例说明了每个类别中仅一个接口由标识为 MyAdapter 的资源适配器提供的情况。

<connectionFactory jndiName="eis/cf1" containerAuthDataRef="auth1"> 
 <properties.MyAdapter portNumber="1234" someVendorProperty="100"/> 
</connectionFactory>

<connectionFactory jndiName="eis/cf2" containerAuthDataRef="auth2">
 <properties.MyAdapter portNumber="1234" someVendorProperty="200"/> 
</connectionFactory> 
<jmsConnectionFactory jndiName="jms/cf"> 
 <properties.MyAdapter serverName="localhost" anotherProperty="40"/>
</jmsConnectionFactory>
<jmsQueueConnectionFactory jndiName="jms/qcf"> 
 <properties.MyAdapter serverName="localhost" vendorProp1="1"/> 
</jmsQueueConnectionFactory>
<jmsTopicConnectionFactory jndiName="jms/tcf"> 
 <properties.MyAdapter serverName="localhost" prop1="A" prop2="B"/> 
</jmsTopicConnectionFactory>
<adminObject jndiName="eis/interactionSpec"> 
 <properties.MyAdapter functionName="find" executionTimeout="5000"/> 
</adminObject>
<jmsDestination jndiName="jms/destination1"> 
 <properties.MyAdapter name="DEST1"/> 
</jmsDestination> 
<jmsQueue jndiName="jms/queue1"> 
 <properties.MyAdapter queueName="QUEUE1"/> 
</jmsQueue> 
<jmsTopic id="topic1" jndiName="jms/topic1"> 
 <properties.MyAdapter topicName="TOPIC1"/> 
</jmsTopic>
<activationSpec id="app1/module1/MyMessageDrivenBean"> 
 <properties.MyAdapter prop1="a" prop2="b" prop3="c"/> 
</activationSpec>
<jmsActivationSpec id="app1/module1/MyJMSMessageDrivenBean">
 <properties.MyAdapter destinationRef="topic1"/> 
</jmsActivationSpec>

用于指示主题类型的图标 概念主题

信息中心的条款和条件 | 反馈


时间戳记图标 最近一次更新时间: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=cwlp_jca_config_overview
文件名:cwlp_jca_config_overview.html