Pré-aplicando uma Probe

Ao pré-aplicar uma probe, o Probekit instrumenta seu aplicativo inserindo código de probe e chamadas para as classes da probe nos arquivos de classe do aplicativo.

O mecanismo de instrumentação processa seus arquivos de aplicativo e pastas da seguinte maneira:
  • Quando um arquivo de classe é instrumentado, o arquivo *.class não instrumentado é copiado para um arquivo denominado *.class.bak e chamadas para as classes de probe são inseridas no arquivo *.class.
  • Quando um arquivo jar é instrumentado, o arquivo *.jar não instrumentado é copiado para um arquivo denominado*.jar.bak e as chamadas para as classes de probe são inseridas em arquivos de classe dentro do arquivo *.jar.
Nota: O mecanismo de instrumentação do Probekit não reinstrumentará arquivos de classe e arquivos jar que já foram instrumentados. Você deve remover a instrumentação da probe existente primeiramente.

As probes podem ser pré-aplicadas a partir do workbench ou da linha de comando.

Pré-aplicando uma Probe a Partir do Workbench

No workbench, uma probe pode ser pré-aplicada a partir da visualização Navegador ou Explorador de Pacotes.

  1. Selecione um arquivo .probe ou os arquivos a serem pré-aplicados.
  2. Clique com o botão direito do mouse e escolha Probekit > Instrument (Instrumentar).
  3. Se você selecionou um arquivo .probe:
    • Na caixa de diálogo Instrument (Instrumentar), selecione os arquivos .class, .jar ou .jar externo a serem instrumentados. Nota: Se o arquivo .jar externo estiver sendo utilizado pelo workbench, a pré-aplicação falhará. O arquivo deve ser pré-aplicado a partir do prompt de comandos.
    Se você selecionou um arquivo .class ou .jar:
    • Na caixa de diálogo Choose Probe File (Escolher Arquivo da Probe), selecione o arquivo .probe a ser aplicado.

Nota: Depois que a probe for pré-aplicada, se o projeto que contiver os arquivos pré-aplicados não tiver o arquivo .probe no caminho de classe, então, alguma configuração será executada no projeto com os arquivos pré-aplicados. Os arquivos probe_necessária.class são copiados no contêiner de saída do projeto. Quando as probes de um projeto de origem não forem mais necessárias, então remova a instrumentação do Probekit.

  1. Construa o projeto pré-aplicado para limpar os dados da probe dos arquivos .class.
  2. Exclua os arquivos _probe.class.
  3. Renomeie os arquivos all.jar.bak novamente para o nome original.
Para projetos binários, a configuração cria uma nova pasta de classes _probes_probekit e inclui essa pasta no caminho de classe do projeto. Quando as probes de um projeto binário não forem mais necessárias, remova a instrumentação do Probekit:
  1. Remova a pasta _probes_probekit_ do caminho de classe do projeto.
  2. Exclua a pasta _probes_probekit_.
  3. Renomeie todos os arquivos .bak novamente para o nome original.

Pré-aplicando uma Probe a Partir da Linha de Comandos

Para pré-aplicar um arquivo externo que não pode ser modificado enquanto o workbench estiver em execução, execute o mecanismo de instrumentação do Probekit e pré-aplique uma probe a partir do prompt de comandos. Você pode especificar os nomes de arquivos de classe de aplicativos, arquivos ou pastas jar na linha de comando que chame o mecanismo de instrumentação do Probekit.
  1. Assegure-se de que a variável de ambiente CLASSPATH contenha o caminho completo e o nome do arquivo probekit.jar. O arquivo probekit.jar está localizado na subpastaorg.eclipse.hyades.probekit da sua pasta de plugins do Eclipse.
  2. Assegure-se de que a variável de ambiente PATH contenha o caminho completo da subpasta do org.eclipse.hyades.probekit apropriada para a sua plataforma:
    • ícone da plataforma Windows os\win32\x86 para Microsoft® Windows®
    • ícone da plataforma Solaris os/solaris/sparc para Solaris
    • ícone da plataforma Linux os/linux/x86 para Linux™
  3. No prompt de comandos, digite o comando: java ProbeInstrumenter, seguido pelo nome do arquivo .probescript da probe que você deseja utilizar e uma lista de itens a serem instrumentados. Os itens da lista podem ser arquivos de classe, arquivos jar ou pastas. Por exemplo:
    java ProbeInstrumenter myprobe.probescript c:\myproject_path\myprogram.jar
    Os arquivos de classe do aplicativo que correspondem às regras de destino da probe são instrumentados.

Tarefas Relacionadas
Removendo Instrumentação do Probekit

(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.