Creación de archivos XML Blueprint
El archivo de configuración Blueprint contiene información de configuración y ensamblaje de componentes para un paquete. El archivo describe cómo se registran los componentes en el registro de servicios OSGi o cómo buscan servicios en el registro de servicios OSGi. Esta información se utiliza durante el tiempo de ejecución para crear instancias y configurar los componentes necesarios cuando se inicia el paquete.
Procedimiento
- Pulse el botón derecho del ratón en el proyecto de paquete y seleccione Nuevo > Archivo Blueprint. Se abre el asistente Archivo Blueprint nuevo.
- En el campo Nombre de archivo, escriba el nombre del archivo de configuración blueprint y, a continuación, pulse Siguiente.
- En la página Añadir o eliminar espacios de nombres Blueprint adicionales
del asistente, seleccione los espacios de nombres que desea añadir al archivo blueprint. Puede añadir espacios de nombres para extensiones de blueprint, JPA, referencia de recursos y transacciones.Más información sobre espacios de nombres Blueprint :
Tabla 1. Descripción de espacios de nombres Blueprint Esquema URL Descripción Extensión de Blueprint http://aries.apache.org/blueprint/xmlns/blueprint-ext/v1.0.0 Extensiones de IBM® Blueprint
Extensiones para el modelo de programación Blueprint de OSGi, por ejemplo inyección de campos.
Seguridad de Blueprint http://www.ibm.com/appserver/schemas/blueprint/security/v1.0.0 Seguridad de IBM Blueprint
Configurar la seguridad de bean para que a los métodos del bean sólo puedan acceder los usuarios a los que se ha asignado un rol especificado.
JPA http://aries.apache.org/xmlns/jpa/v1.0.0 Soporte de JPA de Blueprint
Proporciona la integración de Java™ Persistence API (JPA) en Blueprint. Las unidades de persistencia y los contextos de persistencia se pueden inyectar en beans gestionados de Blueprint.
Referencia de recurso http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference Soporte de referencia de recursos de Blueprint
Mantiene objetos que se han declarado en WebSphere Application Server JNDI, por ejemplo orígenes de datos y fábricas de conexiones que se deben inyectar en beans gestionados por Blueprint.
Transacciones http://aries.apache.org/xmlns/transactions/v1.0.0 Soporte de transacciones de Blueprint
Permite al desarrollador declarar requisitos de transacciones para los beans gestionados por Blueprint.
Nota: Si desea añadir otros espacios de nombres que no estén en esta lista, vaya a la vista Origen y escriba el espacio de nombres. - Pulse Finalizar. Se abre el archivo de configuración de blueprint en el editor.
- Pulse Añadir para añadir la información de configuración y
ensamblaje de componentes al archivo de configuración de Blueprint.
- Bean
- El elemento bean define el componente Blueprint del que se está creando una instancia. Pulse Aceptar para añadir argumentos y propiedades al bean.
- Más información sobre atributos de bean :
- ID
- El atributo id identifica el componente. Es obligatorio si se hace referencia al componente desde otra parte de blueprint, por ejemplo si se hace referencia a él desde una definición de servicio.
- Clase
- El atributo class especifica la clase de implementación del componente de la que se crea la instancia.
- Activación
- Este atributo opcional define la modalidad de activación para el gestor. Se soportan dos modalidades
de activación:
- eager
- El gestor se activa durante la inicialización del contenedor Blueprint.
- lazy
- El gestor se activa a petición.
- Ámbito
- En función del valor de ámbito, un gestor de beans puede crear
instancias de objeto únicas o múltiples. La especificación del contenedor Blueprint
define dos ámbitos principales:
- singleton
- El gestor de bean crea una instancia única del bean y devuelve esa instancia cada vez que se le solicita al gestor que proporcione un objeto.
- prototype
- El gestor de beans crea una instancia nueva del bean cada vez que se le solicita al gestor que proporcione un objeto.
- Depende de
- Especifica una lista de ID de gestor. En primer lugar se activan los gestores listados antes de que se active el gestor. Un gestor puede tener dependencias explícitas e implícitas. El atributo dependsOn define las dependencias explícitas. Las dependencias implícitas se definen mediante las referencias a otros gestores dentro de una definición de gestor.
- Referencia de fábrica
- Especifica el ID de un bean o gestor de referencia que actúa como una fábrica. El objeto especificado debe tener un método de fábrica como el especificado por el atributo de método de fábrica.
- Método de destrucción
- Especifica un método al que se debe llamar cuando el contenedor Blueprint está destruyendo la instancia de objeto.
- Método de fábrica
- Especifica el nombre del método de fábrica estático.
- Método de inicialización
- El método de inicialización se llama cuando se crea el componente. Si no desea invocar un método durante la inicialización del paquete, elimine este atributo.
- Referencia
- El elemento reference especifica servicios que se encuentran en el registro de servicio. Pulse Aceptar para añadir elementos a la referencia.
- Más información sobre los atributos de referencia:
- ID
- El atributo id identifica el componente. Es obligatorio si se hace referencia al componente desde otra parte de blueprint, por ejemplo si se hace referencia a él desde una definición de servicio.
- Interfaz
- El atributo interface hace referencia a la interfaz que la clase de componente implementa.
- Activación
- Este atributo opcional define la modalidad de activación para el gestor. Se soportan dos modalidades
de activación:
- eager
- El gestor se activa durante la inicialización del contenedor Blueprint.
- lazy
- El gestor se activa a petición.
- Disponibilidad
- Controla los requisitos mediante el gestor de referencia de servicio de que al
menos un servicio, que coincide con los criterios de selección, existe antes
de que continúe la inicialización de contenedor Blueprint. El atributo de disponibilidad
tiene dos valores:
- optional
- No tienen que existir los servicios que coinciden con los criterios.
- mandatory
- Debe existir al menos un servicio que coincida con los criterios.
- Filtro
- Especifica la expresión de filtro para la selección de servicios.
- Tiempo de espera
- Especifica el periodo de tiempo, en milisegundos, durante el cual un proxy espera a que un servicio de seguridad quede disponible.
- Nombre de componente
- Especifica el componente buscado por el filtro.
- Depende de
- Especifica una lista de ID de gestor. En primer lugar se activan los gestores listados antes de que se active el gestor. Un gestor puede tener dependencias explícitas e implícitas. El atributo dependsOn define las dependencias explícitas. Las dependencias implícitas se definen mediante las referencias a otros gestores dentro de una definición de gestor.
- Lista de referencias
- El elemento reference-list permite al elemento de referencia buscar varios servicios coincidentes. Pulse Aceptar para añadir elementos a la lista de referencias.
- Más información sobre los atributos de lista de referencias:
- ID
- El atributo id identifica el componente. Es obligatorio si se hace referencia al componente desde otra parte de blueprint, por ejemplo si se hace referencia a él desde una definición de servicio.
- Interfaz
- El atributo interface hace referencia a la interfaz que la clase de componente implementa.
- Activación
- Este atributo opcional define la modalidad de activación para el gestor. Se soportan dos modalidades
de activación:
- eager
- El gestor se activa durante la inicialización del contenedor Blueprint.
- lazy
- El gestor se activa a petición.
- Disponibilidad
- Controla los requisitos mediante el gestor de referencia de servicio de que al
menos un servicio, que coincide con los criterios de selección, existe antes
de que continúe la inicialización de contenedor Blueprint. El atributo de disponibilidad
tiene dos valores:
- optional
- No tienen que existir los servicios que coinciden con los criterios.
- mandatory
- Debe existir al menos un servicio que coincida con los criterios.
- Filtro
- Especifica la expresión de filtro para la selección de servicios.
- Tipo de miembro
- Especifica el tipo de miembros proporcionados por el gestor de lista de referencias.
El atributo de tipo de miembro soporta:
- service-object
- Inyecta una lista de objetos de proxy de servicio.
- service-reference
- Inyecta una lista de objetos de reference de servicio.
- Nombre de componente
- Especifica el componente buscado por el filtro.
- Depende de
- Especifica una lista de ID de gestor. En primer lugar se activan los gestores listados antes de que se active el gestor. Un gestor puede tener dependencias explícitas e implícitas. El atributo dependsOn define las dependencias explícitas. Las dependencias implícitas se definen mediante las referencias a otros gestores dentro de una definición de gestor.
- Servicio
- El elemento service define la exportación de un componente al registro de servicios OSGi. Pulse Aceptar para añadir elementos al servicio.
- Más información sobre atributos de servicio:
- ID
- El atributo id identifica el componente. Es obligatorio si se hace referencia al componente desde otra parte de blueprint, por ejemplo si se hace referencia a él desde una definición de servicio.
- Interfaz
- El atributo interface hace referencia a la interfaz que la clase de componente implementa.
- Activación
- Este atributo opcional define la modalidad de activación para el gestor. Se soportan dos modalidades
de activación:
- eager
- El gestor se activa durante la inicialización del contenedor Blueprint.
- lazy
- El gestor se activa a petición.
- Exportación automática
- El valor de exportación automática lo especifica el atributo auto-export
y soporta las cuatro opciones siguientes:
- disabled
- El valor predeterminado si no se especifica el atributo auto-export. Se debe especificar la lista de interfaces utilizando el atributo interface o los subelementos interfaces.
- interfaces
- Registre el servicio utilizando todas las interfaces públicas implementadas por la clase de servicio y cualquiera de las superclases.
- class-hierarchy
- Registre el servicio utilizando la clase de servicio y cualquiera de las superclases públicas.
- all-classes
- Combina las interfaces y opciones de jerarquía de clases.
- Clasificación
- Puede utilizar el atributo de clasificación (ranking) para exponer el servicio con una clasificación específica.
- Referencia
- El atributo ref hace referencia al ID de componente del componente exportado. Este ID se define en el elemento de componente.
- Depende de
- Especifica una lista de ID de gestor. En primer lugar se activan los gestores listados antes de que se active el gestor. Un gestor puede tener dependencias explícitas e implícitas. El atributo dependsOn define las dependencias explícitas. Las dependencias implícitas se definen mediante las referencias a otros gestores dentro de una definición de gestor.
- Convertidores de tipo
- El elemento type-converters convierte valores entre tipos de datos. Pulse Aceptar para añadir elementos al convertidor de tipo.
Para obtener más información sobre el archivo de configuración blueprint, consulte los temas de ayuda Archivos XML Blueprint de OSGi y Especificación de contenedor Blueprint de OSGi.
- Pulse Abrir descriptor de enlaces de Blueprint WebSphere
para crear un archivo de configuración de Blueprint OSGi que contiene las referencias de recurso
al enlace de alias de autenticación para un paquete.
Si una aplicación OSGi contiene un archivo de configuración de enlace de Blueprint de OSGi cuando se despliega como activo, el archivo de configuración de enlace proporciona los valores de alias de autenticación predeterminados que se utilizan al enlazar las referencias de recursos.
Para obtener más información sobre el archivo de enlace blueprint, consulte Creación de archivos XML de enlace blueprint.
- Pulse Añadir y eliminar espacios de nombres blueprint adicionales
para añadir espacios de nombres al archivo XML blueprint.
- En el diálogo Espacios de nombres Blueprint, seleccione los espacios de nombres que desea añadir al archivo blueprint.
- Pulse Finalizar.
Estos elementos se habilitan basándose en los espacios de nombres blueprint que añade al archivo XML blueprint.
- Contexto
- El elemento bpjpa:context amplía la especificación de Blueprint Apache Aries para los beans JPA utilizados en las transacciones blueprint. Este elemento se añade al añadir el espacio de nombres JPA. Pulse Añadir para añadir atributos al elemento.
- Marcador de propiedades
- El elemento bpext:property-placeholder añade extensiones a la especificación blueprint de Apache Aries. Este elemento se añade al añadir el espacio de nombres de extensión Blueprint. Pulse Añadir para añadir atributos al elemento.
- Referencia de recurso
- El elemento bpresref:resource-reference inyecta referencias de recurso, por ejemplo recursos de datos, en beans o servicios. Este elemento se añade al añadir el espacio de nombres de referencia de recursos. Pulse Añadir para añadir atributos al elemento.
- Transacción
- El elemento tx:transaction amplía la especificación blueprint Apache Aries añadiendo propiedades de transacción al archivo blueprint. Este elemento se agrega cuando se añade el espacio de nombres de transacción. Pulse Añadir para añadir atributos al elemento.
- Guarde el archivo.
Para obtener más información sobre los archivos XML blueprint de OSGi, consulte los subtemas siguientes:
- Archivos XML Blueprint de OSGi
Los archivos XML Blueprint definen y describen los diversos componentes de una aplicación. - Creación de archivos XML de enlace de Blueprint
El archivo XML de enlace de Blueprint, ibm-eba-bnd.xml, contiene las referencias de recursos al enlace de alias de autenticación para un paquete. Si una aplicación OSGi contiene un archivo de configuración de enlace de Blueprint de OSGi cuando se despliega como activo, el archivo de configuración de enlace proporciona los valores de alias de autenticación predeterminados que se utilizan al enlazar las referencias de recursos.