Ejecutar en modalidad de rastreo

La plataforma proporciona un mecanismo para rastrear la actividad del conector durante la ejecución sin tener que depurarlo. Le permite utilizar distintivos de rastreo que harán que se imprima información de rastreo en la salida estándar (o en la vista Consola). Estos distintivos se definen en los archivos llamados ".options" y tienen esta sintaxis:

   <ID del conector>/debug = true/false  (conmutador maestro)
   <ID del conector>/<distintivo de rastreo> = <valor>

La primera entrada representa el conmutador maestro para rastrear el conector. Si llama al método isDebugging en la clase del conector, el método devolverá true si el valor de esta variable de rastreo es true. Usted definirá los otros distintivos de rastreo y sus valores se pueden obtener mediante:

   Platform.getDebugOption(optionName);

La mayoría de los conectores de la plataforma definen distintivos de rastreo, en particular el núcleo de la plataforma. Para un desarrollador de conectores nuevos, el conjunto de distintivos de rastreo más interesante es el formado por los que están relacionados con la carga de las clases, porque permiten rastrear los problemas relacionados con la carga de conectores.  

Para dar soporte al rastreo sin tener que editar los archivos .options de rastreo, el PDE proporciona la pestaña "Rastreo de tiempo de ejecución" en el diálogo de lanzamiento. Todos los valores de rastreo se guardan en la configuración de lanzamiento. Esto significa que puede crear varias configuraciones con opciones de rastreo diferentes y alternar entre ellas.

Lanzador del entorno de trabajo de tiempo de ejecución: rastreo

Si añade soporte de rastreo a los conectores que esté desarrollando, sus conectores aparecerán en la lista de conectores que dan soporte al rastreo (en el grupo Conectores de área de trabajo) y las propiedades de rastreo aparecerán en la hoja de propiedades.

Ejemplo: añadir soporte de rastreo al conector 

Para permitir que los otros desarrolladores controlen los distintivos de rastreo de su conector, tendrá que dar a conocer esas opciones. Esto suele hacerse colocando un archivo .options en el conector. En el archivo figuran todos los distintivos soportados y sus valores por omisión. El PDE detectará inmediatamente este archivo y lo incluirá en la lista "Conectores de área de trabajo" en la página de preferencias avanzadas de rastreo.

Ahora pasaremos a definir un archivo .options de plantilla con unos cuantos distintivos de rastreo para nuestro nuevo conector.

Seleccione el proyecto com.example.xyz que hemos creado antes y cree un archivo .options nuevo. Cuando se abra el editor de texto por omisión, añada las entradas siguientes:

   com.example.xyz/debug = true
   com.example.xyz/debug/flag = true
   com.example.xyz/debug/filter = *

Una vez guardado este archivo, seleccione Ejecutar->Ejecutar... para abrir el diálogo de lanzamiento. El conector deberá figurar ahora bajo "Conectores de área de trabajo". Si se selecciona, debe mostrar los distintivos que acabamos de definir con sus valores por omisión.

Lanzador de entorno de trabajo de tiempo de ejecución: ejemplo de rastreo

Al crear el archivo .options, solo se definen los distintivos de disponibilidad, lo que permite a otros desarrolladores de conectores definir los valores de las propiedades de rastreo. Aún tendrá que comprobar los valores de las propiedades de rastreo del código del conector mediante el método Platform.getDebugOption()

 
Copyright IBM Corporation y otras empresas 2000, 2003