Jiří Tomeš. Nástroje pro vývoj a monitorování SW (NSWI026)

Transcription

1 Jiří Tomeš Nástroje pro vývoj a monitorování SW (NSWI026)

2 Simple open source framework (one of xunit family) for creating and running unit tests in JAVA Basic information Assertion - for testing expected result Fixtures -forsharing common test data Runners -forrunning tests Results - analyzed in a an automatic way JUnit3 (old type prefix test ) Test case -> Java public (protected) method Test suite -> Java class (collection of test cases) JUnit4 (new type) Using annotations

3 @Test Important Annotations 1 Defines test case method Run before (after) all the tests in a class For time expensive actions (DB connection, Execute before (after) each test Initialization / Cleaning External resources (e.g. files, Annotated test will not run

4 Expected (expected = IndexOutOfBoundsException.class) public void empty() { new ArrayList<Object>().get(0); } Passed in case Exception Fails in case public void empty() throws IndexOutOfBoundsException { new ArrayList<Object>().get(0); }

5 Running tests - overview From Java program (e.g main method) org.junit.runner.junitcore.runclasses (MyTest.class,...) From command line export CLASSPATH=$CLASSPATH:JUNIT_HOME/junit.jar java org.junit.runner.junitcore MyTest [other test classes] FROM IDE (NetBeans, Eclipse, ) Ant Maven

6 SimpleTest example import org.junit.*; import static org.junit.assert.*; Import JUnit elements public class MySimpleTest public static void MyBeforeClass() { } Write test public void MyAfter() { public void MyTestOne() public void MyIgnoreTest() { } public static void main(string[] args) { org.junit.runner.junitcore.runclasses(mysimpletest.class); } } DEMO in: MySimpleTest

7 @RunWith Specifies runner that run the test Runners: Suite ( normal tests ), Parametrized tests, Categories, Important Annotations 2 Defining parameters for tests (runn for each parameter) via. static method Each test in new class Groups test method (classes) into categories Categories can be chosen for test Tested method can change their behavior (interpretation)

8 = Parameterized.class) public class ParamTest { private int expectedresult, firstvalue, secondvalue; public ParamTest (int expectedresult, int firstvalue, int secondvalue) { } this.expectedresult = expectedresult; this.firstvalue = firstvalue; this.secondvalue = public static Collection<Integer[]> gettestparameters() { return Arrays.asList (new Integer[][] { {15, 13, 2}, {-10, 12, -22} }); } DEMO in: ParamTest

9 public class Monkey { }; Define public class UnitTest { }; Test chosen categories DEMO in dir: category

10 More Rule implements method public Statement apply (Statement base, Description description) No rule = called method Statement.evaluate() Rule can modify behavior by adding some action before (after) evaluation providing methods accessible from tests storing some information, accessible from test For JUnit are provided Test Rule implementation ErrorCollector collect assertion failures per test method TemporaryFolder delete temporary files after test ExternalResource set up and tear down external resource

11 @Rule examples public class ErrorColectorTest public ErrorCollector collector = new ErrorCollector(); public void defineallerrors() { collector.adderror(new Throwable("My first error")); collector.adderror(new Throwable("My second error")); } DEMO in ErrorCollectorTest DEMO in TemporaryFolderTest DEMO in ExternalResourceTest

12 Organizing tests Class + Tested class in same package (directory) src abc Xyz MyJavaClass.java MyJavaClassTest.java Tested classes are in separate parallel directory src test abc Xyz MyJavaClass.java abc Xyz MyJavaClassTest.java

13 Running tests with Ant 1/2 Define necessary properties <property name= src value= src /> <property name= build value= build /> <property name= test.class.name value= MySimpleTest /> Set up CLASSPATH for JUnit <path id="test.classpath"> <pathelement location = "home/junit4.10/junit-4.10.jar"/> </path> Your JUNIT_HOME/junit.jar

14 Running tests with Ant 2/2 Define Ant task for running tests <target name="test" depends="compile"> <junit fork="yes" printsummary="yes" haltonfailure="yes haltonerror="yes"> <test name="${test.class.name}"/> <formatter usefile="false type="plain" /> <classpath> <pathelement path="${test.classpath}"/> <pathelement location="${build}"/> </classpath> </junit> </target> Run via Ant ant test Define test class XML, Brief, Failure DEMO in: build.xml

15 Define property pro reports HTML (XML) report with Ant <property name="reports.dir" value="test-reports"/> Define Ant task for that <target name="test-html" depends="compile"> DEMO in: build.xml <mkdir dir="${reports.dir}"/> <junit fork="yes" printsummary="yes" haltonfailure="yes" haltonerror="yes"> <! for more tested class can use tag <batchtest fork="yes".../> --> <test name="${test.class.name}" todir="${reports.dir}"/> <formatter type="xml"/> <classpath> <pathelement path="${test.classpath}"/> <pathelement location="${build}"/> </classpath> </junit> ant test-html <junitreport todir="${reports.dir}"> <fileset dir="${reports.dir}"> <include name="test-*.xml" /> </fileset> <report todir="${reports.dir}" /> </junitreport> </target> Run via Ant

16 Failed tests Output + Example From Java program org.junit.runner.result result; result=org.junit.runner.junitcore.runclasses (MyTest.class,...) [int] getruncount(),getfailurecount(),getignorecount() [bool] wassuccessful() [List<Failure>] getfailures() From command line java org.junit.runner.junitcore MyTest [other test classes] FAILURES!!! Tests run: 3, Failures: 2 Ant DEMO in: FailedTest [junit] Tests run: 3, Failures: 1, Errors: 0, Time elapsed: 0,02 sec

17 Other examples DEMO in dir: apache examples DEMO in dir: word

18 Used sources JUnit Cookbook JUnit Wiki JUnit FAQ

19 Question time Ask for what you are interested THANKS for your attention during my presentation