net.lenni0451.lambdaevents

Class LambdaManager

java.lang.Object

net.lenni0451.lambdaevents.LambdaManager

public class LambdaManager
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
LambdaManager(java.util.function.Supplier<java.util.Map> mapSupplier, java.util.function.Supplier<java.util.List<AHandler>> listSupplier, IGenerator generator)

Method Summary

Modifier and Type	Method and Description
static LambdaManager	basic(IGenerator generator) Create a new LambdaManager instance using a HashMap and ArrayList.
<T> T	call(T event) Call all handlers for the given event.
<T> T	callParents(T event) Call all handlers for the given event and all parent classes of the event (including interfaces).
void	register(java.lang.Class<?> owner) Register all static event handlers in the given class.
void	register(java.lang.Class<?> event, java.lang.Class<?> owner) Register all static event handlers for the given event in the given class.
void	register(java.lang.Class<?> event, java.lang.Object owner) Register all non-static event handlers for the given event in the given object's class.
void	register(java.util.function.Consumer<?> consumer, java.lang.Class<?>... events) Deprecated.
void	register(java.util.function.Consumer<?> consumer, int priority, java.lang.Class<?>... events) Deprecated.
void	register(java.lang.Object owner) Register all non-static event handlers in the given object's class.
void	register(java.lang.Runnable runnable, java.lang.Class<?>... events) Deprecated.
void	register(java.lang.Runnable runnable, int priority, java.lang.Class<?>... events) Deprecated.
void	registerConsumer(java.util.function.Consumer<?> consumer, java.lang.Class<?>... events) Register a Consumer as an event handler for the given events.
void	registerConsumer(java.util.function.Consumer<?> consumer, int priority, java.lang.Class<?>... events) Register a Consumer as an event handler for the given events with the given priority.
void	registerRunnable(java.lang.Runnable runnable, java.lang.Class<?>... events) Register a Runnable as an event handler for the given events.
void	registerRunnable(java.lang.Runnable runnable, int priority, java.lang.Class<?>... events) Register a Runnable as an event handler for the given events with the given priority.
void	registerSuper(java.lang.Class<?> event, java.lang.Object owner) Register all non-static event handlers for the given event in the given object's class and all its super classes.
void	registerSuper(java.lang.Object owner) Register all non-static event handlers for the given object's class and all its super classes.
LambdaManager	setAlwaysCallParents(boolean alwaysCallParents) Always call all event handlers for parent classes of the event (including interfaces).
LambdaManager	setEventFilter(IEventFilter eventFilter) Set the event filter which is used to validate registered and called events.
LambdaManager	setExceptionHandler(IExceptionHandler exceptionHandler) Set the IExceptionHandler which is used to handle thrown exceptions in event handlers.
LambdaManager	setRegisterSuperHandler(boolean registerSuperHandler) Register all event handlers from super classes.
static LambdaManager	threadSafe(IGenerator generator) Create a new LambdaManager instance using a ConcurrentHashMap and CopyOnWriteArrayList.
java.lang.String	toString() Generate a debug output of all registered events and handlers.
void	unregister(java.lang.Class<?> owner) Unregister all static event handlers from the given class.
void	unregister(java.lang.Class<?> event, java.lang.Class<?> owner) Unregister all static event handlers for the given event from the given class.
void	unregister(java.lang.Class<?> event, java.lang.Object owner) Unregister all non-static event handlers for the given event from the given object's class.
void	unregister(java.util.function.Consumer<?> consumer) Deprecated.
void	unregister(java.util.function.Consumer<?> consumer, java.lang.Class<?>... events) Deprecated.
void	unregister(java.lang.Object owner) Unregister all non-static event handlers from the given object's class.
void	unregister(java.lang.Runnable runnable) Deprecated.
void	unregister(java.lang.Runnable runnable, java.lang.Class<?>... events) Deprecated.
void	unregisterAll(java.lang.Class<?> event) Unregister all handlers for the given event.
void	unregisterAll(java.lang.Class<?> event, java.util.function.BiPredicate<java.lang.Class<?>,java.util.Optional<java.lang.Object>> filter) Unregister all handlers for the given event which match the given filter.
void	unregisterAll(java.lang.Class<?> event, java.util.function.Predicate<java.lang.Class<?>> filter) Unregister all handlers for the given event which match the given filter.
void	unregisterAll(java.lang.Class<?> event, java.util.function.Predicate<java.lang.Class<?>> filter, boolean staticHandlers) Unregister all handlers for the given event which match the given filter.
void	unregisterConsumer(java.util.function.Consumer<?> consumer) Unregister a Consumer from all events.
void	unregisterConsumer(java.util.function.Consumer<?> consumer, java.lang.Class<?>... events) Unregister a Consumer from the given events.
void	unregisterRunnable(java.lang.Runnable runnable) Unregister a Runnable from all events.
void	unregisterRunnable(java.lang.Runnable runnable, java.lang.Class<?>... events) Unregister a Runnable from the given events.

Methods inherited from class java.lang.Object

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

Constructor Detail

LambdaManager

public LambdaManager(java.util.function.Supplier<java.util.Map> mapSupplier,
                     java.util.function.Supplier<java.util.List<AHandler>> listSupplier,
                     IGenerator generator)

Parameters:

mapSupplier - The supplier for the maps used to store the event to handler mappings

listSupplier - The supplier for the list used to store the handlers for an event

generator - The IGenerator implementation which should be used

Method Detail

basic

public static LambdaManager basic(IGenerator generator)

Create a new LambdaManager instance using a HashMap and ArrayList.
This implementation is not thread safe.

Parameters:

generator - The IGenerator implementation which should be used

Returns:

The new LambdaManager instance

threadSafe

public static LambdaManager threadSafe(IGenerator generator)

Create a new LambdaManager instance using a ConcurrentHashMap and CopyOnWriteArrayList.
This implementation is thread safe but has a performance impact.

Parameters:

generator - The IGenerator implementation which should be used

Returns:

The new LambdaManager instance

setEventFilter

public LambdaManager setEventFilter(@Nullable
                                    IEventFilter eventFilter)

Set the event filter which is used to validate registered and called events.
This can be used to only allow certain events to be registered or called.
If an event is not allowed

Parameters:

eventFilter - The Consumer which should be used to filter events

Returns:

The current LambdaManager instance

setExceptionHandler

public LambdaManager setExceptionHandler(IExceptionHandler exceptionHandler)

Set the IExceptionHandler which is used to handle thrown exceptions in event handlers.

Parameters:

exceptionHandler - The IExceptionHandler which should be used to handle exceptions

Returns:

The current LambdaManager instance

setRegisterSuperHandler

public LambdaManager setRegisterSuperHandler(boolean registerSuperHandler)

Register all event handlers from super classes.
This does not include static event handlers!

Parameters:

registerSuperHandler - If super classes should be scanned for event handlers

Returns:

The current LambdaManager instance

setAlwaysCallParents

public LambdaManager setAlwaysCallParents(boolean alwaysCallParents)

Always call all event handlers for parent classes of the event (including interfaces).
Basically a redirect from call(Object) to callParents(Object).

Parameters:

alwaysCallParents - If all event handlers for parent classes should be called

Returns:

The current LambdaManager instance

call

@Nonnull
public <T> T call(T event)

Call all handlers for the given event.

Type Parameters:

T - The event type

Parameters:

event - The event instance

Returns:

The given event instance

callParents

@Nonnull
public <T> T callParents(T event)

Call all handlers for the given event and all parent classes of the event (including interfaces).
e.g. RuntimeException -> Exception -> Throwable -> Serializable -> Object

Type Parameters:

T - The event type

Parameters:

event - The event instance

Returns:

The given event instance

register

public void register(java.lang.Class<?> owner)

Register all static event handlers in the given class.

Parameters:

owner - The class which should be scanned

register

public void register(@Nullable
                     java.lang.Class<?> event,
                     java.lang.Class<?> owner)

Register all static event handlers for the given event in the given class.

Parameters:

event - The event class

owner - The class which should be scanned

register

public void register(java.lang.Object owner)

Register all non-static event handlers in the given object's class.

Parameters:

owner - The object which should be scanned

register

public void register(@Nullable
                     java.lang.Class<?> event,
                     java.lang.Object owner)

Register all non-static event handlers for the given event in the given object's class.

Parameters:

event - The event class

owner - The object which should be scanned

registerSuper

public void registerSuper(java.lang.Object owner)

Register all non-static event handlers for the given object's class and all its super classes.
This does not include static event handlers!

Parameters:

owner - The object which should be scanned

registerSuper

public void registerSuper(@Nullable
                          java.lang.Class<?> event,
                          java.lang.Object owner)

Register all non-static event handlers for the given event in the given object's class and all its super classes.
This does not include static event handlers!

Parameters:

event - The event class

owner - The object which should be scanned

registerRunnable

public void registerRunnable(java.lang.Runnable runnable,
                             java.lang.Class<?>... events)

Register a Runnable as an event handler for the given events.

Parameters:

runnable - The Runnable which should be registered

events - The events for which the Runnable should be registered

registerRunnable

public void registerRunnable(java.lang.Runnable runnable,
                             int priority,
                             java.lang.Class<?>... events)

Register a Runnable as an event handler for the given events with the given priority.

Parameters:

runnable - The Runnable which should be registered

priority - The priority of the Runnable

events - The events for which the Runnable should be registered

registerConsumer

public void registerConsumer(java.util.function.Consumer<?> consumer,
                             java.lang.Class<?>... events)

Register a Consumer as an event handler for the given events.
Be aware that the Consumer will be called with the event instance as parameter. When using wrong type args this will result in a ClassCastException.

Parameters:

consumer - The Consumer which should be registered

events - The events for which the Consumer should be registered

registerConsumer

public void registerConsumer(java.util.function.Consumer<?> consumer,
                             int priority,
                             java.lang.Class<?>... events)

