org.apache.log.format
Class ExtendedPatternFormatter

java.lang.Object
  extended byorg.apache.log.format.PatternFormatter
      extended byorg.apache.log.format.ExtendedPatternFormatter
All Implemented Interfaces:
Formatter
Direct Known Subclasses:
AvalonFormatter

public class ExtendedPatternFormatter
extends PatternFormatter

Formatter especially designed for debugging applications. This formatter extends the standard PatternFormatter to add two new possible expansions. These expansions are %{method} and %{thread}. In both cases the context map is first checked for values with specified key. This is to facilitate passing information about caller/thread when threads change (as in AsyncLogTarget). They then attempt to determine appropriate information dynamically.

Version:
$Id: ExtendedPatternFormatter.java 30977 2004-07-30 08:57:54Z niclas $
Author:
Avalon Development Team, Peter Donald

Nested Class Summary
 
Nested classes inherited from class org.apache.log.format.PatternFormatter
PatternFormatter.PatternRun
 
Field Summary
 
Fields inherited from class org.apache.log.format.PatternFormatter
MAX_TYPE
 
Constructor Summary
ExtendedPatternFormatter(java.lang.String format)
          Creation of a new extended pattern formatter.
ExtendedPatternFormatter(java.lang.String format, int callStackOffset)
          Creation of a new extended pattern formatter.
 
Method Summary
protected  java.lang.String formatPatternRun(LogEvent event, PatternFormatter.PatternRun run)
          Formats a single pattern run (can be extended in subclasses).
protected  int getTypeIdFor(java.lang.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, getStackTrace, getThread, getTime, parse
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ExtendedPatternFormatter

public ExtendedPatternFormatter(java.lang.String format)
Creation of a new extended pattern formatter.

Parameters:
format - the format string

ExtendedPatternFormatter

public ExtendedPatternFormatter(java.lang.String format,
                                int callStackOffset)
Creation of a new extended pattern formatter.

Parameters:
format - the format string
callStackOffset - the offset
Method Detail

getTypeIdFor

protected int getTypeIdFor(java.lang.String type)
Retrieve the type-id for a particular string.

Overrides:
getTypeIdFor in class PatternFormatter
Parameters:
type - the string
Returns:
the type-id

formatPatternRun

protected java.lang.String formatPatternRun(LogEvent event,
                                            PatternFormatter.PatternRun run)
Formats a single pattern run (can be extended in subclasses).

Overrides:
formatPatternRun in class PatternFormatter
Parameters:
event - the log event
run - the pattern run to format.
Returns:
the formatted result.


Copyright © 1997-2005 The Apache Software Foundation. All Rights Reserved.