reactor.io.net.http

Class HttpClient<IN,OUT>

java.lang.Object

reactor.io.net.ReactorPeer<IN,OUT,CONN>

reactor.io.net.ReactorClient<IN,OUT,HttpChannel<IN,OUT>>

reactor.io.net.http.HttpClient<IN,OUT>

Type Parameters:

IN - The type that will be received by this client

OUT - The type that will be sent by this client

Direct Known Subclasses:

NettyHttpClient

public abstract class HttpClient<IN,OUT>
extends ReactorClient<IN,OUT,HttpChannel<IN,OUT>>

The base class for a Reactor-based Http client.

Author:

Jon Brisbin, Stephane Maldini

Field Summary

Fields inherited from class reactor.io.net.ReactorClient

PING

Fields inherited from class reactor.io.net.ReactorPeer

started

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpClient(Environment env, Dispatcher dispatcher, Codec<Buffer,IN,OUT> codec, ClientSocketOptions options)

Method Summary

Modifier and Type	Method and Description
Promise<? extends HttpChannel<IN,OUT>>	delete(String url) HTTP DELETE the passed URL.
Promise<? extends HttpChannel<IN,OUT>>	delete(String url, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) HTTP DELETE the passed URL.
Promise<? extends HttpChannel<IN,OUT>>	get(String url) HTTP GET the passed URL.
Promise<? extends HttpChannel<IN,OUT>>	get(String url, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) HTTP GET the passed URL.
Promise<? extends HttpChannel<IN,OUT>>	post(String url, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) HTTP POST the passed URL.
Promise<? extends HttpChannel<IN,OUT>>	put(String url, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) HTTP PUT the passed URL.
abstract Promise<? extends HttpChannel<IN,OUT>>	request(Method method, String url, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) Use the passed HTTP method to send to the given URL.
Promise<? extends HttpChannel<IN,OUT>>	ws(String url) WebSocket to the passed URL.
Promise<? extends HttpChannel<IN,OUT>>	ws(String url, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) WebSocket to the passed URL.

Methods inherited from class reactor.io.net.ReactorClient

doStart, start

Methods inherited from class reactor.io.net.ReactorPeer

doShutdown, doStart, getDefaultCodec, getDefaultDispatcher, getDefaultEnvironment, getDefaultPrefetchSize, shutdown, start

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpClient

protected HttpClient(Environment env,
                     Dispatcher dispatcher,
                     Codec<Buffer,IN,OUT> codec,
                     ClientSocketOptions options)

Method Detail

get

public final Promise<? extends HttpChannel<IN,OUT>> get(String url,
                                                        ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

HTTP GET the passed URL. When connection has been made, the passed handler is invoked and can be used to build precisely the request and write data to it.

Parameters:

url - the target remote URL

handler - the ReactorChannelHandler to invoke on open channel

Returns:

a Promise of the HttpChannel ready to consume for response

get

public final Promise<? extends HttpChannel<IN,OUT>> get(String url)

HTTP GET the passed URL.

Parameters:

url - the target remote URL

Returns:

a Promise of the HttpChannel ready to consume for response

post

public final Promise<? extends HttpChannel<IN,OUT>> post(String url,
                                                         ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

HTTP POST the passed URL. When connection has been made, the passed handler is invoked and can be used to build precisely the request and write data to it.

Parameters:

url - the target remote URL

handler - the ReactorChannelHandler to invoke on open channel

Returns:

a Promise of the HttpChannel ready to consume for response

put

public final Promise<? extends HttpChannel<IN,OUT>> put(String url,
                                                        ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

HTTP PUT the passed URL. When connection has been made, the passed handler is invoked and can be used to build precisely the request and write data to it.

Parameters:

url - the target remote URL

handler - the ReactorChannelHandler to invoke on open channel

Returns:

a Promise of the HttpChannel ready to consume for response

delete

public final Promise<? extends HttpChannel<IN,OUT>> delete(String url,
                                                           ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

HTTP DELETE the passed URL. When connection has been made, the passed handler is invoked and can be used to build precisely the request and write data to it.

Parameters:

url - the target remote URL

handler - the ReactorChannelHandler to invoke on open channel

Returns:

a Promise of the HttpChannel ready to consume for response

delete

public final Promise<? extends HttpChannel<IN,OUT>> delete(String url)

HTTP DELETE the passed URL. When connection has been made, the passed handler is invoked and can be used to build precisely the request and write data to it.

Parameters:

url - the target remote URL

Returns:

a Promise of the HttpChannel ready to consume for response

ws

public final Promise<? extends HttpChannel<IN,OUT>> ws(String url)

WebSocket to the passed URL.

Parameters:

url - the target remote URL

Returns:

a Promise of the HttpChannel ready to consume for response

ws

public final Promise<? extends HttpChannel<IN,OUT>> ws(String url,
                                                       ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

WebSocket to the passed URL. When connection has been made, the passed handler is invoked and can be used to build precisely the request and write data to it.

Parameters:

url - the target remote URL

handler - the ReactorChannelHandler to invoke on open channel

Returns:

a Promise of the HttpChannel ready to consume for response

request

public abstract Promise<? extends HttpChannel<IN,OUT>> request(Method method,
                                                               String url,
                                                               ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

Use the passed HTTP method to send to the given URL. When connection has been made, the passed handler is invoked and can be used to build precisely the request and write data to it.

Parameters:

method - the HTTP method to send

url - the target remote URL

handler - the ReactorChannelHandler to invoke on open channel

Returns:

a Promise of the HttpChannel ready to consume for response