com.openfin.desktop.channel

Class Channel

java.lang.Object

com.openfin.desktop.channel.Channel

public class Channel
extends Object

The Channel object allows an OpenFin application to create a channel as a ChannelProvider, or connect to a channel as a ChannelClient.

Author:

Anthony

Constructor Summary

Constructors

Constructor and Description
Channel(String name, DesktopConnection desktopConnection)

Method Summary

Modifier and Type	Method and Description
boolean	addChannelListener(ChannelListener listener)
protected void	addEventListener(org.json.JSONObject subscriptionObject, EventListener listener, AckListener callback) Registers an event listener on the specified event
void	addEventListener(String type, EventListener listener, AckListener callback) Registers an event listener on the specified event
void	connect(AsyncCallback<ChannelClient> callback) Connect to the channel.
void	connect(String nameAlias, AsyncCallback<ChannelClient> callback) Connect to the channel with an alias.
void	create(AsyncCallback<ChannelProvider> callback) Create a new channel.
protected void	fireChannelConnectEvent(String channelId, String uuid, String name, String channelName)
protected void	fireChannelDisconnectEvent(String channelId, String uuid, String name, String channelName)
DesktopConnection	getDesktopConnection()
String	getName() Get the name of the channel
boolean	hasClient(String channelId) Check if the channel has client connected
boolean	hasProvider(String channelId) Check if the channel has provider created
boolean	hasRegisteredAction(String channelId, String action)
org.json.JSONObject	invokeAction(String channelId, String action, org.json.JSONObject actionPayload, org.json.JSONObject senderIdentity)
void	processConnection(String channelId, org.json.JSONObject payload)
boolean	removeChannelListener(ChannelListener listener)
void	removeEventListener(String type, EventListener listener, AckListener callback) Removes a previously registered event listener from the specified event

Methods inherited from class java.lang.Object

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

Constructor Detail

Channel

public Channel(String name,
               DesktopConnection desktopConnection)

Method Detail

getName

public String getName()

Get the name of the channel

Returns:

name of the channel

getDesktopConnection

public DesktopConnection getDesktopConnection()

create

public void create(AsyncCallback<ChannelProvider> callback)

Create a new channel.

Parameters:

callback - The callback that receives the wrapped ChannelProvider object

connect

public void connect(AsyncCallback<ChannelClient> callback)

Connect to the channel.

Parameters:

callback - The callback that receives the wrapped ChannelClient object

connect

public void connect(String nameAlias,
                    AsyncCallback<ChannelClient> callback)

Connect to the channel with an alias.

Parameters:

nameAlias -

callback -

hasProvider

public boolean hasProvider(String channelId)

Check if the channel has provider created

Parameters:

channelId - id of the channel

Returns:

if the channel provider exists.

hasClient

public boolean hasClient(String channelId)

Check if the channel has client connected

Parameters:

channelId - id of the channel

Returns:

if a channel client exists

hasRegisteredAction

public boolean hasRegisteredAction(String channelId,
                                   String action)

invokeAction

public org.json.JSONObject invokeAction(String channelId,
                                        String action,
                                        org.json.JSONObject actionPayload,
                                        org.json.JSONObject senderIdentity)

addChannelListener

public boolean addChannelListener(ChannelListener listener)

removeChannelListener

public boolean removeChannelListener(ChannelListener listener)

fireChannelConnectEvent

protected void fireChannelConnectEvent(String channelId,
                                       String uuid,
                                       String name,
                                       String channelName)

fireChannelDisconnectEvent

protected void fireChannelDisconnectEvent(String channelId,
                                          String uuid,
                                          String name,
                                          String channelName)

processConnection

public void processConnection(String channelId,
                              org.json.JSONObject payload)

addEventListener

protected void addEventListener(org.json.JSONObject subscriptionObject,
                                EventListener listener,
                                AckListener callback)
                         throws DesktopException

Registers an event listener on the specified event

     Supported system event types are:
 

Parameters:

subscriptionObject - A JSON object containing subscription information such as the topic and type

listener - EventListener for the event

callback - AckListener for the request

Throws:

DesktopException - if this method fails to add event listener specified

See Also:

EventListener, AckListener

addEventListener

public void addEventListener(String type,
                             EventListener listener,
                             AckListener callback)
                      throws DesktopException

Registers an event listener on the specified event

     Supported system event types are:
 

Parameters:

type - Type of the event

listener - EventListener for the event

callback - AckListener for the request

Throws:

DesktopException - if this method fails to add event listener specified

See Also:

EventListener, AckListener

removeEventListener

public void removeEventListener(String type,
                                EventListener listener,
                                AckListener callback)
                         throws DesktopException

Removes a previously registered event listener from the specified event

Parameters:

type - Type of the event

listener - EventListener for the event

callback - AckListener for the request

Throws:

DesktopException - if this method fails to remove event listener specified

See Also:

DesktopException, EventListener, AckListener