Configuración de las especificaciones de activación JCA

Puede configurar las especificaciones de activación que cumplan con la especificación Java EE Connector Architecture (JCA).

Acerca de esta tarea

Puede configurar una o más instancias de las especificaciones de activación 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 los subelementos de propiedades de la configuración de servidor para fábricas de conexiones, 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 especificaciones de activación. Cuando configure especificaciones de activación, debe proporcionar un subelemento properties, incluso si no desea alterar temporalmente las propiedades de configuración, para asociar el elemento activationSpec a un tipo de escucha de mensajes que se proporciona mediante un adaptador de recursos determinado. En el ejemplo siguiente, el adaptador de recursos MyAdapter proporciona solamente un tipo de escucha de mensajes:
    <activationSpec id="app1/module1/MyMessageDrivenBean">
     <properties.MyAdapter messageFilter="ALL"/>
    </activationSpec>
  4. Si es necesario, identifique los nombres de subelemento de la propiedad de especificación de activación disponibles.
    • Si un adaptador de recursos proporciona exactamente una interfaz de escucha de mensajes, excluyendo las fábricas de conexiones JMS, el nombre del subelemento es: properties.<identificador_rar>

    • Si el nombre de la interfaz de escucha de mensajes es único sin el nombre de paquete, el nombre del subelemento es: properties.<identificador_rar>.<nombre_interfaz_escucha_mensajes>

    • Si el nombre de la implementación de la especificación de activación es único sin el nombre de paquete, el nombre del subelemento es: properties.<identificador_rar>.<nombre_implementación_especificación_activación>

    • Si el nombre de la implementación de la especificación de activación es único sin el nombre de paquete, el nombre del subelemento es: properties.<identificador_rar>.<nombre_implementación_especificación_activación>

    • En otros casos, el nombre del subelemento es: properties.<identificador_rar>.<nombre_completo_interfaz_escucha_mensaje>

  5. Consulte la documentación sobre el despliegue de beans controlados por mensajes para obtener información sobre cómo asociar la especificación de activación con un bean controlado por mensajes.

Ejemplo

Utilice el ejemplo siguiente para aprender a configurar adaptadores de recursos con dos tipos de escucha de mensajes con nombres únicos de clase de interfaz.

En el fragmento siguiente de un archivo ra.xml, el adaptador de recursos MyAdapter proporciona dos tipos de escucha de mensajes con nombres exclusivos de clases de interfaz:

<messagelistener>
<messagelistener-type>javax.resource.cci.MessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.CCIActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>maxSize</config-property-name>
  <config-property-type>java.lang.Long</config-property-type>
 </config-property>
 ...
</activationspec>
...
</messagelistener>

<messagelistener>
<messagelistener-type>com.vendor.adapter.MyMessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.MyActivationSpec</activationspec-class>
 <config-property> 
  <config-property-name>messageFilter</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 ...
</activationspec>
...
</messagelistener>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<activationSpec id="app1/module1/CCIMessageDrivenBean">
 <properties.MyAdapter.MessageListener maxSize="1024"/>
</activationSpec> 

<activationSpec id="app1/module1/MyMessageDrivenBean">
 <properties.MyAdapter.MyMessageListener messageFilter="ALL"/>
</activationSpec>

Utilice el ejemplo siguiente para aprender a configurar adaptadores de recursos con dos tipos de escucha de mensajes con nombres únicos de clases de implementación.

En el fragmento siguiente de un archivo ra.xml, el adaptador de recursos MyAdapter proporciona dos tipos de escucha de mensajes con nombres exclusivos de clases de implementación:

<messagelistener>
<messagelistener-type>javax.resource.cci.MessageListener</messagelistener-type>
<activationspec> 
 <activationspec-class>com.vendor.adapter.CCIActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>maxSize</config-property-name> 
  <config-property-type>java.lang.Long</config-property-type>
 </config-property> 
...
</activationspec>
...
</messagelistener>

<messagelistener>
<messagelistener-type>com.vendor.adapter.MessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.MyActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>messageFilter</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
...
</activationspec>
...
</messagelistener>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<activationSpec id="app1/module1/CCIMessageDrivenBean">
 <properties.MyAdapter.CCIActivationSpec maxSize="1024"/>
</activationSpec>

<activationSpec id="app1/module1/MyMessageDrivenBean">
 <properties.MyAdapter.MyActivationSpec messageFilter="ALL"/>
</activationSpec>

Utilice el ejemplo siguiente para aprender a configurar adaptadores de recursos con dos tipos de escucha de mensajes 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 tipos de escucha de mensajes donde ninguno de los nombres de clase simples de interfaz ni implementación son únicos:

<messagelistener>
<messagelistener-type>javax.resource.cci.MessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.cci.ActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>maxSize</config-property-name>
  <config-property-type>java.lang.Long</config-property-type>
 </config-property> 
...
</activationspec>
...
</messagelistener>

<messagelistener>
<messagelistener-type>com.vendor.adapter.MessageListener</messagelistener-type> 
<activationspec>
 <activationspec-class>com.vendor.adapter.ActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>messageFilter</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
...
</activationspec>
...
</messagelistener>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<activationSpec id="app1/module1/CCIMessageDrivenBean">
 <properties.MyAdapter.javax.resource.cci.MessageListener maxSize="1024"/>
</activationSpec>

<activationSpec id="app1/module1/MyMessageDrivenBean">
 <properties.MyAdapter.com.vendor.adapter.MessageListener messageFilter="ALL"/>
</activationSpec>

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_actspec.html