javax.microedition.broadcast.esg
Interface ProgramEvent

All Superinterfaces:

ServiceGuideData

public interface ProgramEvent
extends ServiceGuideData

ProgramEvent uniquely identifies a broadcast program event. This could be a program on a broadcast TV channel, a radio broadcast program, a movie streamed via IPDC or a locally recorded program, etc.

ProgramEvents are normally obtained from ServiceGuide via the findPrograms methods.

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

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

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

See Also:

ServiceContext

Method Summary

Service

getService() Get the Service that this ProgramEvent is broadcast from.

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

getService

Service getService()
                   throws java.lang.IllegalArgumentException

Get the Service that this ProgramEvent is broadcast from.

Returns:

The Service that this ProgramEvent is broadcast from. The return value must not be null.

Throws:

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