JarCastingMule WireMock Module
When writing integration software for distributed systems the most critical part to test is the interaction between those systems. Obviously this makes integration tests vital. Traditionally we would test against live systems, but having a local instance of an upstream system or a dedicated test instance can be expensive and/or difficult to coordinate its state between tests.
Instead we can opt to verify the interactions against test doubles, also known as narrow integration tests. WireMock is a simulator for HTTP-based APIs that allows us to spin up a HTTP server and configure stubbed responses for particular requests.
With the Mule WireMock Module we can spin up an in-process HTTP Server and run our integration tests against it. WireMock gives us a couple of advantages over MUnit's 'Mock When' processor:
- We're actually sending requests over the wire so we get the confidence that HTTP Requester configuration and subsequent processors are correct.
- WireMock supports conditional responses based on scenarios, this way we can more easily test behavior that changes the external system's state as it executes.
- With an actual HTTP Server serving requests it's simpler to implement your application if the real services are not yet available or it's difficult to control their state.
Resources worth checking out:
WireMock Key Features
- HTTP response stubbing, matchable on URL, header and body content patterns
- Request verification
- Fault injection
- Stateful behaviour simulation
- Configurable response delays
Full documentation can be found at wiremock.org
Using the connector
Add this dependency to your application pom.xml
<dependency>
<groupId>com.ms3-inc.mule</groupId>
<artifactId>mule-wiremock-module</artifactId>
<version>0.5.0</version>
<classifier>mule-plugin</classifier>
</dependency>
See the module's own MUnit integration test for a complete and commented example on how to use the connector.
For more details on verifying requests and stubbing responses, see WireMock Stubbing, WireMock Verifying, and WireMock RequestMatching
