Opprett JUnit Test Suite med eksempel: @RunWith @SuiteClasses

In JUnit, en testsuite lar oss aggregere alle test tilfeller fra flere klasser på ett sted og kjøre dem sammen.

For å kjøre suite-testen må du annotere en klasse ved hjelp av annotasjonene nedenfor:

1. @RunWith(Suite.klasse)
2. @SuiteClasses(test1.klasse, test2.klasse…) eller @Suite.SuiteClasses({test1.klasse, test2.klasse…})

Med annotasjonene ovenfor vil alle testklassene i suiten begynne å kjøre én etter én. Selve suiteklassen forblir tom: den er bare en holder for annotasjonene, og løperen leser disse annotasjonene for å bestemme hva som skal kjøres.

Trinn for å lage Test Suite og Test Runner

De fire trinnene nedenfor bygger den minste suiten som faktisk kjører: to vanlige testklasser, en suite-klasse som navngir dem, og en runner som starter suiten fra en main-metode.

Trinn 1) Opprett en enkel testklasse (f.eks. MyFirstClassTest) og legg til en metode kommentert med @Test.

Den første klassen har én tom testmetode, som er nok til å bevise at suiten plukker den opp:

Trinn 2) Opprett en annen testklasse å legge til (f.eks. MySecondClassTest) og opprett en metode kommentert med @Test.

Den andre klassen følger nøyaktig samme form, så suiten har to separate klasser å aggregere:

Trinn 3) For å opprette en testSuite må du først annotere klassen med @RunWith(Suite.class) og @SuiteClasses(class1.class, class2.class…).

Legg merke til at suite-klassen TestSuiteExample ikke deklarerer noen egen testmetode – de to annotasjonene inneholder all informasjonen:

Trinn 4) Opprett en Test Runner-klasse for å kjøre testsuiten vår som vist nedenfor:

Løperen er en vanlig Java klasse med en hovedmetode som overleverer suite-klassen til JUnitKjerne:

Code Forklaring:

• Code Linje 8: Deklarerer hovedmetoden til klassen Test som vil kjøre vår JUnit test.
• Code Linje 9: Utføre testtilfeller ved hjelp av JUnitCore.runClasses som tar navnet på testklassen som en parameter (i eksemplet ovenfor bruker du TestSuiteExample.class vist i trinn 3).
• Code Linje 11: Behandler resultatet ved hjelp av en for-løkke og skriver ut det mislykkede resultatet.
• Code Linje 13: Skriver ut det vellykkede resultatet.

Utgang: Her er resultatet som viser en vellykket test uten feil trace som gitt nedenfor:

Den grønne linjen bekrefter hva en suite er til for: én oppstart, én resultatvisning, og begge klassene rapporteres under suite-noden i stedet for i to separate kjøringer.

JUnit Eksempel på testsuite

Tenk deg et mer komplekst eksempel, der klassene i suiten faktisk hevde noe i stedet for å holde en tom metode.

JunitTest.java

JunitTest.java er en enkel klasse kommentert med @RunWith og @Suite annoteringer. Du kan liste opp et hvilket som helst antall klasser i pakken som parametere, som gitt nedenfor:

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 er en testklasse som har testmetoder som skriver ut en melding, som gitt nedenfor. Du vil bruke denne klassen som et suite-medlem i klassen nevnt ovenfor. Den er avhengig av en hjelpeklasse kalt JUnitMelding, som er definert et annet sted i samme pakke og ikke gjengis her.

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 er en annen testklasse, lik SuiteTest1.java, med en testmetode for å skrive ut en melding som gitt nedenfor. Du vil bruke denne klassen som et suitemedlem i JunitTest.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);							
    }		

}		

Produksjon

Etter henrettelse JunitTest.java, som inneholder en suite som inneholder SuiteTest1.java og SuiteTest2.java, vil du få utdataene nedenfor. Konsollen skriver ut meldingene produsert av begge klassene:

Ocuco JUnit vis poster samme kjøring som tre beståtte testmetoder gruppert under suite-klassen:

OBS: Konsolletikettene i dette eksemplet er krysset over – strengen som skrives ut av SuiteTest1 lyder «Suite Test 2» og den som skrives ut av SuiteTest2 lyder «Suite Test 1». De opprinnelige oppføringene gjengis uendret, slik at etikettene forblir slik forfatteren skrev dem; les klassenavnet i JUnit visning i stedet for den utskrevne etiketten når du matcher utdata med kilde.

Slik oppretter du en testsuite i JUnit 5

JUnit 5 fjerner løpere helt, så @RunWith(Suite.class) finnes ikke i org.junit.jupiter-pakkene. Suiter flyttet til JUnit Plattform, som sender dem i en separat artefakt kalt junit-plattform-suite-motorLegg til den avhengigheten, og annoter deretter en klasse med @Suite og en av selektorannotasjonene.

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
}

Selektorannotasjonene erstatter den enkle @SuiteClasses-listen med en liten familie av alternativer:

To ytterligere forskjeller er viktige i praksis. JUnit 5 suite-klassen kan deklarere @BeforeSuite- og @AfterSuite-metodene, som kjører én gang rundt hele suiten, og JUnit 4. eksempel ovenfor kjøres fortsatt på JUnit Plattform gjennom den gamle motoren, slik at den originale koden på denne siden ikke trenger å skrives om for å fortsette å fungere.

Fordeler og begrensninger ved JUnit Test suiter

En suite er en gruppeping mekanisme, ikke en testrammeverk av seg selv, og det former både hva den gjør bra og hvor den slutter å være nyttig.

Fordeler

• Én oppskytning kjører relaterte klasser sammen, så et røyksett eller en regresjon settet startes med én enkelt kommando.
• Resultatvisningen grupperer hver klasse under én suite-node, noe som gjør det enklere å oppdage en delt feil.
• Medlemslisten ligger i kode, så den blir gjennomgått og versjonert som alle andre kildefiler.
• Den samme suite-klassen kan startes fra et IDE, fra en løper som for eksempel JUnitKjerne, eller fra et byggeverktøy.

Begrensninger

• @SuiteClasses er en hardkodet liste, så en ny testklasse utelates stille inntil noen redigerer pakken.
• Suiten gir ingen rekkefølgegaranti utover rekkefølgen klassene er oppført i.
• Ingenting deles mellom medlemsklassene, så en suite er ikke en erstatning for et inventar eller en basisklasse.
• Byggeverktøy oppdager allerede testklasser etter navnekonvensjon, noe som gjør en pakke overflødig i mange prosjekter.

Vanlige feil når du oppretter en JUnit Test Suite

De fleste problemer i suiten produserer en kort, lite nyttig melding. Tabellen knytter meldingene du sannsynligvis vil møte til årsaken og løser dem.

Å skrive suiten én gang og holdeping Det er nøyaktig som er det virkelige arbeidet. Hvis listen avviker fra klassene på disken, rapporterer suiten grønt mens en del av enhetstest settet kjøres aldri i det hele tatt, en av de stilleste feilmodusene i programvaretesting.

Spørsmål og svar