Module org.pdfsam.eventstudio

Package org.pdfsam.eventstudio

Class Listeners

java.lang.Object

org.pdfsam.eventstudio.Listeners

class Listeners
extends java.lang.Object

A thread-safe holder for the listeners

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	Listeners.DefaultListenerWrapper	Listener wrapper around an explicitly defined Listener
(package private) static class	Listeners.ListenerReferenceHolder	Holder for a Listeners.ListenerWrapper
(package private) static interface	Listeners.ListenerWrapper	Wraps a listener defined either explicitly or picked up by the annotation processor
private static class	Listeners.ReflectiveListenerWrapper	Reflective invocation of an annotated listener

Field Summary

Fields

Modifier and Type	Field	Description
private java.util.Map<java.lang.Class<?>,java.util.TreeSet<Listeners.ListenerReferenceHolder>>	listeners
private java.util.concurrent.locks.ReentrantReadWriteLock	lock
private static org.slf4j.Logger	LOG

Constructor Summary

Constructors

Constructor	Description
Listeners()

Method Summary

Modifier and Type	Method	Description
(package private) <T> void	add(java.lang.Class<T> eventClass, Listener<T> listener, int priority, ReferenceStrength strength)
java.util.Set<java.lang.Class<?>>	addAll(java.lang.Object bean, java.util.List<Annotations.ReflectiveListenerDescriptor> descriptors)
private java.util.TreeSet<Listeners.ListenerReferenceHolder>	nullSafeGetListenerHolders(java.lang.Class<?> eventClass)
(package private) java.util.List<Listeners.ListenerReferenceHolder>	nullSafeGetListeners(java.lang.Class<?> eventClass)
(package private) boolean	remove(java.lang.Class<?> eventClass, Listeners.ListenerReferenceHolder listener)	Removes the listener listening for the given event if present.
(package private) <T> boolean	remove(java.lang.Class<T> eventClass, Listener<T> listener)	Removes the listener listening for the given event if present.
private boolean	removeListenerAndSetIfNeeded(java.lang.Class<?> eventClass, Listeners.ListenerReferenceHolder listener, java.util.TreeSet<Listeners.ListenerReferenceHolder> set)

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final org.slf4j.Logger LOG

lock

private final java.util.concurrent.locks.ReentrantReadWriteLock lock

listeners

private final java.util.Map<java.lang.Class<?>,java.util.TreeSet<Listeners.ListenerReferenceHolder>> listeners

Constructor Detail

Listeners

Listeners()

Method Detail

add

<T> void add(java.lang.Class<T> eventClass,
             Listener<T> listener,
             int priority,
             ReferenceStrength strength)

addAll

public java.util.Set<java.lang.Class<?>> addAll(java.lang.Object bean,
                                                java.util.List<Annotations.ReflectiveListenerDescriptor> descriptors)

nullSafeGetListenerHolders

private java.util.TreeSet<Listeners.ListenerReferenceHolder> nullSafeGetListenerHolders(java.lang.Class<?> eventClass)

remove

<T> boolean remove(java.lang.Class<T> eventClass,
                   Listener<T> listener)

Removes the listener listening for the given event if present. It also removes the listeners set from the map if the set is empty.

Returns:

true if the listener was present and has been removed

remove

boolean remove(java.lang.Class<?> eventClass,
               Listeners.ListenerReferenceHolder listener)

Removes the listener listening for the given event if present. It also removes the listeners set from the map if the set is empty.

Returns:

true if the listener was present and has been removed

removeListenerAndSetIfNeeded

private boolean removeListenerAndSetIfNeeded(java.lang.Class<?> eventClass,
                                             Listeners.ListenerReferenceHolder listener,
                                             java.util.TreeSet<Listeners.ListenerReferenceHolder> set)

nullSafeGetListeners

java.util.List<Listeners.ListenerReferenceHolder> nullSafeGetListeners(java.lang.Class<?> eventClass)

Returns:

A sorted set containing the listeners queue for the given class.