ch.cmbntr.eventbus

Class Handlers

java.lang.Object

ch.cmbntr.eventbus.Handlers

public class Handlers
extends Object

Event handling.

Author:

Michael Locher

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Handlers.EventAndTargets Pair of an event and targets.
static interface	Handlers.EventDelivery Event delivery.
static class	Handlers.EventHandler An event handler.

Field Summary

Fields

Modifier and Type	Field and Description
static com.google.common.base.Predicate<Method>	IS_SUBSCRIBE_METHOD Tests if a method is a Subscribe handler.

Method Summary

Methods

Modifier and Type	Method and Description
static Handlers.EventDelivery	createDelivery(Method handler, boolean concurrent) Creates a new delivery for the given handler method.
static com.google.common.base.Function<Method,Handler>	handlerBuilder(String identifier, com.google.common.base.Function<? super Method,? extends Executor> deliveryExecutor, com.google.common.base.Predicate<? super Method> batchDelivery) Creates a handler factory.
static com.google.common.base.Predicate<Method>	isHandlerMarkedWith(Class<? extends Annotation> marker) Checks if a method is a valid handler method.
static Set<Class<?>>	linearizeHierarchy(Class<?> concreteClass) Linearizes a class's type hierarchy into a set of Class objects.
static com.google.common.cache.LoadingCache<Class<?>,Set<Handler>>	newHandlerCache(com.google.common.base.Predicate<? super Method> isHandler, com.google.common.base.Function<? super Method,Handler> builder) Creates a new event Handler cache.

Methods inherited from class java.lang.Object

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

Field Detail

IS_SUBSCRIBE_METHOD

public static final com.google.common.base.Predicate<Method> IS_SUBSCRIBE_METHOD

Tests if a method is a Subscribe handler.

Method Detail

newHandlerCache

public static com.google.common.cache.LoadingCache<Class<?>,Set<Handler>> newHandlerCache(com.google.common.base.Predicate<? super Method> isHandler,
                                                                          com.google.common.base.Function<? super Method,Handler> builder)

Creates a new event Handler cache.

Parameters:

isHandler - determines if a method is a handler

builder - the factory for handlers

Returns:

a new handler cache

createDelivery

public static Handlers.EventDelivery createDelivery(Method handler,
                                    boolean concurrent)

Creates a new delivery for the given handler method.

Parameters:

handler - the handler

concurrent - if true, concurrent deliveries are allowed on a single target

Returns:

the delivery

handlerBuilder

public static com.google.common.base.Function<Method,Handler> handlerBuilder(String identifier,
                                                             com.google.common.base.Function<? super Method,? extends Executor> deliveryExecutor,
                                                             com.google.common.base.Predicate<? super Method> batchDelivery)

Creates a handler factory.

Parameters:

identifier - a bus identifier

deliveryExecutor - provides executors for the handler methods

batchDelivery - determines if handler invocations are batched

Returns:

a new handler factory

isHandlerMarkedWith

public static com.google.common.base.Predicate<Method> isHandlerMarkedWith(Class<? extends Annotation> marker)

Checks if a method is a valid handler method.

Parameters:

marker - the marker to identify handlers

Returns:

the predicate, which returns true if a method is a handler method

linearizeHierarchy

public static Set<Class<?>> linearizeHierarchy(Class<?> concreteClass)

Linearizes a class's type hierarchy into a set of Class objects. The set will include all superclasses (transitively), and all interfaces implemented by these superclasses.

Parameters:

concreteClass - the type whose hierarchy will be processed

Returns:

the complete type hierarchy, flattened and uniqued