Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
123 lines (106 sloc) 5.94 KB
layout title permalink comments github excerpt
Java 9: High level HTTP and WebSocket API
Although the flagship feature of Java 9 is Modularity, a large number of other enhancements are planned for this release. One of those is the new HTTP client API ...

Update (13 July 2017)

The new HTTP Client will be shipped with Java 9 but as part of an Incubator module named jdk.incubator.httpclient. Incubator modules are a means of putting non-final APIs in the hands of developers while the APIs progress towards either finalization or removal in a future release.


Although the flagship feature of Java 9 is Modularity, a large number of other enhancements are planned for this release. One of those is the new HTTP client API which supports HTTP/2 and WebSocket and, hopefully, will replace the legacy HttpUrlConnection API, the low level and painful API. If you're wondering why that API was such a pain, consider reading this post on stackoverflow.
This new API is part of the java.httpclient jdk.incubator.httpclient module. So, if you're going to use this module, you should declare that your module requires the jdk.incubator.httpclient module. To do so, add the following to your file:
{% highlight java %} module me.alidg { // Other declarations // requires java.httpclient; requires jdk.incubator.httpclient; } {% endhighlight %}


First off, we should prepare the HTTP request. HttpRequest can be used to represent an HTTP request which can be sent to a server. In order to build a HttpRequest, use the create static factory method:
{% highlight java %} HttpRequest request = HttpRequest .create(new URI("")) .GET(); {% endhighlight %}

Then send the GET request and block until a response comes back:
{% highlight java %} HttpResponse response = request.response(); System.out.println(response.statusCode()); System.out.println(response.body(HttpResponse.asString())); {% endhighlight %}

What about POST requests? The following snippet would send a POST request to some API with a JSON request body, expecting a JSON response with a 500 milliseconds timeout:
{% highlight java %} HttpRequest.create(new URI("http://some-api")) .header("Accept", "application/json") .header("Content-Type", "application/json") .timeout(TimeUnit.MILLISECONDS, 500) .body(HttpRequest.fromString(someJsonString)) .POST(); {% endhighlight %}

There is a PUT() method for, well, PUT requests and method(String methodName) for others. Also HttpRequest provides an responseAsync method which returns an instance of CompletableFuture<HttpResponse>. Using this method one can simply compose and combine multiple HttpResponsees, react when the HttpResponse is available or even transform it to whatever she likes, all in a very declarative way:
{% highlight java %} /* Two web targets to consume asynchronously. List.of is part of Java 9, too. */ List targets = List.of( new URI(""), new URI("") );

/* Send two requests asynchronously, read the body in async fashion and print the body when it's available */ CompletableFuture[] futures = .map(uri -> HttpRequest.create(uri).GET().responseAsync()) .map(f -> f.thenCompose(r -> r.bodyAsync(HttpResponse.asString()))) .map(f -> f.thenAccept(System.out::println)) .toArray(CompletableFuture[]::new);

/* Wait until all are done */ CompletableFuture.allOf(futures).join(); {% endhighlight %}

WebSocket Client API

jdk.incubator.httpclient module also contains a client for WebSocket. WebScoket interface is the heart of this new addition which contains four other abstractions to build, represent close codes, listen for events and messages and finally, handling partial messages.
For starters, we could implement the WebSocket.Listener interface, which, as its name suggests, is a listener for events and messages on a WebSocket. For example, here after receiving each message, we're sending a request for one more message and then printing the current message on console:
{% highlight java %} class EchoListener implements WebSocket.Listener { @Override public CompletionStage<?> onText(WebSocket webSocket, CharSequence message, WebSocket.MessagePart part) { // Gimme one more webSocket.request(1);

    // Print the message when it's available
    return CompletableFuture.completedFuture(message)

} {% endhighlight %}

Then using the newBuilder static factory method we can connect to the WebSocket API and continuously consume incoming messags:
{% highlight java %} WebSocket.newBuilder(new URI("ws://"), new EchoListener()).buildAsync().join(); {% endhighlight %}


The upcoming release of Java will be shipped with a new HTTP Client which is going to cover numerous problems of the existing HttpURLConnection API. For more details on its motivation and goals, checkout the original proposal here. The early access javadocs contains more technical information about the API itself, which is available at here. And last but not least, you can experiment with the API using the Java 9 early access builds, have fun!