Aplicación previa de una Sonda

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.

Aplicación previa de una sonda desde un banco de trabajo

En el banco de trabajo, se puede aplicar previamente una sonda desde la vista Navegador o Explorador de paquetes.

  1. Seleccione un archivo .probe o los archivos que quiere aplicar previamente.
  2. Pulse el botón derecho del ratón y elija Probekit > Instrumentar.
  3. 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.

  1. Construya el proyecto de aplicación previa para limpiar los datos de sonda de los archivos .class.
  2. Suprima los archivos _probe.class.
  3. 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:
  1. Elimine la carpeta _probekit_probes_ de la vía classpath del proyecto.
  2. Elimine la carpeta _probekit_probes_.
  3. 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.
  1. 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.
  2. 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:
    • Icono plataforma Windows os\win32\x86 para Microsoft® Windows®
    • Icono plataforma Solaris os/solaris/sparc para Solaris
    • Icono plataforma Linux os/linux/x86 para Linux™
  3. 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.

Tareas relacionadas
Eliminación de instrumentación de Probekit

(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.