Why TestRestTemplate for API testing in JUnit? - Purpose & Use Cases

The Big Idea

What if you could test your APIs with just a few lines of code instead of clicking around all day?

The Scenario

Imagine you have a web service with many APIs. You want to check if each API works correctly by sending requests and reading responses manually using tools like Postman or curl.

You open the tool, type the URL, set headers, send the request, then check the response. You repeat this for every API and every test case.

The Problem

This manual way is slow and boring. You can easily make mistakes typing URLs or headers. It's hard to remember which tests you did or what the results were. If the API changes, you must redo everything manually.

Also, manual testing can miss bugs because it's tiring and repetitive.

The Solution

TestRestTemplate lets you write simple Java code to send HTTP requests and check responses automatically. You write tests once, then run them anytime with one command.

This saves time, reduces errors, and keeps your tests organized and repeatable.

Before vs After

✗ Before

Send request in Postman -> Check response manually -> Repeat for each test

✓ After

ResponseEntity<String> response = restTemplate.getForEntity(url, String.class);
assertEquals(HttpStatus.OK, response.getStatusCode());

What It Enables

It enables fast, reliable, and repeatable API testing directly in your Java test code.

Real Life Example

A developer changes an API endpoint. Instead of manually testing all calls, they run automated tests using TestRestTemplate to quickly confirm everything still works.

Key Takeaways

Manual API testing is slow and error-prone.

TestRestTemplate automates sending requests and checking responses.

This makes API testing faster, easier, and more reliable.

Practice

1. What is the primary purpose of TestRestTemplate in JUnit testing?

easy

A. To mock database connections during tests

B. To send real HTTP requests to test REST APIs

C. To generate random test data for unit tests

D. To create UI components for testing

Solution

1. Step 1: Understand the role of TestRestTemplate

   TestRestTemplate is designed to send actual HTTP requests to REST APIs during integration tests.

2. Step 2: Compare with other options

   Mocking databases, generating test data, or creating UI components are unrelated to TestRestTemplate's purpose.

3. Final Answer:

   To send real HTTP requests to test REST APIs -> Option B

4. Quick Check:

   TestRestTemplate = Real HTTP requests [OK]

Hint: Remember: TestRestTemplate sends real HTTP calls [OK]

Common Mistakes:

• Confusing TestRestTemplate with mocking tools
• Thinking it generates test data
• Assuming it tests UI components

2. Which of the following is the correct way to autowire TestRestTemplate in a Spring Boot test class?

easy

A. @Autowired private TestRestTemplate restTemplate;

B. private TestRestTemplate restTemplate = new TestRestTemplate();

C. @InjectMocks private TestRestTemplate restTemplate;

D. private TestRestTemplate restTemplate = null;

Solution

1. Step 1: Identify correct Spring Boot injection

   In Spring Boot tests, @Autowired is used to inject TestRestTemplate automatically.

2. Step 2: Evaluate other options

   Creating a new instance manually or using @InjectMocks is incorrect for TestRestTemplate injection in Spring Boot tests.

3. Final Answer:

   @Autowired private TestRestTemplate restTemplate; -> Option A

4. Quick Check:

   Use @Autowired for TestRestTemplate injection [OK]

Hint: Use @Autowired to inject TestRestTemplate [OK]

Common Mistakes:

• Manually instantiating TestRestTemplate
• Using @InjectMocks instead of @Autowired
• Leaving the variable null without injection

3. Given the following test code snippet using TestRestTemplate:

ResponseEntity<String> response = restTemplate.getForEntity("/api/users/1", String.class);
int statusCode = response.getStatusCodeValue();
String body = response.getBody();

If the API returns HTTP 200 with body "User Found", what will be the values of statusCode and body?

medium

A. statusCode = 404, body = null

B. statusCode = 500, body = "Error"

C. statusCode = 200, body = "User Found"

D. statusCode = 200, body = null

Solution

1. Step 1: Understand getForEntity behavior

   getForEntity sends a GET request and returns the full response including status and body.

2. Step 2: Match API response to variables

   Since API returns 200 and "User Found", statusCode will be 200 and body will be "User Found".

3. Final Answer:

   statusCode = 200, body = "User Found" -> Option C

4. Quick Check:

   API 200 + body = statusCode 200 & body "User Found" [OK]

Hint: getForEntity returns status and body as received [OK]

Common Mistakes:

• Assuming body is null on success
• Confusing status codes with error codes
• Ignoring response body content

4. Consider this test code using TestRestTemplate:

@Autowired
private TestRestTemplate restTemplate;

@Test
public void testGetUser() {
    ResponseEntity<String> response = restTemplate.getForEntity("/api/users/", String.class);
    assertEquals(200, response.getStatusCodeValue());
}

What is the likely problem with this test?

medium

A. The URL is missing a user ID, causing a 404 error

B. The assertion should check for 404 instead of 200

C. TestRestTemplate cannot be autowired

D. ResponseEntity<String> is not a valid return type

Solution

1. Step 1: Analyze the request URL

   The URL "/api/users/" lacks a specific user ID, so the endpoint may not exist or return a list, not a single user.

2. Step 2: Understand the assertion failure cause

   Expecting status 200 for a missing user ID endpoint may cause a 404 error, failing the test.

3. Final Answer:

   The URL is missing a user ID, causing a 404 error -> Option A

4. Quick Check:

   Missing ID in URL causes 404, not 200 [OK]

Hint: Check URL completeness before asserting status [OK]

Common Mistakes:

• Assuming URL without ID returns 200
• Wrong assertion status code
• Thinking autowiring is the issue

5. You want to test a POST API endpoint /api/users that creates a user and returns HTTP 201 with the created user JSON. Which TestRestTemplate method and assertion combination correctly tests this?

hard

A. Use delete with user ID, then assert status 204

B. Use getForEntity with user ID, then assert status 200

C. Use exchange with GET method, then assert status 404

D. Use postForEntity with user object, then assert status 201 and response body contains user data

Solution

1. Step 1: Identify correct HTTP method for creation

   POST is used to create resources, so postForEntity is appropriate for sending the user object.

2. Step 2: Validate expected response and assertions

   The API returns 201 Created with user JSON, so assert status 201 and check response body contains user data.

3. Final Answer:

   Use postForEntity with user object, then assert status 201 and response body contains user data -> Option D

4. Quick Check:

   POST + postForEntity + assert 201 + check body [OK]

Hint: POST creation uses postForEntity and assert 201 [OK]

Common Mistakes:

• Using GET instead of POST for creation
• Asserting wrong status codes
• Ignoring response body validation