Integration testing of APIs in Spring-Boot( Java) with Junit | For Beginners

Updated on: May 30, 2020 · 7 mins read
Categories: java   | springboot   | testing |

Shipping your product without testing is like buying a car without turning on the engine.

Integration testing in spring boot | Java
We have to run a few tests again and again during the development of the product and if those tests are not automated, we will have a hard time testing our application.

Here is a post that will help you to understand the importance of writing tests?

This post is in continuation of the last post we shared related to Spring boot in which we talked about writing Rest APIs in Spring Boot.

Please go through that post if you want to learn how to create rest APIs using Spring Boot.

In this post, we are going to discuss how we can test our spring boot application from start to end without any mocking.

Spring boot logo
First, we have to add the test libraries to the pom.xml, so that the Maven can install them for us. Here is the GitHub Repo that contains the code for this tutorial.

Here is the code to add testing libraries to pom.xml


Using separate config for testing purposes

We don’t want to add the data to the same database as of the production one. So, we will start by creating a separate configuration for handling the test cases. Also, its always a good practice to have separate configurations anyway.

Create a new resource file, src/main/resources/ and add the following data to it.

Note: We will have to create the database in our local system to make it work.

Now that we have a separate configuration file, we have to export it as an App configuration so that we can use it in the tests itself.

Add the following code to the file, src/main/java/io/singh1114/springboottut/

Writing Controller test for Spring Boot API.

Now since we are going to test the application from end to end, let’s create a controller test.

Add the following code to src/test/java/io/singh1114/springboottut/

Let’s go through the file and understand this.

@ActiveProfiles, is used to let the framework know that we are going to use the given profile. As we have already declared the test Profile in the Configuration file, we can use it here directly.

@RunWith and @SpringBootTest is used to start a simple server to carry out the tests using the SpringBootFramework.

Running on a random port

With SpringBootTest.WebEnvironment.RANDOM_PORT we are telling the framework to launch the application on a Random PORT.

Removing any change made to the database after test completion.

@Transactional will help us to clean the database once tests are completed. We don’t want to keep adding stuff to the database and want to clean it after every test run.

Wrapping something with Transaction is a very general programming concept which is present in almost every Database. According to this, if you run any number of SQL commands inside the transaction and if it fails on any step, the whole transaction will be reverted.

This is fairly useful when you are running related commands, for example, reducing the inventory size and adding stuff to someone brought list.

The same concept is used here, the only hack is that anything you run inside @Transactional is rolled back in the end.

Read more about this on Spring boot logs.

Creating the API endpoint

    private int port;

    private String createURLWithPort(String uri) {
        return "http://localhost:" + port + uri;
These are used to create the URL for a given endpoint to hit.

Creating the School Object

    private SchoolRepository repository;
        School testSchool = new School(1, "First Location", "Mr. Ranvir", "California");;
This code is used to create the object in the database.

Sending the request and getting the response

    TestRestTemplate restTemplate = new TestRestTemplate();

    HttpHeaders headers = new HttpHeaders();
        HttpEntity<String> entity = new HttpEntity<String>(null, headers);

        ResponseEntity<String> response =
                HttpMethod.GET, entity, String.class);

Checking if the response is equal to the object created

JSONAssert.assertEquals(expected, response.getBody(), false);
Here we are checking if the body of the response is equal to the expected response.

Run the tests

Use can use the following command to run the tests.

mvn test
Spring boot test passing
Adding tests to your code is never enough, you have to run those tests after each code push. CircleCI is a tool which help you to build continuous integration pipelines. Read the following post to know more.

I hope you liked the post. Please share your views in the comment section below. Also, please Subscribe if you want to read more such posts.

Please share your Feedback:

Did you enjoy reading or think it can be improved? Don’t forget to leave your thoughts in the comments section below! If you liked this article, please share it with your friends, and read a few more!

We don't share your details with others