org.dvb.application.plugins

Class XletSystemCall

java.lang.Object

org.dvb.application.plugins.XletSystemCall

public abstract class XletSystemCall
extends 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

Constructors

Modifier	Constructor and Description
protected	XletSystemCall() Create a new XletSystemCall

Method Summary

Methods

Modifier and Type	Method and Description
abstract 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:

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:

NullPointerException - if p or ctx is null

See Also:

register(org.dvb.application.plugins.Plugin, javax.tv.xlet.XletContext)

getRootContainer

public abstract 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)