com.sun.tv

Class AppSignalEvent

java.lang.Object

java.util.EventObject

com.sun.tv.AppSignalEvent

All Implemented Interfaces:

Serializable

public class AppSignalEvent
extends EventObject

This class represents an event that is sent from the service selection subsystem to the Application Manager when an application is signaled on a newly selected service. It will include the following information from signaling descriptors:

application_control_code (see table below).

base_directory_byte

class_extension_byte

initial_class_byte

application_control_code: This control code allows the broadcaster to signal to the receiver what to do with the application with regard to its lifecycle. The possible codes are list below.

Code	Identifier	Semantics
0x00		reserved
0x01	AUTOSTART	The Object Carousel module containing the class implementing the Xlet interface is loaded, The class implementing the Xlet is loaded into the VM and an Xlet object is instanciated, and the application is started.
0x02	PRESENT	Indicates that the application is present in the service, but is not autostarted.
0x03	PREFETCH	Indicates that the receiver should try to prefetch the application. Exact semantics to be defined. NOTE: Not used in the DVB-IFA profile!
0x04	DESTROY	When the control code changes from AUTOSTART or PRESENT to DESTROY, the destroy method of the Xlet is called by the application manager and the application is allowed to destroy itself gracefully.
0x05	KILL	When the control code changes to KILL, the application is terminated by the application manager.
0x06...0x0FF		Reserved for future use.

base_directory_byte: These bytes contain a string specifying a directory namer starting from the root of the carousel with directories delimited by the slash character '/' (0x2F). This directory is used as a base directory for relative path names. This base directory is automatically considered to form the first directory in the class path (after the path to the systems classes).

classpath_extension_byte:These bytes contain a string specifying a further extension for the Java runtime class path where the classes of the application are searched in addition to the base directory. The class path extension string contains path names where the elements in the path are delimited by the semicolon character ';' (0xXX). The elements of the path may be either absolute paths starting from the root of the carousel or they can be relative to the base directory. The directories are delimited by the slash character '/' (0x2F) and absolute path names begin with the slash character '/' (0x2F ).

initial_class_byte: These bytes contain a string specifying the name of the object in the carousel that contains the class implementing the Xlet interface. This string is a Java class name that is found in the class path. (e.g. com.brodcaster.appA.MainClass).

application_identifier_byte: The application identifier byte will be used for an application identifier.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static byte	AUTOSTART Indicates that the signalled application is Autostart
static byte	DESTROY Indicates that the Applcation Manager should call the Xlet's destroyXlet method and allow the application to exit gracefully.
static byte	KILL Indicates that the application manager should kill the the application.
static byte	PAUSE Indicates that the app manager should call the Xlet's pauseXlet method.
static byte	PREFETCH Indicates that the receiver should try to prefetch the application.
static byte	PRESENT Indicates that there is a non autostart application present in the service.
static byte	START
static byte	STORE

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
AppSignalEvent(Object source, byte controlCode, String baseDir, String className, String id, ServiceContext context, String[] args)

Method Summary

Methods

Modifier and Type	Method and Description
String	getApplicationIdentifier() get unique identifier from broadcaster.
String[]	getArgs() get Xlet args
String	getBaseDirectory() get base directory
String	getClassName() get Class name
byte	getControlCode() Get the control code.
ServiceContext	getServiceContext()
String	toString()

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

AUTOSTART

public static final byte AUTOSTART

Indicates that the signalled application is Autostart

See Also:

Constant Field Values

STORE

public static final byte STORE

See Also:

Constant Field Values

START

public static final byte START

See Also:

Constant Field Values

PRESENT

public static final byte PRESENT

Indicates that there is a non autostart application present in the service.

See Also:

Constant Field Values

PREFETCH

public static final byte PREFETCH

Indicates that the receiver should try to prefetch the application.

See Also:

Constant Field Values

PAUSE

public static final byte PAUSE

Indicates that the app manager should call the Xlet's pauseXlet method.

See Also:

Constant Field Values

DESTROY

public static final byte DESTROY

Indicates that the Applcation Manager should call the Xlet's destroyXlet method and allow the application to exit gracefully.

See Also:

Constant Field Values

KILL

public static final byte KILL

Indicates that the application manager should kill the the application.

See Also:

Constant Field Values

Constructor Detail

AppSignalEvent

public AppSignalEvent(Object source,
              byte controlCode,
              String baseDir,
              String className,
              String id,
              ServiceContext context,
              String[] args)

Method Detail

getControlCode

public byte getControlCode()

Get the control code.

getBaseDirectory

public String getBaseDirectory()

get base directory

getClassName

public String getClassName()

get Class name

getArgs

public String[] getArgs()

get Xlet args

getApplicationIdentifier

public String getApplicationIdentifier()

get unique identifier from broadcaster.

getServiceContext

public ServiceContext getServiceContext()

toString

public String toString()

Overrides:

toString in class EventObject