Esecuzione con funzione di traccia

La piattaforma fornisce un meccanismo per tenere traccia dell'attività del plug-in in fase di run-time, senza l'esecuzione di un debug completo. Ciò consente di utilizzare indicatori di traccia che provocheranno la stampa delle informazioni di traccia nell'output standard (o nella vista Console). Questi indicatori sono definiti in file denominati ".options" e presentano la seguente sintassi:

   <plug-in Id>/debug = true/false  (master switch)
   <plug-in Id>/<tracing flag> = <value>

La prima voce rappresenta l'opzione principale per eseguire la traccia del proprio plug-in. Se si richiama il metodo isDebugging nella classe del plug-in in uso, verrà restituito true se il valore di questa variabile di traccia è true. Altri indicatori di traccia sono definiti dall'utente e i relativi valori possono essere ottenuti utilizzando

   Platform.getDebugOption(optionName);

La maggior parte dei plug-in della piattaforma definisce indicatori di traccia, in particolare il core della piattaforma. Per lo sviluppatore di un nuovo plug-in, l'insieme di indicatori di traccia più interessante è quella collegata al caricamento delle classi, in quanto consente di tenere traccia dei problemi di caricamento dei plug-in.  

Per supportare la funzione di traccia senza la necessità di modificare i file .options per la traccia, nel PDE è disponibile una scheda "Traccia run-time" nella finestra di dialogo di avvio. Tutte le impostazioni di traccia vengono salvate nella configurazione di avvio. Ciò significa che è possibile creare diverse configurazioni con diverse opzioni di traccia e passare dall'una all'altra.

Utilità di avvio del workbench di run-time - funzione di traccia

Se si aggiunge il supporto di traccia al plug-in in fase di sviluppo, il plug-in apparirà nell'elenco dei plug-in che supportano la traccia (nel gruppo Plug-in dello spazio di lavoro) e le proprietà della funzione di traccia vengono visualizzate nel foglio delle proprietà.

Esempio:  aggiunta del supporto di traccia al proprio plug-in

Per consentire ad altri sviluppatori di controllare gli indicatori di traccia del plug-in, è necessario rendere note queste opzioni.   Questa operazione viene generalmente effettuata inserendo un file .options nel plug-in.  Nel file sono elencati tutti gli indicatori supportati oltre che i valori predefiniti. Il PDE rileverà immediatamente questo file e lo includerà nell'elenco dei "Plug-in dello spazio di lavoro" sulla pagina delle preferenze della funzione di traccia avanzata.

Di seguito verrà definito un file .options modello con alcuni indicatori di traccia per il nuovo plug-in dell'utente.

Selezionare il progetto com.example.xyz creato di recente e creare un nuovo file .options. Quando si apre l'editor di testo predefinito, aggiungere quanto segue:

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

Quando il file viene salvato, selezionare Esegui->Esegui... per aprire la finestra di dialogo di avvio. Ora il plug-in dovrebbe apparire in "Plug-in dello spazio di lavoro". Quando viene selezionato, dovrebbe mostrare i nuovi indicatori e i relativi valori predefiniti.

Utilità di avvio del workbench di run-time - esempio della funzione di traccia

La creazione del file .options definisce solo gli indicatori di disponibilità, consentendo ad altri sviluppatori di plug-in di definire i valori delle proprietà della traccia.   Sarà ancora necessario verificare i valori delle proprietà di traccia nel codice di plug-in utilizzando Platform.getDebugOption().

 
Copyright IBM Corporation e altri 2000, 2003