|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.dvb.si.SIDatabase
This class represents the root of the SI information hierarchy. There is one SIDatabase per network interface. In a system with a single network interface there is only one SIDatabase object.
When adding a listener to monitor for changes in an SI table (or data carried in an SI table), an event shall not be generated for the current version of that table (or data) found in the network at the time the listener is added. Events shall only be generated for changes following the detection of that current version.
Constructor Summary | |
protected |
SIDatabase()
This constructor is provided for the use of implementations and specifications which extend the present document. |
Method Summary | |
void |
addBouquetMonitoringListener(SIMonitoringListener listener,
int bouquetId)
Initiate monitoring of the bouquet information. |
void |
addEventPresentFollowingMonitoringListener(SIMonitoringListener listener,
int originalNetworkId,
int transportStreamId,
int serviceId)
Initiate monitoring of information in the EIT related to present and following events. |
void |
addEventScheduleMonitoringListener(SIMonitoringListener listener,
int originalNetworkId,
int transportStreamId,
int serviceId,
java.util.Date startTime,
java.util.Date endTime)
Initiate monitoring of information in the EIT related to scheduled events. |
void |
addNetworkMonitoringListener(SIMonitoringListener listener,
int networkId)
Initiate monitoring of the network information. |
void |
addPMTServiceMonitoringListener(SIMonitoringListener listener,
int originalNetworkId,
int transportStreamId,
int serviceId)
Initiate monitoring of information in the PMT related to a service. |
void |
addServiceMonitoringListener(SIMonitoringListener listener,
int originalNetworkId,
int transportStreamId)
Initiate monitoring of information in the SDT related to services. |
static SIDatabase[] |
getSIDatabase()
Return an array of SIDatabase objects (one object per network interface). |
void |
removeBouquetMonitoringListener(SIMonitoringListener listener,
int bouquetId)
Removes the registration of an event listener for bouquet information monitoring. |
void |
removeEventPresentFollowingMonitoringListener(SIMonitoringListener listener,
int originalNetworkId,
int transportStreamId,
int serviceId)
Removes the registration of an event listener for monitoring information related to present and following events If this method is called with a listener that is registered but not with the same identifiers of the SI objects as given in the parameters, the method shall fail silently and the listeners stays registered with those identifiers that it has been added. |
void |
removeEventScheduleMonitoringListener(SIMonitoringListener listener,
int originalNetworkId,
int transportStreamId,
int serviceId)
Removes the registration of an event listener for monitoring information related to scheduled events for all periods If this method is called with a listener that is registered but not with the same identifiers of the SI objects as given in the parameters, the method shall fail silently and the listeners stays registered with those identifiers that it has been added. |
void |
removeNetworkMonitoringListener(SIMonitoringListener listener,
int networkId)
Removes the registration of an event listener for network information monitoring. |
void |
removePMTServiceMonitoringListener(SIMonitoringListener listener,
int originalNetworkId,
int transportStreamId,
int serviceId)
Removes the registration of an event listener for monitoring information in the PMT related to a service. |
void |
removeServiceMonitoringListener(SIMonitoringListener listener,
int originalNetworkId,
int transportStreamId)
Removes the registration of an event listener for monitoring information related to services. |
SIRequest |
retrieveActualSINetwork(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
short[] someDescriptorTags)
Retrieve information associated with the actual network. |
SIRequest |
retrieveActualSIServices(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
short[] someDescriptorTags)
Retrieve information associated with the actual services. |
SIRequest |
retrieveActualSITransportStream(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
short[] someDescriptorTags)
Retrieve information associated with the actual transport stream. |
SIRequest |
retrievePMTElementaryStreams(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
DvbLocator dvbLocator,
short[] someDescriptorTags)
Retrieve PMT elementary stream information associated with components of a service. |
SIRequest |
retrievePMTElementaryStreams(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
int serviceId,
int componentTag,
short[] someDescriptorTags)
Retrieve PMT elementary stream information associated with components of a service from the actual transport stream of this SIDatabase object. |
SIRequest |
retrievePMTService(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
DvbLocator dvbLocator,
short[] someDescriptorTags)
Retrieve PMT information associated with a service. |
SIRequest |
retrievePMTServices(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
int serviceId,
short[] someDescriptorTags)
Retrieve PMT information associated with services from the actual transport stream of this SIDatabase object. |
SIRequest |
retrieveSIBouquets(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
int bouquetId,
short[] someDescriptorTags)
Retrieve information associated with bouquets. |
SIRequest |
retrieveSINetworks(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
int networkId,
short[] someDescriptorTags)
Retrieve information associated with networks. |
SIRequest |
retrieveSIService(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
DvbLocator dvbLocator,
short[] someDescriptorTags)
Retrieve information associated with a service. |
SIRequest |
retrieveSIServices(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
int originalNetworkId,
int transportStreamId,
int serviceId,
short[] someDescriptorTags)
Retrieve information associated with services. |
SIRequest |
retrieveSITimeFromTDT(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener)
Retrieve information associated with time from the Time and Date Table (TDT) from the actual transport stream. |
SIRequest |
retrieveSITimeFromTOT(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
short[] someDescriptorTags)
Retrieve information associated with time from the Time Offset Table (TOT) from the actual transport stream. |
SIRequest |
retrieveSITransportStreamDescription(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
short[] someDescriptorTags)
Retrieve the SITransportStreamDescription object representing the information of the TSDT table in the actual transport stream of this SIDatabase object. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
protected SIDatabase()
Method Detail |
public static SIDatabase[] getSIDatabase()
This is the first method to be called to access the DVB-SI API. The returned SIDatabase objects provide the access point to the DVB-SI information.
public SIRequest retrieveSIBouquets(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, int bouquetId, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes
successfully will contain one or more objects that implement the SIBouquet interface.
If no matching object was found, the appropriate one of the
following events is sent: SINotInCacheEvent
,
SIObjectNotInTableEvent
or SITableNotFoundEvent
.
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.bouquetId
- Identifier of the bouquet to be retrieved or -1 for all
bouquets signalled on the currently received transport stream.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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalid or
the numeric identifiers are out of rangeSIRequest
,
SIRetrievalListener
,
SIBouquet
,
DescriptorTag
public SIRequest retrieveActualSINetwork(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes successfully will contain an object that implements the SINetwork interface. If no matching object was found, the appropriate one of the following events is sent: SINotInCacheEvent or SITableNotFoundEvent
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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalidSIRequest
,
SIRetrievalListener
,
SINetwork
,
DescriptorTag
public SIRequest retrieveSINetworks(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, int networkId, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes
successfully will contain one or more objects that implement the SINetwork interface.
If no matching object was found, the appropriate one of the
following events is sent: SINotInCacheEvent
,
SITableNotFoundEvent
.
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.networkId
- Identification of the network to be retrieved or -1 for all
networks currently signalled.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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalid or
the numeric identifiers are out of rangeSIRequest
,
SIRetrievalListener
,
SINetwork
,
DescriptorTag
public SIRequest retrieveActualSITransportStream(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes successfully will contain an object that implements the SITransportStreamNIT interface. If no matching object was found, the appropriate one of the following events is sent: SINotInCacheEvent SIObjectNotInTableEvent or SITableNotFoundEvent.
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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalidSIRequest
,
SIRetrievalListener
,
SITransportStream
,
DescriptorTag
public SIRequest retrieveActualSIServices(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes
successfully will contain one or more objects that implement the SIService interface.
If no matching object was found, the appropriate one of the
following events is sent: SINotInCacheEvent
,
SIObjectNotInTableEvent
or SITableNotFoundEvent
.
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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalidSIRequest
,
SIRetrievalListener
,
SIService
,
DescriptorTag
public SIRequest retrieveSIServices(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, int originalNetworkId, int transportStreamId, int serviceId, short[] someDescriptorTags) throws SIIllegalArgumentException
transportStreamId
then services shall be
retrieved regardless of their transport stream id. When -1 is specified for
serviceId
then services shall be retrieved regardless of their
service id.
The SIIterator that is returned with the event when the request completes
successfully will contain one or more objects that implement the SIService interface.
If no matching object was found, the appropriate one of the
following events is sent: SINotInCacheEvent
,
SIObjectNotInTableEvent
or SITableNotFoundEvent
.
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.originalNetworkId
- Identification of the services to be retrieved:
original network identifiertransportStreamId
- Identification of the services to be retrieved:
transport stream identifier (-1 means return services regardless
of their transport stream id)serviceId
- Identification of the services to be retrieved:
service identifier (-1 means return services regardless of
their service id)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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalid or
the numeric identifiers are out of rangeSIRequest
,
SIRetrievalListener
,
SIService
,
DescriptorTag
public SIRequest retrieveSIService(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, DvbLocator dvbLocator, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes successfully will contain an object that implements the SIService interface. If no matching object was found, the appropriate one of the following events is sent: SINotInCacheEvent SIObjectNotInTableEvent or SITableNotFoundEvent"
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.dvbLocator
- DVB locator identifying the service.The locator
may be more specific than identifying a service,
but this method will only use the parts starting from
the beginning up to the service id.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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalid or
the locator is invalid and does not
identify a serviceSIRequest
,
SIRetrievalListener
,
SIService
,
DescriptorTag
public SIRequest retrievePMTServices(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, int serviceId, short[] someDescriptorTags) throws SIIllegalArgumentException
serviceId
then services shall be retrieved
regardless of their service id.
The SIIterator that is returned with the event when the request completes
successfully will contain one or more objects that implement the PMTService interface.
If no matching object was found, the appropriate one of the
following events is sent: SINotInCacheEvent
,
SIObjectNotInTableEvent
or SITableNotFoundEvent
.
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.serviceId
- Identification of the services to be retrieved:
service identifier (-1 means return services regardless of
their service id)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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalid or
the numeric identifiers are out of rangeSIRequest
,
SIRetrievalListener
,
SIService
,
DescriptorTag
public SIRequest retrievePMTService(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, DvbLocator dvbLocator, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes successfully will contain an object that implements the PMTService interface. If no matching object was found, the appropriate one of the following events is sent: SINotInCacheEvent SIObjectNotInTableEvent or SITableNotFoundEvent.
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.dvbLocator
- DVB Locator identifying the service. The locator
may be more specific than identifying a service,
but this method will only use the parts starting from
the beginning up to the service id.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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalid or
the locator is invalid and does not
identify a serviceSIRequest
,
SIRetrievalListener
,
SIService
,
DescriptorTag
public SIRequest retrievePMTElementaryStreams(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, int serviceId, int componentTag, short[] someDescriptorTags) throws SIIllegalArgumentException
componentTag
then elementary streams shall be
retrieved regardless of their component tag.
The SIIterator that is returned with the event when the request completes
successfully will contain one or more objects that implement the PMTElementaryStream
interface. If no matching object was found, the appropriate one of the
following events is sent: SINotInCacheEvent
,
SIObjectNotInTableEvent
or SITableNotFoundEvent
.
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.serviceId
- Identification of the elementary streams to be retrieved:
service identifiercomponentTag
- Identification of the elementary streams to be retrieved:
component tag (-1 means return elementary streams regardless
of their component tag)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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalid or
the numeric identifiers are out of rangeSIRequest
,
SIRetrievalListener
,
SIService
,
DescriptorTag
public SIRequest retrievePMTElementaryStreams(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, DvbLocator dvbLocator, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes
successfully will contain one or more objects that implement the PMTElementaryStream
interface. If no matching object was found, the appropriate one of the
following events is sent: SINotInCacheEvent
,
SIObjectNotInTableEvent
or SITableNotFoundEvent
.
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.dvbLocator
- DVB Locator identifying the component(s) of a service.
The locator may be more specific than identifying one or more
service components, but this method will only use the
parts starting from the beginning up to the component tags.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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalid or if the
locator is invalid and does not identify
one or more service componentsSIRequest
,
SIRetrievalListener
,
SIService
,
DescriptorTag
public SIRequest retrieveSITimeFromTDT(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes successfully will contain an object that implements the SITime interface. If no matching object was found, the appropriate one of the following events is sent: SINotInCacheEvent SIObjectNotInTableEvent or SITableNotFoundEvent.
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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalidSIRequest
,
SIRetrievalListener
,
SITime
public SIRequest retrieveSITimeFromTOT(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes successfully will contain an object that implements the SITime interface. If no matching object was found, the appropriate one of the following events is sent: SINotInCacheEvent SIObjectNotInTableEvent or SITableNotFoundEvent.
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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalidSIRequest
,
SIRetrievalListener
,
SITime
public SIRequest retrieveSITransportStreamDescription(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, short[] someDescriptorTags) throws SIIllegalArgumentException
The SIIterator that is returned with the event when the request completes successfully will contain an object that implements the SITransportStreamDescription interface. If no matching object was found, the appropriate one of the following events is sent: SINotInCacheEvent SIObjectNotInTableEvent or SITableNotFoundEvent.
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.
SIIllegalArgumentException
- thrown if the retrieveMode is invalidSIRequest
,
SIRetrievalListener
,
SITransportStreamDescription
,
DescriptorTag
public void addNetworkMonitoringListener(SIMonitoringListener listener, int networkId) throws SIIllegalArgumentException
How the monitoring is performed is implementation dependent and especially does not necessarily need to be continuous. The event will be delivered as soon as the implementation notices the change which might have some delay relative to when the change was actually made in the stream due to resources for the monitoring being scheduled between the monitoring activities of different tables. The present document does not set any minimum requirements for monitoring of the SI tables. This is to be done at a best effort basis by the implementation and is entirely implementation dependent. The only requirement is that when an implementation detects a change, e.g. because a resident Navigator or an MHP application has retrieved some SI information from the stream, then these listeners are notified of the change.
The monitoring stops silently and permanently when the network interface with which this SIDatabase object is associated starts tuning to another transport stream.
listener
- listener object that will receive events when a
change in the information is detected.networkId
- network identifier of the network whose information
will be monitored.
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void removeNetworkMonitoringListener(SIMonitoringListener listener, int networkId) throws SIIllegalArgumentException
listener
- listener object that has previously been registerednetworkId
- network identifier of the network which is no longer
to be monitored by the listener
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void addBouquetMonitoringListener(SIMonitoringListener listener, int bouquetId) throws SIIllegalArgumentException
How the monitoring is performed is implementation dependent and especially does not necessarily need to be continuous. The event will be delivered as soon as the implementation notices the change which might have some delay relative to when the change was actually made in the stream due to resources for the monitoring being scheduled between the monitoring activities of different tables. The present document does not set any minimum requirements for monitoring of the SI tables. This is to be done at a best effort basis by the implementation and is entirely implementation dependent. The only requirement is that when an implementation detects a change, e.g. because a resident Navigator or an MHP application has retrieved some SI information from the stream, then these listeners are notified of the change.
The monitoring stops silently and permanently when the network interface with which this SIDatabase object is associated starts tuning to another transport stream.
listener
- listener object that will receive events when a
change in the information is detected.bouquetId
- bouquet identifier of the bouquet whose information
will be monitored.
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void removeBouquetMonitoringListener(SIMonitoringListener listener, int bouquetId) throws SIIllegalArgumentException
listener
- listener object that has previously been registeredbouquetId
- bouquet identifier of the bouquet whose information
has been requested to be monitored
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void addServiceMonitoringListener(SIMonitoringListener listener, int originalNetworkId, int transportStreamId) throws SIIllegalArgumentException
The scope of the monitoring is determined by the original network identifier and transport stream identifier. The listener will be notified about the change of the information in any service within that scope.
How the monitoring is performed is implementation dependent and especially does not necessarily need to be continuous. The event will be delivered as soon as the implementation notices the change which might have some delay relative to when the change was actually made in the stream due to resources for the monitoring being scheduled between the monitoring activities of different tables. The present document does not set any minimum requirements for monitoring of the SI tables. This is to be done at a best effort basis by the implementation and is entirely implementation dependent. The only requirement is that when an implementation detects a change, e.g. because a resident Navigator or an MHP application has retrieved some SI information from the stream, then these listeners are notified of the change.
The monitoring stops silently and permanently when the network interface with which this SIDatabase object is associated starts tuning to another transport stream.
listener
- listener object that will receive events when a
change in the information is detected.originalNetworkId
- original network identifier specifying the
scope of the monitoring.transportStreamId
- transport stream identifier specifying the
scope of the monitoring.
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void removeServiceMonitoringListener(SIMonitoringListener listener, int originalNetworkId, int transportStreamId) throws SIIllegalArgumentException
listener
- listener object that has previously been registeredoriginalNetworkId
- original network identifier specifying the
scope of the monitoring.transportStreamId
- transport stream identifier specifying the
scope of the monitoring.
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void addPMTServiceMonitoringListener(SIMonitoringListener listener, int originalNetworkId, int transportStreamId, int serviceId) throws SIIllegalArgumentException
How the monitoring is performed is implementation dependent and especially does not necessarily need to be continuous. The event will be delivered as soon as the implementation notices the change which might have some delay relative to when the change was actually made in the stream due to resources for the monitoring being scheduled between the monitoring activities of different tables. Except as specified below, the present document does not set any minimum requirements for monitoring of the SI tables. This is to be done at a best effort basis by the implementation and is entirely implementation dependent. The only requirement is that when an implementation detects a change, e.g. because a resident Navigator or an MHP application has retrieved some SI information from the stream, then these listeners are notified of the change. When the referenced service is the currently selected service within a service context, the terminal shall monitor this PMT and report the changes to any registered listener(s).
The monitoring stops silently and permanently when the network interface with which this SIDatabase object is associated starts tuning to another transport stream.
listener
- listener object that will receive events when a
change in the information is detected.originalNetworkId
- original network identifier of the servicetransportStreamId
- transport stream identifier of the serviceserviceId
- service identifier specifying the service
whose information will be monitored
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void removePMTServiceMonitoringListener(SIMonitoringListener listener, int originalNetworkId, int transportStreamId, int serviceId) throws SIIllegalArgumentException
listener
- listener object that has previously been registeredoriginalNetworkId
- original network identifier of the servicetransportStreamId
- transport stream identifier of the serviceserviceId
- service identifier specifying the service
whose information has been requested to be monitored
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void addEventPresentFollowingMonitoringListener(SIMonitoringListener listener, int originalNetworkId, int transportStreamId, int serviceId) throws SIIllegalArgumentException
The scope of the monitoring is determined by the original network identifier, transport stream identifier and service identifier. The listener will be notified about the change of the information in any present and following event within that scope.
How the monitoring is performed is implementation dependent and especially does not necessarily need to be continuous. The event will be delivered as soon as the implementation notices the change which might have some delay relative to when the change was actually made in the stream due to resources for the monitoring being scheduled between the monitoring activities of different tables. The present document does not set any minimum requirements for monitoring of the SI tables. This is to be done at a best effort basis by the implementation and is entirely implementation dependent. The only requirement is that when an implementation detects a change, e.g. because a resident Navigator or an MHP application has retrieved some SI information from the stream, then these listeners are notified of the change.
The monitoring stops silently and permanently when the network interface with which this SIDatabase object is associated starts tuning to another transport stream. When the referenced service is carried in the currently tuned transport stream, the terminal shall monitor this EITp/f actual and report the changes to any registered listener(s).
listener
- listener object that will receive events when a
change in the information is detected.originalNetworkId
- original network identifier specifying the
scope of the monitoring.transportStreamId
- transport stream identifier specifying the
scope of the monitoring.serviceId
- service identifier specifying the scope of the monitoring
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void removeEventPresentFollowingMonitoringListener(SIMonitoringListener listener, int originalNetworkId, int transportStreamId, int serviceId) throws SIIllegalArgumentException
listener
- listener object that has previously been registeredoriginalNetworkId
- original network identifier specifying the
scope of the monitoring.transportStreamId
- transport stream identifier specifying the
scope of the monitoring.serviceId
- service identifier specifying the scope of the
monitoring
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
public void addEventScheduleMonitoringListener(SIMonitoringListener listener, int originalNetworkId, int transportStreamId, int serviceId, java.util.Date startTime, java.util.Date endTime) throws SIIllegalArgumentException, SIInvalidPeriodException
The scope of the monitoring is determined by the original network identifier, transport stream identifier, service identifier, start time and end time of the schedule period. The listener will be notified about the change of the information in any scheduled event within that scope. The scope of the start time and end time shall be as specified for the parameters of the same name in SIService.retrieveScheduledSIEvents.
How the monitoring is performed is implementation dependent and especially does not necessarily need to be continuous. The event will be delivered as soon as the implementation notices the change which might have some delay relative to when the change was actually made in the stream due to resources for the monitoring being scheduled between the monitoring activities of different tables. The present document does not set any minimum requirements for monitoring of the SI tables. This is to be done at a best effort basis by the implementation and is entirely implementation dependent. The only requirement is that when an implementation detects a change, e.g. because a resident Navigator or an MHP application has retrieved some SI information from the stream, then these listeners are notified of the change.
The monitoring stops silently and permanently when the network interface with which this SIDatabase object is associated starts tuning to another transport stream.
listener
- listener object that will receive events when a
change in the information is detected.originalNetworkId
- original network identifier specifying the
scope of the monitoring.transportStreamId
- transport stream identifier specifying the
scope of the monitoring.serviceId
- service identifier specifying the scope of the monitoringstartTime
- start time of the schedule periodendTime
- end time of the schedule period
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)
SIInvalidPeriodException
- thrown if end time is before start timeSIMonitoringListener
,
SIMonitoringEvent
public void removeEventScheduleMonitoringListener(SIMonitoringListener listener, int originalNetworkId, int transportStreamId, int serviceId) throws SIIllegalArgumentException
listener
- listener object that has previously been registeredoriginalNetworkId
- original network identifier specifying the
scope of the monitoring.transportStreamId
- transport stream identifier specifying the
scope of the monitoring.serviceId
- service identifier specifying the scope of the
monitoring
SIIllegalArgumentException
- thrown if the identifiers are invalid (e.g.
out of range)SIMonitoringListener
,
SIMonitoringEvent
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |