com.openfin.desktop

Class System

java.lang.Object

com.openfin.desktop.System

public class System
extends Object

An object representing the core of the OpenFin Desktop. Allows the developer to perform system-level actions, such as accessing logs, viewing processes, clearing the cache and exiting the Desktop.

Constructor Summary

Constructors

Constructor and Description
System(DesktopConnection connection) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
void	addEventListener(String type, EventListener listener, AckListener callback) Registers an event listener on the specified event Supported system event types are: deskband-icon-clicked desktop-icon-clicked monitor-info-changed
void	clearCache(boolean cache, boolean cookies, boolean localStorage, boolean appcache, boolean userData) Clears cached data containing window state/positions, application resource files (images, HTML, JavaScript files) cookies, and items stored in the Local Storage.
void	clearCache(boolean cache, boolean cookies, boolean localStorage, boolean appcache, boolean userData, AckListener listener) Clears cached data containing window state/positions, application resource files (images, HTML, JavaScript files) cookies, and items stored in the Local Storage.
void	deleteCacheOnRestart() Clears all cached data when App Desktop is restarted
void	deleteCacheOnRestart(AckListener listener) Clears all cached data when App Desktop is restarted
void	exit() Exits App Desktop
void	exit(AckListener listener) Exits App Desktop
void	getAllApplications(AckListener callback) Retrieves an array of data (uuid, running/active state) for all application windows The object passed to callback takes the form: [ { uuid: (string) uuid of the application, isRunning: (bool) true when the application is running/active }, ...
void	getAllWindows(AckListener listener) The object passed to callback takes the form: [ { uuid: (string) uuid of the application, mainWindow: { name: (string) name of the main window, top: (integer) top-most coordinate of the main window, right: (integer) right-most coordinate of the main window, bottom: (integer) bottom-most coordinate of the main window, left: (integer) left-most coordinate of the main window }, childWindows: [{ name: (string) name of the child window, top: (integer) top-most coordinate of the child window, right: (integer) right-most coordinate of the child window, bottom: (integer) bottom-most coordinate of the child window, left: (integer) left-most coordinate of the child window }, ...
void	getCommandLineArguments(AckListener listener) Retrieves the command line argument string that started App Desktop
void	getConfig(String section, AckListener callback) Retrieves the App Desktop's configuration
void	getDeviceId(AckListener listener) Gets Device ID
void	getLog(String logName, AckListener listener) Retrieves the contents of the log with the specified filename
void	getLogList(AckListener listener) Retrieves an array of data objects for all available logs Each object in the returned array takes the form: { name: (string) the filename of the log, size: (integer) the size of the log in bytes, date: (integer) the unix time at which the log was created }
void	getMonitorInfo(AckListener listener) Retrieves an object that contains data about the about the monitor setup of the computer that App Desktop is running on.
void	getMousePosition(AckListener listener) Returns the mouse in virtual screen coordinates (left, top) The returned object takes the form: { top: (integer) the top position of the mouse in virtual screen coordinates, left: (integer) the left position of the mouse in virtual screen coordinates }
void	getProcessList(AckListener listener) Retrieves an array of all App Desktop processes that are currently running Each element in the array is an object containing the uuid and the name of the application to which the process belongs.
void	getProxySettings(AckListener listener) Retrieves the proxy settings object The proxy object the callback receives takes the following form: { type: (string) "system" or "named", proxyAddress: (string) the address of the proxy server, proxyPort: (integer) the port of proxy server }
void	getVersion(AckListener listener) Gets AppDesktop version number
void	hideStartWindow() Hides the start menu window
void	hideStartWindow(AckListener listener) Hides the start menu window
void	installDeskbandIcon(String enabledIcon, String disabledIcon, String hoverIcon) Installs a start icon in the Windows Deskband
void	installDeskbandIcon(String enabledIcon, String disabledIcon, String hoverIcon, AckListener listener) Installs a start icon in the Windows Deskband
void	installStartIcon(String enabledIcon, String disabledIcon, String hoverIcon) Installs a start icon in the notification tray
void	installStartIcon(String enabledIcon, String disabledIcon, String hoverIcon, AckListener listener) Installs a start icon in the notification tray
void	launchExternalProcess(String path, String commandLine, AsyncCallback<LaunchExternalProcessResult> callback, AckListener listener) Runs an executable or batch file.
void	log(String level, String message) Writes a message to the log
void	log(String level, String message, AckListener listener) Writes a message to the log
void	openUrlWithBrowser() Opens the passed URL
void	openUrlWithBrowser(AckListener listener) Opens the passed URL
void	releaseExternalProcess(String processUuid, AckListener callback) Removes the process entry for the passed UUID obtained from a previous call to DesktopSystem.launchExternalProcess().
void	removeDeskbandIcon() Removes a start icon from the Windows Deskband
void	removeDeskbandIcon(AckListener listener) Removes a start icon from the Windows Deskband
void	removeEventListener(String type, EventListener listener, AckListener callback) Removes a previously registered event listener from the specified event Supported system event types are: deskband-icon-clicked desktop-icon-clicked monitor-info-changed
void	removeStartIcon() Removes a start icon from the notification tray
void	removeStartIcon(AckListener listener) Removes a start icon from the notification tray
void	showDeveloperTools(String applicationUUID, String windowName, AckListener callback) Shows Developer tool
void	showStartWindow() Shows the start menu window
void	showStartWindow(AckListener listener) Shows the start menu window
void	terminateExternalProcess(String processUuid, int timeout, boolean killTree, AsyncCallback<TerminateExternalProcessResult> callback, AckListener listener) Attempts to cleanly close an external process and terminates it if the close has not occured after the elapsed timeout in milliseconds.
void	updateProxySettings(String type, String proxyAddress, int proxyPort, AckListener listener) Updates the proxy settings The passed type can be either "system" or "named".

Methods inherited from class java.lang.Object

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

Constructor Detail

System

public System(DesktopConnection connection)

Constructor

Parameters:

connection - Connection object to the AppDesktop

See Also:

DesktopConnection

Method Detail

getDeviceId

public void getDeviceId(AckListener listener)

Gets Device ID

Parameters:

listener - AckListener for device ID

See Also:

AckListener

getVersion

public void getVersion(AckListener listener)

Gets AppDesktop version number

Parameters:

listener - AckListener for version number

See Also:

AckListener

getCommandLineArguments

public void getCommandLineArguments(AckListener listener)

Retrieves the command line argument string that started App Desktop

Parameters:

listener - AckListener for command line argument

See Also:

AckListener

getProcessList

public void getProcessList(AckListener listener)

Retrieves an array of all App Desktop processes that are currently running Each element in the array is an object containing the uuid and the name of the application to which the process belongs.

Parameters:

listener - AckListener for process list

See Also:

AckListener

getLog

public void getLog(String logName,
          AckListener listener)

Retrieves the contents of the log with the specified filename

Parameters:

logName - The filename of the log

listener - AckListener for log contents

See Also:

AckListener

getLogList

public void getLogList(AckListener listener)

Retrieves an array of data objects for all available logs Each object in the returned array takes the form: { name: (string) the filename of the log, size: (integer) the size of the log in bytes, date: (integer) the unix time at which the log was created }

Parameters:

listener - AckListener for log list

See Also:

AckListener

log

public void log(String level,
       String message)

Writes a message to the log

Parameters:

level - The log level for the entry. Can be either "info", "warning" or "error"

message - The log message text

log

public void log(String level,
       String message,
       AckListener listener)

Writes a message to the log

Parameters:

level - The log level for the entry. Can be either "info", "warning" or "error"

message - The log message text

listener - AckListener for the result

See Also:

AckListener

getProxySettings

public void getProxySettings(AckListener listener)

Retrieves the proxy settings object The proxy object the callback receives takes the following form: { type: (string) "system" or "named", proxyAddress: (string) the address of the proxy server, proxyPort: (integer) the port of proxy server }

Parameters:

listener - AckListener for the request

See Also:

AckListener

updateProxySettings

public void updateProxySettings(String type,
                       String proxyAddress,
                       int proxyPort,
                       AckListener listener)

Updates the proxy settings The passed type can be either "system" or "named". Use "system" to use the default system proxy settings. Otherwise use "named" to specify the address and port of the proxy server.

Parameters:

type - Type of the proxy

proxyAddress - Address of the proxy

proxyPort - Port of the proxy

listener - AckListener for the request

See Also:

AckListener

installStartIcon

public void installStartIcon(String enabledIcon,
                    String disabledIcon,
                    String hoverIcon)

Installs a start icon in the notification tray

Parameters:

enabledIcon - URL of icon when app is enabled

disabledIcon - URL of icon when app is disabled

hoverIcon - URL of icon for hover over

installDeskbandIcon

public void installDeskbandIcon(String enabledIcon,
                       String disabledIcon,
                       String hoverIcon)

Installs a start icon in the Windows Deskband

Parameters:

enabledIcon - URL of icon when app is enabled

disabledIcon - URL of icon when app is disabled

hoverIcon - URL of icon for hover over

clearCache

public void clearCache(boolean cache,
              boolean cookies,
              boolean localStorage,
              boolean appcache,
              boolean userData)

Clears cached data containing window state/positions, application resource files (images, HTML, JavaScript files) cookies, and items stored in the Local Storage.

Parameters:

cache - If true, clears chrome caches

cookies - If true, deletes all cookies

localStorage - If true, clear application caches

appcache - If true, clears local storage

userData - If true, clears user data

clearCache

public void clearCache(boolean cache,
              boolean cookies,
              boolean localStorage,
              boolean appcache,
              boolean userData,
              AckListener listener)

Clears cached data containing window state/positions, application resource files (images, HTML, JavaScript files) cookies, and items stored in the Local Storage.

Parameters:

cache - If true, clears chrome caches

cookies - If true, deletes all cookies

localStorage - If true, clear application caches

appcache - If true, clears local storage

userData - If true, clears user data

listener - AckListener for the request

See Also:

AckListener

deleteCacheOnRestart

public void deleteCacheOnRestart()

Clears all cached data when App Desktop is restarted

deleteCacheOnRestart

public void deleteCacheOnRestart(AckListener listener)

Clears all cached data when App Desktop is restarted

Parameters:

listener - AckListener for the request

See Also:

AckListener

installStartIcon

public void installStartIcon(String enabledIcon,
                    String disabledIcon,
                    String hoverIcon,
                    AckListener listener)

Installs a start icon in the notification tray

Parameters:

enabledIcon - URL of icon when app is enabled

disabledIcon - URL of icon when app is disabled

hoverIcon - URL of icon for hover over

listener - AckListener for the request

See Also:

AckListener

installDeskbandIcon

public void installDeskbandIcon(String enabledIcon,
                       String disabledIcon,
                       String hoverIcon,
                       AckListener listener)

Installs a start icon in the Windows Deskband

Parameters:

enabledIcon - URL of icon when app is enabled

disabledIcon - URL of icon when app is disabled

hoverIcon - URL of icon for hover over

listener - AckListener for the request

See Also:

AckListener

openUrlWithBrowser

public void openUrlWithBrowser(AckListener listener)

Opens the passed URL

Parameters:

listener - AckListener for the request

See Also:

AckListener

removeStartIcon

public void removeStartIcon()

Removes a start icon from the notification tray

removeStartIcon

public void removeStartIcon(AckListener listener)

Removes a start icon from the notification tray

Parameters:

listener - AckListener for the request

See Also:

AckListener

removeDeskbandIcon

public void removeDeskbandIcon()

Removes a start icon from the Windows Deskband

removeDeskbandIcon

public void removeDeskbandIcon(AckListener listener)

Removes a start icon from the Windows Deskband

Parameters:

listener - AckListener for the request

See Also:

AckListener

showStartWindow

public void showStartWindow()

Shows the start menu window

showStartWindow

public void showStartWindow(AckListener listener)

Shows the start menu window

Parameters:

listener - AckListener for the request

See Also:

AckListener

hideStartWindow

public void hideStartWindow()

Hides the start menu window

hideStartWindow

public void hideStartWindow(AckListener listener)

Hides the start menu window

Parameters:

listener - AckListener for the request

See Also:

AckListener

getMonitorInfo

public void getMonitorInfo(AckListener listener)

Retrieves an object that contains data about the about the monitor setup of the computer that App Desktop is running on. The returned object takes the form: { nonPrimaryMonitors: [{ availableRect: { bottom: (integer) bottom-most available monitor coordinate, left: (integer) left-most available monitor coordinate, right: (integer) right-most available monitor coordinate, top: (integer) top-most available monitor coordinate }, deviceId: (string) device id of the display, displayDeviceActive: (boolean) true if the display is active, monitorRect: { bottom: (integer) bottom-most monitor coordinate, left: (integer) left-most monitor coordinate, right: (integer) right-most monitor coordinate, top: (integer) top-most monitor coordinate }, name: (string) name of the display }, ... ], primaryMonitor: { availableRect: { bottom: (integer) bottom-most available monitor coordinate, left: (integer) left-most available monitor coordinate, right: (integer) right-most available monitor coordinate, top: (integer) top-most available monitor coordinate }, deviceId: (string) device id of the display, displayDeviceActive: (boolean) true if the display is active, monitorRect: { bottom: (integer) bottom-most monitor coordinate, left: (integer) left-most monitor coordinate, right: (integer) right-most monitor coordinate, top: (integer) top-most monitor coordinate }, name: (string) name of the display }, reason: (string) always "api-query", taskbar: { edge: {string} which edge of a monitor the taskbar is on, rect: { bottom: ({integer} bottom-most coordinate of the taskbar), left: ({integer} left-most coordinate of the taskbar), right: ({integer} right-most coordinate of the taskbar), top: ({integer} top-most coordinate of the taskbar) } }, virtualScreen: { bottom: (integer) bottom-most coordinate of the virtual screen, left: (integer) left-most coordinate of the virtual screen, right: (integer) right-most coordinate of the virtual screen, top: (integer) top-most coordinate of the virtual screen } }

Parameters:

listener - AckListener for the request

See Also:

AckListener

getAllWindows

public void getAllWindows(AckListener listener)

The object passed to callback takes the form: [ { uuid: (string) uuid of the application, mainWindow: { name: (string) name of the main window, top: (integer) top-most coordinate of the main window, right: (integer) right-most coordinate of the main window, bottom: (integer) bottom-most coordinate of the main window, left: (integer) left-most coordinate of the main window }, childWindows: [{ name: (string) name of the child window, top: (integer) top-most coordinate of the child window, right: (integer) right-most coordinate of the child window, bottom: (integer) bottom-most coordinate of the child window, left: (integer) left-most coordinate of the child window }, ... ] }, ... ]

Parameters:

listener - AckListener for the request

See Also:

AckListener

getAllApplications

public void getAllApplications(AckListener callback)

Retrieves an array of data (uuid, running/active state) for all application windows The object passed to callback takes the form: [ { uuid: (string) uuid of the application, isRunning: (bool) true when the application is running/active }, ... ]

Parameters:

callback -

exit

public void exit()

Exits App Desktop

exit

public void exit(AckListener listener)

Exits App Desktop

Parameters:

listener - AckListener for the request

See Also:

AckListener

getMousePosition

public void getMousePosition(AckListener listener)

Returns the mouse in virtual screen coordinates (left, top) The returned object takes the form: { top: (integer) the top position of the mouse in virtual screen coordinates, left: (integer) the left position of the mouse in virtual screen coordinates }

Parameters:

listener - AckListener for the request

See Also:

AckListener

openUrlWithBrowser

public void openUrlWithBrowser()

Opens the passed URL

getConfig

public void getConfig(String section,
             AckListener callback)

Retrieves the App Desktop's configuration

Parameters:

section - Which section to return from the configuration

callback - AckListener for the request

See Also:

AckListener

showDeveloperTools

public void showDeveloperTools(String applicationUUID,
                      String windowName,
                      AckListener callback)

Shows Developer tool

Parameters:

applicationUUID - The application ID

windowName - The name of dev tool window

callback - AckListener for the request

See Also:

AckListener

addEventListener

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

Registers an event listener on the specified event Supported system event types are: deskband-icon-clicked desktop-icon-clicked monitor-info-changed

Parameters:

listener - EventListener for the event

callback - AckListener for the request

See Also:

EventListener, AckListener

removeEventListener

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

Removes a previously registered event listener from the specified event Supported system event types are: deskband-icon-clicked desktop-icon-clicked monitor-info-changed

Parameters:

listener - EventListener for the event

callback - AckListener for the request

See Also:

EventListener, AckListener

launchExternalProcess

public void launchExternalProcess(String path,
                         String commandLine,
                         AsyncCallback<LaunchExternalProcessResult> callback,
                         AckListener listener)

Runs an executable or batch file.

Parameters:

path - The path of the file to launch via the command line

commandLine - The command line arguments to pass

callback - A function that is called if the method succeeds

listener - A function that is called if the method fails

See Also:

AsyncCallback, LaunchExternalProcessResult, AckListener

terminateExternalProcess

public void terminateExternalProcess(String processUuid,
                            int timeout,
                            boolean killTree,
                            AsyncCallback<TerminateExternalProcessResult> callback,
                            AckListener listener)

Attempts to cleanly close an external process and terminates it if the close has not occured after the elapsed timeout in milliseconds.

Parameters:

processUuid - The UUID for a process launched by DesktopSystem.launchExternalProcess()

timeout - The time in milliseconds to wait for a close to occur before terminating

killTree -

callback - A function that is called if the method succeed with result code being passed

listener - A function that is called if the method fails

See Also:

terminateExternalProcess, TerminateExternalProcessResult, AckListener

releaseExternalProcess

public void releaseExternalProcess(String processUuid,
                          AckListener callback)

Removes the process entry for the passed UUID obtained from a previous call to DesktopSystem.launchExternalProcess().

Parameters:

processUuid - The UUID for a process launched by DesktopSystem.launchExternalProcess()

callback - AckListener for the request

See Also:

AckListener