|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface (together with the SITransportStreamBAT interface) represents a sub-table of the Bouquet Association Table (BAT) describing a particular bouquet.
Each object that implements the SIBouquet interface is identified by the identifier bouquet_id.
SITransportStreamBAT
Field Summary |
Fields inherited from interface org.dvb.si.SIInformation |
FROM_CACHE_ONLY, FROM_CACHE_OR_STREAM, FROM_STREAM_ONLY |
Method Summary | |
int |
getBouquetID()
Get the identification. |
short[] |
getDescriptorTags()
This method defines extra semantics for the SIInformation.getDescriptorTags method. |
java.lang.String |
getName()
This method returns the name of this bouquet. |
java.lang.String |
getShortBouquetName()
This method returns the short name (ETR 211) of this bouquet without emphasis marks. |
DvbLocator[] |
getSIServiceLocators()
Get a list of DvbLocators identifying the services that belong to the bouquet. |
SIRequest |
retrieveDescriptors(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener)
This method defines extra semantics for the SIInformation.retrieveDescriptors method (first prototype). |
SIRequest |
retrieveDescriptors(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
short[] someDescriptorTags)
This method defines extra semantics for the SIInformation.retrieveDescriptors method (second prototype). |
SIRequest |
retrieveSIBouquetTransportStreams(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
short[] someDescriptorTags)
Retrieve information associated with transport streams belonging to the bouquet. |
Methods inherited from interface org.dvb.si.SIInformation |
fromActual, getDataSource, getSIDatabase, getUpdateTime |
Method Detail |
public SIRequest retrieveDescriptors(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener) throws SIIllegalArgumentException
retrieveDescriptors
in interface SIInformation
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 invalidSIInformation
,
SIInformation.retrieveDescriptors(short, java.lang.Object, org.dvb.si.SIRetrievalListener)
public SIRequest retrieveDescriptors(short retrieveMode, java.lang.Object appData, SIRetrievalListener listener, short[] someDescriptorTags) throws SIIllegalArgumentException
retrieveDescriptors
in interface SIInformation
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
- Descriptor tag values that are used for filtering descriptors
from descriptors included in the SI table item corresponding
to this object. If the array contains -1 as its one and only
element, all descriptors related to this object are retrieved.
SIIllegalArgumentException
- thrown if the retrieveMode is invalidSIInformation
,
SIInformation.retrieveDescriptors(short, Object, SIRetrievalListener, short[])
public short[] getDescriptorTags()
getDescriptorTags
in interface SIInformation
SIInformation
,
SIInformation.getDescriptorTags()
public int getBouquetID()
public java.lang.String getName()
javax.tv.service.SIManager.getPreferredLanguage
is one of those in the multilingual_bouquet_name_descriptor, return the name in that
language, otherwise return an implementation dependent selection between the names in
the multilingual_bouquet_name_descriptor and the name in the bouquet_name_descriptor.
When this information is not available "" is returned.
All control characters as defined in ETR 211 are ignored. For each character
the DVB-SI 8 bit character code is mapped to the appropriate Unicode representation
public java.lang.String getShortBouquetName()
javax.tv.service.SIManager.getPreferredLanguage
is one of those in the multilingual_bouquet_name_descriptor, return the name in that
language, otherwise return an implementation dependent selection between the names in
the multilingual_bouquet_name_descriptor and the name in the bouquet_name_descriptor.
If the descriptor is not present, "" is returned. If the string can be found but does
not contain control codes for abbreviating it, the full string shall be returned.
For each character
the DVB-SI 8 bit character code is mapped to the appropriate Unicode representation.
public SIRequest retrieveSIBouquetTransportStreams(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 SITransportStreamBAT interface. This method will retrieve SIBouquetTransportStreams from the same sub-table version as this SIBouquet instance. If this version of the sub-table is no longer available, an SITableUpdatedEvent is returned.
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 behaviour is implementation dependent.
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
,
SITransportStreamBAT
,
DescriptorTag
public DvbLocator[] getSIServiceLocators()
DvbLocator
,
SIService
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |