javax.microedition.broadcast.esg
Interface Service

All Superinterfaces:

ServiceGuideData

public interface Service
extends ServiceGuideData

Service uniquely identifies a broadcast TV or radio channel.

Services are normally obtained from ServiceGuide via the findServices methods.

Information regarding the service (metadata) can be obtained by means of the accessor methods. The information on a service may be changed over time. But the Service object is persistent. Updated information can be accessed through the Service object. A ServiceGuideListener can be registered via addListener registered to receive service event updates.

Service information in the service guide may be updated anytime. Applications can monitor the updates via the ServiceGuideListener.

A Service may also be deleted and becomes invalid over time. A SERVICE_DELETED or SERVICE_GUIDE_UPDATED event from the ServiceGuideListener may signal that. In that case, calling get*Value from a deleted Service object will receive an IllegalArgumentException.

See Also:

ServiceContext

Method Summary

ProgramEvent[]

getProgramEvents() Get the ProgramEvents that this Service carries.

Methods inherited from interface javax.microedition.broadcast.esg.ServiceGuideData

equals, getAvailableMetadataSets, getBooleanValue, getBooleanValues, getDateValue, getDateValues, getDoubleValue, getDoubleValues, getLongValue, getLongValues, getObjectValue, getObjectValues, getStringValue, getStringValues

Method Detail

getProgramEvents

ProgramEvent[] getProgramEvents()

Get the ProgramEvents that this Service carries.

Returns:

The list of ProgramEvents that this Service carries. If the Service does not carry any ProgramEvent, an array of zero-length will be returned.

Throws:

java.lang.IllegalArgumentException - Thrown if this Service has been deleted from the service guide.