|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
An interface that provides methods allowing an Xlet to discover information about its environment. An XletContext is passed to an Xlet when the Xlet is initialized. It provides an Xlet with a mechanism to retrieve properties, as well as a way to signal internal state changes.
Critical resources (such as an Xlet's parent container and service
context) can be obtained by means of an XletContext
instance. Therefore, an Xlet's XletContext
instance
should only be accessible to other code that is highly trusted.
Xlet
,
TVContainer
,
ServiceContextFactory.getServiceContext(javax.tv.xlet.XletContext)
Field Summary | |
static java.lang.String |
ARGS
The property key used to obtain initialization arguments for the Xlet. |
Method Summary | |
java.lang.Object |
getXletProperty(java.lang.String key)
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. |
Field Detail |
public static final java.lang.String ARGS
XletContext.getXletProperty(XletContext.ARGS)
will
return the arguments as an array of Strings. If there are
no arguments, then an array of length 0 will be returned.
getXletProperty(java.lang.String)
,
Constant Field ValuesMethod Detail |
public void notifyDestroyed()
destroy
method, and all resources
held by the Xlet are considered eligible for immediate reclamation.
Before calling this method,
the Xlet must perform the same operations
(clean up, releasing of resources etc.) as it would in response
to call to Xlet.destroyXlet(boolean)
.
If this method is called during the execution of one of the
Xlet
state transition methods, the Xlet will immediately
transition into the Destroyed state and the Xlet state
transition method is considered to have completed
unsuccesfully.
public void notifyPaused()
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.
public java.lang.Object getXletProperty(java.lang.String key)
key
- The name of the property.
null
is returned if no value is available for key.public void resumeRequest()
Xlet.startXlet()
as a result of this method will
be made via a different thread than the one used to call
resumeRequest()
.
Xlet.startXlet()
|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |