Criando arquivos XML de blueprint
O arquivo de configuração de blueprint contém as informações do conjunto de componentes e da configuração para um pacote configurável. O arquivo descreve como os componentes são registrados no registro de serviço OSGi ou como eles procuram serviços no registro de serviço OSGi. Essas informações são usadas no tempo de execução para instanciar e configurar os componentes necessários quando o pacote configurável é iniciado.
Procedimento
- Clique com o botão direito do mouse no projeto de pacote configurável e selecione Novo > Arquivo de Projeto. A assistente Novo Arquivo de Projeto é aberto.
- No campo Nome do Arquivo, digite o nome do arquivo de configuração de projeto e, em seguida, clique em Avançar.
- Na página Incluir ou Remover Namespaces de Blueprint Adicionais
do assistente, selecione os namespaces que você deseja incluir em seu
arquivo blueprint. É possível incluir namespaces para extensões de projeto, JPA, Referência de recurso e Transações.Saiba sobre namespaces de projetos:
Tabela 1. Descrição de Namespaces de Projetos Esquema URL Descrição Extensão de Projeto http://aries.apache.org/blueprint/xmlns/blueprint-ext/v1.0.0 Extensões do IBM® Blueprint
Extensões para o modelo de programação do Projeto OSGi, tal como uma injeção de campo.
Segurança de blueprint http://www.ibm.com/appserver/schemas/blueprint/security/v1.0.0 Segurança do IBM Blueprint
Configure a segurança do bean para que os métodos do bean possam ser acessados apenas por usuários que sejam designados com uma função especificada.
JPA http://aries.apache.org/xmlns/jpa/v1.0.0 Suporte ao JPA Blueprint
Fornece a integração do Java™ Persistence API (JPA) no Blueprint. As unidades de persistência e os contextos de persistência podem ser injetados em beans gerenciados do Projeto.
Referência de Recurso http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference Suporte de referência de recurso de Projeto
Fornece para objetos que são declarados no JNDI do WebSphere Application Server, tais como origens de dados e connection factories a serem injetados em beans gerenciados do Blueprint.
Transações http://aries.apache.org/xmlns/transactions/v1.0.0 Suporte a transações do projeto
Permite que o desenvolvedor declare os requisitos de transação para beans gerenciados do Projeto.
Nota: Se você deseja incluir outros namespaces não nesta lista, alterne para a visualização Origem e digite o namespace. - Clique em Concluir. O arquivo de configuração de projeto é aberto no editor.
- Clique em Incluir para incluir as informações de configuração e do conjunto de componentes no arquivo de configuração de projeto.
- Bean
- O elemento bean define o componente do projeto que é instanciado. Clique em OK para incluir argumentos e propriedades no bean.
- Saiba mais sobre os atributos Bean:
- ID
- O atributo id identifica o componente. Ele será obrigatório, se o componente for referido de outro lugar no projeto, por exemplo, se ele for referido de uma definição de serviço.
- Classe
- O atributo class especifica qual classe de implementação do componente é instanciada.
- Ativação
- Esse atributo opcional define o modo de ativação para o gerenciador. Dois modos de ativação são suportados:
- rápido
- O gerenciador é ativado durante a inicialização do Blueprint Container.
- lazy
- O gerenciador é ativado sob demanda.
- Escopo
- Dependendo da configuração do escopo, um gerenciador de bean pode criar uma única ou diversas instâncias de objetos.
A especificação do Blueprint Container define dois escopos principais:
- singleton
- O gerenciador de bean cria uma única instância do bean e retorna esse instância cada vez que for solicitado que o gerenciador forneça um objeto.
- prototype
- O gerenciador de bean cria uma nova instância do bean cada vez que for solicitado que ele forneça um objeto.
- Depende de
- Especifica uma lista de IDs do gerenciador. Os gerenciadores listados são ativados primeiro, antes de o gerenciador ser ativado. Um gerenciador pode ter dependências explícitas e implícitas. O atributo dependsOn define as dependências explícitas. As dependências implícitas são definidas pelas referências a outros gerenciadores dentro de uma definição de gerenciador.
- Referência de Factory
- Especifica o ID de um bean ou o gerenciador de referência que age como um factory. O objeto especificado deve ter um factory method, conforme especificado pelo atributo factory method.
- Método de Destruição
- Especifica um método a ser chamado quando o Blueprint Container estiver destruindo a instância do objeto.
- Factory method
- Especifica o nome do factory method estático.
- Método de Inicialização
- O método de inicialização é chamada quando o componente é criado. Se você não desejar chamar um método durante a inicialização do pacote configurável, remova esse atributo.
- Referenciar
- O elemento reference especifica os serviços que são localizados no registro de serviço. Clique em OK para incluir itens na referência.
- Saiba mais sobre os atributos de Referência:
- ID
- O atributo id identifica o componente. Ele será obrigatório, se o componente for referido de outro lugar no projeto, por exemplo, se ele for referido de uma definição de serviço.
- Interface
- O atributo interface se refere à interface que a classe de componente implementa.
- Ativação
- Esse atributo opcional define o modo de ativação para o gerenciador. Dois modos de ativação são suportados:
- rápido
- O gerenciador é ativado durante a inicialização do Blueprint Container.
- lazy
- O gerenciador é ativado sob demanda.
- Disponibilidade
- Controla requisitos pelo gerenciador de referência de serviço de que pelo
menos um serviço, que corresponde aos critérios de seleção, existe antes
da inicialização do contêiner de blueprint continuar. O atributo de disponibilidade possui dois valores:
- Opcional
- Os serviços que correspondem aos critérios não precisam existir.
- obrigatórias
- Pelo menos um serviço que corresponde aos critérios deve existir.
- Filtrar
- Especifica a expressão de filtro para a seleção de serviço.
- Tempo-limite
- Especifica o período de tempo, em milissegundos, que um proxy aguarda um serviço de apoio se tornar disponível.
- Nome do componente
- Especifica o componente procurado pelo filtro.
- Depende de
- Especifica uma lista de IDs do gerenciador. Os gerenciadores listados são ativados primeiro, antes de o gerenciador ser ativado. Um gerenciador pode ter dependências explícitas e implícitas. O atributo dependsOn define as dependências explícitas. As dependências implícitas são definidas pelas referências a outros gerenciadores dentro de uma definição de gerenciador.
- Lista de Referências
- O elemento reference-list ativa o elemento de referência para localizar diversos serviços correspondentes. Clique em OK para incluir itens na lista de referência.
- Saiba mais sobre os Atributos de lista de referências:
- ID
- O atributo id identifica o componente. Ele será obrigatório, se o componente for referido de outro lugar no projeto, por exemplo, se ele for referido de uma definição de serviço.
- Interface
- O atributo interface se refere à interface que a classe de componente implementa.
- Ativação
- Esse atributo opcional define o modo de ativação para o gerenciador. Dois modos de ativação são suportados:
- rápido
- O gerenciador é ativado durante a inicialização do Blueprint Container.
- lazy
- O gerenciador é ativado sob demanda.
- Disponibilidade
- Controla requisitos pelo gerenciador de referência de serviço de que pelo
menos um serviço, que corresponde aos critérios de seleção, existe antes
da inicialização do contêiner de blueprint continuar. O atributo de disponibilidade possui dois valores:
- Opcional
- Os serviços que correspondem aos critérios não precisam existir.
- obrigatórias
- Pelo menos um serviço que corresponde aos critérios deve existir.
- Filtrar
- Especifica a expressão de filtro para a seleção de serviço.
- Tipo de Membro
- Especifica os tipos de membros fornecidos pelo gerenciador de lista de referências. O atributo de tipo de membro suporta:
- objeto de serviço
- Injeta uma lista de objetos proxy de serviço.
- referência de serviço
- Injeta uma lista de objetos de referência de serviço.
- Nome do componente
- Especifica o componente procurado pelo filtro.
- Depende de
- Especifica uma lista de IDs do gerenciador. Os gerenciadores listados são ativados primeiro, antes de o gerenciador ser ativado. Um gerenciador pode ter dependências explícitas e implícitas. O atributo dependsOn define as dependências explícitas. As dependências implícitas são definidas pelas referências a outros gerenciadores dentro de uma definição de gerenciador.
- serviço
- O elemento service define a exportação de um componente para o registro de serviço OSGi. Clique em OK para incluir itens no serviço.
- Saiba mais sobre os Atributos de serviço:
- ID
- O atributo id identifica o componente. Ele será obrigatório, se o componente for referido de outro lugar no projeto, por exemplo, se ele for referido de uma definição de serviço.
- Interface
- O atributo interface se refere à interface que a classe de componente implementa.
- Ativação
- Esse atributo opcional define o modo de ativação para o gerenciador. Dois modos de ativação são suportados:
- rápido
- O gerenciador é ativado durante a inicialização do Blueprint Container.
- lazy
- O gerenciador é ativado sob demanda.
- Autoexportação
- A configuração de exportação automática é especificada pelo atributo de exportação automática
e suporta as quatro opções a seguir:
- desativada
- O valor padrão, se o atributo de exportação automática não estiver especificado. A lista de interfaces deve ser especificada usando o atributo de interface ou subelementos de interfaces.
- interfaces
- Registre o serviço usando todas as interfaces públicas implementadas pela classe de serviço e qualquer uma de suas superclasses.
- hierarquia de classes
- Registre o serviço usando a classe de serviço e qualquer uma de suas superclasses públicas.
- todas as classes
- Combina opções de interfaces e de hierarquia de classes.
- Ranking
- É possível usar o atributo de classificação para expor o serviço com uma classificação específica.
- Referenciar
- O atributo ref se refere ao ID do componente exportado. Esse ID é definido no elemento do componente.
- Depende de
- Especifica uma lista de IDs do gerenciador. Os gerenciadores listados são ativados primeiro, antes de o gerenciador ser ativado. Um gerenciador pode ter dependências explícitas e implícitas. O atributo dependsOn define as dependências explícitas. As dependências implícitas são definidas pelas referências a outros gerenciadores dentro de uma definição de gerenciador.
- Conversores de Tipo
- O elemento type-converters converte os valores entre os tipos de dados. Clique em OK para incluir itens no conversor de tipo.
Para obter mais informações sobre o arquivo de configuração do blueprint, consulte os tópicos da Ajuda Arquivos XML do Blueprint do OSGi e Especificação de Contêiner de Blueprint do OSGi.
- Clique em Abrir o Descritor de Ligação de Projeto do WebSphere para criar um arquivo de configuração de projeto do OSGi que contenha as referências de recursos para a ligação do alias de autenticação de um pacote configurável.
Se um aplicativo OSGi contiver um arquivo de configuração de ligação de projeto do OSGi, quando ele for implementado como um ativo, o arquivo de configuração de ligação fornecerá os valores do alias de autenticação padrão usados ao ligar as referências de recursos.
Para obter mais informações sobre o arquivo de ligação do blueprint, consulte Criando arquivos XML de ligação do blueprint.
- Clique em Incluir e remover namespaces do blueprint adicionais para
incluir namespaces no arquivo XML do blueprint.
- No diálogo Namespaces de Projeto, selecione os namespaces que deseja incluir no arquivo de projeto.
- Clique em Concluir.
Esses elementos são ativados com base nos namespaces do blueprint que você inclui no arquivo XML do blueprint.
- Contexto
- O elemento bpjpa:context estende a especificação do projeto Apache Aries para beans JPA usados dentro das transações do projeto. Este elemento é incluído quando você inclui o namespace de JPA. Clique em Incluir para incluir atributos no elemento.
- Marcador de Propriedades
- O elemento bpext:property-placeholder inclui extensões para a especificação do projeto do Apache Aries. Este elemento é incluído quando você inclui o namespace de extensão Blueprint. Clique em Incluir para incluir atributos no elemento.
- Referência de Recurso
- O elemento bpresref:resource-reference injeta referências de recursos, por exemplo origens de dados, nos beans ou serviços. Este elemento é incluído quando você inclui o namespace de referência de Recurso. Clique em Incluir para incluir atributos no elemento.
- Transação
- O elemento tx:transaction estende a especificação do projeto do Apache Aries incluindo as propriedades de transações no arquivo de projeto. Este elemento é incluído quando você inclui o namespace da Transação. Clique em Incluir para incluir atributos no elemento.
- Salve o arquivo.
Para obter mais informações sobre arquivos XML do blueprint OSGi, consulte os subtópicos a seguir:
- Arquivos XML de blueprint do OSGi
Os arquivos XML de Projeto definem e descrevem os vários componentes de um aplicativo. - Criando arquivos XML de ligação do blueprint
O arquivo XML de ligação do projeto, ibm-eba-bnd.xml, contém as referências de recursos para a ligação do alias de autenticação de um pacote configurável. Se um aplicativo OSGi contiver um arquivo de configuração de ligação de projeto do OSGi, quando ele for implementado como um ativo, o arquivo de configuração de ligação fornecerá os valores do alias de autenticação padrão usados ao ligar as referências de recursos.