54 lines
1.2 KiB
Java
54 lines
1.2 KiB
Java
package dev.kske.eventbus.core.handler;
|
|
|
|
import java.lang.reflect.InvocationTargetException;
|
|
|
|
import dev.kske.eventbus.core.*;
|
|
|
|
/**
|
|
* Internal representation of an event handling method.
|
|
*
|
|
* @author Kai S. K. Engelbart
|
|
* @since 1.2.0
|
|
* @see EventBus
|
|
*/
|
|
public interface EventHandler {
|
|
|
|
/**
|
|
* Executes the event handler.
|
|
*
|
|
* @param event the event used as the method parameter
|
|
* @throws EventBusException if the event handler isn't accessible or has an invalid
|
|
* signature
|
|
* @throws InvocationTargetException if the handler throws an exception
|
|
* @throws EventBusException if the handler has the wrong signature or is inaccessible
|
|
* @since 1.2.0
|
|
*/
|
|
void execute(Object event) throws EventBusException, InvocationTargetException;
|
|
|
|
/**
|
|
* @return the listener containing this handler
|
|
* @since 1.2.0
|
|
*/
|
|
Object getListener();
|
|
|
|
/**
|
|
* @return the event type this handler listens for
|
|
* @since 1.2.0
|
|
*/
|
|
Class<?> getEventType();
|
|
|
|
/**
|
|
* @return the priority of this handler
|
|
* @since 1.2.0
|
|
* @see Priority
|
|
*/
|
|
int getPriority();
|
|
|
|
/**
|
|
* @return whether this handler also accepts subtypes of the event type
|
|
* @since 1.2.0
|
|
* @see Polymorphic
|
|
*/
|
|
boolean isPolymorphic();
|
|
}
|