Configuración de adaptadores de recursos

Puede configurar adaptadores de recursos que sean compatibles con las versiones 1.6, 1.5 o 1.0 de la especificación JCA (Java™ EE Connector Architecture).

Acerca de esta tarea

Puede instalar y configurar un adaptador de recursos y las diversas fábricas de conexiones, objetos administrados y especificaciones de activación tal como se define en la especificación de JCA.

Procedimiento

  1. Actualice el archivo server.xml para añadir la característica jca-1.6 bajo el código featureManager. El archivo server.xml se halla en [vía_acceso_a_liberty\wlp\usr\servers\nombre_servidor]
     <featureManager>
      <feature>jca-1.6</feature>
     </featureManager>
  2. (Opcional) Habilite las características adicionales siguientes en función de las necesidades de su sistema:
    • Si su adaptador de recursos proporciona interfaces de especificación JMS, habilite la característica jms-1.1.
      <feature>jms-1.1</feature>
    • Si desea buscar las fábricas de conexiones y los objetos administrados desde su aplicación, habilite la característica jndi-1.0.
      <feature>jndi-1.0</feature>
    • Si su adaptador de recursos proporciona especificaciones de activación para beans controlados por mensajes, habilite la característica mdb-3.1.
      <feature>mdb-3.1</feature>
    • Si su adaptador de recursos da soporte a la seguridad de entrada, habilite la característica jcaInboundSecurity-1.0.
      <feature>jcaInboundSecurity-1.0</feature>
    • Si el adaptador de recursos soporta la validación del bean, puede habilitar la característica beanValidation-1.0si desea que los beans se validen.

      <feature>beanValidation-1.0</feature>
  3. Configure un adaptador de recursos o varios en el servidor. Puede utilizar uno de los métodos siguientes para configurar el adaptador de respuesta.
    • Configure un adaptador de recursos autónomo editando el archivo server.xml.
      <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
    • Configure un adaptador de recursos incorporado editando el archivo server.xml para instalar una aplicación que incluya un módulo de adaptador de recursos o más de uno. En el ejemplo siguiente se supone que el archivo app1.ear contiene un archivo incorporado RAR o varios:
       <application location="C:/applications/app1.ear"/>
    • Permita que el servidor configure automáticamente un adaptador de recursos autónomo descartando el archivo RAR en la carpeta de descartes del servidor.
       wlp/usr/servers/your-server-name/dropins/MyDropinAdapter.rar
    • Permita que el servidor configure automáticamente una aplicación que contenga un adaptador de recursos incorporado o varios descartando el archivo EAR en la carpeta de descartes del servidor. En el ejemplo siguiente se supone que el archivo app2.ear contiene un archivo incorporado RAR o varios:
      wlp/usr/servers/your-server-name/dropins/app2.ear
  4. Inicie el servidor de aplicaciones. Tras iniciarlo, en el archivo console.log aparecerán mensajes como los siguientes:
    [AUDIT ] J2CA7001I: El adaptador de recursos MyAdapter se ha instalado en 0,495 segundos.
    [AUDIT ] J2CA7001I: El adaptador de recursos MyDropinAdapter se ha instalado en 0,311 segundos.
    [AUDIT ] J2CA7001I: El adaptador de recursos app1.MyEmbeddedAdapter se ha instalado en 0,247 segundos.
    [AUDIT ] J2CA7001I: El adaptador de recursos app2.anotherEmbeddedAdapter se ha instalado en 0,518 segundos. 

Ejemplo

