Creazione di codice Java personalizzato

Il codice personalizzato utilizza riferimenti nel test come input e restituisce valori modificati al test. Si utilizza l'interfaccia ICustomCode2 per creare il codice personalizzato e l'interfaccia ITestExecutionServices per estendere l'esecuzione del test. Queste interfacce sono contenute nel package com.ibm.rational.test.lt.kernel.services.

Informazioni su questa attività

Nota: quando si utilizza l'interfaccia ITestExecutionServices nel codice personalizzato per riportare i risultati dei test, i risultati per il codice personalizzato vengono visualizzati nel log del test. Se si registrano i verdetti dei punti di verifica personalizzati, questi risulteranno nel verdetto della pianificazione complessivo.

I valori di input del codice personalizzato possono trovarsi nei riferimenti oppure nei riferimenti di campo. È anche possibile passare una stringa di testo come un argomento al codice personalizzato. I riferimenti utilizzati come input al codice personalizzato devono essere inclusi nello stesso test del codice personalizzato. Nel test, il riferimento deve precedere il codice che influenza. Assicurarsi che il test contenga i riferimenti richiesti per gli input personalizzati per il codice. Per i dettagli sulla creazione di riferimenti e di riferimenti di campo, vedere Creazione di un riferimento o di un riferimento campo.

Se il codice personalizzato utilizza file JAR esterni, potrebbe essere necessario modificare il percorso di generazione Java™. In alcuni casi, è possibile evitare di modificare il percorso di generazione manualmente eseguendo il test prima di aggiungere ad esso il codice personalizzato. La prima volta che viene eseguito un test, le classi e le librerie che sono richieste per la compilazione vengono aggiunte al percorso di generazione. Ad esempio, è possibile importare classi TPTP (Test and Performance Tools Platform) richieste per creare eventi personalizzati nel log di test se il test, al quale è stato aggiunto il codice personalizzato, è stata eseguito precedentemente. Tuttavia, se il test non è mai stato eseguito, si verificano errori di importazione perché le classi non sono denominate nel percorso di generazione per il progetto fino all'esecuzione del test.

Se il codice utilizza risorse esterne, ad esempio, un database SQL oppure un prodotto che gestisce le relazioni con i clienti, è necessario configurare il codice personalizzato per operare su ogni computer sul quale viene eseguito il test.

Il codice personalizzato si trova nella cartella src del progetto che contiene il test che richiama il codice. Per impostazione predefinita, il codice personalizzato si trova in un package denominato test nella cartella src.

È possibile riutilizzare un package di codice personalizzato per i test che si trovano in più progetti. I progetti devono trovarsi in un singolo spazio di lavoro. Per riutilizzare il codice personalizzato nei diversi progetti, utilizzare il nome progetto prima del package di codice personalizzato. Ad esempio, campo Nome classe..

Il seguente esempio mostra la vista di selezione standard di due classi del codice personalizzato. Test Navigator non visualizza i file di origine Java.

Vista di selezione con le classi ReplaceCC.java e VerifyUserID.java

Quando si aggiungono le classi di codice personalizzato ReplaceCC.java e VerifyYUserID.java al test e si restituisce un valore al test, Sostituisci elenca queste due classi.

Il package test contiene anche il codice Java generato per i test nel progetto.

È possibile inserire codice personalizzato in un package diverso (ad esempio, custom). Separare il codice personalizzato da quello generato, soprattutto se si utilizza un sistema di controllo origine.

Procedura

Per aggiungere codice personalizzato:

  1. Aprire il test e selezionare un elemento di test.
  2. Fare clic su Aggiungi oppure Inserisci e selezionare Codice personalizzato. Aggiungi aggiunge il codice personalizzato alla parte inferiore dell'elemento di test selezionato. Inserisci aggiunge il codice personalizzato precedente all'elemento di test selezionato.
    Nota: Una volta aggiunto o inserito il codice personalizzato, la vista Problemi visualizza un errore in cui riporta che il nuovo elemento del codice personalizzato non presenta file Java. Questo messaggio di errore resta finché non si fa clic su Visualizza codice o Genera codice, per segnalare che l'elemento di test del codice personalizzato non è ancora associato al codice Java.
  3. Esaminare il campo Nome classe e completare una di queste procedure:
    • Se il codice da richiamare esiste già, modificare il nome della classe in modo che corrisponda al suo nome. Fare clic su Visualizza codice per aprire il codice nell'editor Java.
    • Se il codice non esiste, modificare il nome della classe per descrivere la funzione del codice. Fare clic su Genera codice per generare una classe di modello per registrare i risultati e aprirla nell'editor Java. Se una classe con lo stesso nome risulta già esistente, verrà visualizzato un messaggio che informa della conseguente sovrascrittura.
  4. Nel campo Argomenti, fare clic su Aggiungi.
  5. Nella finestra Codice personalizzato, selezionare tutti gli input richiesti dal codice. La finestra Codice personalizzato elenca tutti i valori nel test che possono essere utilizzati come input per il codice (riferimenti o riferimenti di campo nel test che precede il codice).
  6. Fare clic su OK. La finestra viene chiusa e i riferimenti selezionati vengono aggiunti al campo Argomenti.
  7. Opzionale: Per aggiungere delle stringhe di testo come input al codice personalizzato, fare clic su Testo e immettere quindi la stringa di testo da utilizzare.
  8. Nel test, dopo il codice personalizzato, individuare un valore che il codice restituisce al test.
  9. Evidenziare il valore.
  10. Fare clic con il pulsante destro del mouse sul valore evidenziato, fare clic su Sostituisci e selezionare il nome classe del codice personalizzato. Vengono visualizzate le classi del codice personalizzato che sono state aggiunte. Dopo aver effettuato la selezione, il valore da restituire al test viene evidenziato in arancione e la tabella Utilizzato in base a viene aggiornata con queste informazioni.

Operazioni successive

Il codice personalizzato non viene visualizzato nella vista Test Navigator. Per visualizzare il codice personalizzato, aprire la vista Esplora package e utilizzare gli strumenti Java per identificare il codice personalizzato aggiunto.

Feedback