Ejecutar en modalidad de rastreo

La plataforma proporciona un mecanismo para rastrear la actividad del conector durante la ejecución sin tener que depurarlo. 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 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 en la clase del conector se llama al método isDebugging, devolverá true si el valor de esta variable de rastreo es true. El usuario puede definir otros distintivos de rastreo y sus valores pueden obtenerse utilizando

   Platform.getDebugOption(optionName);

La mayoría de los conectores de 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 son aquellos relacionados con la carga de las clases, ya que pueden permitir rastrear los problemas de carga de conectores. 

Con el fin de permitir el rastreo sin necesidad de editar los archivos .options de rastreo, el PDE proporciona la pestaña "Rastreo" 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 de entorno de trabajo de tiempo de ejecución- rastreo

Si añade soporte de rastreo al conector en desarrollo, los 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 otros desarrolladores controlen los distintivos de rastreo del conector, hay que hacer públicas esas opciones. Esto suele hacerse colocando un archivo .options en el conector. El archivo lista todos los distintivos soportados, así como sus valores por omisión. El PDE detectará inmediatamente este archivo y lo incluirá en la lista de "Conectores de área de trabajo" en la página de preferencias avanzadas de rastreo.

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

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 = *

Al guardar este archivo, seleccione Ejecutar->Ejecutar... para abrir el diálogo de lanzamiento. El conector se mostrará ahora en "Conectores de área de trabajo". Al seleccionarlo, debería 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

La creación del archivo .options sólo define los distintivos de disponibilidad, lo que permite a otros desarrolladores de conectores definir los valores de las propiedades de rastreo. Seguiremos necesitando comprobar los valores de las propiedades de rastreo del código del conector utilizando Platform.getDebugOption().

Copyright IBM Corporation y otros 2000, 2002