Package io.vertx.reactivex.core.http

Class HttpClient

java.lang.Object

io.vertx.reactivex.core.http.HttpClient

All Implemented Interfaces:

RxDelegate, Measured

public class HttpClient
extends Object
implements RxDelegate, Measured

An asynchronous HTTP client.

It allows you to make requests to HTTP servers, and a single client can make requests to any server.

This gives the benefits of keep alive when the client is loaded but means we don't keep connections hanging around unnecessarily when there would be no benefits anyway.

The client is designed to be reused between requests.

NOTE: This class has been automatically generated from the original non RX-ified interface using Vert.x codegen.

Field Summary

Fields

Modifier and Type	Field	Description
static TypeArg<HttpClient>	__TYPE_ARG

Constructor Summary

Constructors

Constructor	Description
HttpClient(HttpClient delegate)
HttpClient(Object delegate)

Method Summary

Modifier and Type	Method	Description
void	close()	Close the client.
void	close(Handler<AsyncResult<Void>> handler)	Close the client.
HttpClient	connectionHandler(Handler<HttpConnection> handler)	Deprecated.
boolean	equals(Object o)
HttpClient	getDelegate()
int	hashCode()
boolean	isMetricsEnabled()	Whether the metrics are enabled for this measured object
static HttpClient	newInstance(HttpClient arg)
HttpClient	redirectHandler(io.reactivex.functions.Function<HttpClientResponse,io.reactivex.Single<RequestOptions>> handler)	Deprecated.
HttpClient	redirectHandler(Function<HttpClientResponse,Future<RequestOptions>> handler)	Deprecated.
void	request(HttpMethod method, int port, String host, String requestURI)	Create an HTTP request to send to the server at the host and port.
void	request(HttpMethod method, int port, String host, String requestURI, Handler<AsyncResult<HttpClientRequest>> handler)	Create an HTTP request to send to the server at the host and port.
void	request(HttpMethod method, String requestURI)	Create an HTTP request to send to the server at the default host and port.
void	request(HttpMethod method, String requestURI, Handler<AsyncResult<HttpClientRequest>> handler)	Create an HTTP request to send to the server at the default host and port.
void	request(HttpMethod method, String host, String requestURI)	Create an HTTP request to send to the server at the host and default port.
void	request(HttpMethod method, String host, String requestURI, Handler<AsyncResult<HttpClientRequest>> handler)	Create an HTTP request to send to the server at the host and default port.
void	request(RequestOptions options)	Create an HTTP request to send to the server.
void	request(RequestOptions options, Handler<AsyncResult<HttpClientRequest>> handler)	Create an HTTP request to send to the server.
io.reactivex.Completable	rxClose()	Close the client.
io.reactivex.Single<HttpClientRequest>	rxRequest(HttpMethod method, int port, String host, String requestURI)	Create an HTTP request to send to the server at the host and port.
io.reactivex.Single<HttpClientRequest>	rxRequest(HttpMethod method, String requestURI)	Create an HTTP request to send to the server at the default host and port.
io.reactivex.Single<HttpClientRequest>	rxRequest(HttpMethod method, String host, String requestURI)	Create an HTTP request to send to the server at the host and default port.
io.reactivex.Single<HttpClientRequest>	rxRequest(RequestOptions options)	Create an HTTP request to send to the server.
io.reactivex.Single<Boolean>	rxUpdateSSLOptions(SSLOptions options)	Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).
io.reactivex.Single<Boolean>	rxUpdateSSLOptions(SSLOptions options, boolean force)	Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).
io.reactivex.Single<WebSocket>	rxWebSocket(int port, String host, String requestURI)	Deprecated.
io.reactivex.Single<WebSocket>	rxWebSocket(WebSocketConnectOptions options)	Deprecated.
io.reactivex.Single<WebSocket>	rxWebSocket(String requestURI)	Deprecated.
io.reactivex.Single<WebSocket>	rxWebSocket(String host, String requestURI)	Deprecated.
io.reactivex.Single<WebSocket>	rxWebSocketAbs(String url, MultiMap headers, WebsocketVersion version, List<String> subProtocols)	Deprecated.
String	toString()
void	updateSSLOptions(SSLOptions options)	Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).
void	updateSSLOptions(SSLOptions options, boolean force)	Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).
void	updateSSLOptions(SSLOptions options, boolean force, Handler<AsyncResult<Boolean>> handler)	Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).
void	updateSSLOptions(SSLOptions options, Handler<AsyncResult<Boolean>> handler)	Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).
void	webSocket(int port, String host, String requestURI)	Deprecated.
void	webSocket(int port, String host, String requestURI, Handler<AsyncResult<WebSocket>> handler)	Deprecated.
void	webSocket(WebSocketConnectOptions options)	Deprecated.
void	webSocket(WebSocketConnectOptions options, Handler<AsyncResult<WebSocket>> handler)	Deprecated.
void	webSocket(String requestURI)	Deprecated.
void	webSocket(String requestURI, Handler<AsyncResult<WebSocket>> handler)	Deprecated.
void	webSocket(String host, String requestURI)	Deprecated.
void	webSocket(String host, String requestURI, Handler<AsyncResult<WebSocket>> handler)	Deprecated.
void	webSocketAbs(String url, MultiMap headers, WebsocketVersion version, List<String> subProtocols)	Deprecated.
void	webSocketAbs(String url, MultiMap headers, WebsocketVersion version, List<String> subProtocols, Handler<AsyncResult<WebSocket>> handler)	Deprecated.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

__TYPE_ARG

public static final TypeArg<HttpClient> __TYPE_ARG

Constructor Detail

HttpClient

public HttpClient(HttpClient delegate)

HttpClient

public HttpClient(Object delegate)

Method Detail

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getDelegate

public HttpClient getDelegate()

Specified by:

getDelegate in interface Measured

Specified by:

getDelegate in interface RxDelegate

isMetricsEnabled

public boolean isMetricsEnabled()

Whether the metrics are enabled for this measured object

Specified by:

isMetricsEnabled in interface Measured

Returns:

true if metrics are enabled

request

public void request(RequestOptions options,
                    Handler<AsyncResult<HttpClientRequest>> handler)

Create an HTTP request to send to the server. The handler is called when the request is ready to be sent.

Parameters:

options - the request options

handler - the handler called when the request is ready to be sent

request

public void request(RequestOptions options)

Create an HTTP request to send to the server. The handler is called when the request is ready to be sent.

Parameters:

options - the request options

rxRequest

public io.reactivex.Single<HttpClientRequest> rxRequest(RequestOptions options)

Create an HTTP request to send to the server. The handler is called when the request is ready to be sent.

Parameters:

options - the request options

Returns:

request

public void request(HttpMethod method,
                    int port,
                    String host,
                    String requestURI,
                    Handler<AsyncResult<HttpClientRequest>> handler)

Create an HTTP request to send to the server at the host and port. The handler is called when the request is ready to be sent.

Parameters:

method - the HTTP method

port - the port

host - the host

requestURI - the relative URI

handler - the handler called when the request is ready to be sent

request

public void request(HttpMethod method,
                    int port,
                    String host,
                    String requestURI)

Create an HTTP request to send to the server at the host and port. The handler is called when the request is ready to be sent.

Parameters:

method - the HTTP method

port - the port

host - the host

requestURI - the relative URI

rxRequest

public io.reactivex.Single<HttpClientRequest> rxRequest(HttpMethod method,
                                                        int port,
                                                        String host,
                                                        String requestURI)

Create an HTTP request to send to the server at the host and port. The handler is called when the request is ready to be sent.

Parameters:

method - the HTTP method

port - the port

host - the host

requestURI - the relative URI

Returns:

request

public void request(HttpMethod method,
                    String host,
                    String requestURI,
                    Handler<AsyncResult<HttpClientRequest>> handler)

Create an HTTP request to send to the server at the host and default port. The handler is called when the request is ready to be sent.

Parameters:

method - the HTTP method

host - the host

requestURI - the relative URI

handler - the handler called when the request is ready to be sent

request

public void request(HttpMethod method,
                    String host,
                    String requestURI)

Create an HTTP request to send to the server at the host and default port. The handler is called when the request is ready to be sent.

Parameters:

method - the HTTP method

host - the host

requestURI - the relative URI

rxRequest

public io.reactivex.Single<HttpClientRequest> rxRequest(HttpMethod method,
                                                        String host,
                                                        String requestURI)

Create an HTTP request to send to the server at the host and default port. The handler is called when the request is ready to be sent.

Parameters:

method - the HTTP method

host - the host

requestURI - the relative URI

Returns:

request

public void request(HttpMethod method,
                    String requestURI,
                    Handler<AsyncResult<HttpClientRequest>> handler)

Create an HTTP request to send to the server at the default host and port. The handler is called when the request is ready to be sent.

Parameters:

