Ejercicio 1.2: Creación de la primera sonda

Antes de empezar, complete el Ejercicio 1.1: Importación de los recursos necesarios.

La sonda que va a crear informa sobre cada vez que se especifica un método en el programa.

En la creación de una sonda intervienen tres tareas principales:

  1. Creación de un archivo de origen de ProbeKit vacío.
  2. Creación del contenido del archivo de origen.
  3. Comprobación de la sonda.

Creación de un archivo de ProbeKit vacío

Crearemos el archivo de ProbeKit en un proyecto propio de ProbeKit, aunque también se puedan crear sondas en el mismo proyecto en el que esté la aplicación.

  1. Cree un nuevo proyecto Java, que contendrá la sonda:
    1. En la barra de menús de Software Development Platform, seleccione Archivo > Nuevo > Proyecto...; se abrirá el recuadro de diálogo Nuevo proyecto.
    2. Seleccione Proyecto Java y pulse Siguiente. Se abre el recuadro de diálogo Proyecto Java nuevo.
    3. En el campo Nombre de proyecto, escriba RandomNumbersProbe y pulse Finalizar. Se añade una entrada para RandomNumbersProbe en la vista Explorador de paquetes.
  2. Convierta el proyecto en un proyecto ProbeKit:
    1. En la vista Explorador de paquetes, pulse el botón derecho del ratón sobre el proyecto RandomNumbersProbe que acaba de crear y seleccione Nuevo > Otros...; se abre el recuadro de diálogo Nuevo.
    2. Marque la opción Mostrar todos los asistentes y, a continuación, expanda la entrada Perfilado y registro.
    3. Seleccione Convertir proyectos Java a proyectos ProbeKit y pulse Siguiente.
    4. Si se abre el recuadro de diálogo Confirmar habilitación, pulse Habilitar posibilidades siempre y no volver a preguntarme y, a continuación, pulse Aceptar. Se abre el recuadro de diálogo Convertir proyectos Java a proyectos ProbeKit.
    5. Asegúrese de que sólo se haya marcado el proyecto RandomNumbersProbe y, a continuación, pulse Finalizar.
  3. Cree un nuevo archivo de origen de ProbeKit en el proyectoRandomNumbersProbe:
    1. En la vista Explorador de paquetes, pulse el botón derecho del ratón sobre RandomNumbersProbe.
    2. Seleccione Nuevo > Archivo. Se abre el recuadro de diálogo Nuevo archivo.
    3. Seleccione RandomNumbersProbe para que se convierta en la carpeta padre.
    4. En el campo Nombre de archivo, escriba RandomNumbersProbe.probe y, a continuación, pulse Finalizar. Se añade una entrada para RandomNumbersProbe.probe en la vista Explorador de paquetes. Se abre la vista Editor de ProbeKit y problemas. En el editor se visualiza el archivo creado recientemente.

Ahora tiene un archivo de origen de ProbeKit vacío en su propio proyecto. Puesto que el archivo se encuentra en un proyecto ProbeKit, y ya que ha habilitado la construcción automática en el espacio de trabajo, el compilador de sondas ha tratado de compilar el archivo de origen. La vista Problemas informa de que se ha producido un error porque un archivo vacío no es un archivo de origen de ProbeKit válido.

Creación del contenido del archivo de origen

Ahora utilizará el editor de ProbeKit para crear los elementos de sonda de los que consta una sonda.

Los archivos de origen de ProbeKit tienen una estructura en árbol. En su parte superior aparece un elemento Probekit. Debe crear un elemento Probe debajo del elemento Probekit, y un nuevo elemento Fragment debajo de éste último. A continuación, debe indicar que este elemento Fragment accederá a dos fragmentos de datos: el nombre de clase y el de método. Finalmente, deberá escribir el fragmento de código Java pertinente.

La sonda que queremos crear consta de un fragmento de código Java "entry" único. Un fragmento "entry" es un fragmento que se desencadena en el momento en que se genera la entrada del método de los métodos especificados en el programa que está investigando. En nuestra sonda, cada vez que se especifica un método, el fragmento "entry" imprime el nombre de la clase y del método. Una vez escrita, nuestra sonda se aplicará a todas las clases y métodos; no obstante, cuando la despleguemos, restringiremos su ámbito filtrando las clases del sistema como parte del procedimiento de inicio.

Nota: ProbeKit da soporte a otros tipos de fragmentos además de los fragmentos "entry". Por ejemplo, también puede escribir fragmentos que se ejecuten cuando los métodos especificados finalicen, o cuando un método especificado maneje una excepción. Consulte la ayuda del sistema para obtener información detallada.

Para crear los elementos de la sonda:

  1. En el editor de ProbeKit, pulse el botón derecho del ratón sobre el elemento Probekit y elija Nuevo > Sonda. Se añade un elemento Probe al árbol.
  2. Pulse el botón derecho del ratón sobre el elemento Sonda creado recientemente y seleccione Nuevo > Fragmento. Se añade un elemento Fragment debajo del elemento Probe. Por omisión, los fragmentos se crean como fragmentos "entry". (Tenga en cuenta que entry también es la opción seleccionada en el campo Tipo de fragmento que aparece a la derecha del editor de ProbeKit.)
  3. Cree una variable que contenga el nombre de la clase:
    1. Pulse el botón derecho del ratón sobre el elemento Entrada de fragmento y seleccione Nuevo > Datos.
    2. Compruebe que, a la derecha del editor de ProbeKit, se haya seleccionado className como el valor de Tipo de datos.
    3. En el campo Nombre, escriba cname como el nombre de la variable.
  4. Cree la variable que deba contener el nombre del método:
    1. Pulse el botón derecho del ratón sobre el elemento Entrada de fragmento y seleccione Nuevo > Datos.
    2. Seleccione methodName en la lista desplegable Tipo de datos.
    3. En el campo Nombre, escriba mname como el nombre de la variable.
  5. Escriba el código Java que desee ejecutar:
    1. Pulse el elemento Entrada de fragmento.
    2. En el área Código Java, escriba la línea de código siguiente:
      System.out.println("[Enter method " + cname + "." + mname + "]");
  6. En la barra de menús, seleccione Archivo > Guardar. El compilador de sondas compila automáticamente la sonda a partir de su código fuente.

Comprobación de la sonda

Al guardar la sonda, el compilador de sondas visualiza los errores producidos en la vista Problemas. Para ver si algo ha ido mal, consulte esta vista que acabamos de mencionar, la vista Problemas. Si se han producido errores, corríjalos en el editor de sondas y guarde la sonda otra vez.

En la vista Problemas pueden visualizarse dos tipos de errores:

¡Lo ha conseguido!, ha creado su primera sonda.

Ahora ya está preparado para comenzar el Ejercicio 1.3: Aplicación de la sonda.

Condiciones de uso | Información de retorno
(C) Copyright IBM Corporation 2000, 2005. Todos los derechos reservados.