{"id":7567,"date":"2013-12-17T13:20:46","date_gmt":"2013-12-17T11:20:46","guid":{"rendered":"http:\/\/examples.javacodegeeks.com\/?p=7567"},"modified":"2019-03-21T12:52:47","modified_gmt":"2019-03-21T10:52:47","slug":"junit-time-test-example","status":"publish","type":"post","link":"https:\/\/examples.javacodegeeks.com\/java-development\/core-java\/junit\/junit-time-test-example\/","title":{"rendered":"JUnit Time Test Example"},"content":{"rendered":"

In this example we are going to see how to use @Test<\/code> annotation along with its optional parameter timeout<\/code> in JUnit<\/a> testing framework. Also, we will see how to run our test case from the command line by using the org.junit.runner.JUnitCore<\/a><\/code>.<\/p>\n

1. Create the java class to be tested
\n<\/strong><\/h2>\n

Create a folder named JUnitTest<\/code>. This is the folder where your classes will be located. Using a text editor, create a Java class named FirstDayAtSchool.java<\/code>. To make sure your file name is FirstDayAtSchool.java<\/code>, (not FirstDayAtSchool.java.txt<\/code>), first choose “Save as -> Save as type -> All files”<\/em>, then type in the file name FirstDayAtSchool.java<\/code>.<\/p>\n

 
\nFirstDayAtSchool.java<\/em><\/span><\/p>\n

public class FirstDayAtSchool {\n\n\tpublic String[] prepareMyBag() {\n\t\tString[] schoolbag = { \"Books\", \"Notebooks\", \"Pens\" };\n\t\tSystem.out.println(\"Preparing my bag\");\n\t\treturn (schoolbag);\n\t}\n\n\tpublic void printItems(String items) {\n\t\tSystem.out.println(\"My school bag contains: \" + items);\n\t\twhile (true);\n\t}\n}\n<\/pre>\n
2. Create JUnit test case
\n<\/strong><\/h2>\n
In the same directory (JUnitTest<\/code>), use a text editor and create a java class named JunitTest.java<\/code> with the following code.<\/p>\n
JunitTest.java<\/em><\/span><\/p>\n
import static org.junit.Assert.assertArrayEquals;\nimport java.util.Arrays;\nimport org.junit.Test;\n\npublic class JunitTest {\n\n   FirstDayAtSchool school = new FirstDayAtSchool();\n   String[] bag = {\"Books\", \"Notebooks\", \"Pens\"};\n  \n   @Test\n   public void testPrepareMyBag() {\t\n      System.out.println(\"Inside testPrepareMyBag()\");    \n      assertArrayEquals(bag, school.prepareMyBag());     \n   }\n\n   @Test(timeout=100)\n   public void testPrintItems() {\t \n      System.out.println(\"Inside printItems()\");   \n      school.printItems(Arrays.toString(bag)); \n   }\n}\n<\/pre>\n
Inside the method testPrintItems()<\/code>, we can see that @Test <\/code> annotation is followed by a parameter, called timeout<\/code>. Timeout<\/code> is an optional parameter supported by @Test <\/code>annotation that causes a test to fail if it takes longer than the specified amount of time (measured in milliseconds).
 
<\/div> <\/div><\/p>\n
For further details regarding the @Test<\/code> annotation, the assertArrayEquals<\/code> assertion (which are also mentioned in our code) and other JUnit Assertions and Annotations, you can have a look at JUnit using Assertions and Annotations Example<\/a>.<\/p>\n
3. Run your test case from the command line
\n<\/strong><\/h2>\n
You can run your JUnit test outside Eclipse, by using the org.junit.runner.JUnitCore<\/code> class. This class provides the runClasses()<\/code> method which allows you to execute one or several test classes. The return type of runClasses()<\/code> method is an object of the type org.junit.runner.Result<\/a><\/code>. This object can be used to collect information about the tests. Also, in case there is a failed test, you can use the object org.junit.runner.notification.Failure<\/a><\/code> which holds description of the failed tests.<\/p>\n
The procedure below shows how to run your test outside Eclipse.<\/p>\n
In the directory JUnitTest<\/code>, use a text editor and create a new Java class named JunitTestRunner.java<\/code> with the following code.<\/p>\n
JunitTestRunner.java<\/em><\/span><\/p>\n
import org.junit.runner.JUnitCore;\nimport org.junit.runner.Result;\nimport org.junit.runner.notification.Failure;\n\npublic class JunitTestRunner {\n\n\tpublic static void main(String[] args) {\n\n\t\tResult result = JUnitCore.runClasses(JunitTest.class);\n\t\tfor (Failure fail : result.getFailures()) {\n\t\t\tSystem.out.println(fail.toString());\n\t\t}\n\t\tif (result.wasSuccessful()) {\n\t\t\tSystem.out.println(\"All tests finished successfully...\");\n\t\t}else{\n\t\t\tSystem.out.println(\"The test failed..\");\n\t\t}\n\t}\n}\n<\/pre>\n