|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface provides access to service meta-data. It provides more
information about a Service
object and represents a
specific instance of a service bound to a transport stream.
A ServiceDetails
object may optionally implement the
ServiceNumber
interface to report service numbers as
assigned by the broadcaster of the service.
A ServiceDetails
object may optionally implement the
ServiceProviderInformation
interface to report information
concerning the service provider.
Service
,
ServiceNumber
,
ServiceProviderInformation
,
Optionally implemented interfacesMethod Summary | |
void |
addServiceComponentChangeListener(ServiceComponentChangeListener listener)
Registers a ServiceComponentChangeListener to be
notified of changes to a ServiceComponent that is
part of this ServiceDetails . |
DeliverySystemType |
getDeliverySystemType()
Reports the type of mechanism by which this service was delivered. |
java.lang.String |
getLongName()
Called to obtain a full service name. |
ProgramSchedule |
getProgramSchedule()
Returns a schedule of program events associated with this service. |
Service |
getService()
Returns the Service this ServiceDetails
object is associated with. |
ServiceType |
getServiceType()
Returns the type of this service, for example, "digital television", "digital radio", "NVOD", etc. |
void |
removeServiceComponentChangeListener(ServiceComponentChangeListener listener)
Called to unregister an ServiceComponentChangeListener . |
SIRequest |
retrieveComponents(SIRequestor requestor)
Retrieves an array of elementary components which are part of this service. |
SIRequest |
retrieveServiceDescription(SIRequestor requestor)
Retrieves a textual description of this service if available. |
Methods inherited from interface javax.tv.service.SIElement |
equals, getLocator, getServiceInformationType, hashCode |
Methods inherited from interface javax.tv.service.SIRetrievable |
getUpdateTime |
Methods inherited from interface javax.tv.service.navigation.CAIdentification |
getCASystemIDs, isFree |
Method Detail |
public SIRequest retrieveServiceDescription(SIRequestor requestor)
requestor
- The SIRequestor
to be notified
when this retrieval operation completes.
SIRequest
object identifying this
asynchronous retrieval request.ServiceDescription
public ServiceType getServiceType()
public SIRequest retrieveComponents(SIRequestor requestor)
ServiceComponent
instances c
for which
the caller has
javax.tv.service.ReadPermission(c.getLocator())
. If
no ServiceComponent
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.ServiceComponent
,
ReadPermission
public ProgramSchedule getProgramSchedule()
null
if no schedule is available.public java.lang.String getLongName()
public Service getService()
Service
this ServiceDetails
object is associated with.
Service
to which this
ServiceDetails
belongs.public void addServiceComponentChangeListener(ServiceComponentChangeListener listener)
ServiceComponentChangeListener
to be
notified of changes to a ServiceComponent
that is
part of this ServiceDetails
. Subsequent notification
is made via ServiceComponentChangeEvent
with this
ServiceDetails
instance as the event source and an
SIChangeType
of ADD
,
REMOVE
or MODIFY
. Only changes to
ServiceComponent
instances c
for which
the caller has
javax.tv.service.ReadPermission(c.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 ServiceComponentChangeListener
is
already registered, no action is performed.
listener
- A ServiceComponentChangeListener
to be
notified about changes related to a ServiceComponent
in this ServiceDetails
.ServiceComponentChangeEvent
,
ReadPermission
public void removeServiceComponentChangeListener(ServiceComponentChangeListener listener)
ServiceComponentChangeListener
. If the specified
ServiceComponentChangeListener
is not registered, no
action is performed.
listener
- A previously registered listener.public DeliverySystemType getDeliverySystemType()
|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |