Configuration et déploiement d'un adaptateur de ressources JCA de base
Vous pouvez configurer et déployer une fabrique de connexions et un adaptateur de ressources JCA (Java™ EE Connector Architecture) de base.
Pourquoi et quand exécuter cette tâche
Procédure
- Activez la fonction JCA dans votre fichier server.xml. Le fichier server.xml est situé à l'emplacement suivant : [chemin_liberty\wlp\usr\servers\nom_serveur]
<server> <featureManager> <feature>jca-1.6</feature> <feature>servlet-3.0</feature> </featureManager> </server>
- Placez le fichier RAR de l'adaptateur de ressources (ExampleRA.rar) dans le dossier 'dropins' de votre serveur. Si votre serveur est en exécution, un message similaire à ceci
sera consigné dans votre journal de la console pour indiquer que
l'adaptateur de ressources a été installé :
[AUDIT ] J2CA7001I: Adaptateur de ressources ExampleRA installé en 1,306 secondes.
- Inspectez le descripteur de déploiement, les annotations, et toute autre
documentation de l'adaptateur de ressources pour identifier les types de ressources qu'il fournit et les propriétés de configuration acceptées par chaque adaptateur. Pour l'exemple d'adaptateur de ressources, ExampleRA.rar, ces informations figurent dans le descripteur de déploiement ra.xml. Le fichier ra.xml est situé à l'emplacement suivant : [chemin_ExampleRA\ExampleRA\META-INF.]. Le descripteur de déploiement identifie trois types de ressources que vous pouvez configurer.
<connection-definition> <managedconnectionfactory-class>com.ibm.example.jca.adapter.ManagedConnectionFactoryImpl</managedconnectionfactory-class> <config-property> <config-property-name>tableName</config-property-name> <config-property-type>java.lang.String</config-property-type> </config-property> <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface> ... </connection-definition> <adminobject> <adminobject-interface>javax.resource.cci.ConnectionSpec</adminobject-interface> <adminobject-class>com.ibm.example.jca.adapter.ConnectionSpecImpl</adminobject-class> <config-property> <config-property-name>readOnly</config-property-name> <config-property-type>java.lang.Boolean</config-property-type> <config-property-value>false</config-property-value> </config-property> </adminobject> <adminobject> <adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface> <adminobject-class>com.ibm.example.jca.adapter.InteractionSpecImpl</adminobject-class> <config-property> <description>Function name. Supported values are: ADD, FIND, REMOVE</description> <config-property-name>functionName</config-property-name> <config-property-type>java.lang.String</config-property-type> </config-property> </adminobject>
- Dans le fichier server.xml, configurez des instances des types de ressource disponibles.
<server> <featureManager> <feature>jca-1.6</feature> <feature>servlet-3.0</feature> </featureManager> <connectionFactory jndiName="eis/conFactory"> <properties.ExampleRA tableName="TABLE1"/> </connectionFactory> <adminObject jndiName="eis/conSpec"> <properties.ExampleRA.ConnectionSpec/> </adminObject> <adminObject jndiName="eis/iSpec_ADD"> <properties.ExampleRA.InteractionSpec functionName="ADD"/> </adminObject> <adminObject jndiName="eis/iSpec_FIND"> <properties.ExampleRA.InteractionSpec functionName="FIND"/> </adminObject> </server>
- Utilisez une injection de ressources pour accéder aux ressources dans votre servlet ; par exemple :
@Resource(lookup = "eis/conFactory") private ConnectionFactory conFactory; @Resource(lookup = "eis/conSpec") private ConnectionSpec conSpec; @Resource(lookup = "eis/iSpec_ADD") private InteractionSpec iSpec_ADD; @Resource(lookup = "eis/iSpec_FIND") private InteractionSpec iSpec_FIND; ... MappedRecord input = conFactory.getRecordFactory().createMappedRecord("input"); input.put("city", "Rochester"); input.put("state", "Minnesota"); input.put("population", 106769); Connection con = conFactory.getConnection(conSpec); try { Interaction interaction = con.createInteraction(); interaction.execute(iSpec_ADD, input); interaction.close(); } finally { con.close(); }
Remarque : Vous devez activer la fonction JNDI dans le fichier server.xml si vous désirez rechercher les ressources depuis l'espace nom au lieu d'utiliser une injection.
Sous-rubriques
- 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.
Rubrique parent : Administration manuelle de Liberty


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_jca_config_dep
Nom du fichier : twlp_jca_config_dep.html