org.dvb.si

Interface SITransportStream

All Superinterfaces:

SIInformation

All Known Subinterfaces:

SITransportStreamBAT, SITransportStreamNIT

public interface SITransportStream
extends SIInformation

This interface is the base interface for representing information about transport streams.

Transport stream retrieval methods in the SIDatabase class and the SINetwork interface use the NIT table and will return objects that implement the SITransportStreamNIT interface.

Transport stream retrieval methods in the SIBouquet interface use the BAT table and will return objects that implement the SITransportStreamBAT interface.

Field Summary

Fields inherited from interface org.dvb.si.SIInformation

FROM_CACHE_ONLY, FROM_CACHE_OR_STREAM, FROM_STREAM_ONLY

Method Summary

Methods

Modifier and Type	Method and Description
DvbLocator	getDvbLocator() Gets a DvbLocator that identifies this transport stream.
int	getOriginalNetworkID() Get the original network identification.
int	getTransportStreamID() Get the transport stream identification.
SIRequest	retrieveSIServices(short retrieveMode, Object appData, SIRetrievalListener listener, short[] someDescriptorTags) Retrieve information associated with services carried via the transport stream.

Methods inherited from interface org.dvb.si.SIInformation

fromActual, getDataSource, getDescriptorTags, getSIDatabase, getUpdateTime, retrieveDescriptors, retrieveDescriptors

Method Detail

getDvbLocator

DvbLocator getDvbLocator()

Gets a DvbLocator that identifies this transport stream.

Returns:

The DvbLocator of this transport stream.

getOriginalNetworkID

int getOriginalNetworkID()

Get the original network identification.

Returns:

The original network identification identifier.

getTransportStreamID

int getTransportStreamID()

Get the transport stream identification.

Returns:

The transport stream identification identifier.

retrieveSIServices

SIRequest retrieveSIServices(short retrieveMode,
                           Object appData,
                           SIRetrievalListener listener,
                           short[] someDescriptorTags)
                             throws SIIllegalArgumentException

Retrieve information associated with services carried via the transport stream. This method works in the same way for objects that implement the SITransportStreamNIT and SITransportStreamBAT interfaces.

The SIIterator that is returned with the event when the request completes successfully will contain objects that implement the SIService interface.

Parameters:

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream (FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY).

appData - An object supplied by the application. This object will be delivered to the listener when the request completes. The application can use this objects for internal communication purposes. If the application does not need any application data, the parameter can be null.

listener - SIRetrievalListener that will receive the event informing about the completion of the request.

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is interested in. If the array contains -1 as its one and only element, the application is interested in all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the special meaning of -1 as the only element in the array.

Returns:

An SIRequest object

Throws:

SIIllegalArgumentException - thrown if the retrieveMode is invalid

See Also:

SIRequest, SIRetrievalListener, SIService, DescriptorTag