net.lenni0451.lambdaevents.IExceptionHandler Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of LambdaEvents Show documentation

Fast and modular event library for Java

The newest version!

package net.lenni0451.lambdaevents;

import net.lenni0451.lambdaevents.utils.EventException;
import net.lenni0451.lambdaevents.utils.ThrowingExceptionHandler;

/**
 * An interface to handle all exceptions thrown by event handlers.
 */
public interface IExceptionHandler {

    /**
     * @return A simple exception handler which just prints the stacktrace
     */
    static IExceptionHandler simplePrint() {
        return (handler, event, t) -> t.printStackTrace();
    }

    /**
     * @return An exception handler which prints the stacktrace with some additional information about the event and handler
     */
    static IExceptionHandler infoPrint() {
        return (handler, event, t) -> {
            new EventException("Exception occurred in '" + event.getClass().getSimpleName() + "' handler in '" + handler.getOwner().getName() + "'", t).printStackTrace();
        };
    }

    /**
     * @return A simple exception handler which just rethrows the exception
     */
    static IExceptionHandler throwing() {
        return new ThrowingExceptionHandler();
    }

    /**
     * @return A simple exception handler which ignores all exceptions
     */
    static IExceptionHandler ignore() {
        return (handler, event, t) -> {};
    }

    /**
     * @return A simple exception handler which throws a {@link StopCall} exception causing the event to stop calling other handlers
     */
    static IExceptionHandler stopCall() {
        return (handler, event, t) -> {
            throw StopCall.INSTANCE;
        };
    }


    /**
     * Handle the thrown exception.
     *
     * @param handler The handler that threw the exception
     * @param event   The instance of the event which caused the exception
     * @param t       The thrown exception
     */
    void handle(final AHandler handler, final Object event, final Throwable t);

}