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.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	setAlwaysCallParents(boolean alwaysCallParents) Always call all event handlers for parent classes of the event (including interfaces).
void	setExceptionHandler(ExceptionHandler exceptionHandler) Set the ExceptionHandler 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.
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, toString, wait, wait, wait

Constructor Detail

LambdaManager

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

Deprecated.

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

LambdaManager

public LambdaManager(@Nonnull
                     java.util.function.Supplier<java.util.Map> mapSupplier,
                     @Nonnull
                     java.util.function.Supplier<java.util.List<AHandler>> listSupplier,
                     @Nonnull
                     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(@Nonnull
                                  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(@Nonnull
                                       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(@Nonnull
                                ExceptionHandler exceptionHandler)

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

Parameters:

exceptionHandler - The ExceptionHandler which should be used to handle exceptions

setRegisterSuperHandler

public void setRegisterSuperHandler(boolean registerSuperHandler)

Register all event handlers from super classes.

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(@Nonnull
                            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(@Nonnull
                                   T event)

Call all handlers for the given event and all parent classes of the event (including interfaces).
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(@Nonnull
                     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,
                     @Nonnull
                     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(@Nonnull
                     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,
                     @Nonnull
                     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

register

public void register(@Nonnull
                     java.lang.Runnable runnable,
                     @Nonnull
                     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(@Nonnull
                     java.lang.Runnable runnable,
                     int priority,
                     @Nonnull
                     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(@Nonnull
                     java.util.function.Consumer<?> consumer,
                     @Nonnull
                     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(@Nonnull
                     java.util.function.Consumer consumer,
                     int priority,
                     @Nonnull
                     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(@Nonnull
                       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(@Nullable
                       java.lang.Class<?> event,
                       @Nonnull
                       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(@Nonnull
                       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(@Nullable
                       java.lang.Class<?> event,
                       @Nonnull
                       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(@Nonnull
                       java.lang.Runnable runnable)

Unregister a Runnable from all events.

Parameters:

runnable - The Runnable to unregister

unregister

public void unregister(@Nonnull
                       java.lang.Runnable runnable,
                       @Nonnull
                       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(@Nonnull
                       java.util.function.Consumer consumer)

Unregister a Consumer from all events.

Parameters:

consumer - The Consumer to unregister

unregister

public void unregister(@Nonnull
                       java.util.function.Consumer consumer,
                       @Nonnull
                       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