JUnit Report Generation Example

In this example we shall show users how we can generate reports using the Maven and JUnit. JUnit Report Generation example demonstrates the basic usage of the reporting functionality of JUnit tests.

As you already know, JUnit is the basic unit test framework for the Java programmers. This example focuses more on generating the report. Let’s start by analyzing the ways through which we can generate the HTML reports of our test cases.

1. Introduction

JUnit helps us in validation our methods for functionality. But in some cases we have to see the report also for the test cases. In the process of developing reports, Maven plays an important role as it will make a text, XML and also HTML reports. All JUnit test cases with the details are printed in the reports. We will see in this example how this can be achieved.

However, reports can be generated in many different ways like with Ant, TestNG and other independent libraries. But we will focus on very simple case i.e. with the help of Maven.

We will be using the surefire plugin of maven to generate the reports for our example.

2. Technologies Used

We will be using following technologies to work n this example

  • Java – primary language for coding
  • Eclipse – IDE for coding
  • Maven – dependency management tool and also to generate reports for our test cases.
  • JUnit 4.12 – testing framework

3. Project Setup

You may skip project creation and jump directly to the beginning of the example below.

Open Eclipse. Select File -> New -> Maven Project. Following screen will appear. Fill in the values displayed below and then click on Next.

Junit Report Generation Example Setup 1
Figure 1: Junit Report Generation Example Setup 1

Fill in all the details as shown and click on Finish button.

Junit Report Generation Example Setup 2
Figure 2: Junit Report Generation Example Setup 2

Clicking on Finish button will create a blank Maven project that will be a starting point of our example.

4. JUnit Report Generation Example

First of all we need to put the dependencies for our project. Simply put the following line in the pom.xml file.





Lines 1-7 will download JUnit jar file.
Lines 9-12 will ask Maven to use Java 1.8 for this example.
Lines 14-22 are used to fetch the surefire plugin that helps us to generate the report for our test cases.

This will ready our project. Let’s start creating a unit test case.

4.1 JUnit Report Generation Test Class

We will be creating a small test class with only 4 test cases to be tested. By default all test cases will be passed so that our report will be generated.


package junitreportgeneration;

import static org.hamcrest.CoreMatchers.instanceOf;
import static org.hamcrest.CoreMatchers.is;
import static org.junit.Assert.assertThat;
import static org.junit.Assert.assertTrue;

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

import org.junit.Test;

public class JUnitReportGenerationTest {

	private String developer = "Vinod";

	public void instanceOfTest() {
		assertThat(new ArrayList(), instanceOf(List.class));

	public void assertTrueTest() {

	public void equalToTest() {
		assertThat(developer, is("Vinod"));
	public void failTest() {
		assertThat(developer, is("Any"));

This is a simple test class.

5. Generate Reports

To generate a report you need to simple run the Maven command:

mvn clean install test surefire-report:report

To run from eclipse you need to follow some steps.

    1. Right click on project
    2. Run As -> Run Configurations…
    3. You will be prompted with the screen

Junit Report Generation Example Run 1
Figure 3: Junit Report Generation Example Run 1

    1. Double Click on Maven Build
    2. You will be prompted with following screen

Junit Report Generation Example Run 2
Figure 4: Junit Report Generation Example Run 2

  1. For Base Directory field, Select Workspace… button and select your project
  2. Fill in the details as shown above and click on Apply button.
  3. Now click on Run button on same window

You will see the output generated in the target folder.

Junit Report Generation Example Project Structure
Figure 5: Junit Report Generation Example Project Structure

Open sure-fire.html file from target -> site folder in any browser. You will see the following output.

Junit Report Generation Example Output
Figure 6: Junit Report Generation Example Output

6. Conclusion

Through this example we have learnt that generation of a simple HTML report of JUnit test cases is very simple. We have generated reports with the help of the Maven plugin surefire.

7. Download the Eclipse Project

This is a JUnit Report Generation Example.

You can download the full source code of this example here: JUnitReportGeneration.zip

Vinod Kumar Kashyap

Vinod is Sun Certified and love to work in Java and related technologies. Having more than 13 years of experience, he had developed software's including technologies like Java, Hibernate, Struts, Spring, HTML 5, jQuery, CSS, Web Services, MongoDB, AngularJS, AWS. He is also a JUG Leader of Chandigarh Java User Group.
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

1 Comment
Newest Most Voted
Inline Feedbacks
View all comments
5 years ago

After Complete of 4 step
5 step Reporting
Maven Build as per screenshot is displaying filename of java or project name
and make run

Back to top button