Configuración de objetos administrados JCA

Puede configurar objetos administrados que cumplan la especificación JCA (Java™ EE Connector Architecture).

Acerca de esta tarea

Puede configurar una instancia o varias instancias de objetos administrados 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 instancia de objetos administrados o más de una. Cuando configure instancias de objetos administrados, deberá suministrar un subelemento properties, incluso si no desea alterar temporalmente ninguna propiedad de configuración, para asociar el elemento adminObject al tipo de objeto administrado que proporciona un determinado adaptador de recursos. En el ejemplo siguiente, el adaptador de recursos MyAdapter proporciona solamente un tipo de objeto administrado:
    <adminObject jndiName="eis/interactionSpec">
     <properties.MyAdapter functionName="find" executionTimeout="5000"/>
    </adminObject>
  4. (Opcional) Si es necesario, identifique los nombres de los subelementos de propiedades de objetos administrados que haya disponibles.
    • Si un adaptador de recursos proporciona exactamente una interfaz de objetos administrados excluyendo los destinos, colas y temas JMS, el nombre del 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>

    • Si la combinación de nombre de interfaz y nombre de implementación es única sin el nombre de paquete, el nombre del subelemento es: properties.<identificador_rar>.<nombre_interfaz>-<nombre_implementación>

    • En otros casos, el nombre del subelemento es: properties.<identificador_rar>.<nombre_instancia_completo>-<nombre_implementación_completo>

Ejemplo

Utilice el ejemplo siguiente para aprender a configurar los adaptadores de recursos con dos objetos administrados con nombres de clase de interfaz únicos.

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

<adminobject>
<adminobject-interface>javax.resource.cci.ConnectionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.ConnectionSpecImpl</adminobject-class>
<config-property> 
 <config-property-name>isolationLevel</config-property-name>
 <config-property-type>java.lang.Integer</config-property-type>
</config-property>
... 
</adminobject>

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.InteractionSpecImpl</adminobject-class>
<config-property>
 <config-property-name>FunctionName</config-property-name>
 <config-property-type>java.lang.String</config-property-type>
</config-property>
... 
</adminobject>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<adminObject jndiName="eis/connectionSpec">
 <properties.MyAdapter.ConnectionSpec isolationLevel="4"/>
</adminObject>

<adminObject jndiName="eis/interactionSpec">
 <properties.MyAdapter.InteractionSpec functionName="find"/>
</adminObject>

Utilice el ejemplo siguiente para aprender a configurar los adaptadores de recursos con dos objetos administrados con nombres de clase de implementación únicos.

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

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.FinderInteractionSpec</adminobject-class>
<config-property>
 <config-property-name>ResultSetType</config-property-name>
 <config-property-type>java.lang.Integer</config-property-type>
</config-property> 
... 
</adminobject>

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.UpdaterInteractionSpec</adminobject-class> 
<config-property> 
 <config-property-name>ExecutionTimeout</config-property-name>
 <config-property-type>java.lang.Long</config-property-type> 
</config-property>
...
</adminobject>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<adminObject jndiName="eis/finder">
 <properties.MyAdapter.FinderInteractionSpec resultSetType="1003"/>
</adminObject>

<adminObject jndiName="eis/updater">
 <properties.MyAdapter.UpdaterInteractionSpec executionTimeout="3000"/>
</adminObject>

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

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.finder.InteractionSpecImpl</adminobject-class>
<config-property> 
 <config-property-name>ResultSetType</config-property-name>
 <config-property-type>java.lang.Integer</config-property-type>
</config-property>
... 
</adminobject>

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.updater.InteractionSpecImpl</adminobject-class>
<config-property> 
 <config-property-name>ExecutionTimeout</config-property-name>
 <config-property-type>java.lang.Long</config-property-type>
</config-property>
...
</adminobject>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<adminObject jndiName="eis/finder">
 <properties.MyAdapter.javax.resource.cci.InteractionSpec-com.vendor.adapter.finder.InteractionSpecImpl resultSetType="1003"/>
</adminObject> 

<adminObject jndiName="eis/updater"> 
 <properties.MyAdapter.javax.resource.cci.InteractionSpec-com.vendor.adapter.updater.InteractionSpecImpl executionTimeout="3000"/>
</adminObject>

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



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_admobj
Nombre de archivo:twlp_jca_config_admobj.html