Class ICUNotifier
- Direct Known Subclasses:
ICUService
Abstract implementation of a notification facility. Clients add EventListeners with addListener and remove them with removeListener. Notifiers call notifyChanged when they wish to notify listeners. This queues the listener list on the notification thread, which eventually dequeues the list and calls notifyListener on each listener in the list.
Subclasses override acceptsListener and notifyListener to add type-safe notification. AcceptsListener should return true if the listener is of the appropriate type; ICUNotifier itself will ensure the listener is non-null and that the identical listener is not already registered with the Notifier. NotifyListener should cast the listener to the appropriate type and call the appropriate method on the listener.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprivate static class
The notification thread. -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate List<EventListener>
private final Object
private ICUNotifier.NotifyThread
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected abstract boolean
Subclasses implement this to return true if the listener is of the appropriate type.void
Add a listener to be notified when notifyChanged is called.void
Queue a notification on the notification thread for the current listeners.protected abstract void
Subclasses implement this to notify the listener.void
Stop notifying this listener.
-
Field Details
-
notifyLock
-
notifyThread
-
listeners
-
-
Constructor Details
-
ICUNotifier
public ICUNotifier()
-
-
Method Details
-
addListener
Add a listener to be notified when notifyChanged is called. The listener must not be null. AcceptsListener must return true for the listener. Attempts to concurrently register the identical listener more than once will be silently ignored. -
removeListener
Stop notifying this listener. The listener must not be null. Attempts to remove a listener that is not registered will be silently ignored. -
notifyChanged
public void notifyChanged()Queue a notification on the notification thread for the current listeners. When the thread unqueues the notification, notifyListener is called on each listener from the notification thread. -
acceptsListener
Subclasses implement this to return true if the listener is of the appropriate type. -
notifyListener
Subclasses implement this to notify the listener.
-