com.sun.mail.util.logging

Class CompactFormatter

java.lang.Object

java.util.logging.Formatter

com.sun.mail.util.logging.CompactFormatter

public class CompactFormatter
extends Formatter

A plain text formatter that can produce fixed width output. By default this formatter will produce output no greater than 160 characters wide. Only specified fields support an alternate fixed width format.

The LogManager properties are:

• <formatter-name>.format - the format string used to transform the output. The format string can be used to fix the output size. (defaults to "%7$#.160s%n")

Since:

JavaMail 1.5.2

Author:

Jason Mehrens

Constructor Summary

Constructors

Constructor and Description
CompactFormatter() Creates an instance with a default format pattern.
CompactFormatter(String format) Creates an instance with the given format pattern.

Method Summary

Methods

Modifier and Type	Method and Description
protected Throwable	apply(Throwable t) Chooses a single throwable from the cause chain that will be formatted.
String	format(LogRecord record) Format the given log record and returns the formatted string.
String	formatBackTrace(LogRecord record) Formats the back trace for the given log record.
String	formatLevel(LogRecord record) Formats the level property of the given log record.
String	formatLoggerName(LogRecord record) Formats the logger name property of the given log record.
String	formatMessage(LogRecord record) Formats message for the log record.
String	formatMessage(Throwable t) Formats the message from the thrown property of the log record.
String	formatSource(LogRecord record) Formats the source from the given log record.
String	formatThrown(LogRecord record) Formats the thrown property of a LogRecord.
protected boolean	ignore(StackTraceElement s) Determines if a stack frame should be ignored as the cause of an error.
protected String	toAlternate(String s) Defines the alternate format.

Methods inherited from class java.util.logging.Formatter

getHead, getTail

Methods inherited from class java.lang.Object

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

Constructor Detail

CompactFormatter

public CompactFormatter()

Creates an instance with a default format pattern.

CompactFormatter

public CompactFormatter(String format)

Creates an instance with the given format pattern.

Parameters:

format - the pattern or null to use the LogManager default. The arguments are described in the format method.

Method Detail

format

public String format(LogRecord record)

Format the given log record and returns the formatted string. The java.util argument indexes are assigned to the following properties:

0. format - the java.util.Formatter format string specified in the <formatter-name>.format property or the format that was given when this formatter was created.
1. date - a Date object representing event time of the log record.
2. source - a string representing the caller, if available; otherwise, the logger's name.
3. logger - the logger's name.
4. level - the log level.
5. message - the formatted log message returned from the formatMessage(LogRecord) method.
6. thrown - a string representing the throwable associated with the log record and a relevant stack trace element if available. Otherwise, an empty string is used.
7. message|thrown The message and the thrown properties joined as one parameter. This parameter supports alternate form.
8. thrown|message The thrown and message properties joined as one parameter. This parameter supports alternate form.

Specified by:

format in class Formatter

Parameters:

record - to format.

Returns:

the formatted record.

Throws:

NullPointerException - if the given record is null.

formatMessage

public String formatMessage(LogRecord record)

Formats message for the log record. This method removes any fully qualified throwable class names from the message.

Overrides:

formatMessage in class Formatter

Parameters:

record - the log record.

Returns:

the formatted message string.

formatMessage

public String formatMessage(Throwable t)

Formats the message from the thrown property of the log record. This method removes any fully qualified throwable class names from the message cause chain.

Parameters:

t - the throwable to format.

Returns:

the formatted message string from the throwable.

formatLevel

public String formatLevel(LogRecord record)

Formats the level property of the given log record.

Parameters:

record - the record.

Returns:

the formatted logger name.

Throws:

NullPointerException - if the given record is null.

formatSource

public String formatSource(LogRecord record)

Formats the source from the given log record.

Parameters:

record - the record.

Returns:

the formatted source of the log record.

Throws:

NullPointerException - if the given record is null.

formatLoggerName

public String formatLoggerName(LogRecord record)

Formats the logger name property of the given log record.

Parameters:

record - the record.

Returns:

the formatted logger name.

Throws:

NullPointerException - if the given record is null.

formatThrown

public String formatThrown(LogRecord record)

Formats the thrown property of a LogRecord. The returned string will contain a throwable message with a back trace.

Parameters:

record - the record.

Returns:

empty string if nothing was thrown or formatted string.

Throws:

NullPointerException - if the given record is null.

See Also:

apply(java.lang.Throwable), formatBackTrace(java.util.logging.LogRecord)

formatBackTrace

public String formatBackTrace(LogRecord record)

Formats the back trace for the given log record.

Parameters:

record - the log record to format.

Returns:

the formatted back trace.

Throws:

NullPointerException - if the given record is null.

See Also:

apply(java.lang.Throwable), formatThrown(java.util.logging.LogRecord), ignore(java.lang.StackTraceElement)

apply

protected Throwable apply(Throwable t)

Chooses a single throwable from the cause chain that will be formatted. This implementation chooses the throwable that best describes the chain. Subclasses can override this method to choose an alternate throwable for formatting.

Parameters:

t - the throwable from the log record.

Returns:

the throwable or null.

See Also:

formatThrown(java.util.logging.LogRecord)

ignore

protected boolean ignore(StackTraceElement s)

Determines if a stack frame should be ignored as the cause of an error.

Parameters:

s - the stack trace element.

Returns:

true if this frame should be ignored.

See Also:

formatThrown(java.util.logging.LogRecord)

toAlternate

protected String toAlternate(String s)

Defines the alternate format. This implementation removes all control characters from the given string.

Parameters:

s - any string or null.

Returns:

null if the argument was null otherwise, an alternate string.