Personalización de los elementos de configuración de JCA

Puede personalizar la forma en que se generan los subelementos de las propiedades JCA cuando se instala un adaptador de recursos.

Acerca de esta tarea

Cuando instale un adaptador de recursos autónomo o un adaptador de recursos que esté incorporado en una aplicación, puede añadir uno o varios subelementos <customize> bajo el elemento <resourceAdapter> para elegir el sufijo que se utiliza para el subelemento de propiedades de la interfaz o clase de implementación especificada. La personalización de un subelemento le permite evitar nombres de subelementos de propiedades largos que podrían, por otra parte, ser necesarios para la configuración de elementos con nombres exclusivos.
Nota:

Para añadir soporte JCA para Liberty, debe editar el archivo server.xml utilizando la vista de origen del editor de configuración de servidor de WebSphere® Application Server Developer Tools for Eclipse o algún otro editor de texto. La edición de partes de la configuración de fábricas de conexiones, objetos administrativos, especificaciones de activación y adaptadores de recursos en la vista Diseño no recibe soporte en la versión Beta.

Procedimiento

  1. Para un adaptador de recursos autónomo, empiece con la configuración existente que desee personalizar. Por ejemplo, si un adaptador MyAdapter proporciona dos fábricas de conexiones, en que ni el nombre de clase de la interfaz simple ni de la implementación son exclusivos:
    <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>
    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
    
    <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>
  2. Añada los subelementos customize en resourceAdapter para elegir los sufijos para ambas interfaces de fábricas de conexiones.
    <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>
    
    <resourceAdapter location="C:/adapters/MyAdapter.rar">
     <customize interface="javax.resource.cci.ConnectionFactory" suffix="cci"/>
     <customize interface="com.vendor.adapter.custom.ConnectionFactory" suffix="custom"/>
    </resourceAdapter>
    
    <connectionFactory jndiName="eis/cci-cf">
     <properties.MyAdapter.cci serverName="localhost"/>
    </connectionFactory>
    
    <connectionFactory jndiName="eis/custom-cf">
     <properties.MyAdapter.custom hostName="localhost"/>
    </connectionFactory>
  3. Para un adaptador de recursos que está incorporado en una aplicación, empiece con la configuración existente que desee personalizar. Por ejemplo, supongamos que tiene una aplicación app1 con MyAdapter tal como se indica a continuación:
    <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>
    
    <application name="app1" type="ear" location="C:/applications/app1.ear"/>
    
    <adminObject jndiName="eis/interactionSpec-find">
     <properties.app1.MyAdapter.javax.resource.cci.InteractionSpec-com.vendor.adapter.finder.InteractionSpecImpl resultSetType="1003"/>
    </adminObject>
    
    <adminObject jndiName="eis/interactionSpec-update">
     <properties.app1.MyAdapter.com.vendor.adapter.InteractionSpec-com.vendor.adapter.updater.InteractionSpecImpl executionTimeout="3000"/> 
    </adminObject>
  4. Especifique un elemento resourceAdapter para el módulo RAR (Resource Adapter Archive) de la aplicación. Especifique el atributo del ID que debe ser el nombre del módulo RAR. Añada los subelementos customize para elegir los sufijos para ambos objetos administrado que se basan en la interfaz o en la clase de implementación. En este ejemplo, solamente se especifica la clase de implementación que es suficiente para identificar los objetos administrados:
    <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>
    
    <application name="app1" type="ear" location="C:/applications/app1.ear">
     <resourceAdapter id="MyAdapter">
      <customize implementation="com.vendor.adapter.finder.InteractionSpecImpl" suffix="finder"/>
      <customize implementation="com.vendor.adapter.updater.InteractionSpecImpl" suffix="updater"/>
     </resourceAdapter>
    </application>  
    
    <adminObject jndiName="eis/interactionSpec-find">
     <properties.app1.MyAdapter.finder resultSetType="1003"/>
    </adminObject>
    
    <adminObject jndiName="eis/interactionSpec-update">
     <properties.app1.MyAdapter.updater executionTimeout="3000"/>
    </adminObject>

Icono que indica el tipo de tema Tema de tarea



Icono de indicación de fecha y hora Última actualización: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=twlp_jca_config_custelements
Nombre de archivo:twlp_jca_config_custelements.html