JUnit ErrorCollector @Rule met voorbeeld

⚡ Slimme samenvatting

JUnit ErrorCollector is een regel die ervoor zorgt dat een test na een fout blijft draaien. Alle foutobjecten worden verzameld en samen gerapporteerd zodra de testmethode is voltooid, in plaats van dat de test stopt.ping bij het eerste probleem.

  • 🔘 Doel: Ga door met de test nadat een bewering, netwerk- of GUI-controle mislukt en rapporteer vervolgens alle verzamelde fouten in één keer.
  • ☑️ Verklaring: @Rule op een openbaar niet-statisch ErrorCollector-veld zegt JUnit om de regel aan elke test te koppelen.
  • ✅ Verzamelen: addError(Throwable) slaat elke Error of Exception op, omdat Throwable de ouder is van beide.
  • 🧪 Controleren: checkThat() evalueert een matcher en registreert een mismatch zonder de resterende instructies af te breken.
  • ️ Rapportage: De mislukking trace geeft een lijst van alle verzamelde werpbare voorwerpen met een eigen regelnummer in de JUnit uitzicht.
  • 📌 JUnit 5: Regels zijn verdwenen van Jupiter, dus assertAll() of AssertJ SoftAssertions vervullen dezelfde rol.

JUnit De ErrorCollector-regel verzamelt meerdere fouten in één testrun.

In een normaal scenario zou u, telkens wanneer u een fout constateert tijdens de uitvoering van de test, de test stoppen, de fout herstellen en de test opnieuw uitvoeren.

Maar JUnit heeft een iets andere aanpak. Met de JUnit Met de foutenverzamelaar kunt u de testuitvoering voortzetten, zelfs nadat er een probleem is gevonden of de test is mislukt. De foutenverzamelaar verzamelt alle foutobjecten en rapporteert deze slechts één keer, nadat de testuitvoering is voltooid.

Waarom Error Collector gebruiken?

Wanneer je een testscript schrijft, wil je alle tests uitvoeren, zelfs als een regel code faalt door een netwerkfout, een mislukte assertie of een andere reden. In dat geval kun je de uitvoering van het testscript toch voortzetten met behulp van een speciale functie die wordt aangeboden door... JUnit bekend als ‘foutverzamelaar’.

Voor deze, JUnit gebruikt @RegelannotatieDit wordt gebruikt om een ​​object voor de foutenverzamelaar te maken. Zodra het object voor de foutenverzamelaar is aangemaakt, kunt u eenvoudig alle fouten aan het object toevoegen met behulp van de methode. addError (werpbare fout). Zoals u weet, Gooibaar is de superklasse van de uitzondering en Fout lessen in JavaWanneer je op deze manier fouten toevoegt, worden deze fouten vastgelegd in het logboek. JUnit testresultaat.

Het voordeel van het toevoegen van alle fouten aan een foutenverzamelaar is dat je alle fouten in één keer kunt controleren. Bovendien, als het script halverwege vastloopt, wordt de uitvoering toch voortgezet tot het einde van de testmethode.

NoteIn het geval van een eenvoudige assert of een try/catch-blok is het niet mogelijk om de foutafhandelingsmethode te gebruiken.

Voorbeeldcode

Voor meer informatie over Error Collector, zie het onderstaande codevoorbeeld. Dit voorbeeld laat zien hoe u een Error Collector-object aanmaakt en alle fouten aan dat object toevoegt. track het probleem:

package guru99.junit;		

import org.junit.Rule;		
import org.junit.Test;		
import org.junit.rules.ErrorCollector;		

public class ErrorCollectorExample {				
    @Rule		
    public ErrorCollector collector = new ErrorCollector();							

    @Test		
    public void example() {					
    collector.addError(new Throwable("There is an error in first line"));							
    collector.addError(new Throwable("There is an error in second line"));							
    collector.checkThat(getResults(),			
                not(containsString("here is an error")));			
    // all lines of code will execute and at the end a combined failure will		
    be logged in.		
    }		
}	

Let op: Dit is een illustratief voorbeeld.tract, geen compileerbaar bestand. De afsluitende commentaarregel loopt door naar een tweede regel zonder een // ervoor, en getResults() plus de Hamcrest-matchers worden niet weergegeven. De volledige, uitvoerbare versie volgt hieronder. Voorbeeld met ErrorCollector.

Wat is @Rule in JUnit?

JUnit biedt een speciale manier om tests af te handelen. Testgeval of testsuite door gebruik te maken van de @RegelannotatieMet @Rule kun je eenvoudig het gedrag van de test toevoegen of herdefiniëren.

Er zijn verschillende ingebouwde regels die door de JUnit Een API die een tester kan gebruiken, en je kunt ook je eigen regel schrijven. Een regelveld moet openbaar, niet-statisch en van een type zijn dat TestRule implementeert.

Zie onderstaande code, die laat zien hoe je de @Rule-annotatie samen met de Error Collector kunt gebruiken:

@Rule				
public ErrorCollector collector= new ErrorCollector();

JUnit Opmerking voor 5: Jupiter heeft regels vervangen door de Extension API, waardoor @Rule en ErrorCollector niet meer bestaan ​​in org.junit.jupiter. De dichtstbijzijnde equivalenten zijn Assertions.assertAll() en AssertJ SoftAssertions. JUnit De code 4 die hier wordt weergegeven, werkt nog steeds met de vintage engine. Zie de JUnit annotaties handleiding voor de volledige kaartping.

Voorbeeld met ErrorCollector

Om de foutenverzamelaar te begrijpen, maken we een klasse en een regel om alle fouten te verzamelen. Je voegt alle fouten hier toe met behulp van `addError(throwable)`.

Zie de onderstaande code, die simpelweg een regel aanmaakt die niets meer is dan een "Error Collector-object". Dit object wordt vervolgens gebruikt om alle fouten toe te voegen, zodat het probleem uiteindelijk gerapporteerd kan worden:

ErrorCollectorExample.java

package guru99.junit;		

import org.junit.Assert;		
import org.junit.Rule;		
import org.junit.Test;		
import org.junit.rules.ErrorCollector;		

public class ErrorCollectorExample {				
    @Rule		
    public ErrorCollector collector = new ErrorCollector();							

    @Test		
    public void example() {					
    collector.addError(new Throwable("There is an error in first line"));							
    collector.addError(new Throwable("There is an error in second line"));							

        System.out.println("Hello");					
        try {			
            Assert.assertTrue("A " == "B");					
        } catch (Throwable t) {					
            collector.addError(t);					
        }		
        System.out.println("World!!!!");					
    }		
}		

TestRunner.java

Laten we de bovenstaande testklasse toevoegen aan een testrunner en deze uitvoeren om alle fouten te verzamelen. Zie de code hieronder:

package guru99.junit;		

import org.junit.runner.JUnitCore;		
import org.junit.runner.Result;		
import org.junit.runner.notification.Failure;		

public class TestRunner {				
			public static void main(String[] args) {									
      Result result = JUnitCore.runClasses(ErrorCollectorExample.class);					
			for (Failure failure : result.getFailures()) {							
         System.out.println(failure.toString());					
      }		
      System.out.println("Result=="+result.wasSuccessful());							
   }		
}      

Output:

Zie de mislukking trace, welke tracAlle fouten worden op één plek verzameld. JUnit De weergave telt één run, maar meldt twee fouten en één mislukking, elk met een eigen regelnummer:

Eclipse JUnit storing trace geeft een overzicht van twee Throwable-fouten en één AssertionError die tijdens één run zijn verzameld.

Voordelen van JUnit ErrorCollector

U kunt gebruik maken van een JUnit bewering bijvoorbeeld voor functionele of GUI-validatie:

  1. assertEquals(String message, Object expected, Object actual), waarmee wordt vergeleken of twee objecten gelijk zijn.
  2. Op dezelfde manier beweert assertTrue(Booleaanse voorwaarde) dat een voorwaarde waar is.

Met behulp van beweringen wordt validatietesten eenvoudig. Een belangrijk probleem is echter dat de testuitvoering stopt, zelfs als slechts één bewering niet klopt.

Testcontinuïteit en het correct afhandelen van herstel zijn cruciaal voor het succes van testautomatisering, en vooral op de lange termijn zijn ze van groot belang. Selenium In situaties waarin het herstarten van een browser na elke mislukte controle kostbaar is, biedt Error Collector de beste oplossing.

Veelgestelde vragen

addError(Throwable) registreert een fout die je al hebt opgevangen of veroorzaakt. checkThat(value, matcher) evalueert een Hamcrest-matcher en registreert automatisch een mismatch, waardoor het leest als een assertie, terwijl de overige instructies nog steeds kunnen worden uitgevoerd.

Ja. De methode wordt volledig uitgevoerd, en dan JUnit markeert het als mislukt en print elke verzamelde throwable in de foutmelding. trace. De voorbeeldschermafbeelding toont twee fouten en één mislukking van één enkele testmethode.

JUnit De testklasse wordt gescand op openbare instantievelden die zijn geannoteerd met @Rule en elk van deze velden wordt toegepast rond elke testmethode. Een privé- of statisch veld wordt genegeerd. JUnit Geeft een initialisatiefout in plaats van de test uit te voeren.

Nee. Jupiter heeft het regelmechanisme laten vallen, dus org.junit.rules.ErrorCollector bestaat alleen nog in JUnit 4. Gebruik Assertions.assertAll() voor gegroepeerde beweringen, of voeg AssertJ SoftAssertions toe wanneer er meer uitgebreide vergelijkingen nodig zijn.

Ja, en het is een veelvoorkomend patroon. Een pagina met meerdere velden kan in één keer worden gevalideerd, waarbij elke afwijking wordt verzameld in plaats van dat de validatie bij de eerste wordt afgebroken. Dit voorkomt dat de browsersessie opnieuw moet worden gestart voor elk gevonden defect.

Beide methoden stellen de rapportage uit, maar SoftAssert vereist een expliciete assertAll()-aanroep aan het einde van de test, terwijl ErrorCollector automatisch rapporteert wanneer de methode terugkeert. Het vergeten van assertAll() in TestNG Verbergt stilletjes mislukkingen.

AI-assistenten zijn al lange tijd een mislukking. trace op basis van de hoofdoorzaak, waardoor twintig verzamelde fouten worden teruggebracht tot een handvol afzonderlijke defecten. Ze geven ook aan welke controles in één gecombineerde testrun thuishoren in plaats van in aparte tests.

GitHub-copiloot Het veld @Rule wordt weliswaar correct aangemaakt, maar het wordt vaak in een Jupiter-testklasse geplaatst waar geen regels bestaan. Controleer of de imports org.junit zijn voordat u de testsuite uitvoert.

Vat dit bericht samen met: