genius.core.listener

Interface Listener<T>

Type Parameters:

T - type of data being notified back to the caller.

All Known Implementing Classes:

ActionDocumentModel, ConsoleLogger, FileLogger, ListDataListenerAdapter, MultiPartyDataModel, MultiPartyTournamentProgressUI, OutcomesListModel, StatisticsLogger, XmlLogger

public interface Listener<T>

Listener for changes in a Listenable.

Method Summary

Modifier and Type	Method and Description
void	notifyChange(T data) a notification call that occurs when something changed.

Method Detail

notifyChange

void notifyChange(T data)

a notification call that occurs when something changed. Consult the parent object for details about this event.

NOTICE 1

notifications run in the thread of the caller. The caller will be blocked until this callback has been completed. It is therfore good practice to handle callbacks quickly.

NOTICE 2

Notifications often cross a thread sarety boundary. For example when in MVC a model (typically thread safe) calls back a panel (not thread safe). The called side (the panel) thus must handle the callback in a thread safe manner, e.g. using SwingUtilities.invokeLater(Runnable). We recommend to avoid synchronize as this will can block indefinitely (see notice 1) which might lead to deadlocks.

Parameters:

data - additional data, typically the new value associated with the event