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.

Lanzador de entorno de trabajo de tiempo de ejecución - Rastreo

Ejemplo: añadir soporte de rastreo al conector 

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.

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.

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 en la lista. 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()