Module org.pdfsam.eventstudio

Package org.pdfsam.eventstudio

Class Listeners

java.lang.Object

org.pdfsam.eventstudio.Listeners

class Listeners
extends Object

A thread-safe holder for the listeners

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final record	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 final record	Listeners.ReflectiveListenerWrapper	Reflective invocation of an annotated listener

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	Description
Listeners()

Method Summary

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

Methods inherited from class java.lang.Object

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

Field Details

LOG

private static final org.slf4j.Logger LOG

lock

private final ReentrantReadWriteLock lock

listeners

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

Constructor Details

Listeners

Listeners()

Method Details

add

<T> void add(Class<T> eventClass,
 Listener<T> listener,
 int priority,
 ReferenceStrength strength,
 boolean once)

addAll

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

nullSafeGetListenerHolders

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

remove

<T> boolean remove(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(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(Class<?> eventClass,
 Listeners.ListenerReferenceHolder listener,
 TreeSet<Listeners.ListenerReferenceHolder> set)

nullSafeGetListeners

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

Returns:

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