javax.tv.carousel

Interface CarouselFileListener

All Superinterfaces:

EventListener

public interface CarouselFileListener
extends EventListener

The CarouselFileListener interface is implemented by application classes which require notification of changes to CarouselFile data.

Author:

Jon Courtney courtney@eng.sun.com

Method Summary

Methods

Modifier and Type	Method and Description
void	carouselFileChanged(CarouselFileChangeEvent event) Notifies the CarouselFileListener that the CarouselFile has changed in the broadcast.

Method Detail

carouselFileChanged

void carouselFileChanged(CarouselFileChangeEvent event)

Notifies the CarouselFileListener that the CarouselFile has changed in the broadcast. If the contents of a CarouselFile change while an application is reading its data from the local cache, the cached data shall either (a) remain entirely unchanged or (b) be flushed from the cache. If the data is flushed from the cache, attempts to read from this CarouselFile using pre-existing file reading objects (e.g. FileInputStream, FileReader, or RandomAccessFile) will fail.

To read the new data, the application must create a new file reading object. To ensure that this data is the most recent version from the broadcast, the application should first invoke the CarouselFile.refreshCache() method.

No guarantees are provided concerning the ability of the receiver to detect changes to the broadcast CarouselFile or the latency of event notification if a change is detected.

Parameters:

event - Event indicating CarouselFile that has changed.

See Also:

CarouselFile.refreshCache()