Referencias de recurso de Blueprint [Valores]

Los componentes Blueprint pueden acceder a las referencias de recursos de WebSphere Application Server. Cada referencia se declara en un archivo XML Blueprint, y puede asegurarse mediante un alias de autenticación de JCA (Java™ EE Connector Architecture) de Java Platform, Enterprise Edition. Cada paquete de una aplicación OSGi puede contener cualquier número de declaraciones de referencia de recurso en sus diferentes archivos XML Blueprint.

Para ver este panel en la consola administrativa, pulse una de las rutas siguientes:

Aplicaciones > Tipos de aplicación > Aplicaciones de nivel empresarial > nombre_aplicación > [Activos desplegados] Añadir > Añadir activo > nombre_activo > Paso de asistente: Enlazar referencias de recurso Blueprint
Aplicaciones > Tipos de aplicación > Aplicaciones de nivel empresarial > nombre_aplicación > nombre_unidad_composición > [Propiedades adicionales] Referencias de recurso de Blueprint

El paso de asistente Enlazar referencias de recurso de Blueprint y la propiedad Referencias de recurso de Blueprint sólo están visibles si el paquete incluye declaraciones de referencia de recurso Blueprint.

Cuando se protegen referencias de recursos, esas referencias de recursos sólo se pueden enlazar a los alias de autenticación JCA que existen en cada servidor o clúster en el que se despliega la aplicación. Una aplicación OSGi puede desplegarse en varios servidores y clústeres que estén en el mismo dominio de seguridad. Por lo tanto, cada alias de autenticación JCA debe existir en el dominio de seguridad de los servidores y clústeres de destino o el dominio de seguridad global.

Debe declarar las referencias de recursos en el archivo XML Blueprint. Por ejemplo:

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" 
  xmlns:rr="http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference">
  <!-- Otras declaraciones Blueprint ... -->
  
  <rr:resource-reference id="resourceRef" 
          interface="javax.sql.DataSource"
          filter="(osgi.jndi.service.name=jdbc/Account)">
    <rr:res-auth>Container</rr:res-auth>
    <rr:res-sharing-scope>Shareable</rr:res-sharing-scope>
  </rr:resource-reference>
</blueprint>

Esta declaración incluye el ID de referencia de recurso (por ejemplo resourceRef), el filtro de servicio (por ejemplo jdbc/Account), el tipo de autenticación (por ejemplo Container) y el valor de compartición (por ejemplo Shareable).

Las referencias de recursos Blueprint a enlaces de alias de autenticación para cada paquete se almacenan en un archivo ibm-eba-bnd.xml en el directorio META-INF de ese paquete. Si una aplicación OSGi contiene cualquiera de estos archivos cuando se despliega como un activo, estos archivos proporcionan los valores de alias de autenticación predeterminados que se utilizan al enlazar las referencia de recursos. Por ejemplo:

<eba-bnd>
  <resource-ref>
    <jndi-name>jdbc/Acount</jndi-name>
    <authentication-alias>Alias1</authentication-alias>
    <interface>javax.sql.DataSource</interface>
    <authentication>Container</authentication>
    <sharing-scope>Shareable</sharing-scope>
    <id>resourceRef</id>
  </resource-ref>
</eba-bnd>

Propiedades generales

Identificador de paquete compuesto

Este identificador se visualiza sólo si el activo de EBA utiliza paquetes compuestos. Cada paquete compuesto se identifica por una serie con el formato siguiente: Composite bundle archive (CBA)'nombre.simbólico.paquete.compuesto_versión.paquete.compuesto'. Los paquetes que forman parte de un paquete compuesto se listan bajo el identificador de paquete compuesto.

Nombre simbólico del paquete compuesto: Nombre no convertible al entorno local para este paquete compuesto.
Versión del paquete compuesto: Versión de este paquete compuesto.

El nombre simbólico, junto con la versión, identifican un paquete compuesto de forma exclusiva.

Identificador de paquete

Cada paquete se identifica por una serie que contiene el nombre simbólico de paquete y la versión de paquete. Los paquetes que forman parte de un paquete compuesto se listan bajo el identificador de paquete compuesto.

Nombre simbólico del paquete

El nombre para este paquete no localizable.

Versión del paquete compuesto

Versión de este paquete.

El nombre simbólico del paquete, junto con la versión del paquete, identifica un paquete de forma exclusiva.

ID de referencia de recurso

El ID de la referencia de recurso tal como se declara en Blueprint.

Interfaz de referencia de recurso

La interfaz de esta referencia de recurso.

La aplicación Blueprint puede utilizar cualquiera de los tipos de recursos siguientes:

Destinos de colas JMS de mensajería por omisión
Destinos de temas JMS de mensajería por omisión
Origen de datos
Fábrica de conexiones JMS genérica
Sesión de correo
Fábrica de conexiones de J2C
Fábrica de conexiones de colas JMS para el proveedor de JMS de WebSphere MQ
Destino de colas JMS para WebSphere MQ
Fábrica de conexiones de tema JMS para WebSphere MQ
Destino de tema JMS para WebSphere MQ
Fábrica de conexiones JMS unificada para WebSphere MQ
Configuración del URL

Filtro de servicio de referencia de recurso

El nombre del filtro de servicio que es el destino de correlación de la referencia de recurso. Por ejemplo, jdbc/AccountDS2.

Autenticación de referencia de recurso

La aplicación o el contenedor son los encargados de autenticar la referencia de recurso.

Compartición de la referencia de recurso

La referencia de recurso puede compartirse o no compartirse.

Alias de autenticación

El alias de autenticación, si lo hubiera, que se utiliza para proteger la referencia de recursos.

Para cada referencia puede seleccionar, opcionalmente, un alias de autenticación de la lista. Los alias de autenticación por omisión (de los archivos ibm-eba-bnd.xml) se ofrecen sólo si existen en cada servidor o clúster de destino.

Los enlaces marcados (en línea) requieren acceso a Internet. Cada enlace inicia una búsqueda del tema en el Information Center. Cuando se listen los resultados de la búsqueda, seleccione el tema que se ajuste mejor a la configuración.

Compruebe las actualizaciones de este tema (en línea)

Nombre de archivo: OSGi_BLA_BlueprintResourceRefs.html