Java TV(tm) API 1.0

javax.tv.carousel
Interface CarouselFileListener

All Superinterfaces:
java.util.EventListener

public interface CarouselFileListener
extends java.util.EventListener

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


Method Summary
 void carouselFileChanged(CarouselFileChangeEvent event)
          Notifies the CarouselFileListener that the CarouselFile has changed in the broadcast.
 

Method Detail

carouselFileChanged

public 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()

Java TV(tm) API 1.0

Copyright © 1998 - 2000 Sun Microsystems, Inc.