Cuando aplica previamente una sonda, Probekit instrumentaliza su aplicación
mediante la inserción de código y llamadas de sonda en las clases de sonda dentro
de los archivos de clase de su aplicación.
El motor de instrumentación procesa los archivos y carpetas
de su aplicación de la siguiente manera:
- Cuando se instrumenta un archivo de clase, el archivo *.class sin
instrumentar se copia a un archivo denominado *.class.bak, y las llamadas a las clases
de la sonda se insertan en el archivo *.class.
- Cuando se instrumenta un archivo jar, el archivo *.jar sin instrumentar
se copia a un archivo denominado *.jar.bak, y las llamadas a las clases de la sonda se
insertan en los archivos de clase dentro del archivo *.jar.
Nota: El motor de instrumentación de Probekit
no volverá a instrumentar los archivos de clase y jar que ya han sido instrumentados. Antes debe
eliminar la instrumentación existente en la sonda.
Las sondas se pueden aplicar previamente desde el banco de trabajo o desde la línea de mandatos.
En el banco de trabajo, se puede aplicar previamente una sonda desde la vista
Navegador o Explorador de paquetes.
- Seleccione un archivo .probe o los archivos que quiere aplicar previamente.
- Pulse el botón derecho del ratón y elija Probekit > Instrumentar.
- Si ha seleccionado un archivo .probe:
- En el cuadro de diálogo Instrumentar, seleccione los archivos .class, .jar o .jar externo
que quiere instrumentar.
Nota: Si el archivo .jar externo está en uso por parte del banco de trabajo, la aplicación
previa será errónea.
El archivo se debe aplicar previamente desde la línea de mandatos.
Si ha seleccionado un archivo .class o .jar:
- En el cuadro de diálogo Elegir archivo de sonda, seleccione el archivo .probe a aplicar.
Nota: Una vez que se aplica previamente la sonda, si el proyecto que contiene los archivos
a aplicar previamente no tiene el archivo .probe en su vía classpath, se realiza cierta configuración
en el proyecto con los archivos aplicados previamente.
Los archivos _probe.class necesarios se copian en el contenedor de salida del proyecto.
Cuando las sondas de un proyecto fuente ya no son necesarias, elimine la instrumentación de Probekit.
- Construya el proyecto de aplicación previa para limpiar los datos de sonda de los archivos .class.
- Suprima los archivos _probe.class.
- Cambie el nombre de los archivos all.jar.bak nuevamente a su nombre original.
Para proyectos binarios, la configuración crea una clase nueva folder _probekit_probes y añade dicha carpeta a la vía classpath del proyecto.
Cuando las sondas de un proyecto binario ya no hacen falta, elimine la instrumentación de Probekit:
- Elimine la carpeta _probekit_probes_ de la vía classpath del proyecto.
- Elimine la carpeta _probekit_probes_.
- Cambie el nombre de los archivos .bak nuevamente a su nombre original.
Aplicación previa de una sonda desde la línea de mandatos
Para la aplicación previa de un archivo externo que no se puede modificar
mientras se ejecuta el banco de trabajo, ejecute el motor de instrumentación Probekit y aplique
de forma previa una sonda desde la línea de mandatos. Puede especificar los nombres de los archivos
de clase de aplicación, archivos jar o carpetas en la línea de mandatos que invoca el motor de
instrumentación de Probekit.
- Asegúrese que la variable de entorno CLASSPATH
contiene la vía de acceso y nombre de archivo completos del archivo
probekit.jar. El archivo probekit.jar se encuentra en la subcarpeta
org.eclipse.hyades.probekit de la carpeta plugins de Eclipse.
- Asegúrese de que la variable de entorno
PATH contiene la vía de acceso completa a la subcarpeta
de org.eclipse.hyades.probekit adecuada para su plataforma:
-
os\win32\x86 para Microsoft® Windows®
-
os/solaris/sparc para Solaris
-
os/linux/x86 para Linux™
- En el indicador de mandatos, entre el mandato:
java ProbeInstrumenter,
seguido del nombre de archivo .probescript para la sonda que quiera utilizar, y una lista
de los elementos a instrumentar. Los elementos de lista pueden ser archivos de clase,
archivos jar o carpetas. Por ejemplo:
java ProbeInstrumenter myprobe.probescript c:\myproject_path\myprogram.jar
Los archivos de clase de la aplicación que cumplen las reglas de objetivo de la sonda se instrumentan.