Register a Consumer as an event handler for the given events with the given priority.
Be aware that the Consumer will be called with the event instance as parameter. When using wrong type args this will result in a ClassCastException.

Parameters:

consumer - The Consumer which should be registered

priority - The priority of the Consumer

events - The events for which the Consumer should be registered

register

@Deprecated
public void register(java.lang.Runnable runnable,
                                  java.lang.Class<?>... events)

Deprecated.

Deprecated! Please use registerRunnable(Runnable, Class[]) instead

register

@Deprecated
public void register(java.lang.Runnable runnable,
                                  int priority,
                                  java.lang.Class<?>... events)

Deprecated.

Deprecated! Please use registerRunnable(Runnable, int, Class[]) instead

register

@Deprecated
public void register(java.util.function.Consumer<?> consumer,
                                  java.lang.Class<?>... events)

Deprecated.

Deprecated! Please use registerConsumer(Consumer, Class[]) instead

register

@Deprecated
public void register(java.util.function.Consumer<?> consumer,
                                  int priority,
                                  java.lang.Class<?>... events)

Deprecated.

Deprecated! Please use registerConsumer(Consumer, int, Class[]) instead

unregister

public void unregister(java.lang.Class<?> owner)

Unregister all static event handlers from the given class.

Parameters:

owner - The class from which the static event handlers should be unregistered

unregister

public void unregister(java.lang.Class<?> event,
                       java.lang.Class<?> owner)

Unregister all static event handlers for the given event from the given class.

Parameters:

event - The event class

owner - The class from which the static event handlers should be unregistered

unregister

public void unregister(java.lang.Object owner)

Unregister all non-static event handlers from the given object's class.

Parameters:

owner - The object from which the non-static event handlers should be unregistered

unregister

public void unregister(java.lang.Class<?> event,
                       java.lang.Object owner)

Unregister all non-static event handlers for the given event from the given object's class.

Parameters:

event - The event class

owner - The object from which the non-static event handlers should be unregistered

unregisterRunnable

public void unregisterRunnable(java.lang.Runnable runnable)

Unregister a Runnable from all events.

Parameters:

runnable - The Runnable to unregister

unregisterRunnable

public void unregisterRunnable(java.lang.Runnable runnable,
                               java.lang.Class<?>... events)

Unregister a Runnable from the given events.

Parameters:

runnable - The Runnable to unregister

events - The events from which the Runnable should be unregistered

unregisterConsumer

public void unregisterConsumer(java.util.function.Consumer<?> consumer)

Unregister a Consumer from all events.

Parameters:

consumer - The Consumer to unregister

unregisterConsumer

public void unregisterConsumer(java.util.function.Consumer<?> consumer,
                               java.lang.Class<?>... events)

Unregister a Consumer from the given events.

Parameters:

consumer - The Consumer to unregister

events - The events from which the Consumer should be unregistered

unregister

@Deprecated
public void unregister(java.lang.Runnable runnable)

Deprecated.

Deprecated! Please use unregisterRunnable(Runnable) instead

unregister

@Deprecated
public void unregister(java.lang.Runnable runnable,
                                    java.lang.Class<?>... events)

Deprecated.

Deprecated! Please use unregisterRunnable(Runnable, Class[]) instead

unregister

@Deprecated
public void unregister(java.util.function.Consumer<?> consumer)

Deprecated.

Deprecated! Please use unregisterConsumer(Consumer) instead

unregister

@Deprecated
public void unregister(java.util.function.Consumer<?> consumer,
                                    java.lang.Class<?>... events)

Deprecated.

Deprecated! Please use unregisterConsumer(Consumer, Class[]) instead

unregisterAll

public void unregisterAll(java.lang.Class<?> event)

Unregister all handlers for the given event.
This unregisters both static and non-static handlers.

Parameters:

event - The event class

unregisterAll

public void unregisterAll(java.lang.Class<?> event,
                          java.util.function.Predicate<java.lang.Class<?>> filter)

Unregister all handlers for the given event which match the given filter.
This unregisters both static and non-static handlers.

Parameters:

event - The event class

filter - The filter which should be used to filter the handlers

unregisterAll

public void unregisterAll(java.lang.Class<?> event,
                          java.util.function.Predicate<java.lang.Class<?>> filter,
                          boolean staticHandlers)

Unregister all handlers for the given event which match the given filter.

Parameters:

event - The event class

filter - The filter which should be used to filter the handlers

staticHandlers - If static handlers should be unregistered

unregisterAll

public void unregisterAll(java.lang.Class<?> event,
                          java.util.function.BiPredicate<java.lang.Class<?>,java.util.Optional<java.lang.Object>> filter)

Unregister all handlers for the given event which match the given filter.
This unregisters both static and non-static handlers.
The optional parameter is the instance of the handler or empty if the handler is static.

Parameters:

event - The event class

filter - The filter which should be used to filter the handlers

toString

public java.lang.String toString()

Generate a debug output of all registered events and handlers.

Overrides:

toString in class java.lang.Object

Returns:

The debug output