org.jrebirth.af.core.ui.handler

Class AnnotationEventHandler<E extends Event>

java.lang.Object

org.jrebirth.af.core.ui.handler.AbstractNamedEventHandler<E>

org.jrebirth.af.core.ui.handler.AnnotationEventHandler<E>

Type Parameters:

E - the event type to handle

All Implemented Interfaces:

EventListener, EventHandler<E>, MessageContainer, UIMessages

public class AnnotationEventHandler<E extends Event>
extends AbstractNamedEventHandler<E>
implements EventHandler<E>, UIMessages

The interface AnnotationEventHandler.

Author:

Sébastien Bordes

Field Summary

Fields

Modifier and Type	Field and Description
private Annotation	annotation The OnXxxxx annotation that define which handler to manage.
private Object	callbackObject The object used to handle the triggered event.
private static JRLogger	LOGGER The class logger.

Fields inherited from interface org.jrebirth.af.core.ui.UIMessages

ANIM_ANNO_PROCESSING_FAILURE, CREATION_FAILURE, EVENT_HANDLING_IMPOSSIBLE, NO_EVENT_CALLBACK, NODE_ANNO_PROCESSING_FAILURE, VIEW_ANNO_PROCESSING_FAILURE

Constructor Summary

Constructors

Constructor and Description
AnnotationEventHandler(Object callbackObject, Annotation annotation) Default Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
private String	buildHandlingMethodName(EnumEventType annotationType) Build the handling method name used to manage this event.
private void	callMethod(String methodName, Event event) Call the method into the callback object.
private void	checkCallbackMethods() For each annotation event type, check if the callback method exists.
private EnumEventType	convertEventToEnum(EventType<? extends Event> eventType) Convert a JavaFX event type into an annotation event type.
private Class<Event>	getAnnotationApiEventClass() Return the api event class used by the annotation.
private String	getAnnotationName() Return the name of the annotation to define the unique callback method name.
private EnumEventType[]	getAnnotationValue() Return the value of the annotation used to define type of handler to manage.
void	handle(Event event)

Methods inherited from class org.jrebirth.af.core.ui.handler.AbstractNamedEventHandler

getName, toString

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

private static final JRLogger LOGGER

The class logger.

annotation

private final Annotation annotation

The OnXxxxx annotation that define which handler to manage.

callbackObject

private final Object callbackObject

The object used to handle the triggered event.

Constructor Detail

AnnotationEventHandler

public AnnotationEventHandler(Object callbackObject,
                      Annotation annotation)
                       throws CoreException

Default Constructor.

Parameters:

callbackObject - the object that will handle the event by reflection

annotation - the annotation that configure the event handling

Throws:

CoreException - if handler is not correctly initialized

Method Detail

checkCallbackMethods

private void checkCallbackMethods()
                           throws CoreException

For each annotation event type, check if the callback method exists.

Throws:

CoreException - an exception if the current class doesn't have the right handling method

handle

public void handle(Event event)

Specified by:

handle in interface EventHandler<E extends Event>

buildHandlingMethodName

private String buildHandlingMethodName(EnumEventType annotationType)

Build the handling method name used to manage this event.

Parameters:

annotationType - the custom annotation event type used to define the kind of event to manage

Returns:

the method name to trigger into the callback object

getAnnotationName

private String getAnnotationName()

Return the name of the annotation to define the unique callback method name.

Returns:

the annotation name attribute

getAnnotationValue

private EnumEventType[] getAnnotationValue()

Return the value of the annotation used to define type of handler to manage.

Returns:

the annotation value attribute

getAnnotationApiEventClass

private Class<Event> getAnnotationApiEventClass()

Return the api event class used by the annotation.

Returns:

the annotation apiEventClass attribute

convertEventToEnum

private EnumEventType convertEventToEnum(EventType<? extends Event> eventType)

Convert a JavaFX event type into an annotation event type.

Parameters:

eventType - the JavaFX event type

Returns:

the Annotation event type or null if not found

callMethod

private void callMethod(String methodName,
              Event event)

Call the method into the callback object.

Parameters:

methodName - the method name to call

event - the event to trigger