public class TransportImpl extends Object implements BouquetCollection, NetworkCollection, TransportStreamCollection
Transport objects serve as an access point for acquiring
information about services and their groupings.
A Transport object may expose various types of
entities (e.g. Bouquets, Networks and/or TransportStreams) by
implementing additional optional interfaces
(i.e. BouquetCollection,
NetworkCollection, and/or
TransportStreamCollection), depending on the particular
SI format used and the presence of optional elements and tables in
the SI data being broadcast.
| Constructor and Description |
|---|
TransportImpl(int transportID,
DeliverySystemType deliverySystemType) |
| Modifier and Type | Method and Description |
|---|---|
void |
addBouquetChangeListener(BouquetChangeListener listener)
Registers a
BouquetChangeListener to be
notified of changes to a Bouquet that is
part of this BouquetCollection. |
void |
addNetworkChangeListener(NetworkChangeListener listener)
Registers a
NetworkChangeListener to be
notified of changes to a Network that is
part of this NetworkCollection. |
void |
addServiceDetailsChangeListener(ServiceDetailsChangeListener listener)
Registers a
ServiceDetailsChangeListener to be notified of
changes to ServiceDetails that are carried on
this Transport. |
void |
addTransportStreamChangeListener(TransportStreamChangeListener listener)
Registers a
TransportStreamChangeListener to be
notified of changes to a TransportStream that is
part of this TransportStreamCollection. |
DeliverySystemType |
getDeliverySystemType()
Reports the type of mechanism by which this
Transport delivers content. |
void |
notifyBouquetListeners(BouquetChangeEvent event)
Notify all listeners that the bouquet has changed.
|
void |
notifyNetworkListeners(NetworkChangeEvent event)
Notify all listeners that the bouquet has changed.
|
void |
notifyServiceDetailsListeners(ServiceDetailsChangeEvent event)
Notify all listeners that this transport has been changed.
|
void |
notifyTransportStreamListeners(TransportStreamChangeEvent event)
Notify all listeners that the transport stream has changed.
|
void |
removeBouquetChangeListener(BouquetChangeListener listener)
Called to unregister an
BouquetChangeListener. |
void |
removeNetworkChangeListener(NetworkChangeListener listener)
Called to unregister an
NetworkChangeListener. |
void |
removeServiceDetailsChangeListener(ServiceDetailsChangeListener listener)
Called to unregister an
ServiceDetailsChangeListener. |
void |
removeTransportStreamChangeListener(TransportStreamChangeListener listener)
Called to unregister an
TransportStreamChangeListener. |
SIRequest |
retrieveBouquet(Locator locator,
SIRequestor requestor)
Retrieves the specified
Bouquet from the collection. |
SIRequest |
retrieveBouquets(SIRequestor requestor)
Retrieves an array of all the
Bouquet objects in
this BouquetCollection. |
SIRequest |
retrieveNetwork(Locator locator,
SIRequestor requestor)
Retrieves the specified
Network from the collection. |
SIRequest |
retrieveNetworks(SIRequestor requestor)
Retrieves an array of all the
Network objects in
this NetworkCollection. |
SIRequest |
retrieveTransportStream(Locator locator,
SIRequestor requestor)
Retrieves the specified
TransportStream from the collection. |
SIRequest |
retrieveTransportStreams(Locator locator,
SIRequestor requestor)
Retrieves an array of
TransportStream objects
representing the transport streams carried in the specified
Network. |
SIRequest |
retrieveTransportStreams(SIRequestor requestor)
Retrieves an array of the
TransportStream objects in
this TransportStreamCollection. |
public TransportImpl(int transportID,
DeliverySystemType deliverySystemType)
public DeliverySystemType getDeliverySystemType()
Transport delivers content.getDeliverySystemType in interface Transportpublic void addServiceDetailsChangeListener(ServiceDetailsChangeListener listener) throws SecurityException
ServiceDetailsChangeListener to be notified of
changes to ServiceDetails that are carried on
this Transport. Subsequent notification is made via
ServiceDetailsChangeEvent with this
Transport instance as the event source.This method is only a request for notification. No guarantee is provided that the SI database will detect all, or even any, SI changes or whether such changes will be detected in a timely fashion.
If the specified ServiceDetailsChangeListener is
already registered, no action is performed.
addServiceDetailsChangeListener in interface Transportlistener - An ServiceDetailsChangeListener to be
notified about changes related to ServiceDetails
carried on this Transport.SecurityException - If the caller does not have
javax.tv.service.ReadPermission(locator) for this
Transport.ServiceDetailsChangeEvent,
ReadPermissionpublic void removeServiceDetailsChangeListener(ServiceDetailsChangeListener listener)
ServiceDetailsChangeListener. If the specified
ServiceDetailsChangeListener is not registered, no
action is performed.removeServiceDetailsChangeListener in interface Transportlistener - A previously registered listener.public void notifyServiceDetailsListeners(ServiceDetailsChangeEvent event)
public SIRequest retrieveBouquet(Locator locator, SIRequestor requestor) throws InvalidLocatorException, SecurityException
Bouquet from the collection.This method delivers its results asynchronously.
retrieveBouquet in interface BouquetCollectionlocator - Locator referencing the Bouquet of interestrequestor - The SIRequestor to be notified
when this retrieval operation completes.SIRequest object identifying this
asynchronous retrieval request.InvalidLocatorException - If locator does not
reference a valid bouquet.SecurityException - if the caller does not have
javax.tv.service.ReadPermission(locator)Bouquet,
ReadPermissionpublic SIRequest retrieveBouquets(SIRequestor requestor)
Bouquet objects in
this BouquetCollection. This array will only contain
Bouquet instances for which the caller has
javax.tv.service.ReadPermission on the underlying
locator.This method delivers its results asynchronously.
retrieveBouquets in interface BouquetCollectionrequestor - The SIRequestor to be notified
when this retrieval operation completes.SIRequest object identifying this
asynchronous retrieval request.Bouquetpublic SIRequest retrieveNetwork(Locator locator, SIRequestor requestor) throws InvalidLocatorException, SecurityException
Network from the collection.This method delivers its results asynchronously.
retrieveNetwork in interface NetworkCollectionlocator - Locator referencing the Network of interest.requestor - The SIRequestor to be notified
when this retrieval operation completes.SIRequest object identifying this
asynchronous retrieval request.InvalidLocatorException - If locator does not
reference a valid network.SecurityException - if the caller does not have
javax.tv.service.ReadPermission(locator)Network,
ReadPermissionpublic SIRequest retrieveNetworks(SIRequestor requestor)
Network objects in
this NetworkCollection. The collection will only
contain instances for which the caller has
javax.tv.service.ReadPermission on the underlying
locator.This method delivers its results asynchronously.
retrieveNetworks in interface NetworkCollectionrequestor - The SIRequestor to be notified
when this retrieval operation completes.SIRequest object identifying this
asynchronous retrieval request.Networkpublic SIRequest retrieveTransportStream(Locator locator, SIRequestor requestor) throws InvalidLocatorException, SecurityException
TransportStream from the collection.retrieveTransportStream in interface TransportStreamCollectionlocator - Locator referencing the
TransportStream of interestrequestor - The SIRequestor to be notified
when this retrieval operation completes.SIRequest object identifying this
asynchronous retrieval request.InvalidLocatorException - If locator does not
reference a valid transport stream.SecurityException - if the caller does not have
javax.tv.service.ReadPermission(locator)TransportStream,
ReadPermissionpublic SIRequest retrieveTransportStreams(SIRequestor requestor)
TransportStream objects in
this TransportStreamCollection. Only
TransportStream instances for which the caller has
javax.tv.service.ReadPermission on the underlying locator will be
present in the array. This method delivers its results asynchronously.
retrieveTransportStreams in interface TransportStreamCollectionrequestor - The SIRequestor to be notified
when this retrieval operation completes.SIRequest object identifying this
asynchronous retrieval request.TransportStream,
ReadPermissionpublic SIRequest retrieveTransportStreams(Locator locator, SIRequestor requestor) throws InvalidLocatorException, SecurityException
TransportStream objects
representing the transport streams carried in the specified
Network.This method delivers its results asynchronously.
locator - A locator referencing a Network from
which to retrieve transport stream information.requestor - The SIRequestor to be notified
when this retrieval operation completes.SIRequest object identifying this
asynchronous retrieval request.InvalidLocatorException - If locator does not
reference a valid Network on the Transport
implementing this interface.SecurityException - if the caller does not have
javax.tv.service.ReadPermission(locator)TransportStream,
Transport,
ReadPermissionpublic void addBouquetChangeListener(BouquetChangeListener listener) throws SecurityException
BouquetChangeListener to be
notified of changes to a Bouquet that is
part of this BouquetCollection. Subsequent
notification is made via BouquetChangeEvent
with this BouquetCollection as the event
source.This method is only a request for notification. No guarantee is provided that the SI database will detect all, or even any, SI changes or whether such changes will be detected in a timely fashion.
If the specified BouquetChangeListener is
already registered, no action is performed.
addBouquetChangeListener in interface BouquetCollectionlistener - A BouquetChangeListener to be
notified about changes related to Bouquet
carried on this Transport.SecurityException - If the caller does not have
javax.tv.service.ReadPermission(locator).BouquetChangeEvent,
ReadPermissionpublic void removeBouquetChangeListener(BouquetChangeListener listener)
BouquetChangeListener. If the specified
BouquetChangeListener is not registered, no
action is performed.removeBouquetChangeListener in interface BouquetCollectionlistener - A previously registered listener.public void notifyBouquetListeners(BouquetChangeEvent event)
public void addNetworkChangeListener(NetworkChangeListener listener) throws SecurityException
NetworkChangeListener to be
notified of changes to a Network that is
part of this NetworkCollection. Subsequent
notification is made via NetworkChangeEvent
with this NetworkCollection as the event
source.This method is only a request for notification. No guarantee is provided that the SI database will detect all, or even any, SI changes or whether such changes will be detected in a timely fashion.
If the specified NetworkChangeListener is
already registered, no action is performed.
addNetworkChangeListener in interface NetworkCollectionlistener - A NetworkChangeListener to be
notified about changes related to Network
carried on this Transport.SecurityException - If the caller does not have
javax.tv.service.ReadPermission(locator).NetworkChangeEvent,
ReadPermissionpublic void removeNetworkChangeListener(NetworkChangeListener listener)
NetworkChangeListener. If the specified
NetworkChangeListener is not registered, no
action is performed.removeNetworkChangeListener in interface NetworkCollectionlistener - A previously registered listener.public void notifyNetworkListeners(NetworkChangeEvent event)
public void addTransportStreamChangeListener(TransportStreamChangeListener listener) throws SecurityException
TransportStreamChangeListener to be
notified of changes to a TransportStream that is
part of this TransportStreamCollection. Subsequent
notification is made via TransportStreamChangeEvent
with this TransportStreamCollection as the event
source.This method is only a request for notification. No guarantee is provided that the SI database will detect all, or even any, SI changes or whether such changes will be detected in a timely fashion.
If the specified TransportStreamChangeListener is
already registered, no action is performed.
addTransportStreamChangeListener in interface TransportStreamCollectionlistener - A TransportStreamChangeListener to be
notified about changes related to TransportStream
carried on this Transport.SecurityException - If the caller does not have
javax.tv.service.ReadPermission(locator).TransportStreamChangeEvent,
ReadPermissionpublic void removeTransportStreamChangeListener(TransportStreamChangeListener listener)
TransportStreamChangeListener. If the specified
TransportStreamChangeListener is not registered, no
action is performed.removeTransportStreamChangeListener in interface TransportStreamCollectionlistener - A previously registered listener.public void notifyTransportStreamListeners(TransportStreamChangeEvent event)
Copyright © 2012 code4tv.com. All Rights Reserved.