com.sun.dtv.application
Interface ApplicationProxy

public interface ApplicationProxy

Control an Application via the application manager. The Application manager of a device controls the applications running on the device. This interface allows an application with appropriate permissions to monitor running applications, to start an application, and to request changes to the lifecycle of the application.

Field Summary

static int	ACTIVE The application is active.
static int	DESTROYED The application has been destroyed.
static int	LOADED The application has been loaded.
static int	NOT_LOADED The application is known to the application manager but has not been loaded.
static int	PAUSED The application has been paused.

Method Summary

void	addListener(AppProxyListener listener) Adds a listener for changes in the application state.
int	getState() Gets the state of the Application.
void	pause() Requests the application be paused.
void	removeListener(AppProxyListener listener) Remove a listener registered for changes.
void	resume() Requests the application be resumed.
void	start(String[] parameters) Request the application be ACTIVE with the specified parameters.
void	stop() Requests the application to be stopped.

Field Detail

ACTIVE

static final int ACTIVE

The application is active. The value is 0.

See Also:

getState(), Xlet states, Constant Field Values

DESTROYED

static final int DESTROYED

The application has been destroyed. The value is 1.

See Also:

getState(), Xlet states, Constant Field Values

LOADED

static final int LOADED

The application has been loaded. The value is 2.

See Also:

getState(), Xlet states, Constant Field Values

PAUSED

static final int PAUSED

The application has been paused. The value is 3.

See Also:

getState(), Xlet states, Constant Field Values

NOT_LOADED

static final int NOT_LOADED

The application is known to the application manager but has not been loaded. The value is 4.

See Also:

getState(), Constant Field Values

Method Detail

start

void start(String[] parameters)

Request the application be ACTIVE with the specified parameters. The number of parameters may be zero or more. The application is requested to be started if it is not already active. If the target application is a Java DTV application the arguments MUST be made available as the javax.microedition.xlet.XletContext.ARGS.

Parameters:

parameters - the array of parameters to be passed to the application; null MUST have the same behavior as passing a zero length array.

Throws:

IllegalStateException - if the application is already ACTIVE

stop

void stop()

Requests the application to be stopped.

Throws:

IllegalStateException - if the application is not ACTIVE

pause

void pause()

Requests the application be paused.

Throws:

IllegalStateException - if the application is not ACTIVE

resume

void resume()

Requests the application be resumed.

Throws:

IllegalStateException - if the application is not PAUSED.

getState

int getState()

Gets the state of the Application.

Returns:

one of LOADED, PAUSED, ACTIVE, DESTROYED, or NOT_LOADED.

addListener

void addListener(AppProxyListener listener)

Adds a listener for changes in the application state.

Parameters:

listener - the listener to add.

See Also:

removeListener(com.sun.dtv.application.AppProxyListener)

removeListener

void removeListener(AppProxyListener listener)

Remove a listener registered for changes. If the listener was not added, no action is taken.

Parameters:

listener - the listener to remove.

See Also:

addListener(com.sun.dtv.application.AppProxyListener)