A Java-based HTTP server that lets you locally test your HTTP client, retry logic, streaming behavior, timeouts, etc. with the endpoints of httpbin.org.
This way, you can write tests without relying on an external dependency like httpbin.org.
Java httpbin supports a subset of httpbin endpoints:
/ip
Returns Origin IP./user-agent
Returns user-agent./headers
Returns headers./delete
Returns DELETE data./get
Returns GET data./patch
Returns PATCH data./post
Returns POST data./put
Returns PUT data./anything
Returns anything passed in request data./status/:code
Returns given HTTP Status code./redirect/:n
302 Redirects n times./relative-redirect/:n
302 Redirects n times./absolute-redirect/:n
302 Absolute redirects n times./redirect-to?url=foo
302 Redirects to the foo URL./stream/:n
Streams n lines of JSON objects./stream-bytes/:n?chunkSize=c&seed=s
Streams n bytes./delay/:n
Delays responding for min(n, 10) seconds./bytes/:n
Generates n random bytes of binary data, accepts optional seed integer parameter./base64/:s
Returns a base64 decoded :s input/range/:s
Return a subset of data based on Content-range header./cookies
Returns the cookies./cookies/set?name=value
Sets one or more simple cookies./cookies/delete?name
Deletes one or more simple cookies./drip?numbytes=n&duration=s&delay=s&code=code
Drips data over a duration after an optional initial delay, then optionally returns with the given status code./cache
Returns 200 unless an If-Modified-Since or If-None-Match header is provided, when it returns a 304./cache/:n
Sets a Cache-Control header for n seconds./etag
Return 200 when If-Match or If-None-Match succeed./gzip
Returns gzip-encoded data./deflate
Returns deflate-encoded data./robots.txt
Returns some robots.txt rules./deny
Denied by robots.txt file./basic-auth/:user/:passwd
Challenges HTTP Basic Auth./hidden-basic-auth/:user/:passwd
Challenges HTTP Basic Auth and returns 404 on failure./html
Returns some HTML./xml
Returns some XML./image/png
Returns page containing a PNG image./image/jpeg
Returns page containing a JPEG image.
First add dependency to pom.xml
:
<dependency>
<groupId>org.gaul</groupId>
<artifactId>httpbin</artifactId>
<version>1.3.0</version>
</dependency>
Then add to your test code:
private URI httpBinEndpoint = URI.create("http://127.0.0.1:0");
private final HttpBin httpBin = new HttpBin(httpBinEndpoint);
@Before
public void setUp() throws Exception {
httpBin.start();
// reset endpoint to handle zero port
httpBinEndpoint = new URI(httpBinEndpoint.getScheme(),
httpBinEndpoint.getUserInfo(), httpBinEndpoint.getHost(),
httpBin.getPort(), httpBinEndpoint.getPath(),
httpBinEndpoint.getQuery(), httpBinEndpoint.getFragment());
}
@After
public void tearDown() throws Exception {
httpBin.stop();
}
@Test
public void test() throws Exception {
URI uri = URI.create(httpBinEndpoint + "/status/200");
HttpURLConnection conn = (HttpURLConnection) uri.toURL().openConnection();
assert conn.getResponseCode() == 200;
}
- httpbin - original Python implementation
- go-httpbin - Go reimplementation
Copyright (C) 2018-2019 Andrew Gaul
Copyright (C) 2015-2016 Bounce Storage
Licensed under the Apache License, Version 2.0