Creación de una sonda mediante el editor Probekit

Puede utilizar la interfaz visual del editor Probekit para crear el código fuente para una sonda nueva.

Para crear una sonda mediante el editor Probekit:

  1. Pulse el botón derecho del ratón sobre el proyecto que contendrá la sonda nueva y seleccione Nuevo > Otro en el menú emergente.
  2. In la página Seleccionar un asistente, despliegue Perfilado y anotación y seleccione Archivo fuente de Probekit.
  3. Pulse Siguiente.
  4. En el asistente Crear un archivo de sonda nuevo, escriba un nombre para el archivo en el campo Nombre de archivo. La extensión para los archivos fuente de sonda debe ser .probe.
  5. En Carpeta de origen, seleccione la carpeta de origen que contendrá el nuevo archivo origen de sonda. Puede especificar un nombre de carpeta en el recuadro de edición o seleccionar una carpeta en el panel en árbol.
    Nota: Los archivos origen de sonda deben aparecer en el nivel superior de una carpeta de origen de proyecto; no pueden estar en una subcarpeta.
  6. Seleccione el tipo de contenido que quiera añadir a la sonda. Si selecciona Sonda de método o Sonda Callsite, tendrá que seleccionar también el Tipo de fragmento.
  7. Pulse Siguiente.
  8. Añada tantos objetos de sonda de datos como sean necesarios, con el botón Añadir. La descripción de los objetos de sonda de datos disponible para el tipo de sonda que se está creando se visualiza en la parte inferior de la página.

    Nota: Si vuelve atrás y cambia el tipo de la sonda que está creando o el tipo del fragmento a insertar, es posible que se le solicite descartar los objetos de sonda de datos que ya no se sean de aplicación.
  9. Pulse Finalizar. En la carpeta de origen del proyecto aparecer el archivo nuevo .probe y, por omisión, se abrirá automáticamente en el editor Probekit.
  10. Seleccione la ficha General.
  11. En el campo ID, entre una cadena id exclusiva para la sonda y, de forma opcional, un número de versión en el campo Version. La cadena id se utilizará para identificar de forma exclusiva la sonda en el registro de Probekit. Para obtener más información, consulte El objeto Probekit.
  12. Seleccione la ficha Sondas y pulse el botón Añadir sonda. El objeto nuevo sonda aparecerá en el panel en árbol.
  13. Pulse el botón derecho del ratón sobre el objeto sonda en el árbol del editor y, en el menú emergente, seleccione Nuevo > Fragmento. En el árbol, aparecerá el objeto nuevo fragmento como hijo del objeto sonda, y en el panel de edición se visualizarán los campos propiedad del fragmento.
  14. En el panel de edición, seleccione Tipo de fragmento, y escriba el código Java para el fragmento de sonda. Para más información, consulte El objeto de sonda Fragmento.
  15. Siga definiendo la sonda mediante la selección de objetos en el árbol, y utilizando el menú emergente para añadir objetos hijo, y escribiendo valores para los objetos nuevos, en el panel de edición. Para información detallada sobre los objetos de sonda y sus propiedades, consulte Consulta del elemento Probekit. El menú emergente sólo muestra una lista de los objetos hijo válidos para el objeto seleccionado en el árbol. Los elementos de menú para los objetos que son válidos pero que ya no se pueden añadir, estarán inhabilitados.
    Nota: Cuando se especifica un valor en el campo de propiedad Importar directiva de un objeto de sonda Importar, escriba sólo el nombre del paquete o clase que quiera importar. No escriba la palabra clave "import" o en punto y coma (;) final.
  16. Cuando haya terminado de definir la sonda, pulse Archivo > Guardar.

    Nota: Cuando se guarda el archivo .probe, el editor de Probekit comprueba la sintaxis de todos los elementos Java del archivo e informa al usuario de los posible problemas javac. Los objetos que tienen errores O avisos tienen el icono modificado en el árbol, mostrando un icono de error o aviso. Los problemas de Javac se visualizan en una tabla, en la parte inferior de la pestaña "Sondas" del editor. Al realizar una doble pulsación sobre un elemento de esta tabla, se cambia el enfoque al panel a la derecha del árbol Sondas y se activa el widget que contiene el error o aviso javac. Para widgets java de líneas múltiples, como el widget "Java Code" que se muestra en la pantalla adjunta, se seleccionará la primera línea del widget, y se desplazará hasta la línea que tiene el problema. La tabla Problemas de sintaxis no tiene soporte para filtro.

Tareas relacionadas
Modificación de una sonda utilizando el editor Probekit

Consulta relacionada
Editor Probekit
Consulta de elementos de Probekit


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