Cuando preaplica una sonda, ProbeKit instrumenta la aplicación insertando el código de la sonda y llamando a las clases de la sonda en los archivos de clase de la aplicación. Puede especificar los nombres de 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.
Para ejecutar el motor de instrumentación de ProbeKit y preaplicar una sonda:
- Compruebe que la variable de entorno CLASSPATH contenga la vía de acceso completa y el nombre de archivo del archivo probekit.jar. El archivo probekit.jar se encuentra en la subcarpeta org.eclipse.hyades.probekit de la carpeta plugins de Eclipse.
- Compruebe que la variable de entorno PATH contenga la vía de acceso completa de la subcarpeta org.eclipse.hyades.probekit que resulte apropiada para la plataforma de que disponga:
-
os\win32\x86 para Microsoft Windows
-
os/solaris/sparc para Solaris
-
os/linux/x86 para Linux
- En el indicador de mandatos, escriba lo siguiente: java ProbeInstrumenter, seguido del nombre del archivo .probescript de la sonda que desee utilizar y una lista de elementos que se deban instrumentar. La lista de elementos puede contener archivos de clase, archivos jar o carpetas. Por ejemplo:
java ProbeInstrumenter mi_sonda.probescript c:\vía_acceso_mi_proyecto\mi_programa.jar
Se instrumentan los archivos de clase de la aplicación que coincidan con las reglas de destino de la sonda.
El motor de instrumentación procesa los archivos de la aplicación y carpetas tal como se indica a continuación:
- Cuando se instrumenta un archivo de clase, el archivo *.class no instrumentado se copia en un archivo llamado *.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 no instrumentado se copia en un archivo llamado *.jar.bak, y las llamadas a las clases de la sonda de insertan en el archivo *.jar.
- Cuando se instrumenta el contenido de una carpeta, el motor de instrumentación de ProbeKit desciende por el árbol de la carpeta de forma recursiva y procesa los archivos de clase y jar tal como se describe más arriba.
Nota: El motor de instrumentación de ProbeKit no volverá a instrumentar los archivos de clase y jar que ya se hayan instrumentado. Debe eliminar primero la instrumentación de sonda existente.