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:

Extraia o Código Fonte do Adaptador de Log Genérico

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:

Crie uma Classe Java

É necessário criar uma classe Java que contenha o código para o novo componente.

  1. Crie um projeto de plug-in para conter o novo componente.
  2. 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.

  3. Depois de concluir o código, salve as alterações.

Inclua as Dependências do Plug-in

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.

  1. Abra o arquivo plugin.xml file e inclua as seguintes dependências:
    org.eclipse.hyades.logging.adapter
    org.eclipse.hyades.logging.core

Configure o Plug-in como uma Extensão

Para configurar seu plug-in como uma extensão de componente do Adaptador de Log Genérico:

  1. 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.
  2. Salve o arquivo plugin.xml.

 

Tarefas Relacionadas
Testando o Componente Customizado