HttpClient (Vert.x Core 3.6.2 API)

All Superinterfaces:

Measured
```
public interface HttpClient
extends Measured
```
An asynchronous HTTP client.
It allows you to make requests to HTTP servers, and a single client can make requests to any server.
It also allows you to open WebSockets to servers.
The client can also pool HTTP connections.
For pooling to occur, keep-alive must be true on the HttpClientOptions (default is true). In this case connections will be pooled and re-used if there are pending HTTP requests waiting to get a connection, otherwise they will be closed.
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 also supports pipe-lining of requests. Pipe-lining means another request is sent on the same connection before the response from the preceding one has returned. Pipe-lining is not appropriate for all requests.
To enable pipe-lining, it must be enabled on the HttpClientOptions (default is false).
When pipe-lining is enabled the connection will be automatically closed when all in-flight responses have returned and there are no outstanding pending requests to write.
The client is designed to be reused between requests.

Author:

Tim Fox

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`close()` Close the client.
`HttpClient`	`connectionHandler(Handler<HttpConnection> handler)` Set a connection handler for the client.
`HttpClientRequest`	`delete(int port, String host, String requestURI)` Create an HTTP DELETE request to send to the server at the specified host and port.
`HttpClientRequest`	`delete(int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`delete(RequestOptions options)` Create an HTTP DELETE request to send to the server with the specified options.
`HttpClientRequest`	`delete(RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`delete(String requestURI)` Create an HTTP DELETE request to send to the server at the default host and port.
`HttpClientRequest`	`delete(String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`delete(String host, String requestURI)` Create an HTTP DELETE request to send to the server at the specified host and default port.
`HttpClientRequest`	`delete(String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`deleteAbs(String absoluteURI)` Create an HTTP DELETE request to send to the server using an absolute URI
`HttpClientRequest`	`deleteAbs(String absoluteURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`get(int port, String host, String requestURI)` Create an HTTP GET request to send to the server at the specified host and port.
`HttpClientRequest`	`get(int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`get(RequestOptions options)` Create an HTTP GET request to send to the server with the specified options.
`HttpClientRequest`	`get(RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`get(String requestURI)` Create an HTTP GET request to send to the server at the default host and port.
`HttpClientRequest`	`get(String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`get(String host, String requestURI)` Create an HTTP GET request to send to the server at the specified host and default port.
`HttpClientRequest`	`get(String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`getAbs(String absoluteURI)` Create an HTTP GET request to send to the server using an absolute URI
`HttpClientRequest`	`getAbs(String absoluteURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`getNow(int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`getNow(RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`getNow(String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`getNow(String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`head(int port, String host, String requestURI)` Create an HTTP HEAD request to send to the server at the specified host and port.
`HttpClientRequest`	`head(int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`head(RequestOptions options)` Create an HTTP HEAD request to send to the server with the specified options.
`HttpClientRequest`	`head(RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`head(String requestURI)` Create an HTTP HEAD request to send to the server at the default host and port.
`HttpClientRequest`	`head(String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`head(String host, String requestURI)` Create an HTTP HEAD request to send to the server at the specified host and default port.
`HttpClientRequest`	`head(String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`headAbs(String absoluteURI)` Create an HTTP HEAD request to send to the server using an absolute URI
`HttpClientRequest`	`headAbs(String absoluteURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`headNow(int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`headNow(RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`headNow(String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`headNow(String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`options(int port, String host, String requestURI)` Create an HTTP OPTIONS request to send to the server at the specified host and port.
`HttpClientRequest`	`options(int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`options(RequestOptions options)` Create an HTTP OPTIONS request to send to the server with the specified options.
`HttpClientRequest`	`options(RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`options(String requestURI)` Create an HTTP OPTIONS request to send to the server at the default host and port.
`HttpClientRequest`	`options(String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`options(String host, String requestURI)` Create an HTTP OPTIONS request to send to the server at the specified host and default port.
`HttpClientRequest`	`options(String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`optionsAbs(String absoluteURI)` Create an HTTP OPTIONS request to send to the server using an absolute URI
`HttpClientRequest`	`optionsAbs(String absoluteURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`optionsNow(int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`optionsNow(RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`optionsNow(String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`optionsNow(String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`post(int port, String host, String requestURI)` Create an HTTP POST request to send to the server at the specified host and port.
`HttpClientRequest`	`post(int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`post(RequestOptions options)` Create an HTTP POST request to send to the server with the specified options.
`HttpClientRequest`	`post(RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`post(String requestURI)` Create an HTTP POST request to send to the server at the default host and port.
`HttpClientRequest`	`post(String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`post(String host, String requestURI)` Create an HTTP POST request to send to the server at the specified host and default port.
`HttpClientRequest`	`post(String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`postAbs(String absoluteURI)` Create an HTTP POST request to send to the server using an absolute URI
`HttpClientRequest`	`postAbs(String absoluteURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`put(int port, String host, String requestURI)` Create an HTTP PUT request to send to the server at the specified host and port.
`HttpClientRequest`	`put(int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`put(RequestOptions options)` Create an HTTP PUT request to send to the server with the specified options.
`HttpClientRequest`	`put(RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`put(String requestURI)` Create an HTTP PUT request to send to the server at the default host and port.
`HttpClientRequest`	`put(String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`put(String host, String requestURI)` Create an HTTP PUT request to send to the server at the specified host and default port.
`HttpClientRequest`	`put(String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`putAbs(String absoluteURI)` Create an HTTP PUT request to send to the server using an absolute URI
`HttpClientRequest`	`putAbs(String absoluteURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`Function<HttpClientResponse,Future<HttpClientRequest>>`	`redirectHandler()`
`HttpClient`	`redirectHandler(Function<HttpClientResponse,Future<HttpClientRequest>> handler)` Set a redirect handler for the http client.
`HttpClientRequest`	`request(HttpMethod method, int port, String host, String requestURI)` Create an HTTP request to send to the server at the specified host and port.
`HttpClientRequest`	`request(HttpMethod method, int port, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`request(HttpMethod method, RequestOptions options)` Create an HTTP request to send to the server with the specified options.
`HttpClientRequest`	`request(HttpMethod method, RequestOptions options, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`request(HttpMethod method, String requestURI)` Create an HTTP request to send to the server at the default host and port.
`HttpClientRequest`	`request(HttpMethod method, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`request(HttpMethod method, String host, String requestURI)` Create an HTTP request to send to the server at the specified host and default port.
`HttpClientRequest`	`request(HttpMethod method, String host, String requestURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClientRequest`	`requestAbs(HttpMethod method, String absoluteURI)` Create an HTTP request to send to the server using an absolute URI
`HttpClientRequest`	`requestAbs(HttpMethod method, String absoluteURI, Handler<HttpClientResponse> responseHandler)` Deprecated. this method will break in Vert.x 4, the handler will use an `Handler<AsyncResult<HttpClientResponse>>`
`HttpClient`	`websocket(int port, String host, String requestURI, Handler<WebSocket> wsConnect)` Connect a WebSocket to the specified port, host and relative request URI
`HttpClient`	`websocket(int port, String host, String requestURI, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket to the specified port, host and relative request URI
`HttpClient`	`websocket(int port, String host, String requestURI, MultiMap headers, Handler<WebSocket> wsConnect)` Connect a WebSocket to the specified port, host and relative request URI, and with the specified headers
`HttpClient`	`websocket(int port, String host, String requestURI, MultiMap headers, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket to the specified port, host and relative request URI, and with the specified headers
`HttpClient`	`websocket(int port, String host, String requestURI, MultiMap headers, WebsocketVersion version, Handler<WebSocket> wsConnect)` Connect a WebSocket to the specified port, host and relative request URI, with the specified headers and using the specified version of WebSockets
`HttpClient`	`websocket(int port, String host, String requestURI, MultiMap headers, WebsocketVersion version, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket to the specified port, host and relative request URI, with the specified headers and using the specified version of WebSockets
`HttpClient`	`websocket(int port, String host, String requestURI, MultiMap headers, WebsocketVersion version, String subProtocols, Handler<WebSocket> wsConnect)` Connect a WebSocket to the specified port, host and relative request URI, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
`HttpClient`	`websocket(int port, String host, String requestURI, MultiMap headers, WebsocketVersion version, String subProtocols, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket to the specified port, host and relative request URI, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
`HttpClient`	`websocket(RequestOptions options, Handler<WebSocket> wsConnect)` Connect a WebSocket with the specified options
`HttpClient`	`websocket(RequestOptions options, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket with the specified options
`HttpClient`	`websocket(RequestOptions options, MultiMap headers, Handler<WebSocket> wsConnect)` Connect a WebSocket with the specified options, and with the specified headers
`HttpClient`	`websocket(RequestOptions options, MultiMap headers, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket with the specified options, and with the specified headers
`HttpClient`	`websocket(RequestOptions options, MultiMap headers, WebsocketVersion version, Handler<WebSocket> wsConnect)` Connect a WebSocket with the specified optionsI, with the specified headers and using the specified version of WebSockets
`HttpClient`	`websocket(RequestOptions options, MultiMap headers, WebsocketVersion version, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket with the specified options, with the specified headers and using the specified version of WebSockets
`HttpClient`	`websocket(RequestOptions options, MultiMap headers, WebsocketVersion version, String subProtocols, Handler<WebSocket> wsConnect)` Connect a WebSocket with the specified options, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
`HttpClient`	`websocket(RequestOptions options, MultiMap headers, WebsocketVersion version, String subProtocols, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket with the specified options, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
`HttpClient`	`websocket(String requestURI, Handler<WebSocket> wsConnect)` Connect a WebSocket at the relative request URI using the default host and port
`HttpClient`	`websocket(String requestURI, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket at the relative request URI using the default host and port
`HttpClient`	`websocket(String requestURI, MultiMap headers, Handler<WebSocket> wsConnect)` Connect a WebSocket at the relative request URI using the default host and port and the specified headers
`HttpClient`	`websocket(String requestURI, MultiMap headers, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket at the relative request URI using the default host and port and the specified headers
`HttpClient`	`websocket(String requestURI, MultiMap headers, WebsocketVersion version, Handler<WebSocket> wsConnect)` Connect a WebSocket at the relative request URI using the default host and port, the specified headers and the specified version of WebSockets
`HttpClient`	`websocket(String requestURI, MultiMap headers, WebsocketVersion version, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket at the relative request URI using the default host and port, the specified headers and the specified version of WebSockets
`HttpClient`	`websocket(String requestURI, MultiMap headers, WebsocketVersion version, String subProtocols, Handler<WebSocket> wsConnect)` Connect a WebSocket at the relative request URI using the default host and port, the specified headers, the specified version of WebSockets and the specified sub protocols
`HttpClient`	`websocket(String requestURI, MultiMap headers, WebsocketVersion version, String subProtocols, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket at the relative request URI using the default host and port, the specified headers, the specified version of WebSockets and the specified sub protocols
`HttpClient`	`websocket(String host, String requestURI, Handler<WebSocket> wsConnect)` Connect a WebSocket to the host and relative request URI and default port
`HttpClient`	`websocket(String host, String requestURI, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket to the host and relative request URI and default port
`HttpClient`	`websocket(String host, String requestURI, MultiMap headers, Handler<WebSocket> wsConnect)` Connect a WebSocket to the specified host,relative request UR, and default port and with the specified headers
`HttpClient`	`websocket(String host, String requestURI, MultiMap headers, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket to the specified host,relative request UR, and default port and with the specified headers
`HttpClient`	`websocket(String host, String requestURI, MultiMap headers, WebsocketVersion version, Handler<WebSocket> wsConnect)` Connect a WebSocket to the specified host, relative request URI and default port with the specified headers and using the specified version of WebSockets
`HttpClient`	`websocket(String host, String requestURI, MultiMap headers, WebsocketVersion version, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket to the specified host, relative request URI and default port with the specified headers and using the specified version of WebSockets
`HttpClient`	`websocket(String host, String requestURI, MultiMap headers, WebsocketVersion version, String subProtocols, Handler<WebSocket> wsConnect)` Connect a WebSocket to the specified host, relative request URI and default port, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
`HttpClient`	`websocket(String host, String requestURI, MultiMap headers, WebsocketVersion version, String subProtocols, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket to the specified host, relative request URI and default port, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
`HttpClient`	`websocketAbs(String url, MultiMap headers, WebsocketVersion version, String subProtocols, Handler<WebSocket> wsConnect, Handler<Throwable> failureHandler)` Connect a WebSocket with the specified absolute url, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols.
`ReadStream<WebSocket>`	`websocketStream(int port, String host, String requestURI)` Create a WebSocket stream to the specified port, host and relative request URI
`ReadStream<WebSocket>`	`websocketStream(int port, String host, String requestURI, MultiMap headers)` Create a WebSocket stream to the specified port, host and relative request URI, and with the specified headers
`ReadStream<WebSocket>`	`websocketStream(int port, String host, String requestURI, MultiMap headers, WebsocketVersion version)` Create a WebSocket stream to the specified port, host and relative request URI, with the specified headers and using the specified version of WebSockets
`ReadStream<WebSocket>`	`websocketStream(int port, String host, String requestURI, MultiMap headers, WebsocketVersion version, String subProtocols)` Create a WebSocket stream to the specified port, host and relative request URI, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
`ReadStream<WebSocket>`	`websocketStream(RequestOptions options)` Create a WebSocket stream with the specified options
`ReadStream<WebSocket>`	`websocketStream(RequestOptions options, MultiMap headers)` Create a WebSocket stream with the specified options, and with the specified headers
`ReadStream<WebSocket>`	`websocketStream(RequestOptions options, MultiMap headers, WebsocketVersion version)` Create a WebSocket stream with the specified options, with the specified headers and using the specified version of WebSockets
`ReadStream<WebSocket>`	`websocketStream(RequestOptions options, MultiMap headers, WebsocketVersion version, String subProtocols)` Create a WebSocket stream to the specified port, host and relative request URI, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
`ReadStream<WebSocket>`	`websocketStream(String requestURI)` Create a WebSocket stream at the relative request URI using the default host and port and the specified headers
`ReadStream<WebSocket>`	`websocketStream(String requestURI, MultiMap headers)` Create a WebSocket stream at the relative request URI using the default host and port and the specified headers
`ReadStream<WebSocket>`	`websocketStream(String requestURI, MultiMap headers, WebsocketVersion version)` Create a WebSocket stream at the relative request URI using the default host and port, the specified headers and the specified version of WebSockets
`ReadStream<WebSocket>`	`websocketStream(String requestURI, MultiMap headers, WebsocketVersion version, String subProtocols)` Create a WebSocket stream at the relative request URI using the default host and port, the specified headers, the specified version of WebSockets and the specified sub protocols
`ReadStream<WebSocket>`	`websocketStream(String host, String requestURI)` Create a WebSocket stream to the specified host, relative request URI and default port
`ReadStream<WebSocket>`	`websocketStream(String host, String requestURI, MultiMap headers)` Create a WebSocket stream to the specified host, relative request URI and default port and with the specified headers
`ReadStream<WebSocket>`	`websocketStream(String host, String requestURI, MultiMap headers, WebsocketVersion version)` Create a WebSocket stream with the specified options and with the specified headers and using the specified version of WebSockets
`ReadStream<WebSocket>`	`websocketStream(String host, String requestURI, MultiMap headers, WebsocketVersion version, String subProtocols)` Create a WebSocket stream to the specified host, relative request URI and default port, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
`ReadStream<WebSocket>`	`websocketStreamAbs(String url, MultiMap headers, WebsocketVersion version, String subProtocols)` Create a WebSocket stream with the specified absolute url, the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols.

Methods inherited from interface io.vertx.core.metrics.Measured
isMetricsEnabled

- Method Detail
  - request
```
HttpClientRequest request(HttpMethod method,
                          RequestOptions options)
```
    Create an HTTP request to send to the server with the specified options.
    
    Parameters:
    
    method - the HTTP method
    
    options - the request options
    
    Returns:
    
    an HTTP client request object
  - request
```
HttpClientRequest request(HttpMethod method,
                          int port,
                          String host,
                          String requestURI)
```
    Create an HTTP request to send to the server at the specified host and port.
    
    Parameters:
    
    method - the HTTP method
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - request
```
HttpClientRequest request(HttpMethod method,
                          String host,
                          String requestURI)
```
    Create an HTTP request to send to the server at the specified host and default port.
    
    Parameters:
    
    method - the HTTP method
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - request
```
@Deprecated
HttpClientRequest request(HttpMethod method,
                                      RequestOptions options,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP request to send to the server with the specified options, specifying a response handler to receive
    
    Parameters:
    
    method - the HTTP method
    
    options - the request options
    
    Returns:
    
    an HTTP client request object
  - request
```
@Deprecated
HttpClientRequest request(HttpMethod method,
                                      int port,
                                      String host,
                                      String requestURI,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP request to send to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    method - the HTTP method
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - request
```
@Deprecated
HttpClientRequest request(HttpMethod method,
                                      String host,
                                      String requestURI,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP request to send to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    method - the HTTP method
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - request
```
HttpClientRequest request(HttpMethod method,
                          String requestURI)
```
    Create an HTTP request to send to the server at the default host and port.
    
    Parameters:
    
    method - the HTTP method
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - request
```
@Deprecated
HttpClientRequest request(HttpMethod method,
                                      String requestURI,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP request to send to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    method - the HTTP method
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - requestAbs
```
HttpClientRequest requestAbs(HttpMethod method,
                             String absoluteURI)
```
    Create an HTTP request to send to the server using an absolute URI
    
    Parameters:
    
    method - the HTTP method
    
    absoluteURI - the absolute URI
    
    Returns:
    
    an HTTP client request object
  - requestAbs
```
@Deprecated
HttpClientRequest requestAbs(HttpMethod method,
                                         String absoluteURI,
                                         Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP request to send to the server using an absolute URI, specifying a response handler to receive the response
    
    Parameters:
    
    method - the HTTP method
    
    absoluteURI - the absolute URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - get
```
HttpClientRequest get(RequestOptions options)
```
    Create an HTTP GET request to send to the server with the specified options.
    
    Parameters:
    
    options - the request options
    
    Returns:
    
    an HTTP client request object
  - get
```
HttpClientRequest get(int port,
                      String host,
                      String requestURI)
```
    Create an HTTP GET request to send to the server at the specified host and port.
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - get
```
HttpClientRequest get(String host,
                      String requestURI)
```
    Create an HTTP GET request to send to the server at the specified host and default port.
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - get
```
@Deprecated
HttpClientRequest get(RequestOptions options,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP GET request to send to the server with the specified options, specifying a response handler to receive the response
    
    Parameters:
    
    options - the request options
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - get
```
@Deprecated
HttpClientRequest get(int port,
                                  String host,
                                  String requestURI,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP GET request to send to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - get
```
@Deprecated
HttpClientRequest get(String host,
                                  String requestURI,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP GET request to send to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - get
```
HttpClientRequest get(String requestURI)
```
    Create an HTTP GET request to send to the server at the default host and port.
    
    Parameters:
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - get
```
@Deprecated
HttpClientRequest get(String requestURI,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP GET request to send to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - getAbs
```
HttpClientRequest getAbs(String absoluteURI)
```
    Create an HTTP GET request to send to the server using an absolute URI
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    Returns:
    
    an HTTP client request object
  - getAbs
```
@Deprecated
HttpClientRequest getAbs(String absoluteURI,
                                     Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP GET request to send to the server using an absolute URI, specifying a response handler to receive the response
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - getNow
```
@Deprecated
HttpClient getNow(RequestOptions options,
                              Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP GET request to the server with the specified options, specifying a response handler to receive the response
    
    Parameters:
    
    options - the request options
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - getNow
```
@Deprecated
HttpClient getNow(int port,
                              String host,
                              String requestURI,
                              Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP GET request to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - getNow
```
@Deprecated
HttpClient getNow(String host,
                              String requestURI,
                              Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP GET request to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - getNow
```
@Deprecated
HttpClient getNow(String requestURI,
                              Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP GET request to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - post
```
HttpClientRequest post(RequestOptions options)
```
    Create an HTTP POST request to send to the server with the specified options.
    
    Parameters:
    
    options - the request options
    
    Returns:
    
    an HTTP client request object
  - post
```
HttpClientRequest post(int port,
                       String host,
                       String requestURI)
```
    Create an HTTP POST request to send to the server at the specified host and port.
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - post
```
HttpClientRequest post(String host,
                       String requestURI)
```
    Create an HTTP POST request to send to the server at the specified host and default port.
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - post
```
@Deprecated
HttpClientRequest post(RequestOptions options,
                                   Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP POST request to send to the server with the specified options, specifying a response handler to receive the response
    
    Parameters:
    
    options - the request options
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - post
```
@Deprecated
HttpClientRequest post(int port,
                                   String host,
                                   String requestURI,
                                   Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP POST request to send to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - post
```
@Deprecated
HttpClientRequest post(String host,
                                   String requestURI,
                                   Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP POST request to send to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - post
```
HttpClientRequest post(String requestURI)
```
    Create an HTTP POST request to send to the server at the default host and port.
    
    Parameters:
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - post
```
@Deprecated
HttpClientRequest post(String requestURI,
                                   Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP POST request to send to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - postAbs
```
HttpClientRequest postAbs(String absoluteURI)
```
    Create an HTTP POST request to send to the server using an absolute URI
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    Returns:
    
    an HTTP client request object
  - postAbs
```
@Deprecated
HttpClientRequest postAbs(String absoluteURI,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP POST request to send to the server using an absolute URI, specifying a response handler to receive the response
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - head
```
HttpClientRequest head(RequestOptions options)
```
    Create an HTTP HEAD request to send to the server with the specified options.
    
    Parameters:
    
    options - the request options
    
    Returns:
    
    an HTTP client request object
  - head
```
HttpClientRequest head(int port,
                       String host,
                       String requestURI)
```
    Create an HTTP HEAD request to send to the server at the specified host and port.
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - head
```
HttpClientRequest head(String host,
                       String requestURI)
```
    Create an HTTP HEAD request to send to the server at the specified host and default port.
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - head
```
@Deprecated
HttpClientRequest head(RequestOptions options,
                                   Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP HEAD request to send to the server with the specified options, specifying a response handler to receive the response
    
    Parameters:
    
    options - the request options
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - head
```
@Deprecated
HttpClientRequest head(int port,
                                   String host,
                                   String requestURI,
                                   Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP HEAD request to send to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - head
```
@Deprecated
HttpClientRequest head(String host,
                                   String requestURI,
                                   Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP HEAD request to send to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - head
```
HttpClientRequest head(String requestURI)
```
    Create an HTTP HEAD request to send to the server at the default host and port.
    
    Parameters:
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - head
```
@Deprecated
HttpClientRequest head(String requestURI,
                                   Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP HEAD request to send to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - headAbs
```
HttpClientRequest headAbs(String absoluteURI)
```
    Create an HTTP HEAD request to send to the server using an absolute URI
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    Returns:
    
    an HTTP client request object
  - headAbs
```
@Deprecated
HttpClientRequest headAbs(String absoluteURI,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP HEAD request to send to the server using an absolute URI, specifying a response handler to receive the response
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - headNow
```
@Deprecated
HttpClient headNow(RequestOptions options,
                               Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP HEAD request to the server with the specified options, specifying a response handler to receive the response
    
    Parameters:
    
    options - the request options
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - headNow
```
@Deprecated
HttpClient headNow(int port,
                               String host,
                               String requestURI,
                               Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP HEAD request to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - headNow
```
@Deprecated
HttpClient headNow(String host,
                               String requestURI,
                               Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP HEAD request to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - headNow
```
@Deprecated
HttpClient headNow(String requestURI,
                               Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP HEAD request to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - options
```
HttpClientRequest options(RequestOptions options)
```
    Create an HTTP OPTIONS request to send to the server with the specified options.
    
    Parameters:
    
    options - the request options
    
    Returns:
    
    an HTTP client request object
  - options
```
HttpClientRequest options(int port,
                          String host,
                          String requestURI)
```
    Create an HTTP OPTIONS request to send to the server at the specified host and port.
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - options
```
HttpClientRequest options(String host,
                          String requestURI)
```
    Create an HTTP OPTIONS request to send to the server at the specified host and default port.
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - options
```
@Deprecated
HttpClientRequest options(RequestOptions options,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP OPTIONS request to send to the server with the specified options, specifying a response handler to receive the response
    
    Parameters:
    
    options - the request options
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - options
```
@Deprecated
HttpClientRequest options(int port,
                                      String host,
                                      String requestURI,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP OPTIONS request to send to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - options
```
@Deprecated
HttpClientRequest options(String host,
                                      String requestURI,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP OPTIONS request to send to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - options
```
HttpClientRequest options(String requestURI)
```
    Create an HTTP OPTIONS request to send to the server at the default host and port.
    
    Parameters:
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - options
```
@Deprecated
HttpClientRequest options(String requestURI,
                                      Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP OPTIONS request to send to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - optionsAbs
```
HttpClientRequest optionsAbs(String absoluteURI)
```
    Create an HTTP OPTIONS request to send to the server using an absolute URI
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    Returns:
    
    an HTTP client request object
  - optionsAbs
```
@Deprecated
HttpClientRequest optionsAbs(String absoluteURI,
                                         Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP OPTIONS request to send to the server using an absolute URI, specifying a response handler to receive the response
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - optionsNow
```
@Deprecated
HttpClient optionsNow(RequestOptions options,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP OPTIONS request to the server with the specified options, specifying a response handler to receive the response
    
    Parameters:
    
    options - the request options
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - optionsNow
```
@Deprecated
HttpClient optionsNow(int port,
                                  String host,
                                  String requestURI,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP OPTIONS request to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - optionsNow
```
@Deprecated
HttpClient optionsNow(String host,
                                  String requestURI,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP OPTIONS request to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - optionsNow
```
@Deprecated
HttpClient optionsNow(String requestURI,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Sends an HTTP OPTIONS request to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - put
```
HttpClientRequest put(RequestOptions options)
```
    Create an HTTP PUT request to send to the server with the specified options.
    
    Parameters:
    
    options - the request options
    
    Returns:
    
    an HTTP client request object
  - put
```
HttpClientRequest put(int port,
                      String host,
                      String requestURI)
```
    Create an HTTP PUT request to send to the server at the specified host and port.
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - put
```
HttpClientRequest put(String host,
                      String requestURI)
```
    Create an HTTP PUT request to send to the server at the specified host and default port.
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - put
```
@Deprecated
HttpClientRequest put(RequestOptions options,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP PUT request to send to the server with the specified options, specifying a response handler to receive the response
    
    Parameters:
    
    options - the request options
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - put
```
@Deprecated
HttpClientRequest put(int port,
                                  String host,
                                  String requestURI,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP PUT request to send to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - put
```
@Deprecated
HttpClientRequest put(String host,
                                  String requestURI,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP PUT request to send to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - put
```
HttpClientRequest put(String requestURI)
```
    Create an HTTP PUT request to send to the server at the default host and port.
    
    Parameters:
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - put
```
@Deprecated
HttpClientRequest put(String requestURI,
                                  Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP PUT request to send to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - putAbs
```
HttpClientRequest putAbs(String absoluteURI)
```
    Create an HTTP PUT request to send to the server using an absolute URI
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    Returns:
    
    an HTTP client request object
  - putAbs
```
@Deprecated
HttpClientRequest putAbs(String absoluteURI,
                                     Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP PUT request to send to the server using an absolute URI, specifying a response handler to receive the response
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - delete
```
HttpClientRequest delete(RequestOptions options)
```
    Create an HTTP DELETE request to send to the server with the specified options.
    
    Parameters:
    
    options - the request options
    
    Returns:
    
    an HTTP client request object
  - delete
```
HttpClientRequest delete(int port,
                         String host,
                         String requestURI)
```
    Create an HTTP DELETE request to send to the server at the specified host and port.
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - delete
```
HttpClientRequest delete(String host,
                         String requestURI)
```
    Create an HTTP DELETE request to send to the server at the specified host and default port.
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - delete
```
@Deprecated
HttpClientRequest delete(RequestOptions options,
                                     Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP DELETE request to send to the server with the specified options, specifying a response handler to receive the response
    
    Parameters:
    
    options - the request options
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - delete
```
@Deprecated
HttpClientRequest delete(int port,
                                     String host,
                                     String requestURI,
                                     Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP DELETE request to send to the server at the specified host and port, specifying a response handler to receive the response
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - delete
```
@Deprecated
HttpClientRequest delete(String host,
                                     String requestURI,
                                     Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP DELETE request to send to the server at the specified host and default port, specifying a response handler to receive the response
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - delete
```
HttpClientRequest delete(String requestURI)
```
    Create an HTTP DELETE request to send to the server at the default host and port.
    
    Parameters:
    
    requestURI - the relative URI
    
    Returns:
    
    an HTTP client request object
  - delete
```
@Deprecated
HttpClientRequest delete(String requestURI,
                                     Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP DELETE request to send to the server at the default host and port, specifying a response handler to receive the response
    
    Parameters:
    
    requestURI - the relative URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - deleteAbs
```
HttpClientRequest deleteAbs(String absoluteURI)
```
    Create an HTTP DELETE request to send to the server using an absolute URI
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    Returns:
    
    an HTTP client request object
  - deleteAbs
```
@Deprecated
HttpClientRequest deleteAbs(String absoluteURI,
                                        Handler<HttpClientResponse> responseHandler)
```
    Deprecated. this method will break in Vert.x 4, the handler will use an Handler<AsyncResult<HttpClientResponse>>
    
    Create an HTTP DELETE request to send to the server using an absolute URI, specifying a response handler to receive the response
    
    Parameters:
    
    absoluteURI - the absolute URI
    
    responseHandler - the response handler
    
    Returns:
    
    an HTTP client request object
  - websocket
```
HttpClient websocket(RequestOptions options,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket with the specified options
    
    Parameters:
    
    options - the request options
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(int port,
                     String host,
                     String requestURI,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket to the specified port, host and relative request URI
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(RequestOptions options,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket with the specified options
    
    Parameters:
    
    options - the request options
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(int port,
                     String host,
                     String requestURI,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket to the specified port, host and relative request URI
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String host,
                     String requestURI,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket to the host and relative request URI and default port
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String host,
                     String requestURI,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket to the host and relative request URI and default port
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(RequestOptions options,
                     MultiMap headers,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket with the specified options, and with the specified headers
    
    Parameters:
    
    options - the request options
    
    headers - the headers
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(int port,
                     String host,
                     String requestURI,
                     MultiMap headers,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket to the specified port, host and relative request URI, and with the specified headers
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(RequestOptions options,
                     MultiMap headers,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket with the specified options, and with the specified headers
    
    Parameters:
    
    options - the request options
    
    headers - the headers
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(int port,
                     String host,
                     String requestURI,
                     MultiMap headers,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket to the specified port, host and relative request URI, and with the specified headers
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String host,
                     String requestURI,
                     MultiMap headers,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket to the specified host,relative request UR, and default port and with the specified headers
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String host,
                     String requestURI,
                     MultiMap headers,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket to the specified host,relative request UR, and default port and with the specified headers
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(RequestOptions options,
                     MultiMap headers,
                     WebsocketVersion version,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket with the specified optionsI, with the specified headers and using the specified version of WebSockets
    
    Parameters:
    
    options - the request options
    
    headers - the headers
    
    version - the websocket version
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(int port,
                     String host,
                     String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket to the specified port, host and relative request URI, with the specified headers and using the specified version of WebSockets
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(RequestOptions options,
                     MultiMap headers,
                     WebsocketVersion version,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket with the specified options, with the specified headers and using the specified version of WebSockets
    
    Parameters:
    
    options - the request options
    
    headers - the headers
    
    version - the websocket version
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(int port,
                     String host,
                     String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket to the specified port, host and relative request URI, with the specified headers and using the specified version of WebSockets
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String host,
                     String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket to the specified host, relative request URI and default port with the specified headers and using the specified version of WebSockets
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String host,
                     String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket to the specified host, relative request URI and default port with the specified headers and using the specified version of WebSockets
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(RequestOptions options,
                     MultiMap headers,
                     WebsocketVersion version,
                     String subProtocols,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket with the specified options, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
    
    Parameters:
    
    options - the request options
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols to use
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(int port,
                     String host,
                     String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     String subProtocols,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket to the specified port, host and relative request URI, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols to use
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocketAbs
```
HttpClient websocketAbs(String url,
                        MultiMap headers,
                        WebsocketVersion version,
                        String subProtocols,
                        Handler<WebSocket> wsConnect,
                        Handler<Throwable> failureHandler)
```
    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
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(RequestOptions options,
                     MultiMap headers,
                     WebsocketVersion version,
                     String subProtocols,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket with the specified options, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
    
    Parameters:
    
    options - the request options
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols to use
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(int port,
                     String host,
                     String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     String subProtocols,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket to the specified port, host and relative request URI, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols to use
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String host,
                     String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     String subProtocols,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket to the specified host, relative request URI and default port, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols to use
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String host,
                     String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     String subProtocols,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket to the specified host, relative request URI and default port, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols to use
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String requestURI,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket at the relative request URI using the default host and port
    
    Parameters:
    
    requestURI - the relative URI
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String requestURI,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket at the relative request URI using the default host and port
    
    Parameters:
    
    requestURI - the relative URI
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String requestURI,
                     MultiMap headers,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket at the relative request URI using the default host and port and the specified headers
    
    Parameters:
    
    requestURI - the relative URI
    
    headers - the headers
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String requestURI,
                     MultiMap headers,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket at the relative request URI using the default host and port and the specified headers
    
    Parameters:
    
    requestURI - the relative URI
    
    headers - the headers
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket at the relative request URI using the default host and port, the specified headers and the specified version of WebSockets
    
    Parameters:
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket at the relative request URI using the default host and port, the specified headers and the specified version of WebSockets
    
    Parameters:
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     String subProtocols,
                     Handler<WebSocket> wsConnect)
```
    Connect a WebSocket at the relative request URI using the default host and port, the specified headers, the specified version of WebSockets and the specified sub protocols
    
    Parameters:
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols
    
    wsConnect - handler that will be called with the websocket when connected
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocket
```
HttpClient websocket(String requestURI,
                     MultiMap headers,
                     WebsocketVersion version,
                     String subProtocols,
                     Handler<WebSocket> wsConnect,
                     Handler<Throwable> failureHandler)
```
    Connect a WebSocket at the relative request URI using the default host and port, the specified headers, the specified version of WebSockets and the specified sub protocols
    
    Parameters:
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols
    
    wsConnect - handler that will be called with the websocket when connected
    
    failureHandler - handler that will be called if websocket connection fails
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - websocketStream
```
ReadStream<WebSocket> websocketStream(RequestOptions options)
```
    Create a WebSocket stream with the specified options
    
    Parameters:
    
    options - the request options
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(int port,
                                      String host,
                                      String requestURI)
```
    Create a WebSocket stream to the specified port, host and relative request URI
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(String host,
                                      String requestURI)
```
    Create a WebSocket stream to the specified host, relative request URI and default port
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(RequestOptions options,
                                      MultiMap headers)
```
    Create a WebSocket stream with the specified options, and with the specified headers
    
    Parameters:
    
    options - the request options
    
    headers - the headers
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(int port,
                                      String host,
                                      String requestURI,
                                      MultiMap headers)
```
    Create a WebSocket stream to the specified port, host and relative request URI, and with the specified headers
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(String host,
                                      String requestURI,
                                      MultiMap headers)
```
    Create a WebSocket stream to the specified host, relative request URI and default port and with the specified headers
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(RequestOptions options,
                                      MultiMap headers,
                                      WebsocketVersion version)
```
    Create a WebSocket stream with the specified options, with the specified headers and using the specified version of WebSockets
    
    Parameters:
    
    options - the request options
    
    headers - the headers
    
    version - the websocket version
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(int port,
                                      String host,
                                      String requestURI,
                                      MultiMap headers,
                                      WebsocketVersion version)
```
    Create a WebSocket stream to the specified port, host and relative request URI, with the specified headers and using the specified version of WebSockets
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(String host,
                                      String requestURI,
                                      MultiMap headers,
                                      WebsocketVersion version)
```
    Create a WebSocket stream with the specified options and with the specified headers and using the specified version of WebSockets
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStreamAbs
```
ReadStream<WebSocket> websocketStreamAbs(String url,
                                         MultiMap headers,
                                         WebsocketVersion version,
                                         String subProtocols)
```
    Create a WebSocket stream with the specified absolute url, 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:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(RequestOptions options,
                                      MultiMap headers,
                                      WebsocketVersion version,
                                      String subProtocols)
```
    Create a WebSocket stream to the specified port, host and relative request URI, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
    
    Parameters:
    
    options - the request options
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols to use
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(int port,
                                      String host,
                                      String requestURI,
                                      MultiMap headers,
                                      WebsocketVersion version,
                                      String subProtocols)
```
    Create a WebSocket stream to the specified port, host and relative request URI, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
    
    Parameters:
    
    port - the port
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols to use
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(String host,
                                      String requestURI,
                                      MultiMap headers,
                                      WebsocketVersion version,
                                      String subProtocols)
```
    Create a WebSocket stream to the specified host, relative request URI and default port, with the specified headers, using the specified version of WebSockets, and the specified websocket sub protocols
    
    Parameters:
    
    host - the host
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols to use
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(String requestURI)
```
    Create a WebSocket stream at the relative request URI using the default host and port and the specified headers
    
    Parameters:
    
    requestURI - the relative URI
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(String requestURI,
                                      MultiMap headers)
```
    Create a WebSocket stream at the relative request URI using the default host and port and the specified headers
    
    Parameters:
    
    requestURI - the relative URI
    
    headers - the headers
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(String requestURI,
                                      MultiMap headers,
                                      WebsocketVersion version)
```
    Create a WebSocket stream at the relative request URI using the default host and port, the specified headers and the specified version of WebSockets
    
    Parameters:
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - websocketStream
```
ReadStream<WebSocket> websocketStream(String requestURI,
                                      MultiMap headers,
                                      WebsocketVersion version,
                                      String subProtocols)
```
    Create a WebSocket stream at the relative request URI using the default host and port, the specified headers, the specified version of WebSockets and the specified sub protocols
    
    Parameters:
    
    requestURI - the relative URI
    
    headers - the headers
    
    version - the websocket version
    
    subProtocols - the subprotocols
    
    Returns:
    
    a stream emitting a WebSocket event when the client connection has been upgraded to a websocket
  - connectionHandler
```
HttpClient connectionHandler(Handler<HttpConnection> handler)
```
    Set a connection handler for the client. This handler is called when a new connection is established.
    
    Returns:
    
    a reference to this, so the API can be used fluently
  - redirectHandler
```
HttpClient redirectHandler(Function<HttpClientResponse,Future<HttpClientRequest>> handler)
```
    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<HttpClientRequest> 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<HttpClientRequest> 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
```
Function<HttpClientResponse,Future<HttpClientRequest>> redirectHandler()
```
    Returns:
    
    the current redirect handler.
  - close
```
void close()
```
    Close the client. Closing will close down any pooled connections. Clients should always be closed after use.

Interface HttpClient

Method Summary

Methods inherited from interface io.vertx.core.metrics.Measured

Method Detail

request

request

request

request

request

request

request

request

requestAbs

requestAbs

get

get

get

get

get

get

get

get

getAbs

getAbs

getNow

getNow

getNow

getNow

post

post

post

post

post

post

post

post

postAbs

postAbs

head

head

head

head

head

head

head

head

headAbs

headAbs

headNow

headNow

headNow

headNow

options

options

options

options

options

options

options

options

optionsAbs

optionsAbs

optionsNow

optionsNow

optionsNow

optionsNow

put

put

put

put

put

put

put

put

putAbs

putAbs

delete

delete

delete

delete