How to use JUnit to unit test code

In this blog post, I will be explaining how you can run JUnit unit tests to test your code.

What is JUnit?

JUnit is a unit testing framework for Java. It is used by developers to test individual code and ensure that code works the way it was intended to. The current version of JUnit is JUnit 5.

 

Why JUnit?

Consider the following code snippet:

package demo;public class MathDemo {public int add(int a,int b){return a+b;}public int subtract(int a,int b){return a-b;}}

 

So this class has two methods, called add and subtract. The add method adds 2 numbers and returns the sum while the subtract methods returns the difference of the 2 input numbers.  Now traditionally, if you want to test if this code works, you would write a main method like this:

public static void main(String args[]){MathDemo mathDemo = new MathDemo();int sum = mathDemo.add(5,4);int diff = mathDemo.subtract(9, 3);System.out.println("Sum is "+sum);System.out.println("Difference is "+diff);}

The problem with using an approach like this is, its dependent on human intervention. So when the Sysout statement is printed, you need to manually verify whether the printed output is correct. Now, for a simple example like this, it might not matter much, but when the code gets complex, this approach will be time consuming and error prone. JUnit on the other hand automates the testing process for you, making the code less error prone.

How can you setup JUnit?

There are a couple of ways to setup JUnit. You can download the jar file from the official  and add it to your classpath.

You can also set it up via Maven, you will need to add the following JUnit dependency to your pom file:

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

How to use JUnit?

Consider the following JUnit code:

 

package demo;import static org.junit.Assert.*;import org.junit.After;import org.junit.Before;import org.junit.Test;public class MathTest {private MathDemo mathDemo;@Beforepublic void setUp() throws Exception {mathDemo = new MathDemo();}@Afterpublic void tearDown() throws Exception {}@Testpublic void testAdd() {int result = mathDemo.add(5,3);assertEquals(result,8);}@Testpublic void testSubtract() {int result = mathDemo.subtract(10,4);assertEquals(result,6);}}

 

Using the above code, you can automatically test your code, without any human intervention. The above class is known as a Testcase. You need to have a separate method in the Testcase class for each method that you want to test. Each method that needs to be executed as a test needs to have the @Test annotation. This tells JUnit that this is a test method. Here, we have the following methods with the @Test annotation:

 

testAdd – This method tests the add method in the MathDemo class. It invokes the add method using two numbers. It then uses the assertEquals method to check if the actual result is the same as the expected result. If the result is correct, the test case is said to have passed, otherwise the test case fails. So now, human intervention is no longer needed, if the code is functioning properly, the test case passes, otherwise the test case fails.

testSubtract – This method tests the subtract method in the MathDemo class. As in the case of the testAdd method, it invokes the subtract method using two numbers and uses the assertEquals method to check if the actual result is the same as the expected result.

In addition to these two methods, this class also has the following methods:

 

setUp – This method is executes before invoking any test. Here, you can write any setup code. In our case, we are creating the MathDemo class.

 

tearDown– This method is invoked after all tests are completed. Here you can write any cleanup code. This method does not have implementation in our case.

 

How to run the JUnit tests?

If you are not using an IDE like Eclipse, you need to create a TestRunner code as follows to run the unit tests:

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

 

This class can be executed like any normal Java class. So if we run the code, we will get the following output:

true

 

However, if we change the MathTest class as follows:

@Testpublic void testAdd() {int result = mathDemo.add(5,3);assertEquals(result,3);}

 

If you run the TestRunner class now, the following output will be printed:

testAdd(demo.MathTest): expected:<8> but was:<3>false

 

How to run JUnit tests in Eclipse?

If you are using an IDE like Eclipse, you do not need the TestRunner class. You can directly right click on the test case class and run the JUnit test as follows:

This will print display a JUnit console as follows (In case the tests are successful):

 

In case the tests fail, it will display a console as follows:

Comments

Post a Comment

Popular posts from this blog

How to use logging in SpringBoot with code samples

Image
In this article, we will learn how to use logging in SpringBoot. Introduction There are several Java logging frameworks like logback, log4j, and so on. Spring Boot supports out-of-the-box support for logback. Let us learn how to use logging in SpringBoot with logback. Step 1 – Create a New Maven Project Create a new Maven project. (Refer to  this  blog post). This will create a project in Eclipse as follows:   Step 2 – Add the Spring Boot Dependencies Add the spring-boot-starter-web dependency to the pom.xml . So, the pom.xml should look as follows: <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.learnjava</groupId> <artifactId>learnjava-springboot-logging-example</artifactId> <version>0.0.1-SNAPSHOT&
Read more

Python While Loop with code samples

Much like a Java while loop, you can use a Python while loop to repeatedly execute a block of code as long as a condition is true. In this article, we will learn more about the Python while loop. Python While loop Syntax A while loop in Python has the following syntax: while <condition>: loop body The while keyword is followed by a condition. If the condition evaluates to true, the body of the loop is executed. Once the body of the loop is completed, the condition is checked again and this is repeated until the condition evaluates to false at which point the loop is exited. While loop Sample Code The following code demonstrates how you can use the while loop: num=10counter=1total=0while counter<=num: total += counter counter+=1print("sum of first 10 numbers is",total) This code adds the numbers from 1 to 10 and prints the sum. It uses a while loop to iterate from 1 to 10. The while loop checks the condition counter <= num and if so adds the current value of count
Read more

How to convert a List to a Set

In this blog post ,I will be showing you how you can convert a List to a Set. Consider the following code snippet: public class ListToSetDemo {public static void main(String[] args) {List<Integer> list = Arrays.asList(5,3,11,15,9);//Method 1Set<Integer> set = new HashSet<Integer>(list);System.out.println("Set is "+set);//method 2Set<Integer> set2 = new HashSet<Integer>();set2.addAll(list);System.out.println("Set is "+set2);}} This code demonstrates two ways to convert a List to a Set. Method 1 Here, we are creating a new HashSet . We are invoking the constructor that accepts a Collection object. Here, we are passing in the input list to this constructor.   Method 2 Here again, we are creating a new HashSet . However, we are using the default constructor. We are then invoking the addAll method and passing in the input list.   When you run this code, it will print the following output: Set is [3, 5, 9, 11, 15]Set is [3, 5, 9, 11, 15] No
Read more