A Java native language binding for Hoverfly, a Go proxy which allows you to simulate http services in your unit tests. Another term for this is Service Virtualisation.
-
Simulation of http services
-
Strict or loose http request matching based on URL, method, body and header combinations
-
Fluent and expressive DSL for easy generation of simulated services
-
Automatic marshalling of objects into JSON during request / response body generation
-
Create simulations by running in capture mode
-
Hoverfly is a proxy, so you don’t need to alter the host that you make requests to
-
Multiple hosts / services per single instance of Hoverfly
-
Https automatically supported, no extra configuration required
-
Interoperable with standard Hoverfly json, making it easy to re-use data between Java and other bindings.
Full documentation is available here
<dependency>
<groupId>io.specto</groupId>
<artifactId>hoverfly-java</artifactId>
<version>0.3.6</version>
<scope>test</scope>
</dependency>// Capture and output HTTP traffic to json file
@ClassRule
public static HoverflyRule hoverflyRule = HoverflyRule.inCaptureMode("simulation.json");
// After the capturing, switch to inSimulationMode to spin up a stub server
@ClassRule
public static HoverflyRule hoverflyRule = HoverflyRule.inSimulationMode(classpath("simulation.json"));
// Or you can use both approaches at once. If json file not present in capture mode, if present in simulation mode
@ClassRule
public static HoverflyRule hoverflyRule = HoverflyRule.inCaptureOrSimulationMode("simulation.json");@ClassRule
public static HoverflyRule hoverflyRule = HoverflyRule.inSimulateMode(dsl(
service("www.my-test.com")
.get("/api/bookings/1")
.willReturn(success(json(new Booking(1))))
));
@Test
public void shouldBeAbleToGetABookingUsingHoverfly() {
// When
final ResponseEntity<String> getBookingResponse = restTemplate.getForEntity("http://www.my-test.com/api/bookings/1", String.class);
// Then
assertThat(getBookingResponse.getStatusCode()).isEqualTo(OK);
assertThatJSON(getBookingResponse.getBody()).isEqualTo("{"\"bookingId\":\"1\"}");
}Contributions are welcome!
To submit a pull request you should fork the Hoverfly-Java repository, and make your change on a feature branch of your fork.