com.sun.tv.si

Class ServiceImpl

java.lang.Object

com.sun.tv.si.ServiceImpl

All Implemented Interfaces:

Service, ServiceMinorNumber, ServiceNumber, SIElement, SIRetrievable

public class ServiceImpl
extends Object
implements Service, SIElement, ServiceNumber, ServiceMinorNumber

Constructor Summary

Constructors

Constructor and Description
ServiceImpl(String serviceName, boolean hasMultiples, ServiceType sType, ServiceInformationType siType, int serviceNumber, int minorNumber, Date updatedTime) The ServiceImpl constructor accepts all information to setup a service entry in the SI database.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj) Tests two Service objects for equality.
Locator	getLocator() Gets the complete Locator of this SI Element.
int	getMinorNumber() Reports the minor number of the service.
String	getName() Returns a short service name or an acronym.
int	getPresentationTerminatedReason()
int	getSelectionFailedReason()
ServiceInformationType	getServiceInformationType() Reports the service information format of this object.
int	getServiceNumber() Reports the service number of a service.
ServiceType	getServiceType() Retuns the type of this service.
Date	getUpdateTime() Returns the time when this object was last updated from data in the broadcast.
int	hashCode() Reports the hash code value of this Service.
boolean	hasMultipleInstances() This method indicates whether the service represented by this Service is available on multiple transports.
SIRequest	retrieveDetails(SIRequestor requestor) This method retrieves additional information about the Service.
void	setPresentationTerminatedReason(int reason)
void	setSelectionFailedReason(int reason)

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceImpl

public ServiceImpl(String serviceName,
           boolean hasMultiples,
           ServiceType sType,
           ServiceInformationType siType,
           int serviceNumber,
           int minorNumber,
           Date updatedTime)

The ServiceImpl constructor accepts all information to setup a service entry in the SI database. However, the locator for this service information is created by the contructor from the service name. The service number and minor number are implemented within the service class, so that sorting can be done fairly quickly, information within the service details class is retrieve asynchronously.

Method Detail

getName

public String getName()

Returns a short service name or an acronym. This information comes in the PSIP VCT or the DVB Service Descriptor or the Multilingual Service Name Descriptor.

Specified by:

getName in interface Service

Returns:

A string representing this service's short name.

hasMultipleInstances

public boolean hasMultipleInstances()

This method indicates whether the service represented by this Service is available on multiple transports. (E.g. the same content delivered over terrestrial and cable network).

Specified by:

hasMultipleInstances in interface Service

Returns:

TRUE indicates that multiple transports may carry the same content identified by this Service; FALSE means that there is only one instance of this service.

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 Service

Returns:

Service type of this Service.

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 Service

Specified by:

getLocator in interface SIElement

Returns:

Locator representing this SI Element

See Also:

ServiceDetails

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.

getServiceNumber

public int getServiceNumber()

Reports the service number of a service.

Specified by:

getServiceNumber in interface ServiceNumber

Returns:

The number of the Service.

getMinorNumber

public int getMinorNumber()

Reports the minor number of the service.

Specified by:

getMinorNumber in interface ServiceMinorNumber

Returns:

The minor number of this service.

retrieveDetails

public SIRequest retrieveDetails(SIRequestor requestor)

This method retrieves additional information about the Service. This information is retrieved from the broadcast service information (also called meta-data).

Note that if the content represented by this Service is delivered on multiple transport-dependent streams, there may be multiple ServiceDetails for it. This method returns one of them based on availability or user preferences. If access to all of them is required, the Service Locator can be transformed to transport-dependent Locators and ServiceDetails can be requested for each one of them.

This method returns data asynchronously.

Specified by:

retrieveDetails in interface Service

Parameters:

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

Returns:

An SIRequest object identifying this asynchronous retrieval request.

See Also:

Locator, ServiceDetails

equals

public boolean equals(Object obj)

Tests two Service objects for equality. Returns true if and only if:

• obj's class is the same as the class of this Service, and

• obj's Locator is equal to the Locator of this Service (as reported by Service.getLocator(), and

• obj and this object encapsulate identical data.

Specified by:

equals in interface Service

Specified by:

equals in interface SIElement

Overrides:

equals in class Object

Parameters:

obj - The object against which to test for equality.

Returns:

true if the two Service objects are equal; false otherwise.

hashCode

public int hashCode()

Reports the hash code value of this Service. Two Service objects that are equal will have identical hash codes.

Specified by:

hashCode in interface Service

Specified by:

hashCode in interface SIElement

Overrides:

hashCode in class Object

Returns:

The hash code value of this Service.

setPresentationTerminatedReason

public void setPresentationTerminatedReason(int reason)

getPresentationTerminatedReason

public int getPresentationTerminatedReason()

setSelectionFailedReason

public void setSelectionFailedReason(int reason)

getSelectionFailedReason

public int getSelectionFailedReason()