Visão Geral do Probekit

O Probekit é uma estrutura na plataforma Eclipse utilizada para gravar e utilizar probes. Probes são fragmentos de código Java™ que podem ser inseridos em um programa para fornecer informações sobre o programa durante sua execução.

Para entender os probes, inicie com o probe de amostra descrito aqui. Ele é um probe básico que imprime uma mensagem identificando todos os métodos chamados quando o programa é executado.

Os probes são definidos por entradas feitas no editor Probekit. Esta amostra contém um fragmento único; fragmentos determinam o que o probe faz. As definições de fragmento incluem:

No editor Probekit, o probe é semelhante ao seguinte:

O Editor Probekit Mostrando as Entradas da Amostra de Código Básico Descrita no Tópico da Ajuda.

Após a criação de um probe que utiliza o editor Probekit, é possível aplicá-lo aos arquivos de classe e jar para o projeto. Em seguida, quando o projeto for executado, o código de fragmento será executado juntamente com o programa.

Aqui está uma visão geral de como criar e utilizar probes, incluindo informações sobre como o Probekit ajuda você:
  1. O editor Probekit é utilizado para criar probes em arquivos de origem Probekit. Os arquivos de origem Probekit devem ter a extensão .probe. Eles podem conter um ou mais probes e cada probe pode conter um ou mais fragmentos de probe.
  2. O Probekit monta os fragmentos de probe em um conjunto de métodos Java e, em seguida, compila-os. Quando o Probekit compila um probe, ele combina os fragmentos de probe com clichê Java padrão e gera código fonte Java para uma nova classe de probe. As funções geradas dos fragmentos de probe aparecem como métodos estáticos da nova classe com probe.
  3. Quando um probe é aplicado, você especifica a classe de destino e os arquivos jar que deseja investigar. O mecanismo BCI (Byte-Code Instrumentation) do Probekit faz referência à lista de probes disponíveis e seus padrões de destino e chamadas de inserções em métodos de fragmento de probe nos programas de destino. O processo de inserção de instruções de chamada em métodos de destino é referido como instrumentação. A classe que contém um método instrumentado é chamada de classe com probe. Os itens de dados pedidos por um fragmento de probe (por exemplo, o nome do método e o nome de classe) são transmitidos como argumentos.
  4. Após a instrumentação do aplicativo. Os fragmentos de probe são executados quando o programa é executado.
O tipo de fragmento de probe determina quando um fragmento é executado. É possível especificar tipos que fazem com que o fragmento seja executado nas seguintes ocasiões:

Os fragmentos de probe podem acessar itens de dados que fornecem vários tipos de informações sobre o aplicativo no ponto em que são inseridos. Exemplo:

Para que o probe seja aplicado apenas a determinadas classes e métodos, especifique os destinos ou configure filtros. Para obter informações adicionais, consulte Destinos e Filtros do Probe.

Conceitos Relacionados
Trabalhando com Probes
Probes de Método versus probes callsite
Referência Relacionada
Exemplos de Probekit