org.dvb.application.plugins
Class XletSystemCall

java.lang.Object
  extended by 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

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
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

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:
java.lang.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:
java.lang.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:
TVContainer.getRootContainer(javax.tv.xlet.XletContext)