Es necesario un identificador exclusivo para un adaptador de recursos para que identifique instancias configuradas de las fábricas de conexiones, objetos administrados y especificaciones de activación que están asociados a un adaptador de recursos instalado. Para adaptadores de recursos autónomos, el nombre de módulo se utiliza como identificador. Para los adaptadores de recursos incorporados en aplicaciones, se utiliza como identificador la combinación del nombre de la aplicación más el nombre del módulo (delimitado por el carácter de punto).

  • Para especificar propiedades para un adaptador de recursos autónomo utilizando un subelemento properties.MyAdapter que incluya el identificador de adaptadores de recursos, MyAdapter:

    <resourceAdapter location="C:/adapters/MyAdapter.rar">
      <properties.MyAdapter logFile="${server.output.dir}/logs/myAdapter.log"/>
    </resourceAdapter>
  • Para asociar una fábrica de conexiones a un adaptador de recursos autónomo utilizando un subelemento properties.MyAdapter que incluya el identificador de adaptadores de recursos, MyAdapter:

    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
    <connectionFactory jndiName="eis/cf">
     <properties.MyAdapter serverName="localhost" portNumber="1234"/>
    </connectionFactory>
  • Para asociar una fábrica de conexiones a un adaptador de recursos MyEmbeddedAdapter, que se ha habilitado en la aplicación app1, utilizando un subelemento properties.app1.MyEmbeddedAdapter:

    <application location="C:/applications/app1.ear"/>
    <connectionFactory jndiName="eis/cf">
     <properties.app1.MyEmbeddedAdapter serverName="localhost" portNumber="1234"/>
    </connectionFactory>
  • En algunos casos, el nombre de módulo no es suficientemente exclusiva para que sirva de identificador. Esto puede ocurrir, por ejemplo, si ha instalado dos versiones distintas del mismo adaptador de recursos. De forma alternativa, el nombre de módulo puede ser exclusivo, pero no es lo deseable para utilizarlo en la configuración porque es demasiado largo o contiene caracteres alfanuméricos. Puede alterar temporalmente el identificador de adaptadores de recursos especificando el atributo del ID.

    En el ejemplo siguiente se muestra cómo alterar temporalmente el identificador para los adaptadores de recursos autónomos:

    <resourceAdapter id="MyAdapterV1" location="C:/adapters/version-1.0/MyAdapter.rar"/>
    <resourceAdapter id="MyAdapterV2" location="C:/adapters/version-2.0/MyAdapter.rar"/>
    <connectionFactory jndiName="eis/cf1">
     <properties.MyAdapterV1 serverName="localhost" portNumber="1234"/>
    </connectionFactory>
    <connectionFactory jndiName="eis/cf2">
     <properties.MyAdapterV2 serverName="localhost" portNumber="1234"/>
    </connectionFactory>
  • El ejemplo siguiente muestra cómo alterar temporalmente el identificador para un adaptador de recursos incorporado en una aplicación. En el ejemplo se cambia el identificador por MyEmbeddedRA:

    <application location="C:/applications/app1.ear">
     <resourceAdapter id="MyEmbeddedAdapter" alias="MyEmbeddedRA"/>
    </application>  
    <connectionFactory jndiName="eis/cf">
     <properties.app1.MyEmbeddedRA serverName="localhost" portNumber="1234"/>
    </connectionFactory>
  • Para calcular el nombre del módulo para adaptadores de recursos incorporados, la entrada <module-name> del descriptor de despliegue del adaptador de recursos (ra.xml) tiene prioridad como nombre de módulo. Por ejemplo, dada la definición siguiente en ra.xml:

    <connector ...> 
    		<module-name>MyRARModule</module-name> 
    </connector>

    el nombre del módulo se definiría en "MyRARModule".

    Si no está el nombre del módulo en el descriptor de despliegue del conector, se utilizará el formato corto del URI que hace referencia al módulo de adaptadores de recursos en el descriptor de despliegue de la aplicación (application.xml). Por ejemplo, dada la definición del módulo siguiente en application.xml:

    <module>         
    		<connector>connectors/MyRARModule.rar</connector>     
    </module>

    el nombre de módulo se computaría como "MyRARModule".

    Si se incorporan varios adaptadores de recursos en una aplicación y define el mismo valor <module-name>, la primera listada en el application.xml utiliza dicho nombre de módulo. Los nombres de módulo de los otros conectores con el mismo nombre en conflicto se calcularán a partir del formato completo del URI con todos los caracteres con / (barra inclinada) convertidos en un punto (.). Por ejemplo, si hay dos conectores incorporados en una aplicación que contengan ambos la siguiente definición en ra.xml:

    <connector ...> 
    		<module-name>MyRARModule</module-name> 
    </connector>

    y las definiciones siguientes en application.xml:

    <module>         
    		<connector>subfolder1/connector1.rar</connector>     
    </module>     
    <module>         
    		<connector>subfolder2/connector2.rar</connector>     
    </module>

    El nombre del módulo del primer conector sería "MyRARModule" y el nombre del módulo del segundo conector sería "subfolder2.connector2.rar"


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-nd-mp&topic=twlp_jca_config_resadapters
Nombre de archivo:twlp_jca_config_resadapters.html