|
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 transport streams on a
Transport
. TransportStreamCollection
may
be optionally implemented by Transport
objects,
depending on the SI data carried on that transport.
Method Summary | |
void |
addTransportStreamChangeListener(TransportStreamChangeListener listener)
Registers a TransportStreamChangeListener to be
notified of changes to a TransportStream that is
part of this TransportStreamCollection . |
void |
removeTransportStreamChangeListener(TransportStreamChangeListener listener)
Called to unregister an TransportStreamChangeListener . |
SIRequest |
retrieveTransportStream(Locator locator,
SIRequestor requestor)
Retrieves the specified TransportStream from the
collection. |
SIRequest |
retrieveTransportStreams(SIRequestor requestor)
Retrieves an array of the TransportStream objects in
this TransportStreamCollection . |
Methods inherited from interface javax.tv.service.transport.Transport |
addServiceDetailsChangeListener, getDeliverySystemType, removeServiceDetailsChangeListener |
Method Detail |
public SIRequest retrieveTransportStream(Locator locator, SIRequestor requestor) throws InvalidLocatorException, java.lang.SecurityException
TransportStream
from the
collection.
locator
- Locator referencing the
TransportStream
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 transport stream.
java.lang.SecurityException
- If the caller does not have
javax.tv.service.ReadPermission(locator)
.TransportStream
,
ReadPermission
public SIRequest retrieveTransportStreams(SIRequestor requestor)
TransportStream
objects in
this TransportStreamCollection
. The array will only
contain TransportStream
instances ts
for which the caller has
javax.tv.service.ReadPermission(ts.getLocator())
. If
no TransportStream
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.TransportStream
,
ReadPermission
public void addTransportStreamChangeListener(TransportStreamChangeListener listener)
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 and an SIChangeType
of ADD
,
REMOVE
or MODIFY
. Only changes to
TransportStream
instances ts
for which
the caller has
javax.tv.service.ReadPermission(ts.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 TransportStreamChangeListener
is
already registered, no action is performed.
listener
- A TransportStreamChangeListener
to be
notified about changes related to TransportStream
carried on this Transport
.TransportStreamChangeEvent
,
ReadPermission
public void removeTransportStreamChangeListener(TransportStreamChangeListener listener)
TransportStreamChangeListener
. If the specified
TransportStreamChangeListener
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 |