public interface BouquetCollection extends Transport
Transport. In DVB SI, this information is contained
in the BAT tables. BouquetCollection may be
optionally implemented by Transport objects, depending
on the SI data carried on that transport.| 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 |
removeBouquetChangeListener(BouquetChangeListener listener)
Called to unregister an
BouquetChangeListener. |
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. |
addServiceDetailsChangeListener, getDeliverySystemType, removeServiceDetailsChangeListenerSIRequest retrieveBouquet(Locator locator, SIRequestor requestor) throws InvalidLocatorException, SecurityException
Bouquet from the collection.This method delivers its results asynchronously.
locator - A Locator referencing the
Bouquet 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 bouquet.SecurityException - If the caller does not have
javax.tv.service.ReadPermission(locator).Bouquet,
ReadPermissionSIRequest retrieveBouquets(SIRequestor requestor)
Bouquet objects in
this BouquetCollection. This array will only contain
Bouquet instances b for which the caller has
javax.tv.service.ReadPermission(b.getLocator()). If
no Bouquet instances meet this criteria, this method
will result in an SIRequestFailureType of
DATA_UNAVAILABLE.This method delivers its results asynchronously.
requestor - The SIRequestor to be notified
when this retrieval operation completes.SIRequest object identifying this
asynchronous retrieval request.Bouquet,
ReadPermissionvoid addBouquetChangeListener(BouquetChangeListener listener)
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 and an
SIChangeType of ADD,
REMOVE or MODIFY. Only changes to
Bouquet instances b for which the
caller has
javax.tv.service.ReadPermission(b.getLocator()) will
be reported.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.
listener - A BouquetChangeListener to be
notified about changes related to Bouquet
carried on this Transport.BouquetChangeEvent,
ReadPermissionvoid removeBouquetChangeListener(BouquetChangeListener listener)
BouquetChangeListener. If the specified
BouquetChangeListener is not registered, no
action is performed.listener - A previously registered listener.Copyright © 2012 code4tv.com. All Rights Reserved.