io.ably.lib.http

Class HttpCore

java.lang.Object

io.ably.lib.http.HttpCore

public class HttpCore
extends java.lang.Object

HttpCore performs authenticated HTTP synchronously. Internal; use Http or HttpScheduler instead.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HttpCore.AuthRequiredException Exception signifying that an httpCore request failed with a WWW-Authenticate response
static interface	HttpCore.BodyHandler<T> Interface for an entity that performs type-specific processing on an httpCore response body
static interface	HttpCore.RequestBody Interface for an entity that supplies an httpCore request body
static class	HttpCore.Response A type encapsulating an httpCore response
static interface	HttpCore.ResponseHandler<T> Interface for an entity that performs type-specific processing on an httpCore response

Field Summary

Fields

Modifier and Type	Field and Description
int	port
java.lang.String	scheme

Constructor Summary

Constructors

Constructor and Description
HttpCore(ClientOptions options, Auth auth, PlatformAgentProvider platformAgentProvider) Public API

Method Summary

Modifier and Type	Method and Description
java.lang.String	getPreferredHost() Gets host for this HTTP client
java.lang.String	getPrimaryHost() Gets host for this HTTP client
<T> T	httpExecute(java.net.URL url, java.net.Proxy proxy, java.lang.String method, Param[] headers, HttpCore.RequestBody requestBody, boolean withCredentials, HttpCore.ResponseHandler<T> responseHandler) Make a synchronous HTTP request specified by URL and proxy
<T> T	httpExecuteWithRetry(java.net.URL url, java.lang.String method, Param[] headers, HttpCore.RequestBody requestBody, HttpCore.ResponseHandler<T> responseHandler, boolean requireAblyAuth) Make a synchronous HTTP request specified by URL and proxy, retrying if necessary on WWW-Authenticate
void	setPreferredHost(java.lang.String host) Sets host for this HTTP client

Methods inherited from class java.lang.Object

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

Field Detail

scheme

public final java.lang.String scheme

port

public final int port

Constructor Detail

HttpCore

public HttpCore(ClientOptions options,
                Auth auth,
                PlatformAgentProvider platformAgentProvider)
         throws AblyException

Public API

Throws:

AblyException

Method Detail

httpExecuteWithRetry

public <T> T httpExecuteWithRetry(java.net.URL url,
                                  java.lang.String method,
                                  Param[] headers,
                                  HttpCore.RequestBody requestBody,
                                  HttpCore.ResponseHandler<T> responseHandler,
                                  boolean requireAblyAuth)
                           throws AblyException

Make a synchronous HTTP request specified by URL and proxy, retrying if necessary on WWW-Authenticate

Parameters:

url -

method -

headers -

requestBody -

responseHandler -

Returns:

Throws:

AblyException

setPreferredHost

public void setPreferredHost(java.lang.String host)

Sets host for this HTTP client

Parameters:

host - URL string

getPreferredHost

public java.lang.String getPreferredHost()

Gets host for this HTTP client

Returns:

getPrimaryHost

public java.lang.String getPrimaryHost()

Gets host for this HTTP client

Returns:

httpExecute

public <T> T httpExecute(java.net.URL url,
                         java.net.Proxy proxy,
                         java.lang.String method,
                         Param[] headers,
                         HttpCore.RequestBody requestBody,
                         boolean withCredentials,
                         HttpCore.ResponseHandler<T> responseHandler)
                  throws AblyException

Make a synchronous HTTP request specified by URL and proxy

Parameters:

url -

proxy -

method -

headers -

requestBody -

withCredentials -

responseHandler -

Returns:

Throws:

AblyException