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.
No workbench, uma probe pode ser pré-aplicada a partir da visualização Navegador ou Explorador de Pacotes.
- Selecione um arquivo .probe ou os arquivos a serem pré-aplicados.
- Clique com o botão direito do mouse e escolha Probekit > Instrument (Instrumentar).
- 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.
- Construa o projeto pré-aplicado para limpar os dados da probe dos arquivos .class.
- Exclua os arquivos _probe.class.
- 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:
- Remova a pasta _probes_probekit_ do caminho de classe do projeto.
- Exclua a pasta _probes_probekit_.
- 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.
- 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.
- 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:
-
os\win32\x86 para Microsoft® Windows®
-
os/solaris/sparc para Solaris
-
os/linux/x86 para Linux™
- 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.