opencard.core.util
Class Tracer

java.lang.Object
  |
  +--opencard.core.util.Tracer

public class Tracer
extends java.lang.Object

Utility class for tracing. Each class that wants its operations traced needs to instantiate a Tracer object specifying a tag to enable it by. Tracing at runtime is controlled through the set of tags configured in the opencard.tracer property:

tag
Trace all messages submitted under tag or any tag beginning with tag
tag:level
Trace all message with a level greater or equal to level submitted under tag or any tag beginning with tag


Constructor Summary
Tracer(java.lang.Class clazz)
          Traces a certain class.
Tracer(java.lang.Object me, java.lang.Class clazz)
          Traces a certain class.
Tracer(java.lang.Object me, java.lang.String className)
          Constructs a tracer for a certain object with the name of its class.
 
Method Summary
static void addTracerListener(TracerListener listener)
          Adds a TracerListener.
 void alert(java.lang.String meth, java.lang.String msg)
          Traces a ALERT level message.
 void alert(java.lang.String meth, java.lang.Throwable frisbee)
          Traces a ALERT throwable
 void critical(java.lang.String meth, java.lang.String msg)
          Traces a CRITICAL level message.
 void critical(java.lang.String meth, java.lang.Throwable frisbee)
          Traces a CRITICAL throwable
 void debug(java.lang.String meth, java.lang.String msg)
          Traces a DEBUG level message.
 void debug(java.lang.String meth, java.lang.Throwable frisbee)
          Traces a DEBUG throwable
 void emergency(java.lang.String meth, java.lang.String msg)
          Traces a EMERGENCY level message.
 void emergency(java.lang.String meth, java.lang.Throwable frisbee)
          Trace a EMERGENCY throwable
 void error(java.lang.String meth, java.lang.String msg)
          Traces a ERROR level message.
 void error(java.lang.String meth, java.lang.Throwable frisbee)
          Traces a ERROR throwable
 int getTraceLevel()
          Gets the current trace level of the tracer of a certain class/object.
 void info(java.lang.String meth, java.lang.String msg)
          Traces a INFO level message.
 void info(java.lang.String meth, java.lang.Throwable frisbee)
          Traces a INFO throwable
static void init()
          Initialize tracing by parsing trace properties into tracelist
 void notice(java.lang.String meth, java.lang.String msg)
          Traces a NOTICE level message.
 void notice(java.lang.String meth, java.lang.Throwable frisbee)
          Traces a NOTICE throwable
static void removeTracerListener(TracerListener listener)
          Removes a TracerListener.
protected  void trace(int level, java.lang.String meth, java.lang.String message)
          Adds a trace message.
protected  void trace(int level, java.lang.String meth, java.lang.Throwable frisbee)
          Traces the stack trace of the Throwable.
static void trace(java.lang.Object me, java.lang.String className, int level, java.lang.String meth, java.lang.String message, java.lang.Throwable frisbee)
          Adds a message to the trace.
 void warning(java.lang.String meth, java.lang.String msg)
          Traces a WARNING level message.
 void warning(java.lang.String meth, java.lang.Throwable frisbee)
          Trace a WARNING throwable
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Tracer

public Tracer(java.lang.Object me,
              java.lang.String className)
Constructs a tracer for a certain object with the name of its class.
Parameters:
me - The object that instantiates the tracer.
className - Name identifying the type of trace

Tracer

public Tracer(java.lang.Object me,
              java.lang.Class clazz)
Traces a certain class.
Parameters:
me - The object that instantiates the tracer.
clazz - the class to be traced

Tracer

public Tracer(java.lang.Class clazz)
Traces a certain class.
Parameters:
clazz - the class to be traced
Method Detail

init

public static void init()
Initialize tracing by parsing trace properties into tracelist

getTraceLevel

public int getTraceLevel()
Gets the current trace level of the tracer of a certain class/object.
Returns:
the trace level of this' tracer's class or -1 if this class is not to be traced at all

trace

public static void trace(java.lang.Object me,
                         java.lang.String className,
                         int level,
                         java.lang.String meth,
                         java.lang.String message,
                         java.lang.Throwable frisbee)
Adds a message to the trace.

Parameters:
level - The debug level.
className - The class name of the source.
me - The source object.
meth - The method name.
thread - The originating thread.
message - The trace message

trace

protected void trace(int level,
                     java.lang.String meth,
                     java.lang.String message)
Adds a trace message.
Parameters:
message - The trace message.

trace

protected void trace(int level,
                     java.lang.String meth,
                     java.lang.Throwable frisbee)
Traces the stack trace of the Throwable.
Parameters:
level - The trace level for this trace event.
meth - The name of the method that generates this trace event.
frisbee - The Throwable to trace.

debug

public void debug(java.lang.String meth,
                  java.lang.String msg)
Traces a DEBUG level message.

debug

public void debug(java.lang.String meth,
                  java.lang.Throwable frisbee)
Traces a DEBUG throwable

info

public void info(java.lang.String meth,
                 java.lang.String msg)
Traces a INFO level message.

info

public void info(java.lang.String meth,
                 java.lang.Throwable frisbee)
Traces a INFO throwable

notice

public void notice(java.lang.String meth,
                   java.lang.String msg)
Traces a NOTICE level message.

notice

public void notice(java.lang.String meth,
                   java.lang.Throwable frisbee)
Traces a NOTICE throwable

warning

public void warning(java.lang.String meth,
                    java.lang.String msg)
Traces a WARNING level message.

warning

public void warning(java.lang.String meth,
                    java.lang.Throwable frisbee)
Trace a WARNING throwable

error

public void error(java.lang.String meth,
                  java.lang.String msg)
Traces a ERROR level message.

error

public void error(java.lang.String meth,
                  java.lang.Throwable frisbee)
Traces a ERROR throwable

critical

public void critical(java.lang.String meth,
                     java.lang.String msg)
Traces a CRITICAL level message.

critical

public void critical(java.lang.String meth,
                     java.lang.Throwable frisbee)
Traces a CRITICAL throwable

alert

public void alert(java.lang.String meth,
                  java.lang.String msg)
Traces a ALERT level message.

alert

public void alert(java.lang.String meth,
                  java.lang.Throwable frisbee)
Traces a ALERT throwable

emergency

public void emergency(java.lang.String meth,
                      java.lang.String msg)
Traces a EMERGENCY level message.

emergency

public void emergency(java.lang.String meth,
                      java.lang.Throwable frisbee)
Trace a EMERGENCY throwable

addTracerListener

public static void addTracerListener(TracerListener listener)
Adds a TracerListener.

removeTracerListener

public static void removeTracerListener(TracerListener listener)
Removes a TracerListener.