Class Event<EVENT_DATA>

java.lang.Object

org.teamapps.event.Event<EVENT_DATA>

Type Parameters:

EVENT_DATA - The type of data this event fires.

Direct Known Subclasses:

DecoupledEvent

public class Event<EVENT_DATA>
extends Object

Represents an event that can get fired.

Listeners can be added to this event using the various addListener(...) methods.

SessionContext-bound Event Listeners

Note that if a listener L is added while the thread is bound to a SessionContext A (so while SessionContext.currentOrNull() is not null), L's execution will be bound to A by default, i.e.:

• When this event fires, the SessionContext-bound listener will get invoked bound to the SessionContext A, regardless of the SessionContext (or the lack of it) the event was fired in.
• When the SessionContext A is destroyed (and thereby fires its SessionContext.onDestroyed event), the listener is automatically detached from this event.

You can prevent a listener from being bound to the current SessionContext, by using one of the addListener(..., boolean bindToSessionContext) methods.

Constructor Summary

Constructors

Constructor	Description
Event()

Method Summary

Modifier and Type	Method	Description
Disposable	addListener(Runnable listener)
Disposable	addListener(Runnable listener, boolean bindToSessionContext)
Disposable	addListener(Consumer<EVENT_DATA> listener)
Disposable	addListener(Consumer<EVENT_DATA> listener, boolean bindToSessionContext)
Disposable	addListener(SelfDisposingEventListener<EVENT_DATA> listener)
Disposable	addListener(SelfDisposingEventListener<EVENT_DATA> listener, boolean bindToSessionContext)
<T> Event<T>	converted(Function<EVENT_DATA,T> converter)
void	fire()
void	fire(EVENT_DATA eventData)
void	fireIfChanged(EVENT_DATA eventData)
void	fireIgnoringExceptions(EVENT_DATA eventData)
protected void	invokeListener(EVENT_DATA eventData, Consumer<EVENT_DATA> listener)	May get overridden.
void	removeListener(Runnable listener)	Deprecated. Use the Disposable returned by addListener(Runnable) instead!
void	removeListener(Consumer<EVENT_DATA> listener)	Deprecated. Use the Disposable returned by addListener(Consumer) instead!

Methods inherited from class java.lang.Object

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

Constructor Details

Event

public Event()

Method Details

addListener

public Disposable addListener(Consumer<EVENT_DATA> listener)

addListener

public Disposable addListener(Consumer<EVENT_DATA> listener,
 boolean bindToSessionContext)

addListener

public Disposable addListener(SelfDisposingEventListener<EVENT_DATA> listener)

addListener

public Disposable addListener(SelfDisposingEventListener<EVENT_DATA> listener,
 boolean bindToSessionContext)

addListener

public Disposable addListener(Runnable listener)

addListener

public Disposable addListener(Runnable listener,
 boolean bindToSessionContext)

removeListener

@Deprecated
public void removeListener(Runnable listener)

Deprecated.

Use the Disposable returned by addListener(Runnable) instead!

removeListener

@Deprecated
public void removeListener(Consumer<EVENT_DATA> listener)

Deprecated.

Use the Disposable returned by addListener(Consumer) instead!

fire

public void fire(EVENT_DATA eventData)

fireIgnoringExceptions

public void fireIgnoringExceptions(EVENT_DATA eventData)

invokeListener

protected void invokeListener(EVENT_DATA eventData,
 Consumer<EVENT_DATA> listener)

May get overridden.

fire

public void fire()

fireIfChanged

public void fireIfChanged(EVENT_DATA eventData)

converted

public <T> Event<T> converted(Function<EVENT_DATA,T> converter)