Configuración de fábricas de conexiones JCA

Puede configurar fábricas de conexiones que cumplan con la especificación JCA (Java EE Connector Architecture).

Acerca de esta tarea

Puede configurar una o más instancias de fábrica de conexiones para tipos de fábrica de conexiones que se proporcionan mediante un adaptador de recursos instalado.
Nota: Para configurar el soporte JCA para Liberty, debe editar el archivo server.xml utilizando la vista Origen del editor de configuración del servidor de WebSphere® Application Server Developer Tools for Eclipse o algún otro editor de texto. En este tema se supone que ya se ha configurado en el servidor un adaptador de recursos con un identificador exclusivo de MyAdapter; consulte la documentación sobre la configuración de adaptadores de recursos para obtener más detalles. En los pasos siguientes se proporciona un ejemplo de extremo a extremo sobre la configuración de un escenario básico.
Nota: No se da soporte a la edición de subelementos de propiedades de configuración del servidor para fábricas de conexión, objetos administrativos, especificaciones de activación y adaptadores de recursos en la vista Diseño de WebSphere® Development Tools (WDT).

Procedimiento

  1. Actualice el archivo server.xml para añadir la característica jca-1.6 bajo el código featureManager.
    <featureManager>  
    	<feature>jca-1.6</feature> 
    	<feature>jndi-1.0</feature>  <!-- Añadir la característica jndi para habilitar la búsqueda de fábricas de conexión y objetos administrados. -->   
    		... 
    </featureManager>
  2. Instale un adaptador de recursos. Por ejemplo, actualice el archivo server.xml tal como se indica a continuación:
    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
  3. Configure una o más instancias de fábrica de conexiones. Cuando configure las instancias de la fábrica de conexiones, deberá suministrar un subelemento properties, incluso si no desea alterar temporalmente las propiedades de configuración, para asociar el elemento connectionFactory a una interfaz de fábrica de conexiones que proporcione un adaptador de recursos en particular. En el ejemplo siguiente, el adaptador de recursos MyAdapter solamente proporciona un tipo de fábrica de conexiones:
    <connectionFactory jndiName="eis/cf1">
     <properties.MyAdapter portNumber="1234" someVendorProperty="100"/>
    </connectionFactory>
    
    <connectionFactory jndiName="eis/cf2" containerAuthDataRef="auth2">
     <connectionManager maxPoolSize="20" connectionTimeout="0"/>
     <properties.MyAdapter portNumber="1234" someVendorProperty="200"/>
    </connectionFactory>
    <authData id="auth2" user="user2" password="{xor}Lz4sLCgwLTtt"/>
  4. (Opcional) Si es necesario, identifique los nombres del subelemento de la propiedad de fábrica de conexiones disponibles.
    • Si un adaptador de recursos proporciona exactamente una interfaz de fábrica de conexiones, excluyendo las fábricas de conexiones JMS, el subelemento es: properties.<identificador_rar>

    • Si el nombre de la interfaz es único sin el nombre de paquete, el nombre del subelemento es: properties.<identificador_rar>.<nombre_interfaz>
    • Si el nombre de la implementación es único sin el nombre de paquete, el nombre del subelemento es: properties.<identificador_rar>.<nombre_implementación>
    • En otros casos, el nombre del subelemento es: properties.<identificador_rar>.<nombre_interfaz_completo>

Ejemplo

Utilice el ejemplo siguiente para aprender a configurar los adaptadores de recursos con dos fábricas de conexiones con nombres de clase de interfaz únicos.

En el siguiente fragmento de un archivo ra.xml, el adaptador de recursos MyAdapter proporciona dos fábrica de recursos con nombres de clase de interfaz únicos:

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
<connection-definition>
 <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>javax.sql.DataSource</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.DataSourceImpl</connectionfactory-impl-class>
</connection-defintion> 
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<connectionFactory jndiName="eis/cf">
 <properties.MyAdapter.ConnectionFactory serverName="localhost"/>
</connectionFactory>

<connectionFactory jndiName="jdbc/ds">
 <properties.MyAdapter.DataSource serverName="localhost"/>
</connectionFactory>

Utilice el ejemplo siguiente para aprender a configurar los adaptadores de recursos con dos fábricas de conexiones con nombres de clase de implementación únicos.

En el siguiente fragmento de un archivo ra.xml, el adaptador de recursos MyAdapter proporciona dos fábrica de recursos con nombres de clase de implementación únicos:

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>com.vendor.adapter.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.MyConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<connectionFactory jndiName="eis/cf1">
 <properties.MyAdapter.ConnectionFactoryImpl serverName="localhost"/>
</connectionFactory> 

<connectionFactory jndiName="eis/cf2">
 <properties.MyAdapter.MyConnectionFactoryImpl serverName="localhost"/>
</connectionFactory>

Utilice el ejemplo siguiente para aprender a configurar los adaptadores de recursos con dos fábricas de recursos donde ninguno de los nombres de clase simples de interfaz ni implementación son únicos.

En el siguiente fragmento de un archivo ra.xml, el adaptador de recursos MyAdapter proporciona dos fábricas de recursos donde ninguno de los nombres de clase simples de interfaz ni implementación son únicos:

<connection-definition>
 <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>

<connection-definition>
  <config-property>
  <config-property-name>HostName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>com.vendor.adapter.custom.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.custom.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<connectionFactory jndiName="eis/cci-cf">
 <properties.MyAdapter.javax.resource.cci.ConnectionFactory serverName="localhost"/>
</connectionFactory>

<connectionFactory jndiName="eis/custom-cf">
 <properties.MyAdapter.com.vendor.adapter.custom.ConnectionFactory hostName="localhost"/>
</connectionFactory>
Es posible alterar temporalmente los sufijos de los nombres de elementos de configuración. Consulte la información sobre la personalización de los elementos de configuración JCA para aprender a alterar temporalmente los sufijos de los nombres de elementos de configuración.

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_jca_config_confact.html