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.

Un élément de niveau supérieur configure les capacités générales fournies par le serveur Liberty, comme le nom JNDI, la gestion des connexions et l'authentification des conteneurs. Un sous-élément lie l'instance à un adaptateur de ressources installé et vous permet de spécifier des propriétés de configuration définies par le fournisseur.
Eléments de configuration génériques JCA de niveau supérieur définis préalablement :
  • connectionFactory
  • adminObject
  • activationSpec
Si la fonction JMS est activée, il existe également des éléments de configuration génériques définis préalablement pour JMS :
  • 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 :

Remarque : Dans les exemples suivants, <identificateur_rar désigne le nom de fichier spécifié dans l'attribut d'emplacement de l'élément de configuration resourceAdapter, sans les informations d'extension ou de chemin de répertoire.
  • Si un adaptateur de ressources fournit exactement une interface dans l'une des catégories répertoriées, par exemple connectionFactory ou adminObject, le sous-élément est le suivant : properties.<identificateur_rar>
  • Si le nom d'interface est unique sans le nom de module, le sous-élément est le suivant : properties.<identificateur_rar>.<nom_interface>
  • Si le nom d'implémentation est unique sans le nom de module, le sous-élément est le suivant : properties.<identificateur_rar>.<nom_implémentation>
  • Dans les autres cas, le nom du sous-élément est properties.<identificateur_rar>.<nom_interface_complètement_qualifié> ou properties.<identificateur_rar>.<nom_implémentation_complètement_qualifié>

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>

Icône indiquant le type de rubrique Rubrique de concept

Nom du fichier : cwlp_jca_config_overview.html