Anotace Test. Označuje public void metodu, která může být spuštěna jako test. Parametr expected označuje vyjimku, která by měla být v metodě vyvolána

Transkript

1 junit 4 Petr Fanta

2 Anotace Označuje public void metodu, která může být spuštěna jako Parametr expected označuje vyjimku, která by měla být v metodě Parametr timeout určuje maximální dobu běhu testu (měřeno v milisekundách)

3 Asserty Jsou definované jako statické metody třídy Assert Jsou zaznamenány pouze asserty, které selžou Příklady: assertarrayequals(t[] expecteds, T[] actuals) assertequals(t expected, T actual) assertfalse(boolean condition) assertnotnull(object object) assertsame(object expected, Object actual) asserttrue(boolean condition) assertthat(t actual, org.hamcrest.matcher<t> matcher) fail()

4 Fixtures Slouží k vytvoření prostředků použitých ve více Označuje metodu, která je volána před každým Označuje metodu, která je volána po každém Označuje public static void metodu, která je volána pouze jednou před všemi testy v dané Označuje public static void metodu, která je volána pouze jednou po všech testech v dané třídě

5 Anotace Slouží k označení metody nebo třídy, která se mé vynechat při spuštění testu is ignored as a public void testsane() { assertthat(1, is(1));

6 Anotace RunWith Pokud je třída anotována použije se ke spuštění testů třída určená v parametru místo defaultního junit BTest.class, CTest.class) public class ABCSuite {

7 Parametrizované testy Ke spuštění parametrizovaných testů složí runner Označuje public static metodu vracejicí List<Object[]>, kde jednotlivé prvky Object[] jsou použity jako parametry construktoru parametrizované třídy

8 @RunWith(Parameterized.class) public class FibonacciTest public static List<Object[]> data() { return Arrays.asList(new Object[][] { { 0, 0, { 1, 1, { 2, 1, { 3, 2, { 4, 3, { 5, 5, { 6, 8 ); private int finput; private int fexpected; public FibonacciTest(int input, int expected) { finput= input; fexpected= public void test() { assertequals(fexpected, Fibonacci.compute(fInput));

9 Pravidla Pravidla umožňují předefinování chování každého testu ve třídě Umožňují přístup k informacím o testu uloženým v Označuje public field (ne static), které jsou typu odvozeného od TestRule. ErrorCollector: umožňuje zachycení více chyb v jednom testu ExpectedException: umožňuje zpracování výjimek vyvolaných uvnitř testu ExternalResource: umožňuje například zpuštění a zastavení serveru TemporaryFolder: slouží k vytváření souborů, které budou po testu smazány TestName: obsahuje jméno testu pro použití v jeho průběhu TestWatcher: přidává logiku k průběhu test (např. událost při neúspěchu testu ) Timeout: nastavuje maximální dobu běhu testu Verifier: způsobí neúspěch testu pokud je objekt v nekorektním stavu

10 ErrorCollector Pravidla - příklady public static class UsesErrorCollectorTwice public ErrorCollector collector= new public void example() { collector.adderror(new Throwable("first thing went wrong")); collector.adderror(new Throwable("second thing went wrong")); collector.checkthat(getresult(), not(containsstring("error!"))); // all lines will run, and then a combined failure logged at the end.

11 Pravidla - příklady TemporaryFolder public static class HasTempFolder public TemporaryFolder folder= new public void testusingtempfolder() throws IOException { File createdfile= folder.newfile("myfile.txt"); File createdfolder= folder.newfolder("subfolder"); //...

12 Pravidla - příklady ExternalResource public static class UsesExternalResource { Server myserver= new public ExternalResource resource= new ExternalResource() protected void before() throws Throwable { myserver.connect(); protected void after() { myserver.disconnect(); ; public void testfoo() { new Client().run(myServer);

13 Anotace Category Slouží k rozdělení testů do různých skupin pomocí Slouží k označení tříd testů či testovacích metod Value je pole libovolných tříd Ke spuštění slouží runner Categories.class K výběru kategorii slouží K určení tříd testů, ze kterých se bude vybírat slouží

14 public interface FastTests { /* category marker */ public interface SlowTests { /* category marker */ public class A public void a() public void b() FastTests.class) public class B public void { A.class, B.class ) // Note that Categories is a kind of Suite public class SlowTestSuite { // Will run A.b, but not A.a or B.c

15 Spuštění příkazový řádek Spuštení z príkazové řádky: java org.junit.runner.junitcore TestClass1 [...other test classes...] V CLASSPATH musí byt uvedeny cesty: K souborům Junit Ke zdrojovým souborů, včetně tříd s testy K použitým knihovnám

16 1. Proměnné Spuštění - Ant <property name="bin" value="./bin" /> <property name="lib" value="./lib" /> <property name="junit" value="/path/to/junit.jar" /> <property name="test.class.name" value="mytestsuite" /> 2. CLASSPATH pro JUnit target <path id="test.classpath"> <pathelement location="${classes" /> <pathelement location="${junit" /> <fileset dir="${lib"> <include name="**/*.jar"/> </fileset> </path> 3. Target pro JUnit <target name="test"> <junit fork="yes" haltonfailure="yes"> <test name="${test.class.name" /> <formatter type="plain" usefile="false" /> <classpath refid="test.classpath" /> </junit> </target>

17 Ant - HTML <property name="report" value="./report" /> <target name="test" depends="compile"> <junit failureproperty="testsfailed"> <classpath refid="test.classpath" /> <formatter type="xml"/> <test name="${test.class.name" todir="${reports"/> </junit> <junitreport todir="${reports"> <fileset dir="${reports"> <include name="**/test-*.xml"/> </fileset> <report format="frames" todir="${reports"/> </junitreport> </target>

18 Doporučené postupy Testy by měly být psány předem Programujeme pouze to co musíme Testovat by se mělo pouze to, co se může pokazit Testy by se měli pouštět kdykoliv je to možné (alespoň na část kódu, na které pracujeme) Pokud se objeví chyba, nejdříve napíšeme test a až poté opravíme Proč používat JUnit?

19 Zdroje