|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface (together with the SITransportStreamNIT interface) represents a sub-table of the Network Information Table (NIT) describing a particular network.
Each object that implements the SINetwork interface is identified by the identifier network_id.
SITransportStream
,
SITransportStreamNIT
Field Summary |
Fields inherited from interface org.dvb.si.SIInformation |
FROM_CACHE_ONLY, FROM_CACHE_OR_STREAM, FROM_STREAM_ONLY |
Method Summary | |
short[] |
getDescriptorTags()
This method defines extra semantics for the SIInformation.getDescriptorTags method. |
java.lang.String |
getName()
This method returns the name of this network. |
int |
getNetworkID()
Get the identification of this network. |
java.lang.String |
getShortNetworkName()
This method returns the short name (ETR 211) of this network without emphasis marks. |
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 |
retrieveSITransportStreams(short retrieveMode,
java.lang.Object appData,
SIRetrievalListener listener,
short[] someDescriptorTags)
Retrieve information associated with transport streams carried via the network. |
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.
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 invalidSIInformation
,
SIInformation.retrieveDescriptors(short, Object, SIRetrievalListener, short[])
public short[] getDescriptorTags()
getDescriptorTags
in interface SIInformation
SIInformation
,
SIInformation.getDescriptorTags()
public int getNetworkID()
public java.lang.String getName()
javax.tv.service.SIManager.getPreferredLanguage
is one of those in the multilingual_network_name_descriptor, return the name in that
language, otherwise return an implementation dependent selection between the names in
the multilingual_network_name_descriptor and the name in the network_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 getShortNetworkName()
javax.tv.service.SIManager.getPreferredLanguage
is one of those in the multilingual_network_name_descriptor, return the name in that
language, otherwise return an implementation dependent selection between the names in
the multilingual_network_name_descriptor and the name in the network_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 retrieveSITransportStreams(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 SITransportStreamNIT interface. This method will retrieve SITransportStreams from the same sub-table version as this SINetwork 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
,
SITransportStreamNIT
,
DescriptorTag
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |