|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface represents a collection of bouquets on a
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.
Method Summary | |
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 . |
Methods inherited from interface javax.tv.service.transport.Transport |
addServiceDetailsChangeListener, getDeliverySystemType, removeServiceDetailsChangeListener |
Method Detail |
public SIRequest retrieveBouquet(Locator locator, SIRequestor requestor) throws InvalidLocatorException, java.lang.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.
java.lang.SecurityException
- If the caller does not have
javax.tv.service.ReadPermission(locator)
.Bouquet
,
ReadPermission
public SIRequest 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
,
ReadPermission
public void 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
,
ReadPermission
public void removeBouquetChangeListener(BouquetChangeListener listener)
BouquetChangeListener
. If the specified
BouquetChangeListener
is not registered, no
action is performed.
listener
- A previously registered listener.
|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |