junitKomma igång med junit


Anmärkningar

JUnit är ett enkelt ramverk för att skriva repeterbara tester för Java-programmeringsspråk . Det är ett exempel på xUnit-arkitekturen för enhetstestramar.

Huvudfunktioner består av:

  • Påståenden som låter dig anpassa hur du testar värden i dina tester
  • Testlöpare , som låter dig ange hur du kör testerna i din klass
  • Regler som gör att du flexibel kan ändra beteendet hos tester i din klass
  • Sviter , som gör att du kan bygga en svit med tester från många olika klasser

Användbar förlängning för JUnit:

  • AssertJ : Flytande påståenden för java
  • Mockito : Spottande ramverk för java

versioner

Version Utgivningsdatum
JUnit 5 Milestone 2 2016/07/23
JUnit 5 Milestone 1 2016/07/07
JUnit 4.12 2016/04/18
JUnit 4.11 2012/11/14
JUnit 4.10 2011-09-28
JUnit 4.9 2011-08-22
JUnit 4.8 2009-12-01
JUnit 4.7 2009-07-28
JUnit 4.6 2009-04-14

Installation eller installation

Eftersom JUnit är ett Java-bibliotek är allt du behöver göra för att installera det att lägga till några JAR-filer i klassvägen för ditt Java-projekt och du är redo att gå.

Du kan ladda ner dessa två JAR-filer manuellt: junit.jar & hamcrest-core.jar .

Om du använder Maven kan du helt enkelt lägga till ett beroende i din pom.xml :

<dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>4.12</version>
  <scope>test</scope>
</dependency>
 

Eller om du använder Gradle, lägg till ett beroende i din build.gradle :

apply plugin: 'java'

dependencies {
    testCompile 'junit:junit:4.12'
}
 

Efter detta kan du skapa din första testklass:

import static org.junit.Assert.assertEquals;

import org.junit.Test;

public class MyTest {
    @Test
    public void onePlusOneShouldBeTwo() {
        int sum = 1 + 1;
        assertEquals(2, sum);
    }
}
 

och kör den från kommandoraden:

  • Windows java -cp .;junit-X.YY.jar;hamcrest-core-XYjar org.junit.runner.JUnitCore MyTest
  • Linux eller OsX java -cp .:junit-X.YY.jar:hamcrest-core-XYjar org.junit.runner.JUnitCore MyTest

eller med Maven: mvn test

@Före efter

En annoterad metod med @Before kommer att @Before före varje exekvering av @Test metoder. Analog en @After kommenterad metod körs efter varje @Test metod. Detta kan användas för att upprepade gånger ställa in en testinställning och rensa upp efter varje test. Så testerna är oberoende och förberedelseskoden kopieras inte i @Test metoden.

Exempel:

import static org.junit.Assert.assertEquals;

import java.util.ArrayList;
import java.util.List;

import org.junit.After;
import org.junit.Before;
import org.junit.Test;

public class DemoTest {

    private List<Integer> list;

    @Before
    public void setUp() {
        list = new ArrayList<>();
        list.add(3);
        list.add(1);
        list.add(4);
        list.add(1);
        list.add(5);
        list.add(9);
    }

    @After
    public void tearDown() {
        list.clear();
    }

    @Test
    public void shouldBeOkToAlterTestData() {
        list.remove(0); // Remove first element of list.
        assertEquals(5, list.size()); // Size is down to five
    }

    @Test
    public void shouldBeIndependentOfOtherTests() {
        assertEquals(6, list.size());
    }
}
 

Metoder som är antecknade med @Before eller @After måste vara public void och med nollargumenter.

Grundenhetsexempel

Detta exempel är en grundläggande inställning för att inte testa StringBuilder.toString () med junit.

import static org.junit.Assert.assertEquals;

import org.junit.Test;

public class StringBuilderTest {

    @Test
    public void stringBuilderAppendShouldConcatinate()  {
        StringBuilder stringBuilder = new StringBuilder();
        stringBuilder.append("String");
        stringBuilder.append("Builder");
        stringBuilder.append("Test");

        assertEquals("StringBuilderTest", stringBuilder.toString());
    }

}
 

Fånga förväntat undantag

Det är möjligt att enkelt fånga undantaget utan att try catch block.

public class ListTest {
  private final List<Object> list = new ArrayList<>();

  @Test(expected = IndexOutOfBoundsException.class)
  public void testIndexOutOfBoundsException() {
    list.get(0);
  }
}
 

Exemplet ovan borde räcka för enklare fall när du inte vill / behöver kontrollera meddelandet med det kastade undantaget.

Om du vill kontrollera information om undantag kanske du vill använda try / catch block:

@Test
public void testIndexOutOfBoundsException() {
    try {
        list.get(0);
        Assert.fail("Should throw IndexOutOfBoundException");
    } catch (IndexOutOfBoundsException ex) {
        Assert.assertEquals("Index: 0, Size: 0", ex.getMessage());
    }
}
 

I det här exemplet måste du vara medveten om att alltid lägga till Assert.fail() att se till att testet misslyckas när inget undantag kastas.

För mer detaljerade fall har JUnit ExpectedException @Rule , som också kan testa denna information och används på följande sätt:

public class SimpleExpectedExceptionTest {
     @Rule
     public ExpectedException expectedException = ExpectedException.none();

     @Test
     public void throwsNothing() {
         // no exception expected, none thrown: passes.
     }

     @Test
     public void throwsExceptionWithSpecificType() {
         expectedException.expect(NullPointerException.class);

         throw new NullPointerException();
     }

     @Test
     public void throwsExceptionWithSpecificTypeAndMessage() {
         expectedException.expect(IllegalArgumentException.class);
         expectedException.expectMessage("Wanted a donut.");

         throw new IllegalArgumentException("Wanted a donut.");
     }
}
 

Testa undantag i JUnit5

För att uppnå detsamma i JUnit 5 använder du en helt ny mekanism :

Den testade metoden

public class Calculator {
    public double divide(double a, double b) {
        if (b == 0.0) {
            throw new IllegalArgumentException("Divider must not be 0");
        }
        return a/b;
    }
}
 

Testmetoden

public class CalculatorTest {
    @Test
    void triangularMinus5() { // The test method does not have to be public in JUnit5
        Calculator calc = new Calculator();

        IllegalArgumentException thrown = assertThrows(
            IllegalArgumentException.class, 
            () -> calculator.divide(42.0, 0.0));
        // If the exception has not been thrown, the above test has failed.

        // And now you may further inspect the returned exception...
        // ...e.g. like this:
        assertEquals("Divider must not be 0", thrown.getMessage());
}
 

Att ignorera tester

För att ignorera ett test, lägg bara till @Ignore kommentaren i testet och eventuellt ange en parameter till annotationen med anledningen.

@Ignore("Calculator add not implemented yet.")
@Test
public void testPlus() {
    assertEquals(5, calculator.add(2,3));
}
 

Jämfört med att kommentera testet eller ta bort @Test anteckningen kommer @Test fortfarande att rapportera detta test och notera att det ignorerades.

Det är också möjligt att ignorera ett testfall med villkor genom att använda JUnit antaganden . Ett exempel på användningsfall skulle vara att köra testfallet först efter att ett visst fel har fixats av en utvecklare. Exempel:

import org.junit.Assume;
import org.junit.Assert;
...

@Test 
public void testForBug1234() {

    Assume.assumeTrue(isBugFixed(1234));//will not run this test until the bug 1234 is fixed

    Assert.assertEquals(5, calculator.add(2,3));
}
 

Standardlöparen behandlar tester med felaktiga antaganden som ignoreras. Det är möjligt att andra löpare kan bete sig annorlunda, t.ex. behandla dem som passerade.

JUnit - Exempel på grundläggande kommentarer

Här är några grundläggande JUnit-kommentarer du bör förstå:

@BeforeClass – Run once before any of the test methods in the class, public static void 
@AfterClass – Run once after all the tests in the class has been run, public static void
@Before – Run before @Test, public void
@After – Run after @Test, public void
@Test – This is the test method to run, public void