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
 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, java.lang.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

public DvbLocator getDvbLocator()
Gets a DvbLocator that identifies this transport stream.

Returns:
The DvbLocator of this transport stream.

getOriginalNetworkID

public int getOriginalNetworkID()
Get the original network identification.

Returns:
The original network identification identifier.

getTransportStreamID

public int getTransportStreamID()
Get the transport stream identification.

Returns:
The transport stream identification identifier.

retrieveSIServices

public SIRequest retrieveSIServices(short retrieveMode,
                                    java.lang.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