io.ably.lib.realtime

Class Connection

java.lang.Object

io.ably.lib.util.EventEmitter<ConnectionState,ConnectionStateListener>

io.ably.lib.realtime.Connection

public class Connection
extends EventEmitter<ConnectionState,ConnectionStateListener>

A class representing the connection associated with an AblyRealtime instance. The Connection object exposes the lifecycle and parameters of the realtime connection.

Nested Class Summary

Nested classes/interfaces inherited from class io.ably.lib.util.EventEmitter

EventEmitter.Filter

Field Summary

Fields

Modifier and Type	Field and Description
ConnectionManager	connectionManager
java.lang.String	id A public identifier for this connection, used to identify this member in presence events and message ids.
java.lang.String	key The assigned connection key.
ErrorInfo	reason Error information associated with a connection failure.
long	serial The serial number of the last message to be received on this connection.
ConnectionState	state The current state of this Connection.

Method Summary

Modifier and Type	Method and Description
protected void	apply(ConnectionStateListener listener, ConnectionState state, java.lang.Object... args)
void	close() Causes the connection to close, entering the closed state, from any state except the failed state.
void	connect() Causes the library to re-attempt connection, if it was previously explicitly closed by the user, or was closed as a result of an unrecoverable error.
void	onConnectionStateChange(ConnectionStateListener.ConnectionStateChange stateChange)
void	ping(CompletionListener listener) Send a heartbeat message to the Ably service and await a response.

Methods inherited from class io.ably.lib.util.EventEmitter

emit, off, off, off, on, on, once, once

Methods inherited from class java.lang.Object

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

Field Detail

state

public ConnectionState state

The current state of this Connection.

reason

public ErrorInfo reason

Error information associated with a connection failure.

key

public java.lang.String key

The assigned connection key.

id

public java.lang.String id

A public identifier for this connection, used to identify this member in presence events and message ids.

serial

public long serial

The serial number of the last message to be received on this connection.

connectionManager

public final ConnectionManager connectionManager

Method Detail

connect

public void connect()

Causes the library to re-attempt connection, if it was previously explicitly closed by the user, or was closed as a result of an unrecoverable error.

ping

public void ping(CompletionListener listener)

Send a heartbeat message to the Ably service and await a response.

Parameters:

listener: - a listener to be notified of the outcome of this message.

close

public void close()

Causes the connection to close, entering the closed state, from any state except the failed state. Once closed, the library will not attempt to re-establish the connection without a call to connect().

onConnectionStateChange

public void onConnectionStateChange(ConnectionStateListener.ConnectionStateChange stateChange)

apply

protected void apply(ConnectionStateListener listener,
                     ConnectionState state,
                     java.lang.Object... args)

Specified by:

apply in class EventEmitter<ConnectionState,ConnectionStateListener>