com.openfin.desktop

Class DesktopConnection

java.lang.Object

com.openfin.desktop.DesktopConnection

public class DesktopConnection
extends Object

A object for launching, connecting to, and controlling AppDesktop.

Constructor Summary

Constructors

Constructor and Description
DesktopConnection(String uuid, String host, int port) Creates a new connection to AppDesktop

Method Summary

Methods

Modifier and Type	Method and Description
void	addEventCallback(org.json.JSONObject subscriptionObject, EventListener listener, AckListener callback, Object source) Registers an event listener on the specified event
void	addExternalMessageHandler(ExternalMessageListener listener, Object source) Registers a listener to handle messages for this connection's UUID originating via HTTPS/HTTP
void	connect(DesktopStateListener listener) Connects to an AppDesktop process
void	connect(String type, DesktopStateListener listener) Connects to an AppDesktop process
void	disconnect() Disconnects from AppDesktop
void	exit() Notify AppDesktop to exit
InterApplicationBus	getInterApplicationBus() Gets the Inter-Application message dispatcher associated with this DesktopConnection
boolean	isConnected() InterApplicationBus
void	launchAndConnect(String desktopPath, String commandLineArguments, DesktopStateListener listener, int timeout) Launches AppDesktop and notifies the listener when connected
Integer	registerNotificationListener(NotificationListener listener, Object source) Registers listener for a new notification
void	removeEventCallback(org.json.JSONObject subscriptionObject, EventListener listener, AckListener callback, Object source) Removes a previously registered event listener from the specified event
protected void	respondToPing(long pingId)
void	sendAction(String action, org.json.JSONObject payload) Sends a message to AppDesktop
void	sendAction(String action, org.json.JSONObject payload, AckListener listener, Object source) Sends a message to AppDesktop
void	sendActionToNotificationsCenter(String action, org.json.JSONObject payload, AckListener callback, Object source)

Methods inherited from class java.lang.Object

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

Constructor Detail

DesktopConnection

public DesktopConnection(String uuid,
                 String host,
                 int port)
                  throws DesktopError

Creates a new connection to AppDesktop

Parameters:

uuid - unique ID for AppDesktop to refer to this DesktopConnection

host - The host that AppDesktop is running on

port - The port that AppDesktop is listening on for connections

Throws:

DesktopError

Method Detail

launchAndConnect

public void launchAndConnect(String desktopPath,
                    String commandLineArguments,
                    DesktopStateListener listener,
                    int timeout)

Launches AppDesktop and notifies the listener when connected

Parameters:

desktopPath - Absolute path to the AppDesktop executable

commandLineArguments - Command line arguments to start the AppDesktop with

listener - Receives updates on startup and connection state

timeout - For connecting to Desktop after launch. If the connection to AppDesktop is not established by the timeout the listener will get an onError() call

disconnect

public void disconnect()

Disconnects from AppDesktop

isConnected

public boolean isConnected()

InterApplicationBus

Returns:

true if connected

exit

public void exit()

Notify AppDesktop to exit

getInterApplicationBus

public InterApplicationBus getInterApplicationBus()

Gets the Inter-Application message dispatcher associated with this DesktopConnection

Returns:

InterApplicationBus

sendAction

public void sendAction(String action,
              org.json.JSONObject payload)

Sends a message to AppDesktop

Parameters:

action - The action of the message

payload - The message object to send

sendAction

public void sendAction(String action,
              org.json.JSONObject payload,
              AckListener listener,
              Object source)

Sends a message to AppDesktop

Parameters:

action - The action of the message

payload - The message object to send

listener - AckListener for the message

source - Message source

See Also:

AckListener

connect

public void connect(DesktopStateListener listener)

Connects to an AppDesktop process

Parameters:

listener - Receives updates on startup and connection state

See Also:

DesktopStateListener

connect

public void connect(String type,
           DesktopStateListener listener)

Connects to an AppDesktop process

Parameters:

type - Describes the type of connection to establish

listener - Receives updates on startup and connection state

See Also:

DesktopStateListener

registerNotificationListener

public Integer registerNotificationListener(NotificationListener listener,
                                   Object source)

Registers listener for a new notification

Parameters:

listener - NotificationListener for the notification

source - Source of the request

Returns:

Notification Id

See Also:

NotificationListener

sendActionToNotificationsCenter

public void sendActionToNotificationsCenter(String action,
                                   org.json.JSONObject payload,
                                   AckListener callback,
                                   Object source)

addEventCallback

public void addEventCallback(org.json.JSONObject subscriptionObject,
                    EventListener listener,
                    AckListener callback,
                    Object source)

Registers an event listener on the specified event

Parameters:

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

listener - EventListener for the event

callback - AckListener for this request

source - Source of this request

See Also:

EventListener, AckListener

removeEventCallback

public void removeEventCallback(org.json.JSONObject subscriptionObject,
                       EventListener listener,
                       AckListener callback,
                       Object source)

Removes a previously registered event listener from the specified event

Parameters:

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

listener - EventListener that was registered before

callback - AckListener for this request

source - source of this request

respondToPing

protected void respondToPing(long pingId)

addExternalMessageHandler

public void addExternalMessageHandler(ExternalMessageListener listener,
                             Object source)

Registers a listener to handle messages for this connection's UUID originating via HTTPS/HTTP

Parameters:

listener - process a received HTTPS/HTTP message for this connection

source - The object that originally registered the listener