com.sun.tv.si

Class ServiceDetailsImpl

java.lang.Object

com.sun.tv.si.ServiceDetailsImpl

All Implemented Interfaces:

CAIdentification, ServiceDetails, ServiceProviderInformation, SIElement, SIRetrievable

public class ServiceDetailsImpl
extends Object
implements ServiceDetails, ServiceProviderInformation

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 ServiceDetailsImpl object may optionally implement the ServiceNumber interface to report service numbers as assigned by the broadcaster of the Service

A ServiceDetailsImpl object may optionally implement the ServiceProviderInformation interface to report information concerning the service provider.

See Also:

Service, ServiceNumber, ServiceProviderInformation

Constructor Summary

Constructors

Constructor and Description
ServiceDetailsImpl(ServiceImpl service, String providerName, DeliverySystemType deliverySystemType, String longname, int[] caSystemIDs, Date updatedTime)

Method Summary

Methods

Modifier and Type	Method and Description
void	addServiceComponentChangeListener(ServiceComponentChangeListener listener) Registers a ServiceComponentChangeListener to be notified of changes to a ServiceComponent that is part of this ServiceDetails.
int[]	getCASystemIDs() Returns an array of CA System IDs associated with this object.
DeliverySystemType	getDeliverySystemType() This method provides information about the type of delivery mechanism used for the content described by this object.
Locator	getLocator() Gets the complete Locator of this SI Element.
String	getLongName() Called to obtain a full service name.
ProgramSchedule	getProgramSchedule() Returns a schedule of program events associated with this Service.
String	getProviderName() Returns the name of the service provider.
Service	getService() Returns the Service this ServiceDetailsImpl object is associated with.
ServiceInformationType	getServiceInformationType() Reports the service information format of this object.
ServiceType	getServiceType() Retuns the type of this service.
Date	getUpdateTime() Returns the time when this object was last updated from data in the broadcast.
boolean	isFree() Provides information about conditional access of this object.
void	notifyListeners(ServiceComponentChangeEvent event) Notify all listeners that ServiceComponent has been changed.
void	removeServiceComponentChangeListener(ServiceComponentChangeListener listener) Called to unregister an ServiceComponentChangeListener.
SIRequest	retrieveComponents(SIRequestor requestor) Retrieves a list 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 class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.tv.service.SIElement

equals, hashCode

Constructor Detail

ServiceDetailsImpl

public ServiceDetailsImpl(ServiceImpl service,
                  String providerName,
                  DeliverySystemType deliverySystemType,
                  String longname,
                  int[] caSystemIDs,
                  Date updatedTime)

Method Detail

retrieveServiceDescription

public SIRequest retrieveServiceDescription(SIRequestor requestor)

Retrieves a textual description of this service if available.

This method delivers its results asynchronously.

Specified by:

retrieveServiceDescription in interface ServiceDetails

Parameters:

requestor - The SIRequestor to be notified when this retrieval operation completes.

Returns:

An SIRequest object identifying this asynchronous retrieval request.

See Also:

ServiceDescription

getServiceType

public ServiceType getServiceType()

Retuns the type of this service. (E.g. "digital television", "digital radio", "NVOD", etc.) These values can be mapped to the ATSC service type in the VCT table and the DVB service type in the Service Descriptor.

Specified by:

getServiceType in interface ServiceDetails

Returns:

Service type of this Service.

retrieveComponents

public SIRequest retrieveComponents(SIRequestor requestor)

Retrieves a list of elementary components which are part of this service.

This method delivers its results asynchronously.

Specified by:

retrieveComponents in interface ServiceDetails

Parameters:

requestor - The SIRequestor to be notified when this retrieval operation completes.

Returns:

An SIRequest object identifying this asynchronous retrieval request.

See Also:

javax.tv.service.ServiceComponent

getProgramSchedule

public ProgramSchedule getProgramSchedule()

Returns a schedule of program events associated with this Service.

Specified by:

getProgramSchedule in interface ServiceDetails

Returns:

The Program Schedule for this Service.

getLongName

public String getLongName()

Called to obtain a full service name. This information may be delivered in the ATSC Extended Channel Name Descriptor, the DVB Service Descriptor or the DVB Multilingual Service Name Descriptor.

Specified by:

getLongName in interface ServiceDetails

Returns:

A string representing the full service name.

getService

public Service getService()

Returns the Service this ServiceDetailsImpl object is associated with.

Specified by:

getService in interface ServiceDetails

Returns:

The Service this program is delivered on.

getCASystemIDs

public int[] getCASystemIDs()

Returns an array of CA System IDs associated with this object. This information may be obtained from the CAT MPEG message or a system specific conditional access descriptor (such as defined by Simulcrypt or ATSC).

Specified by:

getCASystemIDs in interface CAIdentification

Returns:

An array of CA System IDs. An empty array is returned when no CA System IDs are available.

isFree

public boolean isFree()

Provides information about conditional access of this object.

Specified by:

isFree in interface CAIdentification

Returns:

TRUE if this Service is not protected by a conditional access; FALSE if one or more components may be protected by conditional access.

getDeliverySystemType

public DeliverySystemType getDeliverySystemType()

This method provides information about the type of delivery mechanism used for the content described by this object.

Specified by:

getDeliverySystemType in interface ServiceDetails

Returns:

The delivery system type

getLocator

public Locator getLocator()

Gets the complete Locator of this SI Element. Each SI Element (such as BroadcastService, ProgramEvent, etc.) in the MPEG-2 domain is identified by a Locator. This identification is encapsulated by the Locator object which may use a URL format, specific MPEG numbers, such as network ID, etc., or other mechanisms.

Specified by:

getLocator in interface SIElement

Returns:

Locator representing this SI Element

getUpdateTime

public Date getUpdateTime()

Returns the time when this object was last updated from data in the broadcast.

Specified by:

getUpdateTime in interface SIRetrievable

Returns:

The date of the last update in UTC format, or null if unknown.

getServiceInformationType

public ServiceInformationType getServiceInformationType()

Reports the service information format of this object.

Specified by:

getServiceInformationType in interface SIElement

Returns:

The service information format.

getProviderName

public String getProviderName()

Returns the name of the service provider. It can be retrieved from the DVB Service Descriptor or the Multilingual Service Name Descriptor.

Specified by:

getProviderName in interface ServiceProviderInformation

Returns:

A string representing the service provider's name. It returns an empty string if no provider information is available.

addServiceComponentChangeListener

public void addServiceComponentChangeListener(ServiceComponentChangeListener listener)
                                       throws SecurityException

Registers a 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.

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.

Specified by:

addServiceComponentChangeListener in interface ServiceDetails

Parameters:

listener - A ServiceComponentChangeListener to be notified about changes related to a ServiceComponent in this ServiceDetails.

Throws:

SecurityException

See Also:

ServiceComponentChangeEvent, ReadPermission

removeServiceComponentChangeListener

public void removeServiceComponentChangeListener(ServiceComponentChangeListener listener)

Called to unregister an ServiceComponentChangeListener. If the specified ServiceComponentChangeListener is not registered, no action is performed.

Specified by:

removeServiceComponentChangeListener in interface ServiceDetails

Parameters:

listener - A previously registered listener.

notifyListeners

public void notifyListeners(ServiceComponentChangeEvent event)

Notify all listeners that ServiceComponent has been changed.