|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.opensymphony.util.Logger
public class Logger
The Logger is a quick way of logging messages of different priorities.
Usage
In it's simplest form, place the following field in the class that uses the debugging:
private static Logger log = new Logger(ThisClassName.class);
Then to log messages, in your code use:
log.info("Debug message");
You can have several Loggers in the same class by using the ( Class, String )
constructor as follows:
Logger logger = newLogger( ThisClassName.class ); // For general logging. Logger loopLogger = newLogger( ThisClassName.class, "loop" ); // Just for logging my loop.
This will create a Logger with context com.somecompany.thispackage.ThisClassName.loop
whose priority can be set from a config file independently of the main logger
com.somecompany.thispackage.ThisClassName
.
That's about it really. The types of log messages available (in order of severity - least first) are:
debug(java.lang.Object)
info(java.lang.Object)
warn(java.lang.Object)
error(java.lang.Object)
fatal(java.lang.Object)
Each of these methods has a variation accepting a second parameter of type Throwable. This is useful for logging Exceptions or Errors that are thrown.
There are corresponding methods for isDebugEnabled()
,
isInfoEnabled()
etc. to save the overhead of building the log string
if the appropriate level is not set, as follows:
if ( logger.isInfoEnabled() ) logger.info( "This " + methodCall() + " and the string " + "concatenation will only take place if " + "INFO debugging is currently enabled" );
The actual logging mechanism used depends on the configured
LogProvider
- this can be set
using the logger.provider system property. If not specified,
DefaultLogProvider
is used.
Constructor Summary | |
---|---|
Logger(Class cls)
Deprecated. Convenience constructor. |
|
Logger(Class cls,
String subCategory)
Deprecated. Convenience constructor. |
|
Logger(Object obj)
Deprecated. Convenience constructor. |
|
Logger(String name)
Deprecated. Create Logger with supplied context. |
Method Summary | |
---|---|
void |
debug(Object o)
Deprecated. |
void |
debug(Object o,
Throwable t)
Deprecated. |
void |
error(Object o)
Deprecated. |
void |
error(Object o,
Throwable t)
Deprecated. |
void |
fatal(Object o)
Deprecated. |
void |
fatal(Object o,
Throwable t)
Deprecated. |
void |
info(Object o)
Deprecated. |
void |
info(Object o,
Throwable t)
Deprecated. |
boolean |
isDebugEnabled()
Deprecated. |
boolean |
isEnabledFor(int priority)
Deprecated. |
boolean |
isErrorEnabled()
Deprecated. |
boolean |
isFatalEnabled()
Deprecated. |
boolean |
isInfoEnabled()
Deprecated. |
boolean |
isWarnEnabled()
Deprecated. |
void |
log(int priority,
Object o)
Deprecated. |
void |
log(int priority,
Object o,
Throwable t)
Deprecated. |
void |
warn(Object o)
Deprecated. |
void |
warn(Object o,
Throwable t)
Deprecated. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public Logger(String name)
public Logger(Class cls)
Logger(java.lang.String)
with cls.getName()
public Logger(Object obj)
Logger(java.lang.String)
with obj.getClass().getName()
public Logger(Class cls, String subCategory)
Method Detail |
---|
public boolean isDebugEnabled()
public boolean isEnabledFor(int priority)
public boolean isErrorEnabled()
public boolean isFatalEnabled()
public boolean isInfoEnabled()
public boolean isWarnEnabled()
public void debug(Object o)
public void debug(Object o, Throwable t)
public void error(Object o)
public void error(Object o, Throwable t)
public void fatal(Object o)
public void fatal(Object o, Throwable t)
public void info(Object o)
public void info(Object o, Throwable t)
public void log(int priority, Object o)
public void log(int priority, Object o, Throwable t)
public void warn(Object o)
public void warn(Object o, Throwable t)
|
OSCore Project Page | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |