Class NoopEventManager

java.lang.Object

org.apache.cayenne.event.NoopEventManager

All Implemented Interfaces:

EventManager

public class NoopEventManager
extends Object
implements EventManager

Since:

4.1

Constructor Summary

Constructors

Constructor	Description
NoopEventManager()

Method Summary

Modifier and Type	Method	Description
<L, E extends EventObject> void	addListener(L listener, Class<E> eventClass, EventHandler<? super L, ? super E> handler, EventSubject subject)	Registers a listener for events sent by any sender.
<L, E extends EventObject> void	addListener(L listener, Class<E> eventClass, EventHandler<? super L, ? super E> handler, EventSubject subject, Object sender)	Registers a listener for events sent by a specific sender.
<L, E extends EventObject> void	addNonBlockingListener(L listener, Class<E> eventClass, EventHandler<? super L, ? super E> handler, EventSubject subject)	Registers a listener for events sent by any sender, to be notified on a dispatch thread instead of the thread that posted the event.
<L, E extends EventObject> void	addNonBlockingListener(L listener, Class<E> eventClass, EventHandler<? super L, ? super E> handler, EventSubject subject, Object sender)	Registers a listener for events sent by a specific sender, to be notified on a dispatch thread instead of the thread that posted the event.
boolean	isSingleThreaded()	Returns true if this EventManager is single-threaded.
void	postEvent(EventObject event, EventSubject subject)	Sends an event to all registered objects about a particular subject.
void	postNonBlockingEvent(EventObject event, EventSubject subject)	Sends an event to all registered objects about a particular subject.
boolean	removeAllListeners(EventSubject subject)	Removes all listeners for a given subject.
boolean	removeListener(Object listener)	Unregister the specified listener from all event subjects handled by this manager instance.
boolean	removeListener(Object listener, EventSubject subject)	Unregister the specified listener for the events about the given subject.
boolean	removeListener(Object listener, EventSubject subject, Object sender)	Unregister the specified listener for the events about the given subject and the given sender.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

NoopEventManager

public NoopEventManager()

Method Details

isSingleThreaded

public boolean isSingleThreaded()

Description copied from interface: EventManager

Returns true if this EventManager is single-threaded. If so it will throw an exception on any attempt to register an unblocking listener or dispatch a non-blocking event.

Specified by:

isSingleThreaded in interface EventManager

addListener

public <L, E extends EventObject> void addListener(L listener,
 Class<E> eventClass,
 EventHandler<? super L, ? super E> handler,
 EventSubject subject)

Description copied from interface: EventManager

Registers a listener for events sent by any sender.

Specified by:

addListener in interface EventManager

Parameters:

listener - the object to be notified about events

eventClass - the class of events the listener is interested in; events of other types are ignored

handler - the callback invoked with the listener and the event, normally an unbound method reference

subject - the event subject that the listener is interested in

addNonBlockingListener

public <L, E extends EventObject> void addNonBlockingListener(L listener,
 Class<E> eventClass,
 EventHandler<? super L, ? super E> handler,
 EventSubject subject)

Description copied from interface: EventManager

Registers a listener for events sent by any sender, to be notified on a dispatch thread instead of the thread that posted the event.

Specified by:

addNonBlockingListener in interface EventManager

See Also:

• EventManager.addListener(Object, Class, EventHandler, EventSubject)

addListener

public <L, E extends EventObject> void addListener(L listener,
 Class<E> eventClass,
 EventHandler<? super L, ? super E> handler,
 EventSubject subject,
 Object sender)

Description copied from interface: EventManager

Registers a listener for events sent by a specific sender.

Specified by:

addListener in interface EventManager

Parameters:

listener - the object to be notified about events

eventClass - the class of events the listener is interested in; events of other types are ignored

handler - the callback invoked with the listener and the event, normally an unbound method reference

subject - the event subject that the listener is interested in

sender - the object whose events the listener is interested in; null means 'any sender'

addNonBlockingListener

public <L, E extends EventObject> void addNonBlockingListener(L listener,
 Class<E> eventClass,
 EventHandler<? super L, ? super E> handler,
 EventSubject subject,
 Object sender)

Description copied from interface: EventManager

Registers a listener for events sent by a specific sender, to be notified on a dispatch thread instead of the thread that posted the event.

Specified by:

addNonBlockingListener in interface EventManager

removeListener

public boolean removeListener(Object listener)

Description copied from interface: EventManager

Unregister the specified listener from all event subjects handled by this manager instance.

Specified by:

removeListener in interface EventManager

Parameters:

listener - the object to be unregistered

Returns:

true if listener could be removed for any existing subjects, else returns false.

removeAllListeners

public boolean removeAllListeners(EventSubject subject)

Description copied from interface: EventManager

Removes all listeners for a given subject.

Specified by:

removeAllListeners in interface EventManager

removeListener

public boolean removeListener(Object listener,
 EventSubject subject)

Description copied from interface: EventManager

Unregister the specified listener for the events about the given subject.

Specified by:

removeListener in interface EventManager

Parameters:

listener - the object to be unregistered

subject - the subject from which the listener is to be unregistered

Returns:

true if listener could be removed for the given subject, else returns false.

removeListener

public boolean removeListener(Object listener,
 EventSubject subject,
 Object sender)

Description copied from interface: EventManager

Unregister the specified listener for the events about the given subject and the given sender.

Specified by:

removeListener in interface EventManager

Parameters:

listener - the object to be unregistered

subject - the subject from which the listener is to be unregistered

sender - the object whose events the listener was interested in; null means 'any sender'.

Returns:

true if listener could be removed for the given subject, else returns false.

postEvent

public void postEvent(EventObject event,
 EventSubject subject)

Description copied from interface: EventManager

Sends an event to all registered objects about a particular subject. Event is sent synchronously, so the sender thread is blocked until all the listeners finish processing the event.

Specified by:

postEvent in interface EventManager

postNonBlockingEvent

public void postNonBlockingEvent(EventObject event,
 EventSubject subject)

Description copied from interface: EventManager

Sends an event to all registered objects about a particular subject. Event is queued by EventManager, releasing the sender thread, and is later dispatched in a separate thread.

Specified by:

postNonBlockingEvent in interface EventManager