< Anterior | Próximo >

Lição 3: Criar o arquivo de configuração 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. Neste tutorial, o arquivo blueprint define um serviço que outros componentes podem usar para acessar o contador que foi definido na Lição 2.

Sobre Esta Tarefa

Nesta lição, você cria o arquivo de configuração de blueprint que define e descreve os serviços que são fornecidos pelo CounterServiceBundle.

Para criar o arquivo de configuração de projeto:

Procedimento

  1. Clique com o botão direito do mouse no projeto CounterServiceBundle e selecione Novo > Arquivo de Projeto e, em seguida, clique em Concluir. O arquivo de configuração de projeto é aberto no editor.
  2. Inclua as informações do conjunto de componentes e de configuração no arquivo de configuração de projeto:
    1. Na guia Design do editor, clique em Incluir. O diálogo Incluir Item se abre.
    2. Clique em Bean e, em seguida, clique em OK. O diálogo Detalhes do Bean é aberto.
    3. Configure o bean:
      1. No campo ID do Bean, digite CounterBean.
      2. No campo Classe de Bean, clique em Procurar. O diálogo Seleção de Tipo é aberto. No campo Escolher nome do tipo, digite CounterImpl e, em seguida, selecione a classe CounterImpl. Clique em OK.
      3. Clique em OK para aceitar as mudanças e fechar o diálogo.
      4. No editor, no campo Método de Inicialização, na seção Referências de Métodos, digite init.
      O bean é incluído no arquivo de projeto.
    4. Clique em Projeto e, em seguida, clique em Incluir. O diálogo Incluir Item se abre.
    5. Clique em Serviço e, em seguida, clique em OK. O diálogo Detalhes do Serviço é aberto.
    6. Configure o serviço:
      1. No campo Interface de Serviço, clique em Procurar e, em seguida, selecione a interface Contador que você criou na Lição 2. Clique em OK.
      2. No campo Referência de Bean, clique em Procurar e, em seguida, selecione Bean: CounterBean. Clique em OK.
      3. Clique em OK para aceitar as mudanças e fechar o diálogo.
      O serviço é incluído no arquivo de projeto.
  3. Salve o arquivo.

Resultados

Alterne para a guia Origem para visualizar a origem de configuração de projeto:
<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
	<bean id="CounterBean" class="com.ibm.ws.eba.counter.CounterImpl" init-method="init"/>
	<service id="CounterBeanService" ref="CounterBean"
		interface="com.ibm.ws.eba.counter.Counter" />
</blueprint>
Dica: Para formatar a origem, pressione Ctrl + Shift + F.

O que Fazer Depois

Saiba mais sobre este arquivo de configuração de projeto:
Bean
O elemento bean define o componente do projeto que é instanciado.
Neste tutorial, o elemento bean resulta na instanciação do componente Counter chamando o construtor de classe CounterImpl. Depois que a classe é criada, o método de inicialização getCount() é chamado.
classe
O atributo class especifica qual classe de implementação do componente é instanciada.
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.
método de inicialização
O init-method init() será chamado quando o componente for criado. Se você não desejar chamar um método durante a inicialização do pacote configurável, remova esse atributo.
serviço
O elemento service define a exportação de um componente para o registro de serviço OSGi.
Neste tutorial, o elemento service exporta o componente com o mesmo Counter como um serviço no registro de serviço OSGi com a interface com.ibm.ws.eba.counter.Counter, especificado pelo atributo de interface.
ref
O atributo ref se refere ao ID do componente exportado. Esse ID é definido no elemento do componente.
lógica
O atributo interface se refere à interface que a classe de componente implementa.

Para obter mais informações sobre o arquivo de configuração de blueprint, consulte XML de Blueprint do OSGi e Modelo de componente do Blueprint OSGi (RFC124).

Ponto de verificação da lição

Você criou o arquivo de configuração de blueprint para o pacote configurável OSGi Counter.

Nesta lição, você aprendeu sobre os seguintes tópicos:
  • Como criar um arquivo blueprint.xml.
  • Como configurar um arquivo blueprint.xml.
< Anterior | Próximo >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: counter_lesson3.html