Mockwebserver Player ![Circle CI](https://camo.githubusercontent.com/bfa65e9c80e34c3aa7786d04f613d2d4d9d27e5cc54f9998ae65416d1f2656af/68747470733a2f2f636972636c6563692e636f6d2f67682f726f647269676f736169746f2f6d6f636b7765627365727665722d706c617965722e7376673f7374796c653d737667)
Mockwebserver Player is a tool to simplify the use of mockwebserver in your JUnit tests
Motivation
When returning large responses such as JSON/XML it could be really boring to write all the code to prepare your MockResponses this project makes it easier to write your tests.
Usage
Installation
Add dependency to your pom.xml.
<dependency>
<groupId>com.github.rodrigosaito</groupId>
<artifactId>mockwebserver-player</artifactId>
<version>1.1.0</version>
</dependency>
Simple response
Add a @Rule Player
property to your test class.
Annotate your test methods with @Play("simple_play")
where simple_play
is the name of the file containing the MockResponse attributes.
@Rule
public Player player = new Player();
@Test
@Play("simple_play")
public void testPlayerWithDefaultSettings() throws IOException {
URL url = player.getURL("/");
// Execute your application code that makes the request to mockwebserver
CloseableHttpResponse response = executeGet(url.toString());
String body = EntityUtils.toString(response.getEntity());
int statusCode = response.getStatusLine().getStatusCode();
assertEquals("Simple Tape", body);
assertEquals(200, statusCode);
}
Create a plays/simple_play.yaml
file inside your test directory.
!play
name: simple play
interactions:
- response:
status: 200
headers:
body: Simple Tape
Request Matching
Sometime you would like to match a request with a response in this case we have the following tape that will matches the request with path /test_1
with the response containing body Test 1
and request with path /test_2
with the response containing body Test 2
.
If you add headers
or body
to request it will use them on matching as well.
!play
name: play with request matching
interactions:
- request:
method: GET
uri: /test_1
headers:
Host: localhost
response:
status: 200
headers:
body: Test 1
- request:
method: GET
uri: /test_2
headers:
Host: localhost
response:
status: 200
body: Test 2
And the test.
@Test
@Play("play_with_request_matching")
public void test() throws IOException {
// Execute request that matches with the second request on tape
URL url2 = player.getURL("/test_2");
CloseableHttpResponse response2 = executeGet(url2.toString());
assertEquals("Test 2", EntityUtils.toString(response2.getEntity()));
// Execute request that matches with the first request on tape
URL url1 = player.getURL("/test_1");
CloseableHttpResponse response1 = executeGet(url1.toString());
assertEquals("Test 1", EntityUtils.toString(response1.getEntity()));
}
Custom Settings
player.setPort(58880); // changes the port of mockwebserver default is a random port