JMeter and JUnit Integration


In this tutorial, we will learn to integrate JMeter and JUnit. This JMeter and JUnit integration helps in load testing of customized Java methods - the JUnit tests. Integrating JUnit in JMeter helps in finding the time taken by individual tests with the applied load using various JMeter capabilities. In this post, we will create a sample JUnit test and then configure it to run in JMeter.

Steps to integrate JMeter with JUnit

  1. Create a JUnit Test Project
  2. Create Jar for the JUnit Project
  3. Put Jar in JMeter's lib/junit directory
  4. Run JUnit tests in JMeter

Creating a JUnit Test Project

Here, we will create sample Java project having JUnit annotations. It contains a test class sampleJUnitTest.java having to test methods.

JUnit with JMeter

For the demo, we have two JUnit Tests in sampleJUnitTest.java - sampleTestPassing and sampleTestFailing. The Test sampleTestPassing gets passed when run and the Test sampleTestFailing is explicitly failed using Assert.fail() command.

SampleJUnitTest.java

package SamplePackage;

import org.junit.*;

public class SampleJUnitTest {
	
    //Constructors
    public sampleJUnitTest() {

    }

    public sampleJUnitTest(String test) {
        this();
    }
	
    @Test
    public void sampleTestPassing() {       
        System.out.println("Running JUnit Sample Test");
    } 
	
    @Test
    public void sampleTestFailing() {       
        Assert.fail();
        System.out.println("Failing JUnit Sample Test");
    }
}


Creating Jar for the JUnit Project

Now we will create a Jar of the above JUnit project. In eclipse, jar can be created easily using Export functionality. Follow the below screenshots for the Jar creation steps-

  • Right click on the Project and click on Export button. JUnit with JMeter
  • Inside Java, click on 'JAR file'. JUnit with JMeter
  • Select your Project and check the resources. Also, provide the path for the generated Jar file. JUnit with JMeter

Putting Jar in JMeter's lib/junit directory

Next put the generated Jar file in the JMeter's lib/junit directory and restart JMeter.

Running JUnit tests in JMeter

  • First add a "JUnit Request" to a Thread group JUnit with JMeter
  • Check the "Search for JUnit 4 annotations (instead of JUnit3)" checkbox
  • From the "Classname" dropdown select the JUnit Test class created
  • From the "Test Method" dropdown, select the JUnit method/Test you want to load test
  • Likewise multiple JUnit Requests can be added with each request having a Test method- in this example two JUnit requests are added for Passing and failing test JUnit with JMeter
  • Add Listeners and run the test JUnit with JMeter

This concludes running JUnit tests in JMeter tutorial.