org.dvb.application.plugins
Class XletSystemCall

java.lang.Object
  extended byorg.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(XletContext ctx)
          Called when the Xlet calls javax.tv.graphics.TVContainer.getRootContainer().
 void register(Plugin p, XletContext ctx)
          Register this instance of XletSystemCall with the system.
 void unregister(Plugin p, 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
 

Constructor Detail

XletSystemCall

protected XletSystemCall()
Create a new XletSystemCall

Method Detail

register

public final void register(Plugin p,
                           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,
                             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(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)