io.ably.lib.transport

Class ConnectionManager

java.lang.Object

io.ably.lib.transport.ConnectionManager

All Implemented Interfaces:

ITransport.ConnectListener

public class ConnectionManager
extends java.lang.Object
implements ITransport.ConnectListener

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ConnectionManager.ConnectionWaiter a class that listens for state change events for in-place authorization
static class	ConnectionManager.QueuedMessage event queueing
static class	ConnectionManager.StateIndication a class encapsulating information associated with a state change request or notification
static class	ConnectionManager.StateInfo a class encapsulating state machine information for a given state

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.HashMap<ConnectionState,ConnectionManager.StateInfo>	states all state information

Constructor Summary

Constructors

Constructor and Description
ConnectionManager(AblyRealtime ably, Connection connection) constructor

Method Summary

Modifier and Type	Method and Description
protected boolean	checkConnectivity() Determine whether or not the client has connection to the network without reference to a specific ably host.
void	close()
void	connect() state management
ConnectionManager.StateInfo	getConnectionState()
java.lang.String	getHost() host management
ErrorInfo	getStateErrorInfo()
boolean	isActive()
void	onAuthError(ErrorInfo errorInfo) Called when where was an error during authentication attempt
void	onAuthUpdated(java.lang.String token, boolean waitForResponse) (RTC8) For a realtime client, Auth.authorize instructs the library to obtain a token using the provided tokenParams and authOptions and upgrade the current connection to use that token; or if not currently connected, to connect with the token.
void	onMessage(ITransport transport, ProtocolMessage message) React on message from the transport
void	onTransportAvailable(ITransport transport, ITransport.TransportParams params)
void	onTransportUnavailable(ITransport transport, ITransport.TransportParams params, ErrorInfo reason)
void	ping(CompletionListener listener)
void	requestState(ConnectionManager.StateIndication state)
void	requestState(ConnectionState state)
void	send(ProtocolMessage msg, boolean queueEvents, CompletionListener listener)
protected void	setLastActivity(long lastActivityTime)

Methods inherited from class java.lang.Object

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

Field Detail

states

public static final java.util.HashMap<ConnectionState,ConnectionManager.StateInfo> states

all state information

Constructor Detail

ConnectionManager

public ConnectionManager(AblyRealtime ably,
                         Connection connection)

constructor

Method Detail

getStateErrorInfo

public ErrorInfo getStateErrorInfo()

isActive

public boolean isActive()

getHost

public java.lang.String getHost()

host management

connect

public void connect()

state management

close

public void close()

getConnectionState

public ConnectionManager.StateInfo getConnectionState()

requestState

public void requestState(ConnectionState state)

requestState

public void requestState(ConnectionManager.StateIndication state)

ping

public void ping(CompletionListener listener)

onAuthUpdated

public void onAuthUpdated(java.lang.String token,
                          boolean waitForResponse)
                   throws AblyException

(RTC8) For a realtime client, Auth.authorize instructs the library to obtain a token using the provided tokenParams and authOptions and upgrade the current connection to use that token; or if not currently connected, to connect with the token.

Throws:

AblyException

onAuthError

public void onAuthError(ErrorInfo errorInfo)

Called when where was an error during authentication attempt

Parameters:

errorInfo - Error associated with unsuccessful authentication

onMessage

public void onMessage(ITransport transport,
                      ProtocolMessage message)
               throws AblyException

React on message from the transport

Parameters:

transport - transport instance or null to bypass transport correctness check (for testing)

message -

Throws:

AblyException

onTransportAvailable

public void onTransportAvailable(ITransport transport,
                                 ITransport.TransportParams params)

Specified by:

onTransportAvailable in interface ITransport.ConnectListener

onTransportUnavailable

public void onTransportUnavailable(ITransport transport,
                                   ITransport.TransportParams params,
                                   ErrorInfo reason)

Specified by:

onTransportUnavailable in interface ITransport.ConnectListener

checkConnectivity

protected boolean checkConnectivity()

Determine whether or not the client has connection to the network without reference to a specific ably host. This is to determine whether it is better to try a fallback host, or keep retrying with the default host.

Returns:

boolean, true if network is available

setLastActivity

protected void setLastActivity(long lastActivityTime)

send

public void send(ProtocolMessage msg,
                 boolean queueEvents,
                 CompletionListener listener)
          throws AblyException

Throws:

AblyException