Crea JUnit Test Suite con esempio: @RunWith @SuiteClasses

In JUnit, una suite di test ci consente di aggregare tutti casi test da più classi in un unico posto e eseguirle insieme.

Per eseguire la suite di test, è necessario annotare una classe utilizzando le annotazioni indicate di seguito:

1. @RunWith(Suite.class)
2. @SuiteClasses(test1.class, test2.class…) oppure @Suite.SuiteClasses({test1.class, test2.class…})

Con le annotazioni di cui sopra, tutte le classi di test nella suite inizieranno a essere eseguite una alla volta. La classe suite stessa rimane vuota: funge solo da contenitore per le annotazioni, e il runner legge tali annotazioni per decidere cosa eseguire.

Passaggi per creare la suite di test e il test runner

I quattro passaggi seguenti costituiscono la suite più piccola effettivamente eseguibile: due classi di test ordinarie, una classe suite che le nomina e un runner che avvia la suite da un metodo main.

Passo 1) Crea una semplice classe di test (ad esempio MyFirstClassTest) e aggiungi un metodo annotato con @Test.

La prima classe contiene un singolo metodo di test vuoto, il che è sufficiente a dimostrare che la suite lo rileva:

Passo 2) Crea un'altra classe di test da aggiungere (ad esempio MySecondClassTest) e crea un metodo annotato con @Test.

La seconda classe segue esattamente la stessa struttura, quindi la suite ha due classi separate da aggregare:

Passo 3) Per creare una testSuite è necessario innanzitutto annotare la classe con @RunWith(Suite.class) e @SuiteClasses(class1.class, class2.class…).

Si noti che la classe suite TestSuiteExample non dichiara alcun metodo di test proprio: le due annotazioni contengono tutte le informazioni:

Passo 4) Crea una classe Test Runner per eseguire la nostra suite di test come mostrato di seguito:

Il corridore è un semplice Java classe con un metodo principale che passa la classe suite a JUnitCore:

Code Spiegazione:

