public TemplateException(Environment env) 
{
                    
        this(null, null, env);
}

Constructs a TemplateException with no specified detail message or underlying cause.

 public TemplateException(String description,
    Environment env) 
{
        this(description, null, env);
}

Constructs a TemplateException with the given detail message, but no underlying cause exception.

Parameters:

description - the description of the error that occurred

 public TemplateException(Exception cause,
    Environment env) 
{
        this(null, cause, env);
}

Constructs a TemplateException with the given underlying Exception, but no detail message.

Parameters:

cause - the underlying Exception that caused this exception to be raised

 public TemplateException(String description,
    Exception cause,
    Environment env) 
{
        super(getDescription(description, cause));
        causeException = cause;
        this.env = env;
        if(env != null)
        {
            StringWriter sw = new StringWriter();
            PrintWriter pw = new PrintWriter(sw);
            env.outputInstructionStack(pw);
            pw.flush();
            ftlInstructionStack = sw.toString();
        }
        else
        {
            ftlInstructionStack = "";
        }
}

Constructs a TemplateException with both a description of the error that occurred and the underlying Exception that caused this exception to be raised.

Parameters:

description - the description of the error that occurred

cause - the underlying Exception that caused this exception to be raised

 public Throwable getCause() 
{
        return causeException;
}

Returns the same exception as getCauseException. Provided to enable full JDK-generated stack traces when running under JDK 1.4.

 public Exception getCauseException() 
{
        return causeException;
}

Returns the underlying exception that caused this exception to be generated.

Note:
avoided calling it getCause to avoid name clash with JDK 1.4 method. This would be problematic because the JDK 1.4 method returns a Throwable rather than an Exception.

 public Environment getEnvironment() 
{
        return env;
}

 public String getFTLInstructionStack() 
{
        return ftlInstructionStack;
}

Returns the quote of the problematic FTL instruction and the FTL stack strace.

 public  void printStackTrace(PrintStream ps) 
{
        PrintWriter pw = new PrintWriter(new OutputStreamWriter(ps), true);
        printStackTrace(pw);
        pw.flush();
}

 public  void printStackTrace(PrintWriter pw) 
{
        pw.println();
        pw.println(getMessage());
        if (ftlInstructionStack != null && ftlInstructionStack.length() != 0) {
            pw.println("The problematic instruction:");
            pw.println(ftlInstructionStack);
        }
        pw.println("Java backtrace for programmers:");
        pw.println("----------");
        super.printStackTrace(pw);
        if (BEFORE_1_4 && causeException != null) {
            pw.println("Underlying cause: ");
            causeException.printStackTrace(pw);
        }
        // Dirty hack to fight with stupid ServletException class whose
        // getCause() method doesn't work properly. Also an aid for pre-J2xE 1.4
        // users.
        try {
            // Reflection is used to prevent dependency on Servlet classes.
            Method m = causeException.getClass().getMethod("getRootCause", EMPTY_CLASS_ARRAY);
            Throwable rootCause = (Throwable) m.invoke(causeException, EMPTY_OBJECT_ARRAY);
            if (rootCause != null) {
                Throwable j14Cause = null;
                if (!BEFORE_1_4) {
                    m = causeException.getClass().getMethod("getCause", EMPTY_CLASS_ARRAY);
                    j14Cause = (Throwable) m.invoke(causeException, EMPTY_OBJECT_ARRAY);
                }
                if (j14Cause == null) {
                    pw.println("ServletException root cause: ");
                    rootCause.printStackTrace(pw);
                }
            }
        } catch (Throwable exc) {
            ; // ignore
        }
}