com.sun.dtv.broadcast
Interface BroadcastFileListener

All Superinterfaces:

EventListener

public interface BroadcastFileListener
extends EventListener

The BroadcastFileListener interface is implemented by application classes which require notification of changes to BroadcastFile data.

Method Summary

void	broadcastFileChanged(BroadcastFileEvent event) Notifies the BroadcastFileListener that the BroadcastFile has changed in the broadcast.
void	broadcastFileLost(BroadcastFileEvent event) Notifies the BroadcastFileListener that the BroadcastFile has been lost from the broadcast.

Method Detail

broadcastFileChanged

void broadcastFileChanged(BroadcastFileEvent event)

Notifies the BroadcastFileListener that the BroadcastFile has changed in the broadcast. If the contents of a BroadcastFile 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 BroadcastFile 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 BroadcastFile.refreshCache() method.

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

Parameters:

event - Event indicating BroadcastFile that has changed.

See Also:

BroadcastFile.refreshCache()

broadcastFileLost

void broadcastFileLost(BroadcastFileEvent event)

Notifies the BroadcastFileListener that the BroadcastFile has been lost from the broadcast. Reason for losing BroadcastFile from the broadcast could be selection of another service, transmission errors, discontinuation of the broadcast or others. If the contents of a BroadcastFile is lost while an application is reading its data from the local cache, the cached data shall either (a) remain available or (b) be cleared from the cache. If the data is cleared from the cache, attempts to read from this BroadcastFile using pre-existing file reading objects (e.g. FileInputStream, FileReader, or RandomAccessFile) will fail. Creation of new file reading object MUST also fail. To ensure information about file availability is the most recent from the broadcast, the application should first invoke the BroadcastFile.refreshCache() method on the parent directory.

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

Parameters:

event - Event indicating BroadcastFile that has changed.

See Also:

BroadcastFile.refreshCache()