org.jboss.weld.event

Class EventImpl<T>

java.lang.Object

org.jboss.weld.bean.builtin.AbstractFacade<T,Event<T>>

org.jboss.weld.event.EventImpl<T>

Type Parameters:

T - The type of event being wrapped

All Implemented Interfaces:

Serializable, Event<T>, ExperimentalEvent<T>

public class EventImpl<T>
extends AbstractFacade<T,Event<T>>
implements ExperimentalEvent<T>, Serializable

Implementation of the Event interface

Author:

David Allen

See Also:

Event, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.jboss.weld.bean.builtin.AbstractFacade

AbstractFacade.AbstractFacadeSerializationProxy<T,X>

Method Summary

Modifier and Type	Method and Description
void	fire(T event) Fires an event with the specified qualifiers and notifies observers.
<U extends T> CompletionStage<U>	fireAsync(U event) Fires an event with the specified qualifiers and notifies observers asynchronously.
<U extends T> CompletionStage<U>	fireAsync(U event, Executor executor) Same as ExperimentalEvent.fireAsync(Object) but allows an executor, which is used for asynchronous event delivery, to be specified.
protected Type	getEventType(Class<?> runtimeType)
static <E> EventImpl<E>	of(InjectionPoint injectionPoint, BeanManagerImpl beanManager)
ExperimentalEvent<T>	select(Annotation... qualifiers) Obtains a child Event for the given additional required qualifiers.
<U extends T> ExperimentalEvent<U>	select(Class<U> subtype, Annotation... qualifiers) Obtains a child Event for the given required type and additional required qualifiers.
<U extends T> ExperimentalEvent<U>	select(TypeLiteral<U> subtype, Annotation... qualifiers) Obtains a child Event for the given required type and additional required qualifiers.
String	toString() Gets a string representation

Methods inherited from class org.jboss.weld.bean.builtin.AbstractFacade

equals, getBeanManager, getCreationalContext, getFacadeType, getInjectionPoint, getQualifiers, getType, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

of

public static <E> EventImpl<E> of(InjectionPoint injectionPoint,
                                  BeanManagerImpl beanManager)

toString

public String toString()

Gets a string representation

Overrides:

toString in class Object

Returns:

A string representation

fire

public void fire(T event)

Description copied from interface: Event

Fires an event with the specified qualifiers and notifies observers.

Specified by:

fire in interface Event<T>

Parameters:

event - the event object

fireAsync

public <U extends T> CompletionStage<U> fireAsync(U event)

Description copied from interface: ExperimentalEvent

Fires an event with the specified qualifiers and notifies observers asynchronously.

Observers bound to a transaction phase are registered to be executed in the corresponding transaction phase. Observers with TransactionPhase.IN_PROGRESS are notified in a configured thread pool. The ordering of observers is preserved. The message may be mutable and is guaranteed to be safely propagated between observers.

If there are multiple observers for the given event, a given observer is guaranteed to observe the event in a consistent state in which is:

• the state in which the event was left in by an observer executing before the given observer, or
• the initial state of the event if the given observer is the first one

The returned CompletionStage allows actions, which execute upon termination of this asynchronous dispatch, to be registered.

Specified by:

fireAsync in interface ExperimentalEvent<T>

Type Parameters:

U - the event type

Parameters:

event - the event object

Returns:

completion stage which allows additional actions to be bound to the asynchronous event dispatch

See Also:

CompletionStage

fireAsync

public <U extends T> CompletionStage<U> fireAsync(U event,
                                                  Executor executor)

Description copied from interface: ExperimentalEvent

Same as ExperimentalEvent.fireAsync(Object) but allows an executor, which is used for asynchronous event delivery, to be specified.

Specified by:

fireAsync in interface ExperimentalEvent<T>

Type Parameters:

U - the event type

Parameters:

event - the event object

executor - the executor to be used for asynchronous event delivery

Returns:

completion stage which allows additional actions to be bound to the asynchronous event dispatch

select

public ExperimentalEvent<T> select(Annotation... qualifiers)

Description copied from interface: Event

Obtains a child Event for the given additional required qualifiers.

Specified by:

select in interface Event<T>

Specified by:

select in interface ExperimentalEvent<T>

Parameters:

qualifiers - the additional specified qualifiers

Returns:

the child Event

select

public <U extends T> ExperimentalEvent<U> select(Class<U> subtype,
                                                 Annotation... qualifiers)

Description copied from interface: Event

Obtains a child Event for the given required type and additional required qualifiers.

Specified by:

select in interface Event<T>

Specified by:

select in interface ExperimentalEvent<T>

Type Parameters:

U - the specified type

Parameters:

subtype - a Class representing the specified type

qualifiers - the additional specified qualifiers

Returns:

the child Event

select

public <U extends T> ExperimentalEvent<U> select(TypeLiteral<U> subtype,
                                                 Annotation... qualifiers)

Description copied from interface: Event

Obtains a child Event for the given required type and additional required qualifiers.

Specified by:

select in interface Event<T>

Specified by:

select in interface ExperimentalEvent<T>

Type Parameters:

U - the specified type

Parameters:

subtype - a TypeLiteral representing the specified type

qualifiers - the additional specified qualifiers

Returns:

the child Event

getEventType

protected Type getEventType(Class<?> runtimeType)