com.sun.tv

Class XletContextImpl

java.lang.Object

com.sun.tv.XletContextImpl

All Implemented Interfaces:

XletContext

public class XletContextImpl
extends Object
implements XletContext

XletContext is used for xlet to communicate back to XletManager. We save a reference to xletManager as a means to get properties, and notify XletManager when calls are made to the lifecycle functions

Version:

99/07/08 @(#)XletContextImpl.java 1.6

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONTAINER
static String	ROOT_CONTAINER
static String	SERVICE_CONTEXT

Fields inherited from interface javax.tv.xlet.XletContext

ARGS

Constructor Summary

Constructors

Constructor and Description
XletContextImpl(XletManager xletMgr, Xlet xlet, ServiceContext context, String[] args)

Method Summary

Methods

Modifier and Type	Method and Description
Object	getXletProperty(String prop) Provides an Xlet with a mechanism to retrieve named properties from the XletContext.
void	notifyDestroyed() Used by an application to notify its manager that it has entered into the Destroyed state.
void	notifyPaused() Notifies the manager that the Xlet does not want to be active and has entered the Paused state.
void	resumeRequest() Provides the Xlet with a mechanism to indicate that it is interested in entering the Active state.

Methods inherited from class java.lang.Object

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

Field Detail

CONTAINER

public static final String CONTAINER

See Also:

Constant Field Values

SERVICE_CONTEXT

public static final String SERVICE_CONTEXT

See Also:

Constant Field Values

ROOT_CONTAINER

public static final String ROOT_CONTAINER

See Also:

Constant Field Values

Constructor Detail

XletContextImpl

public XletContextImpl(XletManager xletMgr,
               Xlet xlet,
               ServiceContext context,
               String[] args)

Method Detail

getXletProperty

public Object getXletProperty(String prop)

Provides an Xlet with a mechanism to retrieve named properties from the XletContext.

Specified by:

getXletProperty in interface XletContext

Parameters:

prop - The name of the property.

Returns:

A reference to an object representing the property. null is returned if no value is available for key.

notifyPaused

public void notifyPaused()

Notifies the manager that the Xlet does not want to be active and has entered the Paused state. Invoking this method will have no effect if the Xlet is destroyed, or if it has not yet been started.

If an Xlet calls notifyPaused(), in the future it may receive an Xlet.startXlet() call to request it to become active, or an Xlet.destroyXlet() call to request it to destroy itself.

Specified by:

notifyPaused in interface XletContext

resumeRequest

public void resumeRequest()

Provides the Xlet with a mechanism to indicate that it is interested in entering the Active state. Calls to this method can be used by an application manager to determine which Xlets to move to Active state.

Specified by:

resumeRequest in interface XletContext

notifyDestroyed

public void notifyDestroyed()

Used by an application to notify its manager that it has entered into the Destroyed state. The application manager will not call the Xlet's destroy method, and all resources held by the Xlet will be considered eligible for reclamation. Before calling this method, the Xlet must have performed the same operations (clean up, releasing of resources etc.) it would have if the Xlet.destroyXlet() had been called.

Specified by:

notifyDestroyed in interface XletContext