Class PrintExceptions

  • All Implemented Interfaces:
    EventHandler, MethodExceptionEventHandler, RuntimeServicesAware

    public class PrintExceptions
    extends java.lang.Object
    implements MethodExceptionEventHandler, RuntimeServicesAware
    Simple event handler that renders method exceptions in the page rather than throwing the exception. Useful for debugging.

    By default this event handler renders an error message containing the class and method which generated the exception, the exception name and its message. To render the reference and the location in the template, set the property eventhandler.methodexception.templateinfo to true. To render the stack trace, set the property eventhandler.methodexception.stacktrace to true.

    Since:
    1.5
    Version:
    $Id$
    • Constructor Summary

      Constructors 
      Constructor Description
      PrintExceptions()  
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      private static java.lang.String getStackTrace​(java.lang.Throwable throwable)  
      java.lang.Object methodException​(Context context, java.lang.Class<?> claz, java.lang.String method, java.lang.Exception e, Info info)
      Render the method exception, and optionally the exception message and stack trace.
      void setRuntimeServices​(RuntimeServices rs)
      Called automatically when event cartridge is initialized.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • SHOW_TEMPLATE_INFO

        private static java.lang.String SHOW_TEMPLATE_INFO
      • SHOW_STACK_TRACE

        private static java.lang.String SHOW_STACK_TRACE
    • Constructor Detail

      • PrintExceptions

        public PrintExceptions()
    • Method Detail

      • methodException

        public java.lang.Object methodException​(Context context,
                                                java.lang.Class<?> claz,
                                                java.lang.String method,
                                                java.lang.Exception e,
                                                Info info)
        Render the method exception, and optionally the exception message and stack trace.
        Specified by:
        methodException in interface MethodExceptionEventHandler
        Parameters:
        context - current context
        claz - the class of the object the method is being applied to
        method - the method
        e - the thrown exception
        info - template name and line, column informations
        Returns:
        an object to insert in the page
      • getStackTrace

        private static java.lang.String getStackTrace​(java.lang.Throwable throwable)