org.dvb.application.plugins
Class XletSystemCall
java.lang.Object
|
+--org.dvb.application.plugins.XletSystemCall
- public abstract class XletSystemCall
- extends java.lang.Object
This class permits user code to intercept certain system calls
initiated by an embedded Xlet that need to be serviced by a
support application. For example, a DVB-HTML plug-in application
needs to service requests that are made by an embedded Xlet, typically
via static method calls.
- Since:
- MHP1.1
Constructor Summary |
protected |
XletSystemCall()
Create a new XletSystemCall |
Method Summary |
abstract java.awt.Container |
getRootContainer(javax.tv.xlet.XletContext ctx)
Called when the Xlet calls
javax.tv.graphics.TVContainer.getRootContainer(). |
void |
register(Plugin p,
javax.tv.xlet.XletContext ctx)
Register this instance of XletSystemCall with the system. |
void |
unregister(Plugin p,
javax.tv.xlet.XletContext ctx)
Unregister this instance of XletSystemCall with the system. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
XletSystemCall
protected XletSystemCall()
- Create a new XletSystemCall
register
public final void register(Plugin p,
javax.tv.xlet.XletContext ctx)
- Register this instance of XletSystemCall with the system.
- Parameters:
p
- The Plugin that services calls made by the xlet, i.e.
the Plugin of which this instance of XletSystemCall is
a part.ctx
- The XletContext of the Xlet making the calls- Throws:
NullPointerException
- if p or ctx is null- See Also:
unregister(org.dvb.application.plugins.Plugin, javax.tv.xlet.XletContext)
unregister
public final void unregister(Plugin p,
javax.tv.xlet.XletContext ctx)
- Unregister this instance of XletSystemCall with the system. When
an interoperable Plugin terminates, of an Xlet managed by a Plugin
is asked to terminate, the Plugin must unregister any relevant
XletSystemCall instances.
- Parameters:
p
- The Plugin that services calls made by the xlet, i.e.
the Plugin of which this instance of XletSystemCall is
a part.ctx
- The XletContext of the Xlet making the calls- Throws:
NullPointerException
- if p or ctx is null- See Also:
register(org.dvb.application.plugins.Plugin, javax.tv.xlet.XletContext)
getRootContainer
public abstract java.awt.Container getRootContainer(javax.tv.xlet.XletContext ctx)
- Called when the Xlet calls
javax.tv.graphics.TVContainer.getRootContainer().
- Parameters:
ctx
- The context of the Xlet making the request; it shall be identical
to the XletContext used to create this instance of
XletSystemCall.- Returns:
- a container object to be returned to the embedded xlet
- See Also:
javax.tv.graphics.TVContainer#getRootContainer