io.ably.lib.realtime

Class Channel

java.lang.Object

io.ably.lib.util.EventEmitter<ChannelState,ChannelStateListener>

io.ably.lib.realtime.Channel

public class Channel
extends EventEmitter<ChannelState,ChannelStateListener>

A class representing a Channel belonging to this application. The Channel instance allows messages to be published and received, and controls the lifecycle of this instance's attachment to the channel.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Channel.MessageListener An interface whereby a client maybe notified of messages changes on a channel.

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

EventEmitter.Filter

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String	attachSerial A message identifier indicating the time of attachment to the channel; used when recovering a message history to mesh exactly with messages received on this channel subsequent to attachment.
java.lang.String	name The name of this channel.
Presence	presence The Presence object for this channel.
ErrorInfo	reason Error information associated with a failed channel state.
ChannelState	state The current channel state.

Method Summary

Modifier and Type	Method and Description
protected void	apply(ChannelStateListener listener, ChannelState state, java.lang.Object... args)
void	attach() Attach to this channel.
void	detach() Detach from this channel.
PaginatedResult<Message>	history(Param[] params) Obtain recent history for this channel using the REST API.
void	publish(Message[] messages, CompletionListener listener) Publish an array of messages on this channel.
void	publish(Message message, CompletionListener listener) Publish a message on this channel.
void	publish(java.lang.String name, java.lang.Object data, CompletionListener listener) Publish a message on this channel.
void	setConnected()
void	setOptions(ChannelOptions options) Channel options
void	setSuspended(ErrorInfo reason)
void	subscribe(Channel.MessageListener listener) Subscribe for messages on this channel.
void	subscribe(java.lang.String[] names, Channel.MessageListener listener) Subscribe for messages with an array of event names on this channel.
void	subscribe(java.lang.String name, Channel.MessageListener listener) Subscribe for messages with a specific event name on this channel.
void	sync()
void	unsubscribe(Channel.MessageListener listener) Unsubscribe a previously subscribed listener from this channel.
void	unsubscribe(java.lang.String[] names, Channel.MessageListener listener) Unsubscribe a previously subscribed event listener from this channel.
void	unsubscribe(java.lang.String name, Channel.MessageListener listener) Unsubscribe a previously subscribed event listener from this channel.

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

emit, 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

name

public final java.lang.String name

The name of this channel.

presence

public final Presence presence

The Presence object for this channel. This controls this client's presence on the channel and may also be used to obtain presence information and change events for other members of the channel.

state

public ChannelState state

The current channel state.

reason

public ErrorInfo reason

Error information associated with a failed channel state.

attachSerial

public java.lang.String attachSerial

A message identifier indicating the time of attachment to the channel; used when recovering a message history to mesh exactly with messages received on this channel subsequent to attachment.

Method Detail

attach

public void attach()
            throws AblyException

Attach to this channel. This call initiates the attach request, and the response is indicated asynchronously in the resulting state change. attach() is called implicitly when publishing or subscribing on this channel, so it is not usually necessary for a client to call attach() explicitly.

Throws:

AblyException

detach

public void detach()
            throws AblyException

Detach from this channel. This call initiates the detach request, and the response is indicated asynchronously in the resulting state change.

Throws:

AblyException

sync

public void sync()
          throws AblyException

Throws:

AblyException

setConnected

public void setConnected()

setSuspended

public void setSuspended(ErrorInfo reason)

apply

protected void apply(ChannelStateListener listener,
                     ChannelState state,
                     java.lang.Object... args)

Specified by:

apply in class EventEmitter<ChannelState,ChannelStateListener>

subscribe

public void subscribe(Channel.MessageListener listener)
               throws AblyException

Subscribe for messages on this channel. This implicitly attaches the channel if not already attached.

Parameters:

listener: - the MessageListener

Throws:

AblyException

unsubscribe

public void unsubscribe(Channel.MessageListener listener)

Unsubscribe a previously subscribed listener from this channel.

Parameters:

listener: - the previously subscribed listener.

subscribe

public void subscribe(java.lang.String name,
                      Channel.MessageListener listener)
               throws AblyException

Subscribe for messages with a specific event name on this channel. This implicitly attaches the channel if not already attached.

Parameters:

name: - the event name

listener: - the MessageListener

Throws:

AblyException

unsubscribe

public void unsubscribe(java.lang.String name,
                        Channel.MessageListener listener)

Unsubscribe a previously subscribed event listener from this channel.

Parameters:

name: - the event name

listener: - the previously subscribed listener.

subscribe

public void subscribe(java.lang.String[] names,
                      Channel.MessageListener listener)
               throws AblyException

Subscribe for messages with an array of event names on this channel. This implicitly attaches the channel if not already attached.

Parameters:

names: - the event names

listener: - the MessageListener

Throws:

AblyException

unsubscribe

public void unsubscribe(java.lang.String[] names,
                        Channel.MessageListener listener)

Unsubscribe a previously subscribed event listener from this channel.

Parameters:

names: - the event names

listener: - the previously subscribed listener.

publish

public void publish(java.lang.String name,
                    java.lang.Object data,
                    CompletionListener listener)
             throws AblyException

Publish a message on this channel. This implicitly attaches the channel if not already attached.

Parameters:

name: - the event name

data: - the message payload. See io.ably.types.Data for supported datatypes

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

Throws:

AblyException

publish

public void publish(Message message,
                    CompletionListener listener)
             throws AblyException

Publish a message on this channel. This implicitly attaches the channel if not already attached.

Parameters:

message: - the message

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

Throws:

AblyException

publish

public void publish(Message[] messages,
                    CompletionListener listener)
             throws AblyException

Publish an array of messages on this channel. This implicitly attaches the channel if not already attached.

Parameters:

message: - the message

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

Throws:

AblyException

history

public PaginatedResult<Message> history(Param[] params)
                                 throws AblyException

Obtain recent history for this channel using the REST API. The history provided relqtes to all clients of this application, not just this instance.

Parameters:

params: - the request params. See the Ably REST API documentation for more details.

Throws:

AblyException

setOptions

public void setOptions(ChannelOptions options)
                throws AblyException

Channel options

Throws:

AblyException