http-test-server

A very simple http server that returns responses in order that you specify (especially for unit testing).

Status: deployed to Maven Central

try (Server server = 
    Server.start()
          .response() // default is status 200, no body, no headers
          .response() 
              .header("Accept", "application/json")
              .body("{}")
              .statusCode(201)
          .response()
              .body("an error occurred")
              .statusCode(500)
          .add()) {
    URL url = new URL(server.baseUrl() + "thing?state=joy");
    // hit the url a couple of times and do your asserts
}

Note that Content-Length header is automatically returned in a response if not present already.

Getting started

Add this dependency to your pom.xml:

<dependency>
  <groupId>com.github.davidmoten</groupId>
  <artifactId>http-test-server</artifactId>
  <version>VERSION_HERE</version>
</dependency>

Demonstration

Run

mvn exec:java

and you will see a line of output like

http://127.0.0.1:40027/

Copy that url to a browser like Chrome and you will see the word "sometimes". Refresh the browser and you will see "something else", then "hi there". Hit refresh again and the page will sit loading forever because there is no response on the queue for that request. If you use the Inspect function in Chrome you will see the response headers set by the code for this session.

The code we are running is ServerMain.java.