method - the HTTP method

requestURI - the relative URI

handler - the handler called when the request is ready to be sent

request

public void request(HttpMethod method,
                    String requestURI)

Create an HTTP request to send to the server at the default host and port. The handler is called when the request is ready to be sent.

Parameters:

method - the HTTP method

requestURI - the relative URI

rxRequest

public io.reactivex.Single<HttpClientRequest> rxRequest(HttpMethod method,
                                                        String requestURI)

Create an HTTP request to send to the server at the default host and port. The handler is called when the request is ready to be sent.

Parameters:

method - the HTTP method

requestURI - the relative URI

Returns:

webSocket

@Deprecated
public void webSocket(int port,
                      String host,
                      String requestURI,
                      Handler<AsyncResult<WebSocket>> handler)

Deprecated.

Connect a WebSocket to the specified port, host and relative request URI

Parameters:

port - the port

host - the host

requestURI - the relative URI

handler - handler that will be called with the WebSocket when connected

webSocket

@Deprecated
public void webSocket(int port,
                      String host,
                      String requestURI)

Deprecated.

Connect a WebSocket to the specified port, host and relative request URI

Parameters:

port - the port

host - the host

requestURI - the relative URI

rxWebSocket

@Deprecated
public io.reactivex.Single<WebSocket> rxWebSocket(int port,
                                                  String host,
                                                  String requestURI)

Deprecated.

Connect a WebSocket to the specified port, host and relative request URI

Parameters:

port - the port

host - the host

requestURI - the relative URI

Returns:

webSocket

@Deprecated
public void webSocket(String host,
                      String requestURI,
                      Handler<AsyncResult<WebSocket>> handler)

Deprecated.

Connect a WebSocket to the host and relative request URI and default port

Parameters:

host - the host

requestURI - the relative URI

handler - handler that will be called with the WebSocket when connected

webSocket

@Deprecated
public void webSocket(String host,
                      String requestURI)

Deprecated.

Connect a WebSocket to the host and relative request URI and default port

Parameters:

host - the host

requestURI - the relative URI

rxWebSocket

@Deprecated
public io.reactivex.Single<WebSocket> rxWebSocket(String host,
                                                  String requestURI)

Deprecated.

Connect a WebSocket to the host and relative request URI and default port

Parameters:

host - the host

requestURI - the relative URI

Returns:

webSocket

@Deprecated
public void webSocket(String requestURI,
                      Handler<AsyncResult<WebSocket>> handler)

Deprecated.

Connect a WebSocket at the relative request URI using the default host and port

Parameters:

requestURI - the relative URI

handler - handler that will be called with the WebSocket when connected

webSocket

@Deprecated
public void webSocket(String requestURI)

Deprecated.

Connect a WebSocket at the relative request URI using the default host and port

Parameters:

requestURI - the relative URI

rxWebSocket

@Deprecated
public io.reactivex.Single<WebSocket> rxWebSocket(String requestURI)

Deprecated.

Connect a WebSocket at the relative request URI using the default host and port

Parameters:

requestURI - the relative URI

Returns:

webSocket

@Deprecated
public void webSocket(WebSocketConnectOptions options,
                      Handler<AsyncResult<WebSocket>> handler)

Deprecated.

Connect a WebSocket with the specified options.

Parameters:

options - the request options

handler -

webSocket

@Deprecated
public void webSocket(WebSocketConnectOptions options)

Deprecated.

Connect a WebSocket with the specified options.

Parameters:

options - the request options

rxWebSocket

@Deprecated
public io.reactivex.Single<WebSocket> rxWebSocket(WebSocketConnectOptions options)

Deprecated.

Connect a WebSocket with the specified options.

Parameters:

options - the request options

Returns:

webSocketAbs

@Deprecated
public void webSocketAbs(String url,
                         MultiMap headers,
                         WebsocketVersion version,
                         List<String> subProtocols,
                         Handler<AsyncResult<WebSocket>> handler)

Deprecated.

Connect a WebSocket with the specified absolute url, with the specified headers, using the specified version of WebSockets, and the specified WebSocket sub protocols.

Parameters:

url - the absolute url

headers - the headers

version - the WebSocket version

subProtocols - the subprotocols to use

handler - handler that will be called if WebSocket connection fails

webSocketAbs

@Deprecated
public void webSocketAbs(String url,
                         MultiMap headers,
                         WebsocketVersion version,
                         List<String> subProtocols)

Deprecated.

Connect a WebSocket with the specified absolute url, with the specified headers, using the specified version of WebSockets, and the specified WebSocket sub protocols.

Parameters:

url - the absolute url

headers - the headers

version - the WebSocket version

subProtocols - the subprotocols to use

rxWebSocketAbs

@Deprecated
public io.reactivex.Single<WebSocket> rxWebSocketAbs(String url,
                                                     MultiMap headers,
                                                     WebsocketVersion version,
                                                     List<String> subProtocols)

Deprecated.

Connect a WebSocket with the specified absolute url, with the specified headers, using the specified version of WebSockets, and the specified WebSocket sub protocols.

Parameters:

url - the absolute url

headers - the headers

version - the WebSocket version

subProtocols - the subprotocols to use

Returns:

updateSSLOptions

public void updateSSLOptions(SSLOptions options,
                             Handler<AsyncResult<Boolean>> handler)

Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).

Parameters:

options - the new SSL options

handler - the update handler

updateSSLOptions

public void updateSSLOptions(SSLOptions options)

Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).

Parameters:

options - the new SSL options

rxUpdateSSLOptions

public io.reactivex.Single<Boolean> rxUpdateSSLOptions(SSLOptions options)

Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).

Parameters:

options - the new SSL options

Returns:

updateSSLOptions

public void updateSSLOptions(SSLOptions options,
                             boolean force,
                             Handler<AsyncResult<Boolean>> handler)

Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).

Parameters:

options - the new SSL options

force - force the update when options are equals

handler - the update handler

updateSSLOptions

public void updateSSLOptions(SSLOptions options,
                             boolean force)

Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).

Parameters:

options - the new SSL options

force - force the update when options are equals

rxUpdateSSLOptions

public io.reactivex.Single<Boolean> rxUpdateSSLOptions(SSLOptions options,
                                                       boolean force)

Like updateSSLOptions(io.vertx.core.net.SSLOptions, io.vertx.core.Handler<io.vertx.core.AsyncResult<java.lang.Boolean>>) but supplying a handler that will be called when the update happened (or has failed).

Parameters:

options - the new SSL options

force - force the update when options are equals

Returns:

connectionHandler

@Deprecated
public HttpClient connectionHandler(Handler<HttpConnection> handler)

Deprecated.

Set a connection handler for the client. This handler is called when a new connection is established.

Parameters:

handler -

Returns:

a reference to this, so the API can be used fluently

redirectHandler

@Deprecated
public HttpClient redirectHandler(Function<HttpClientResponse,Future<RequestOptions>> handler)

Deprecated.

Set a redirect handler for the http client.

The redirect handler is called when a 3xx response is received and the request is configured to follow redirects with HttpClientRequest.setFollowRedirects(boolean).

The redirect handler is passed the HttpClientResponse, it can return an HttpClientRequest or null.

• when null is returned, the original response is processed by the original request response handler
• when a new Future is returned, the client will send this new request

The new request will get a copy of the previous request headers unless headers are set. In this case, the client assumes that the redirect handler exclusively managers the headers of the new request.

The handler must return a Future unsent so the client can further configure it and send it.

Parameters:

handler - the new redirect handler

Returns:

a reference to this, so the API can be used fluently

redirectHandler

@Deprecated
public HttpClient redirectHandler(io.reactivex.functions.Function<HttpClientResponse,io.reactivex.Single<RequestOptions>> handler)

Deprecated.

Set a redirect handler for the http client.

The redirect handler is called when a 3xx response is received and the request is configured to follow redirects with HttpClientRequest.setFollowRedirects(boolean).

The redirect handler is passed the HttpClientResponse, it can return an HttpClientRequest or null.

• when null is returned, the original response is processed by the original request response handler
• when a new Future is returned, the client will send this new request

The new request will get a copy of the previous request headers unless headers are set. In this case, the client assumes that the redirect handler exclusively managers the headers of the new request.

The handler must return a Future unsent so the client can further configure it and send it.

Parameters:

handler - the new redirect handler

Returns:

a reference to this, so the API can be used fluently

close

public void close(Handler<AsyncResult<Void>> handler)

Close the client. Closing will close down any pooled connections. Clients should always be closed after use.

Parameters:

handler -

close

public void close()

Close the client. Closing will close down any pooled connections. Clients should always be closed after use.

rxClose

public io.reactivex.Completable rxClose()

Close the client. Closing will close down any pooled connections. Clients should always be closed after use.

Returns:

newInstance

public static HttpClient newInstance(HttpClient arg)