io.ably.lib.realtime

Class AblyRealtime

java.lang.Object

io.ably.lib.rest.AblyRest

io.ably.lib.realtime.AblyRealtime

public class AblyRealtime
extends AblyRest

AblyRealtime The top-level class to be instanced for the Ably Realtime library.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	AblyRealtime.Channels A collection of the Channels associated with this Realtime instance.

Field Summary

Fields

Modifier and Type	Field and Description
AblyRealtime.Channels	channels The #Channels associated with this instance.
Connection	connection The Connection object for this instance.

Fields inherited from class io.ably.lib.rest.AblyRest

auth, http, httpCore, options

Constructor Summary

Constructors

Constructor and Description
AblyRealtime(ClientOptions options) Instance the Ably library with the given options.
AblyRealtime(java.lang.String key) Instance the Ably library using a key only.

Method Summary

Modifier and Type	Method and Description
void	close() Close this instance.
void	connect() Initiate a connection.
protected void	onAuthError(ErrorInfo errorInfo) Authentication error occurred
protected void	onAuthUpdated(java.lang.String token, boolean waitForResponse) Authentication token has changed.

Methods inherited from class io.ably.lib.rest.AblyRest

publishBatch, publishBatchAsync, request, requestAsync, stats, statsAsync, time, timeAsync

Methods inherited from class java.lang.Object

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

Field Detail

connection

public final Connection connection

The Connection object for this instance.

channels

public AblyRealtime.Channels channels

The #Channels associated with this instance.

Constructor Detail

AblyRealtime

public AblyRealtime(java.lang.String key)
             throws AblyException

Instance the Ably library using a key only. This is simply a convenience constructor for the simplest case of instancing the library with a key for basic authentication and no other options.

Parameters:

key; - String key (obtained from application dashboard)

Throws:

AblyException

AblyRealtime

public AblyRealtime(ClientOptions options)
             throws AblyException

Instance the Ably library with the given options.

Parameters:

options: - see ClientOptions for options

Throws:

AblyException

Method Detail

connect

public void connect()

Initiate a connection. Connection.connect().

close

public void close()

Close this instance. This closes the connection. The connection can be re-opened by calling Connection.connect().

onAuthUpdated

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

Authentication token has changed.

Overrides:

onAuthUpdated in class AblyRest

Parameters:

token - new token

waitForResponse - wait for server response before returning from method

Throws:

AblyException

onAuthError

protected void onAuthError(ErrorInfo errorInfo)

Authentication error occurred

Overrides:

onAuthError in class AblyRest