Slack logo Need help? Join the WireMock community Slack

Automated Testing with Java

Everything that can be done with WireMock Studio’s web UI can also be done via its APIs. This can be useful when automating testing, as it allows stubs to be configured and torn down on-demand by individual test cases rather than it being necessary to configure an entire test suite’s stubs manually up-front. Working this way can make your tests a lot more readable as it makes their preconditions expicit.

WireMock Studio’s API is 100% compatible with WireMock’s. This means that WireMock can be used as a Java client for WireMock Studio.


To follow this guide you first need to add WireMock open source as a dependency to your project. See the download and installation page for details on how to do this.

Configuring your test

After you’ve created a mock API in the WireMock Studio UI, setting up a WireMock client to it is a one-line task (you can copy-paste this from your mock API’s Settings page). Use the port number you allocated when creating the mock API (which you can also find on the top bar in the base URL):

WireMock paymentGatewayMock = new WireMock("localhost", 8000);

Then in your test cases you can create stubs as documented here:


And make assertions about received requests:


Programmatic stub creation

The same approach can be taken if you want to create stubs in your API programmatically. This can be useful when you require a large number of stubs and don’t want to create them all by hand.

The example in the previous section creates an ephemeral stub i.e. one that isn’t stored persistently and will be deleted when the API is reset. To ensure that stubs created programmatically are saved, simply call persistent() during creation:

    .willReturn(ok("Some body content"))

Further reading

You can see a more detailed example of this kind of test automation in action in the MockLab demo app.