Présentation des éléments de configuration JCA
La fonction Java Platform, Enteprise Edition Connector Architecture (JCA) fournit des éléments de configuration permettant de définir des instances de fabriques de connexions, d'objets administrés et de spécifications d'activation, ainsi que d'associer ces instances à un adaptateur de ressources installé. Chaque élément de configuration JCA se compose de deux parties de base, un élément de niveau supérieur et un sous-élément, qui sont toutes les deux requises pour l'instance configurée.
- connectionFactory
- adminObject
- activationSpec
- jmsConnectionFactory
- jmsQueueConnectionFactory
- jmsTopicConnectionFactory
- jmsDestination
- jmsQueue
- jmsTopic
- jmsActivationSpec
Les sous-éléments sont générés depuis le descripteur de déploiement et les annotations de l'adaptateur de ressources lorsque votre adaptateur de ressources est installé. La documentation statique concernant les éléments de configuration de serveur disponibles ne contient pas d'informations sur les sous-éléments disponibles.
Appliquez les règles suivantes pour générer les noms des sous-éléments de configuration de serveur :
- Si un adaptateur de ressources fournit une interface exactement dans l'une des catégories répertoriées, par exemple connectionFactory ou adminObject, le sous-élément est : properties.<identificateur_rar>
- Si le nom d'interface est unique sans le nom de module, le sous-élément est : properties.<identificateur_rar>.<nom_interface>
- Si le nom d'implémentation est unique sans le nom de module, le sous-élément est : properties.<identificateur_rar>.<nom_implémentation>
- Dans les autres cas, le nom de sous-élément est properties.<identificateur_rar>.<nom_interface_qualifié_complet> ou properties.<identificateur_rar>.<nom_implémentation_qualifié_complet>
Les exemples suivants illustrent le cas où une seule interface dans chaque catégorie est fournie par un adaptateur de ressources dont l'identificateur est 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>