org.apache.avalon.framework.logger

Class AvalonFormatter

java.lang.Object

org.apache.log.format.PatternFormatter

org.apache.log.format.ExtendedPatternFormatter

org.apache.avalon.framework.logger.AvalonFormatter

All Implemented Interfaces:

org.apache.log.format.Formatter

public class AvalonFormatter
extends org.apache.log.format.ExtendedPatternFormatter

This formatter extends ExtendedPatternFormatter so that CascadingExceptions are formatted with all nested exceptions.

• class : outputs the name of the class that has logged the message. The optional short subformat removes the package name. Warning : this pattern works only if formatting occurs in the same thread as the call to Logger, i.e. it won't work with AsyncLogTarget.

Version:

$Id: AvalonFormatter.java 30977 2004-07-30 03:57:54 -0500 (Fri, 30 Jul 2004) niclas $

Author:

Avalon Development Team

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.log.format.PatternFormatter

org.apache.log.format.PatternFormatter.PatternRun

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_PRINT_CASCADING The constant defining the default behaviour for printing nested exceptions.
static int	DEFAULT_STACK_DEPTH The constant defining the default stack depth when none other is specified.

Fields inherited from class org.apache.log.format.PatternFormatter

MAX_TYPE

Constructor Summary

Constructors

Constructor and Description
AvalonFormatter(String pattern) Construct the formatter with the specified pattern and which which prints out exceptions to stackDepth of 8.
AvalonFormatter(String pattern, int stackDepth, boolean printCascading) Construct the formatter with the specified pattern and which which prints out exceptions to stackDepth specified.

Method Summary

Modifier and Type	Method and Description
protected String	formatPatternRun(org.apache.log.LogEvent event, org.apache.log.format.PatternFormatter.PatternRun run) Return the result of formaltting a pattern run.
protected String	getStackTrace(Throwable throwable, String format) Utility method to format stack trace.
protected int	getTypeIdFor(String type) Retrieve the type-id for a particular string.

Methods inherited from class org.apache.log.format.PatternFormatter

format, getCategory, getContextMap, getMessage, getPriority, getRTime, getThread, getTime, parse

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_STACK_DEPTH

public static final int DEFAULT_STACK_DEPTH

The constant defining the default stack depth when none other is specified.

Since:

4.1.2

See Also:

Constant Field Values

DEFAULT_PRINT_CASCADING

public static final boolean DEFAULT_PRINT_CASCADING

The constant defining the default behaviour for printing nested exceptions.

Since:

4.1.2

See Also:

Constant Field Values

Constructor Detail

AvalonFormatter

public AvalonFormatter(String pattern)

Construct the formatter with the specified pattern and which which prints out exceptions to stackDepth of 8.

Parameters:

pattern - The pattern to use to format the log entries

Since:

4.1

AvalonFormatter

public AvalonFormatter(String pattern,
                       int stackDepth,
                       boolean printCascading)

Construct the formatter with the specified pattern and which which prints out exceptions to stackDepth specified.

Parameters:

pattern - The pattern to use to format the log entries

stackDepth - The depth to which stacktraces are printed out

printCascading - true enables printing of nested exceptions, false only prints out the outermost exception

Since:

4.1.2

Method Detail

getStackTrace

protected String getStackTrace(Throwable throwable,
                               String format)

Utility method to format stack trace.

Overrides:

getStackTrace in class org.apache.log.format.PatternFormatter

Parameters:

throwable - the throwable instance

format - ancilliary format parameter - allowed to be null

Returns:

the formatted string

getTypeIdFor

protected int getTypeIdFor(String type)

Retrieve the type-id for a particular string.

Overrides:

getTypeIdFor in class org.apache.log.format.ExtendedPatternFormatter

Parameters:

type - the string

Returns:

the type-id

formatPatternRun

protected String formatPatternRun(org.apache.log.LogEvent event,
                                  org.apache.log.format.PatternFormatter.PatternRun run)

Return the result of formaltting a pattern run.

Overrides:

formatPatternRun in class org.apache.log.format.ExtendedPatternFormatter

Parameters:

event - the log event

run - the patter formatter pattern run

Returns:

the formatted string