Docker Docs

Appearance

Fresh

Run tests ​

Back

Guides

Testing REST API integrations in Micronaut apps using WireMock

Learn how to create a Micronaut application that integrates with external REST APIs, then test those integrations using WireMock and the Testcontainers WireMock module.

Java Testing with Docker

20 minutes

1

Create the project

2

Write tests

3

Run tests

« Back to all guides

Run tests and next steps ​

Copy as Markdown

Open MarkdownAsk Docs AIClaudeOpen in Claude

Table of contents

Run the tests ​

console
$ ./mvnw test

Or with Gradle:

console
$ ./gradlew test

You should see the WireMock Docker container start in the console output. It acts as the photo service, serving mock responses based on the configured expectations. All tests should pass.

Summary ​

You built a Micronaut application that integrates with an external REST API using declarative HTTP clients, then tested that integration using WireMock and the Testcontainers WireMock module. Testing at the HTTP protocol level instead of mocking Java methods lets you catch serialization issues and simulate realistic failure scenarios.

Tip

Testcontainers WireMock modules are available for Go and Python as well.

To learn more about Testcontainers, visit the Testcontainers overview.

Further reading ​