com.sun.dtv.service
Class SIDatabase

java.lang.Object
  com.sun.dtv.service.SIDatabase

public class SIDatabase

extends Object

This class provides a generic means to access the low level SI (Service Information) database, which resides on the platform.

A SI database provides means to asynchronously query or monitor SI tables, which are transmitted in the transport stream.

To be fully flexible the SIDatabase provides a common base class, from which the actual SIDatabase implementation class is derived. This mechanism permits to use different SI database formats as provided in the actual broadcasting system.

An implementation of this API must extend SIDatabase and provide additional SI specific access methods to obtain the individual SI tables.

Each SIDatabase instance is associated to a network interface. The SIDatabase class offers the method getSIDatabase to query the Tuner for a specific SIDatabase. The method getAllSIDatabases returns all SIDatabases in the system. The type of SI information, which is supported by a specific SIDatabase can be queried with the method getSICodingFormat.

Field Summary

static String	SIFormatARIB Format of the SIDatabase: ARIB service information.
static String	SIFormatDVB Format of the SIDatabase: DVB service information.
static String	SIFormatSBTVD Format of the SIDatabase: SBTVD service information.

Constructor Summary

protected

SIDatabase() Protected constructor - not to be called directly.

Method Summary

static SIDatabase[]	getAllSIDatabases() Returns an array of all SIDatabase instances in the system.
String	getSICodingFormat() Returns the coding format of the service information database.
static SIDatabase	getSIDatabase(Tuner tuner) Returns the SIDatabase instance which corresponds to the native system.

Methods inherited from class java.lang.Object

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

Field Detail

SIFormatDVB

public static final String SIFormatDVB

Format of the SIDatabase: DVB service information.

See Also:

Constant Field Values

SIFormatARIB

public static final String SIFormatARIB

Format of the SIDatabase: ARIB service information.

See Also:

Constant Field Values

SIFormatSBTVD

public static final String SIFormatSBTVD

Format of the SIDatabase: SBTVD service information.

See Also:

Constant Field Values

Constructor Detail

SIDatabase

protected SIDatabase()

Protected constructor - not to be called directly.

Method Detail

getSIDatabase

public static SIDatabase getSIDatabase(Tuner tuner)
                                throws NullPointerException

Returns the SIDatabase instance which corresponds to the native system.

The tuner is used to select the interface.

Parameters:

tuner - The tuner to get the SI database from.

Returns:

the SIDatabase instance.

Throws:

NullPointerException - if tuner is null.

getAllSIDatabases

public static SIDatabase[] getAllSIDatabases()

Returns an array of all SIDatabase instances in the system.

Returns:

an array of all SIDatabase instances.

getSICodingFormat

public String getSICodingFormat()

Returns the coding format of the service information database.

The following return values are predefined:

• SIDatabase.SIFormatDVB
• SIDatabase.SIFormatARIB
• SIDatabase.SIFormatSBTVD

Returns:

the coding format.