Criando um Componente Customizado
O Adaptador de Log Genérico fornece vários componentes predefinidos
que podem ser usados para criar adaptadores para processar arquivos de log de aplicativos.
Se esses componentes não atenderem a suas necessidades, o Adaptador de Log Genérico
pode ser estendido pela criação de componentes customizados
que podem ser incluídos no contexto de um arquivo de configuração do adaptador.
Siga estas etapas para criar um componente customizado:
Se você quiser referenciar o código fonte do Adaptador de Log Genérico ao desenvolver seu próprio componente
adaptador de log genérico, efetue o registro de saída do projeto de plug-in org.eclipse.hyades.logging.adapter
do Repositório do Eclipse CVS. Para fazer isso:
- Abra a perspectiva Exploração de Repositório do CVS.
- Clique com o botão direito do mouse na área de janela Repositórios do CVS e selecione Novo > Local de Repositório.
- Digite dev.eclipse.org como o Host, /home/tools como o Caminho do Repositório e anonymous
como o Usuário.
- Clique em Concluir.
O novo local de repositório é incluído.
- Sob o novo local de repositório, expanda o nó HEAD.
- Clique com o botão direito do mouse no projeto org.eclipse.hyades.logging.adapter e selecione Efetuar o Registro de Saída.
O projeto é criado no espaço de trabalho.
É necessário criar uma classe Java que contenha o código para o novo componente.
- Crie um projeto de plug-in para conter o novo componente.
- Crie uma classe Java dentro do projeto. Dependendo da função que o novo componente irá desempenhar, ele deve implementar uma das seguintes interfaces
definidas no pacote org.eclipse.hyades.logging.adapter:
- IProcessUnit
- estende IComponent com os métodos para fazer o processamento do componente.
Matrizes de objetos são transmitidas entre componentes de modo que o método de processamento principal, processEventItems,
aceita uma matriz de Objetos como entrada e retorna uma matriz de Objetos.
Todos os componentes devem implementar IProcessUnit. IComponent inclui os métodos getter e setter
para todas as propriedades do componente, um método update para obter as propriedades do componente da configuração
e métodos para iniciar e parar o componente.
- ISensor
- estende IProcessUnit. Deve ser usado ao implementar um componente sensor. O método getNext retorna o próximo grupo de dados da origem que está sendo monitorada pelo sensor.
O método flush descarrega quaisquer dados restantes da origem que estejam sendo armazenados em cache pelo sensor. A interface também inclui um getter e setter
para o tipo de sensor conforme definido no arquivo esquema do sensor sensor.xsd.
- IExtractor
- estende IProcessUnit. Deve ser usado ao implementar um componente extrator.
Como um sensor tipicamente retorna dados como cadeias para o extrator e o extrator
extrai mensagens completas dessas cadeias, um extrator deve implementar um método processStrings
que aceite como entrada uma matriz de Cadeias e retorne uma matriz de objetosMessageString.
A classe MessageString também é definida no pacote org.eclipse.hyades.logging.adapter.
- IParser
- estende IProcessUnit. Deve ser usado ao implementar um componente analisador.
- IFormatter
- estende IProcessUnit. Deve ser usado ao implementar um componente formatador.
- IOutputter
- estende IProcessUnit. Deve ser usado ao implementar um componente emissor de saída.
Outra opção na criação de uma nova classe de componente é estender as classes de implementação padrão para IComponent, IProcessUnit, ISensor e IExtractor
no pacote org.eclipse.hyades.logging.adapter.impl.
Existem exemplos dos componentes nos pacotes de componentes associados no projeto org.eclipse.hyades.logging.adapter.
- Depois de concluir o código, salve as alterações.
Como você está estendendo as classes do Adaptador de Log Genérico, precisará incluir o plug-in do
Adaptador de Log Genérico e suas dependências em seu plug-in.
- Abra o arquivo plugin.xml file e inclua as seguintes dependências:
org.eclipse.hyades.logging.adapter
org.eclipse.hyades.logging.core
Para configurar seu plug-in como uma extensão de componente do Adaptador de Log Genérico:
- Inclua a seguinte extensão no arquivo plugin.xml:
<extension
point="org.eclipse.hyades.logging.adapter.adapterComponent">
<componentClassname
name="nome_da_classe_executável">
</componentClassname>
</extension>
em quem nome_da_classe_executável é o nome da classe Java que você criou para implementar seu novo componente
do Adaptador de Log Genérico.
- Salve o arquivo plugin.xml.
Tarefas Relacionadas
Testando o Componente Customizado
(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.