How-to on Garland — Java Integration Testing Framework

How to create test DTOs

Wed, 10 Jun 2026 00:00:00 +0000

Before writing pipeline tests you need test DTOs — classes that mirror your production types but are shaped for test use. This page explains what to create and why.

Step 1 — Locate the production DTO
#

Start in the service source. Find the DTO your endpoint accepts and returns:

// user-service/src/main/java/.../dto/UserDto.java
public record UserDto(
        UUID uuid,
        String name,
        String surname,
        AddressDto address,
        List<CarDto> cars,
        LocalDateTime createdAt,
        LocalDateTime modifiedAt
) {}

Note the field types — you will recreate this as a test DTO with the same fields but a different class form.

How to test HTTP endpoints with Garland

Wed, 10 Jun 2026 00:00:00 +0000

This page covers how to test HTTP endpoints with HttpTestClient — from a basic status assertion to auth failures and validation error checking. All examples are taken from garland-demo and run against the real stack — clone it to see them execute.

These examples assume test DTOs are already in place. If you are starting from scratch, read How to create test DTOs first.

Assert status and deserialize the response
#

The most common pattern. makeCall asserts the status code and deserializes the response body in one step:

How to test HTTP → PostgreSQL with Garland

Wed, 10 Jun 2026 00:00:00 +0000

This page walks through the full setup for asserting that an HTTP call persisted the correct data in PostgreSQL — from reading production classes through to a working pipeline test. All examples are taken from garland-demo; clone it to run them.

This guide assumes test DTOs are already set up. If not, read How to create test DTOs first.

Step 1 — Locate the entity
#

Find the JPA entity that maps to the table your service writes to:

How-to on Garland — Java Integration Testing Framework

How to create test DTOs

Step 1 — Locate the production DTO #

How to test HTTP endpoints with Garland

Assert status and deserialize the response #

How to test HTTP → PostgreSQL with Garland

Step 1 — Locate the entity #

Step 1 — Locate the production DTO
#

Assert status and deserialize the response
#

Step 1 — Locate the entity
#