Async Http Client for Java and Scripting Language

Wri$ng Powerful HTTP Apps Using the New Asynchronous HTTP Client

Library

Jeanfrancois Arcand h@p://[email protected]/jfarcand

h@p://github.com/AsyncH@pClient/async-‐h@p-‐client

Hubert Iwaniuk h@p://[email protected]/neotyk

Jeanfrancois

Creator of the Grizzly Framework

Creator of GlassFish v3 Grizzly Micro

Kernel Creator and Co-‐

Leader of Atmosphere

9 years @ Sun Microsystem

Creator Async H@p Client

Major contributor to GlassFish

• News and Update • Why

• The Async H@p Client API • Conclusion • Q & A

Since released, we’ve got an impressive amount of

contribu$ons and adop$ons. Library is evolving fast!

Why

JDK’s UrlConnec$on Totally Broken

Why


Apache H@pClient high on steroid

Why



Apache H@p is blocking

Why




Apache H@pClient buffer the bytes in

memory

Why




Apache H@pClient buffer the bytes in

memory

Apache H@pClient is $ed to its own

I/O layer.

Why

AsyncH@pClient supports the “zero-‐copy”

Why


Large Upload using na$ve memory

Small memory

Why


AsyncH@pClient is not $ed to it’s

I/O layer

Why



I/O layer Ne@y

Grizzly

Apache H@pClient

JDK UrlConnec

$on

Why



I/O layer

AsyncH@pClient is blocking or non blocking

Why



I/O layer


Allow efficient streaming

Use the well know

Future<?> API

Why



I/O layer


AsyncH@pClient doesn’t buffer the bytes in memory

Why



I/O layer



Your applica$on have control

Why



I/O layer



AsyncH@pClient is easy to use

Fully Asynchronous

request

callback Response chunk

Calling Thread

callback Response chunk

Server Thread Pool (*)

Comple$onHandler

request

Response start

Calling Thread

callback Response end

Server Thread Pool (*)

Future based API AsyncH@pClient asyncH@pClient = new AsyncH@pClient();

Future<Response> f = [email protected]("h@p://www.sonatype.com/").execute();

Response r = f.get();

Handler based API AsyncH@pClient asyncH@pClient = new AsyncH@pClient(); Future<Response> asyncH@pClient. prepareGet("h@p://www.sonatype.com/").execute(

new AsyncComple=onHandler<Response>( { @Override public Response onCompleted(Response r){

return response; }

@Override public void onThrowable(Throwable t){

} });

Typed AsyncH@pClient asyncH@pClient = new AsyncH@pClient(); [email protected]("h@p://www.sonatype.com/").execute( new AsyncComple$onHandler<Integer>( { @Override public Integer onCompleted(Response r){ return response.getStatus(); }

@Override public void onThrowable(Throwable t){

} }).get(); // Return Integer

Request Builder

AsyncH@pClient c= new AsyncH@pClient();

c.preparePost(“h@ps://….”) .setBody(body) .setHeader(header) .setProxy(proxy) .execute();

Streaming Handler AsyncH@pClient c = new AsyncH@pClient(); Future<String> f = c.prepareGet("h@p://www.sonatype.com/").execute(

new AsyncHandler<String>() {

@Override public STATE onStatusReceived(H@pResponseStatus<String> status) throws Excep$on { // return STATE.ABORT to stop }

@Override public STATE onHeadersReceived(H@pResponseHeaders<String> headers) throws Excep$on { …}

@Override public STATE onBodyPartReceived(H@pResponseBodyPart<String> bodyPart) throws Excep$on {…} }.get();

Progress Handler Future<String> f = [email protected](uri) .setRealm(createRealm()) .setProxyServer(createProxyServer()) .setFile(file) .execute(comple$onHandler); ("….").setFile(.execute(

new AsyncComple=onHandler<String>() {

@Override public STATE onHeaderWriteCompleted() { return STATE.CONTINUE; }

@Override public STATE onContentWriteCompleted() { return STATE.CONTINUE; }

@Override public STATE onContentWriteProgess(long amount, long current, long total) { return STATE.CONTINUE; } )

Configurable AsyncH@pClientConfig c = new [email protected](). setResponseTimeoutInMs(30000).build();

AsyncH@pClient asyncH@pClient = new AsyncH@pClient(c);

Realm realm = new Realm.RealmBuilder() .setPrincipal(“me”) .setPassword(“xxxx”).build(); c.setRealm(realm);


Zero Copy -‐ Upload

AsyncH@pClient c= new AsyncH@pClient();

c.preparePost(“h@ps://….”) .setBody(body) .setFile(header) .setProxy(proxy).execute();

Zero Copy -‐ Download AsyncH@pClient c = new AsyncH@pClient(); Future<String> f = c.prepareGet("h@p://www.sonatype.com/").execute(

new AsyncHandler<String>() {

@Override public STATE onBodyPartReceived(H@pResponseBodyPart<String> bodyPart) throws Excep$on {

bodyPart.write(OutputStream); } }.get();

TLS Support

// Op$onal AsyncH@pClientConfig c = new [email protected](). setSSLEngine(…).build();


Future<String> f = c.prepareGet("hBps://….").get();

Scrip$ng Support -‐ Clojure

• (ns twi@er-‐stream (:require [[email protected] :as c] [org.danlarkin.json :as j] [clojure.contrib.logging :as l]))

(doseq [twit-‐str (c/string (c/stream-‐seq :get "h@p://[email protected]/1/statuses/sample.json" :auth {:user "u" :password "p"} :$meout -‐1))] (try (let [twit (j/decode-‐from-‐str twit-‐str)] (l/info (str (get-‐in twit [:user :screen_name]) "=>" (:text twit)))) (catch Excep$on e (l/warn (str "Failed to parse: " twit-‐str) e))))

Scrip$ng Support -‐ JRuby

client = [email protected] future = client.prepare_get("h@p://…")

.set_header("X-‐Trace", "true").execute

response = future.get

response.headers.each

{ |pair| puts "#{pair.key} =>

#{pair.value.join(", ")}" } client.close

Scrip$ng Support -‐ Jython

client = AsyncH@pClient() future = client.prepareGet("h@p://www.google.com/")

.setHeaders({ "User-‐Agent" : [ "Async HTTP Client/1.0.0" ]})

.execute()

response = future.get() for entry in response.headers: print '%s => %s' % (entry.key, ", ".join(entry.value)) client.close()

What’s Next

• NTLM support • Websocket support

• New Providers: – Grizzly 2.0 – Apache H@pClient

• H@p Pipelining • Annota$on based support.

Fancy @BaseURL("h@p://localhost:12345") public interface FooClient { @GET("/") public Future<Response> getRoot();

@GET("/") public Future<String> getRootAsString();

@GET("/") public Future<String> getRootWithParam(@QueryParam("name") String name); } FancyClientBuilder builder = new FancyClientBuilder(asyncClient); FooClient client = builder.build(FooClient.class);

Async Http Client for Java and Scripting Language

Technology

pclient asynch

pclient blocking

onal asynch

streaminghandler asynch

futurebasedapi asynch

handlerbasedapi asynch

typed asynch

congurable asynch