2020-09-02 16:15:31 +02:00
|
|
|
package dev.kske.eventbus;
|
|
|
|
|
|
|
|
import java.lang.reflect.*;
|
|
|
|
|
2020-09-08 19:47:21 +02:00
|
|
|
import dev.kske.eventbus.Event.USE_PARAMETER;
|
|
|
|
|
2020-09-02 16:15:31 +02:00
|
|
|
/**
|
|
|
|
* Internal representation of an event handling method.
|
|
|
|
*
|
|
|
|
* @author Kai S. K. Engelbart
|
|
|
|
* @since 0.0.1
|
|
|
|
* @see EventBus
|
|
|
|
*/
|
|
|
|
final class EventHandler implements Comparable<EventHandler> {
|
|
|
|
|
|
|
|
private final EventListener listener;
|
|
|
|
private final Method method;
|
|
|
|
private final Event annotation;
|
2020-09-08 19:47:21 +02:00
|
|
|
private final Class<? extends IEvent> eventType;
|
2020-09-02 16:15:31 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructs an event handler.
|
|
|
|
*
|
|
|
|
* @param listener the listener containing the handler
|
|
|
|
* @param method the handler method
|
|
|
|
* @param annotation the event annotation
|
2020-09-08 19:47:21 +02:00
|
|
|
* @throws EventBusException if the method or the annotation do not comply with the
|
|
|
|
* specification
|
2020-09-02 16:15:31 +02:00
|
|
|
* @since 0.0.1
|
|
|
|
*/
|
2020-09-08 19:47:21 +02:00
|
|
|
@SuppressWarnings("unchecked")
|
|
|
|
EventHandler(EventListener listener, Method method, Event annotation) throws EventBusException {
|
2020-09-02 16:15:31 +02:00
|
|
|
this.listener = listener;
|
|
|
|
this.method = method;
|
|
|
|
this.annotation = annotation;
|
2020-09-08 19:47:21 +02:00
|
|
|
|
|
|
|
// Check for correct method signature and return type
|
|
|
|
if (method.getParameterCount() == 0 && annotation.eventType().equals(USE_PARAMETER.class))
|
|
|
|
throw new EventBusException(method + " does not define an event type!");
|
|
|
|
|
|
|
|
if (method.getParameterCount() == 1 && !annotation.eventType().equals(USE_PARAMETER.class))
|
|
|
|
throw new EventBusException(method + " defines an ambiguous event type!");
|
|
|
|
|
|
|
|
if (method.getParameterCount() > 1)
|
|
|
|
throw new EventBusException(method + " defines more than one parameter!");
|
|
|
|
|
|
|
|
if (!method.getReturnType().equals(void.class))
|
|
|
|
throw new EventBusException(method + " does not have a return type of void!");
|
|
|
|
|
|
|
|
// Determine the event type
|
|
|
|
Class<? extends IEvent> eventType = annotation.eventType();
|
|
|
|
if (eventType.equals(USE_PARAMETER.class)) {
|
|
|
|
var param = method.getParameterTypes()[0];
|
|
|
|
if (!IEvent.class.isAssignableFrom(param))
|
|
|
|
throw new EventBusException(param + " is not of type IEvent!");
|
|
|
|
eventType = (Class<? extends IEvent>) param;
|
|
|
|
}
|
|
|
|
this.eventType = eventType;
|
|
|
|
|
|
|
|
// Allow access if the method is non-public
|
2020-09-07 10:38:38 +02:00
|
|
|
method.setAccessible(true);
|
2020-09-02 16:15:31 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Compares this to another event handler based on {@link Event#priority()}. In case of equal
|
|
|
|
* priority a non-zero value based on hash codes is returned.
|
2020-09-03 09:52:00 +02:00
|
|
|
* <p>
|
|
|
|
* This is used to retrieve event handlers in the correct order from a tree set.
|
2020-09-02 16:15:31 +02:00
|
|
|
*
|
|
|
|
* @since 0.0.1
|
|
|
|
*/
|
|
|
|
@Override
|
|
|
|
public int compareTo(EventHandler other) {
|
2020-09-03 09:52:00 +02:00
|
|
|
int priority = other.annotation.priority() - annotation.priority();
|
2020-09-02 16:15:31 +02:00
|
|
|
if (priority == 0)
|
|
|
|
priority = listener.hashCode() - other.listener.hashCode();
|
|
|
|
return priority == 0 ? hashCode() - other.hashCode() : priority;
|
|
|
|
}
|
|
|
|
|
2020-09-20 15:27:51 +02:00
|
|
|
@Override
|
|
|
|
public String toString() {
|
|
|
|
return String.format("EventHandler[method=%s, annotation=%s]", method, annotation);
|
|
|
|
}
|
|
|
|
|
2020-09-02 16:15:31 +02:00
|
|
|
/**
|
|
|
|
* Executes the event handler.
|
|
|
|
*
|
|
|
|
* @param event the event used as the method parameter
|
|
|
|
* @throws EventBusException if the handler throws an exception
|
|
|
|
* @since 0.0.1
|
|
|
|
*/
|
|
|
|
void execute(IEvent event) throws EventBusException {
|
|
|
|
try {
|
2020-09-08 19:47:21 +02:00
|
|
|
if (annotation.eventType().equals(USE_PARAMETER.class))
|
|
|
|
method.invoke(listener, event);
|
|
|
|
else
|
|
|
|
method.invoke(listener);
|
2020-09-02 16:15:31 +02:00
|
|
|
} catch (
|
|
|
|
IllegalAccessException
|
|
|
|
| IllegalArgumentException
|
|
|
|
| InvocationTargetException e
|
|
|
|
) {
|
|
|
|
throw new EventBusException("Failed to invoke event handler!", e);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return the listener containing this handler
|
|
|
|
* @since 0.0.1
|
|
|
|
*/
|
|
|
|
EventListener getListener() { return listener; }
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return the event annotation
|
|
|
|
* @since 0.0.1
|
|
|
|
*/
|
|
|
|
Event getAnnotation() { return annotation; }
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return the priority of the event annotation
|
|
|
|
* @since 0.0.1
|
|
|
|
*/
|
|
|
|
int getPriority() { return annotation.priority(); }
|
2020-09-08 19:47:21 +02:00
|
|
|
|
2020-09-20 12:20:29 +02:00
|
|
|
/**
|
|
|
|
* @return whether this handler includes subtypes
|
|
|
|
* @since 0.0.4
|
|
|
|
*/
|
|
|
|
boolean includeSubtypes() { return annotation.includeSubtypes(); }
|
|
|
|
|
2020-09-08 19:47:21 +02:00
|
|
|
/**
|
|
|
|
* @return the event type this handler listens to
|
|
|
|
* @since 0.0.3
|
|
|
|
*/
|
|
|
|
Class<? extends IEvent> getEventType() { return eventType; }
|
2020-09-02 16:15:31 +02:00
|
|
|
}
|