org.codehaus.groovy.grails.exceptions

Interface StackTraceFilterer

All Known Implementing Classes:

DefaultStackTraceFilterer

public interface StackTraceFilterer

Improves the output of stack traces produced by exceptions in a Grails application.

Since:

2.0

Author:

Graeme Rocher

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	FULL_STACK_TRACE_MESSAGE
static java.lang.String	SYS_PROP_DISPLAY_FULL_STACKTRACE

Method Summary

Modifier and Type	Method and Description
void	addInternalPackage(java.lang.String name) Adds a package name that should be filtered
java.lang.Throwable	filter(java.lang.Throwable source) Remove all apparently Grails-internal trace entries from the exception instance
java.lang.Throwable	filter(java.lang.Throwable source, boolean recursive) Remove all apparently Grails-internal trace entries from the exception instance
void	setCutOffPackage(java.lang.String cutOffPackage) Sets the package where the stack trace should end
void	setShouldFilter(boolean shouldFilter)

Field Detail

FULL_STACK_TRACE_MESSAGE

static final java.lang.String FULL_STACK_TRACE_MESSAGE

See Also:

Constant Field Values

SYS_PROP_DISPLAY_FULL_STACKTRACE

static final java.lang.String SYS_PROP_DISPLAY_FULL_STACKTRACE

See Also:

Constant Field Values

Method Detail

addInternalPackage

void addInternalPackage(java.lang.String name)

Adds a package name that should be filtered

Parameters:

name - The name of the package

setCutOffPackage

void setCutOffPackage(java.lang.String cutOffPackage)

Sets the package where the stack trace should end

Parameters:

cutOffPackage - The cut off package

filter

java.lang.Throwable filter(java.lang.Throwable source,
                           boolean recursive)

Remove all apparently Grails-internal trace entries from the exception instance

This modifies the original instance and returns it, it does not clone

Parameters:

source - The source exception

recursive - Whether to recursively filter the cause

Returns:

The exception passed in, after cleaning the stack trace

filter

java.lang.Throwable filter(java.lang.Throwable source)

Remove all apparently Grails-internal trace entries from the exception instance

This modifies the original instance and returns it, it does not clone

Parameters:

source - The source exception

Returns:

The exception passed in, after cleaning the stack trace

setShouldFilter

void setShouldFilter(boolean shouldFilter)

Parameters:

shouldFilter - Whether to filter stack traces or not