org.apache.velocity.app.event

Interface MethodExceptionEventHandler

All Superinterfaces:

EventHandler

All Known Implementing Classes:

EventExample, PrintExceptions

public interface MethodExceptionEventHandler
extends EventHandler

Event handler called when a method throws an exception. This gives the application a chance to deal with it and either return something nice, or throw. Please return what you want rendered into the output stream.

Version:

$Id: MethodExceptionEventHandler.java 1753233 2016-07-18 14:43:23Z cbrisson $

Author:

Will Glass-Husain, Geir Magnusson Jr.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	MethodExceptionEventHandler.MethodExceptionExecutor Defines the execution strategy for methodException

Method Summary

Methods

Modifier and Type	Method and Description
Object	methodException(Class claz, String method, Exception e, Info info) Called when a method throws an exception.

Method Detail

methodException

Object methodException(Class claz,
                     String method,
                     Exception e,
                     Info info)

Called when a method throws an exception. Only the first registered MethodExceptionEventHandler is called. If none are registered a MethodInvocationException is thrown.

Parameters:

claz - the class of the object the method is being applied to

method - the method

e - the thrown exception

info - contains template, line, column details

Returns:

an object to insert in the page

Throws:

RuntimeException - an exception to be thrown instead inserting an object