Per creare un probe, creare prima un file di origine Probekit (file probe). Successivamente, nel file di origine Probekit, creare il probe ed aggiungere il contenuto che ne definisce il funzionamento.
Per creare il file di origine Probekit, è necessario utilizzare la procedura guidata
File di origine Probekit. Successivamente
è possibile continuare ad utilizzare la procedura guidata per scrivere la maggior parte delle definizioni o
passare direttamente all'editor Probekit. In ogni caso, è necessario utilizzare l'editor
Probekit per scrivere i frammenti di codice Java.
Per informazioni dettagliate sulle diverse parti di un probe,
consultare la sezione Definizioni probe.
- Per creare il file di origine Probekit:
- Nella vista Selezione o Esplora pacchetti, selezionare il progetto Java in cui si desidera
inserire il file di origine con il tasto destro del mouse, quindi scegliere
.
Il progetto deve essere un progetto Java.
- Nella pagina Selezione procedura guidata, espandere
Creazione profili e log e selezionare
File di origine Probekit.
- Fare clic su Avanti.
- Nella procedura guidata Creazione nuovo file probe, immettere un nome per il nuovo file di origine probe
nel campo Nome file. L'estensione dei file di origine
Probekit deve essere .probe.
- Nel campo Cartella di origine, immettere la cartella di origine del progetto in cui
inserire il nuovo file di origine Probekit.
Nota: i file di origine Probekit
devono trovarsi in una cartella principale della cartella di origine del progetto; non possono
trovarsi in una sottocartella.
- Se si desidera uscire dalla procedura guidata ed utilizzare l'editor Probekit
per creare il probe e la relativa definizione, procedere come segue:
- Selezionare Nessun contenuto.
- Scegliere Fine. Il nuovo file di origine Probekit viene aggiunto alla cartella di origine
del progetto e, per impostazione predefinita, viene automaticamente aperta nell'editor Probekit.
- Continuare con il punto 4.
- Se si desidera continuare ad utilizzare la procedura guidata per la creazione
della definizione probe, procedere come segue:
- Selezionare Probe method o Probe callsite.
- Selezionare il valore Tipo di frammento per il frammento che si desidera
creare.
- Fare clic su Avanti.
- Utilizzare i pulsanti Aggiungi e Modifica
per definire gli elementi desiderati.
Quando si aggiunge o si seleziona un elemento, la procedura guidata ne visualizza una descrizione.
Nota: se si
torna indietro e si modifica il tipo di probe in fase di creazione, o il tipo di frammento da inserire,
l'editor richiederà se eliminare gli elementi non più validi.
- Scegliere Fine. Il nuovo file di origine Probekit viene aggiunto alla cartella di origine
del progetto e, per impostazione predefinita, viene automaticamente aperta nell'editor Probekit.
- Facoltativo: nella pagina Generale dell'editor Probekit,
immettere una stringa con ID univoco per il probe
nel campo ID e un numero di versione nel campo Versione
e valori per l'etichetta. Questi dati sono per uso personale e servono ad identificare il probe nella configurazione
della creazione profili.
- Selezionare la scheda Probe.
- Se non è stata utilizzata la procedura guidata per creare il probe, fare clic
con il tasto destro del mouse sulla parte sinistra dell'editor Probekit e scegliere
Aggiungi probe. Nella struttura ad albero nella parte sinistra della pagina
viene creato il nuovo new probe.
- Selezionare il probe con il tasto destro del mouse e scegliere
.
Il nuovo frammento viene visualizzato nella struttura ad albero come secondario del probe,
e i campi delle proprietà vengono visualizzati nel riquadro di modifica nella parte destra della pagina.
- Nel riquadro di modifica, selezionare il valore per il Tipo
di frammento, quindi immettere il codice Java per il frammento probe. Per informazioni specifiche, consultare
la sezione Tipi di frammento probe.
- Continuare la definizione del probe selezionando gli elementi nella struttura con
il tasto destro del mouse per aggiungere/rimuovere elementi secondari, ed immettendo i valori per i nuovi
elementi nel riquadro di modifica. Il menu a comparsa conterrà solo gli elementi
validi per il percorso selezionato. Se l'elemento è valido ma non può più essere aggiunto nel percorso
selezionato, l'elemento viene disabilitato nel menu.
Nota: quando si immette un valore nel campo
Direttiva di importazione, indicare solo il nome del pacchetto o della classe
che si desidera importare.
Non immettere la parola chiave import o il punto e virgola finale (;).
- Dopo aver terminato la definizione del probe,
scegliere .
Nota: quando si salva il file di origine
Probekit, l'editor Probekit verifica la sintassi di tutti gli elementi
Java nel file e riporta eventuali problemi con javac.
In casi di errori o avvisi, l'icona corrispondente alla voce nella struttura cambia in icona di errore o avviso. I
problemi Javac vengono visualizzati nella tabella nella parte inferiore
della pagina Probe. In questa tabella, fare doppio clic su un elemento per attivarlo affinché
possa essere modificato.