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

  1. 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.
  2. En el campo Nombre de archivo, escriba el nombre del archivo de configuración blueprint y, a continuación, pulse Siguiente.
  3. 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.

    Más información: seguridad de Blueprint y aplicaciones OSGi

    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.
  4. Pulse Finalizar. Se abre el archivo de configuración de blueprint en el editor.
  5. 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.
    De forma predeterminada, la activación está establecida en eager.
    Á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.
    De forma predeterminada, se supone el ámbito singleton para gestores de beans de nivel superior. El atributo de ámbito no se puede establecer en un gestor de beans incorporado, por lo que siempre se considera que los gestores incorporados tienen ámbito de prototipo.
    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.
    De forma predeterminada, la activación está establecida en eager.
    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.
    De forma predeterminada, la disponibilidad está establecida en obligatoria (mandatory).
    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.
    De forma predeterminada, la activación está establecida en eager.
    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.
    De forma predeterminada, la disponibilidad está establecida en obligatoria (mandatory).
    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.
    De forma predeterminada, el tipo de miembro está establecido en service-object.
    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.
    De forma predeterminada, la activación está establecida en eager.
    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.

  6. 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.

  7. Pulse Añadir y eliminar espacios de nombres blueprint adicionales para añadir espacios de nombres al archivo XML blueprint.
    1. En el diálogo Espacios de nombres Blueprint, seleccione los espacios de nombres que desea añadir al archivo blueprint.
    2. 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.
  8. Guarde el archivo.

    Para obtener más información sobre los archivos XML blueprint de OSGi, consulte los subtemas siguientes:

Icono que indica el tipo de tema Tema de tarea
Términos y condiciones para centros de información | Comentarios

Icono de indicación de fecha y hora Última actualización: 22 de abril de 2014

Nombre de archivo: tcrtblueprintxml.html