log4j-TraceLevel

Here's an example of how to create a  Level :

public class TraceLevel extends Level {
  public static final int TRACE_INT = 800;

  // We assimilate TRACE to DEBUG on Syslog
  private static final int SYSLOG_TRACE_INT = 7;

  public static final TraceLevel TRACE =
      new TraceLevel(TRACE_INT, "TRACE", SYSLOG_TRACE_INT);

  final static public Level ALL = new TraceLevel(ALL_INT, "ALL", 9);

  protected TraceLevel(int level, String strLevel, int syslogEquiv) {
    super(level, strLevel, syslogEquiv);
  }

  public static Priority toPriority(String sArg) {
    return toPriority(sArg, TraceLevel.TRACE);
  }

  public static Priority toPriority(int i) throws IllegalArgumentException {
    return toPriority(i, TraceLevel.TRACE);
  }

  public static Priority toPriority(int i, Priority priority) {
    Priority p = (i == TRACE_INT) ?
        TraceLevel.TRACE :
        Priority.toPriority(i, priority);

    return p;
  }

  public static Priority toPriority(String sArg, Priority priority) {
    Priority p = (sArg == null) ?
        TraceLevel.TRACE :
        ((sArg.equalsIgnoreCase("TRACE")) ?
        TraceLevel.TRACE :
        Priority.toPriority(sArg, priority));

    return p;
  }

  public static Level toLevel(String s) {
    return toLevel(s, TraceLevel.TRACE);
  }

  public static Level toLevel(int i) {
    return toLevel(i, TraceLevel.TRACE);
  }

  public static Level toLevel(int i, Level level) {
    Level l = (i == TRACE_INT) ?
        TraceLevel.TRACE :
        Level.toLevel(i, level);

    return l;
  }

  public static Level toLevel(String s, Level level) {
    Level l = (s == null) ?
        TraceLevel.TRACE :
        ((s.equalsIgnoreCase("TRACE")) ?
        TraceLevel.TRACE :
        Level.toLevel(s, level));

    return l;
  }

  /**
   * @deprecated
   */
  public static Priority[] getAllPossiblePriorities() {
    return new Priority[]{Priority.FATAL, Priority.ERROR, Level.WARN,
                          Priority.INFO, Priority.DEBUG, TRACE};
  }
}

The value of TRACE_INT affects what log level messages appear at. For example, setting TRACE_INT to LogLevel.DEBUG_INT +1 will make it equivalent to the DEBUG level statements. Setting a value of LogLevel.FATAL_INT + 10000 will set the level above any default level and allow you to only log those messages.

The way it would be used is:

if (LOG.isEnabledFor(TraceLevel.TRACE)) LOG.log(TraceLevel.TRACE, "Got here");
To get it to show in your logs, of course you need to tell your Logger to use the TRACE level and above. Because it's not a predefined Level, you have to specify the class name. Here's an example of how to set the root Logger in your log4j.properties file:

log4j.rootLogger=trace#my.package.TraceLevel, MAIN, STDERR
last edited 2005-11-22 09:24:30 by SeanMcAree