net.lenni0451.lambdaevents

Class LambdaManager

java.lang.Object

net.lenni0451.lambdaevents.LambdaManager

@ParametersAreNonnullByDefault
public class LambdaManager
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
LambdaManager(java.util.Map<java.lang.Class<?>,java.util.List<AHandler>> handlers, java.util.function.Supplier<java.util.List<AHandler>> listSupplier, IGenerator generator) Deprecated.
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) Register a Consumer as an event handler for the given events.
void	register(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	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) Register a Runnable as an event handler for the given events.
void	register(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.
void	setAlwaysCallParents(boolean alwaysCallParents) Always call all event handlers for parent classes of the event (including interfaces).
void	setExceptionHandler(IExceptionHandler exceptionHandler) Set the IExceptionHandler which is used to handle thrown exceptions in event handlers.
void	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) Unregister a Consumer from all events.
void	unregister(java.util.function.Consumer<?> consumer, java.lang.Class<?>... events) Unregister a Consumer from the given events.
void	unregister(java.lang.Object owner) Unregister all non-static event handlers from the given object's class.
void	unregister(java.lang.Runnable runnable) Unregister a Runnable from all events.
void	unregister(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

@Deprecated
public LambdaManager(java.util.Map<java.lang.Class<?>,java.util.List<AHandler>> handlers,
                                  java.util.function.Supplier<java.util.List<AHandler>> listSupplier,
                                  IGenerator generator)

Deprecated.

Deprecated constructor, use LambdaManager(Supplier, Supplier, IGenerator).

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

setExceptionHandler

public void 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

setRegisterSuperHandler

public void 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

setAlwaysCallParents

public void 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

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

register

public void register(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

register

public void register(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

register

public void register(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

register

public void register(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

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

unregister

public void unregister(java.lang.Runnable runnable)

Unregister a Runnable from all events.

Parameters:

runnable - The Runnable to unregister

unregister

public void unregister(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

unregister

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

Unregister a Consumer from all events.

Parameters:

consumer - The Consumer to unregister

unregister

public void unregister(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

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