• Code Linea 8: Dichiarando il metodo principale della classe Test che eseguirà il nostro JUnit test.
• Code Linea 9: Esecuzione dei casi di test utilizzando JUnitCore.runClasses accetta come parametro il nome della classe di test (nell'esempio precedente, si utilizza TestSuiteExample.class, come mostrato al passaggio 3).
• Code Linea 11: Elaborazione del risultato tramite un ciclo for e stampa del risultato non riuscito.
• Code Linea 13: Stampa del risultato positivo.

Produzione: Ecco l'output che mostra un test riuscito senza errori trace come indicato di seguito:

La barra verde conferma lo scopo di una suite: un'unica esecuzione, un'unica visualizzazione dei risultati ed entrambe le classi vengono riportate sotto il nodo della suite, anziché in due esecuzioni separate.

JUnit Esempio di suite di test

Consideriamo un esempio più complesso, in cui le classi all'interno della suite effettivamente affermare qualcosa invece di contenere un metodo vuoto.

Test Junit.java

JunitTest.java è una semplice classe annotata con @Corri con and @Suite annotazioni. È possibile elencare un numero qualsiasi di classi della suite come parametri, come mostrato di seguito:

package guru99.junit;		
import org.junit.runner.RunWith;		
import org.junit.runners.Suite;		

@RunWith(Suite.class)				
@Suite.SuiteClasses({				
  SuiteTest1.class,
  SuiteTest2.class,  			
})		

public class JunitTest {				
			// This class remains empty, it is used only as a holder for the above annotations		
}

SuiteTest1.java

SuiteTest1.java è una classe di test che ha metodi di test che stampano un messaggio, come mostrato di seguito. Userai questa classe come membro della suite nella classe menzionata sopra. Si basa su una classe helper chiamata JUnitMessaggio, che è definito altrove nello stesso pacchetto e non viene riprodotto qui.

package guru99.junit;		

import static org.junit.Assert.assertEquals;				

import org.junit.Test;		

public class SuiteTest1 {				

    public String message = "Saurabh";							

    JUnitMessage junitMessage = new JUnitMessage(message);							

    @Test(expected = ArithmeticException.class)					
    public void testJUnitMessage() {					

        System.out.println("Junit Message is printing ");					
        junitMessage.printMessage();			

    }		

    @Test		
    public void testJUnitHiMessage() {					
        message = "Hi!" + message;							
        System.out.println("Junit Hi Message is printing ");					
        assertEquals(message, junitMessage.printHiMessage());					
        System.out.println("Suite Test 2 is successful " + message);							
    }		
}		

SuiteTest2.java

SuiteTest2.java è un'altra classe di test, simile a SuiteTest1.java, avendo un metodo di test per stampare un messaggio come indicato di seguito. Userai questa classe come membro della suite in Test Junit.java.

package guru99.junit;		

import org.junit.Assert;		
import org.junit.Test;		

public class SuiteTest2 {				
   	

    @Test		
    public void createAndSetName() {					
        		

        String expected = "Y";					
        String actual = "Y";					

        Assert.assertEquals(expected, actual);					
        System.out.println("Suite Test 1 is successful " + actual);							
    }		

}		

Uscita

Dopo l'esecuzione Test di Junit.java, che contiene una suite contenente SuiteTest1.java and SuiteTest2.java, otterrai l'output seguente. La console stampa i messaggi prodotti da entrambe le classi:

Migliori JUnit visualizza i record della stessa esecuzione come tre metodi di test superati raggruppati nella classe suite:

Nota: Le etichette della console in questo esempio sono incrociate: la stringa stampata da SuiteTest1 è "Suite Test 2" e quella stampata da SuiteTest2 è "Suite Test 1". Gli elenchi originali sono riprodotti senza modifiche, quindi le etichette rimangono come le ha scritte l'autore; leggere il nome della classe in JUnit Quando si abbina l'output alla sorgente, si fa riferimento all'immagine anziché all'etichetta stampata.

Come creare una suite di test in JUnit 5

JUnit 5 rimuove completamente i runner, quindi @RunWith(Suite.class) non esiste nei pacchetti org.junit.jupiter. Le suite sono state spostate in JUnit Piattaforma, che li spedisce in un artefatto separato chiamato motore della suite della piattaforma JUnitAggiungi quella dipendenza, quindi annota una classe con @Suite e una delle annotazioni del selettore.

import org.junit.platform.suite.api.SelectClasses;
import org.junit.platform.suite.api.Suite;
import org.junit.platform.suite.api.SuiteDisplayName;

@Suite
@SuiteDisplayName("Guru99 suite")
@SelectClasses({ SuiteTest1.class, SuiteTest2.class })
public class JunitTest {
    // Empty holder, exactly as in JUnit 4
}

Le annotazioni del selettore sostituiscono l'elenco singolo @SuiteClasses con una piccola famiglia di opzioni:

Due ulteriori differenze sono rilevanti nella pratica. A JUnit 5 La classe suite può dichiarare i metodi @BeforeSuite e @AfterSuite, che vengono eseguiti una volta intorno all'intera suite, e JUnit 4 l'esempio sopra è ancora in esecuzione su JUnit La piattaforma utilizza il motore vintage, quindi il codice originale presente in questa pagina non deve essere riscritto per continuare a funzionare.

Vantaggi e limiti di JUnit Suite di prova

Una suite è un gruppoping meccanismo, non un framework di test di per sé, e questo determina sia ciò che fa bene sia dove smette di essere utile.

Vantaggi

• Un lancio esegue insieme classi correlate, quindi un set di fumo o un regressione L'operazione di set viene avviata con un singolo comando.
• La visualizzazione dei risultati raggruppa tutte le classi sotto un unico nodo di suite, il che rende più facile individuare un errore comune.
• L'elenco dei membri risiede nel codice sorgente, quindi viene revisionato e gestito in termini di versioni come qualsiasi altro file sorgente.
• La stessa classe suite può essere avviata da un IDE, da un runner come JUnitCore, oppure da uno strumento di compilazione.

limitazioni

• @SuiteClasses è un elenco predefinito, quindi una nuova classe di test viene silenziosamente omessa finché qualcuno non modifica la suite.
• La suite non offre alcuna garanzia di ordinamento al di là dell'ordine in cui le lezioni sono elencate.
• Nulla è condiviso tra le diverse classi di appartenenza, quindi una suite non sostituisce un immobile fisso o una classe base.
• Gli strumenti di compilazione individuano già le classi di test tramite convenzioni di denominazione, il che rende una suite ridondante in molti progetti.

Errori comuni durante la creazione di un JUnit Suite di prova

La maggior parte dei problemi relativi alle suite di software produce un messaggio breve e poco utile. La tabella illustra i messaggi che è più probabile ricevere, la loro causa e la soluzione.

Scrivere la suite una volta e mantenerlaping è accurato è il vero lavoro. Se l'elenco si discosta dalle classi sul disco, la suite segnala verde mentre parte del test unitario set non viene mai eseguito affatto, una delle modalità di errore più silenziose in test del software.

DOMANDE FREQUENTI