|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.log4j.Category
org.apache.log4j.Logger
This is the central class in the log4j package. Most logging operations, except configuration, are done through this class.
Field Summary |
Fields inherited from class org.apache.log4j.Category |
additive, level, name, parent, repository, resourceBundle |
Constructor Summary | |
protected |
Logger(java.lang.String name)
|
Method Summary | |
void |
debug(java.lang.String message)
Writes a debug message. |
void |
error(java.lang.String message)
Writes a error message. |
void |
fatal(java.lang.String message)
Writes a fatal message. |
static Logger |
getLogger(java.lang.Class clazz)
Shorthand for getLogger(clazz.getName()) . |
static Logger |
getLogger(java.lang.String name)
Retrieve a logger named according to the value of the name parameter. |
static Logger |
getLogger(java.lang.String name,
org.apache.log4j.spi.LoggerFactory factory)
Like getLogger(String) except that the type of logger
instantiated depends on the type returned by the LoggerFactory.makeNewLoggerInstance(java.lang.String) method of the
factory parameter. |
static Logger |
getRootLogger()
Return the root logger for the current logger repository. |
void |
info(java.lang.String message)
Writes an info message. |
boolean |
isErrorEnabled()
Determines if error is enabled. |
boolean |
isFatalEnabled()
Determines if fatal is enabled. |
boolean |
isTraceEnabled()
Check whether this category is enabled for the TRACE Level. |
boolean |
isWarnEnabled()
Determines if warn is enabled. |
void |
trace(java.lang.Object message)
Log a message object with the TRACE level. |
void |
trace(java.lang.Object message,
java.lang.Throwable t)
Log a message object with the TRACE level including the
stack trace of the Throwable t passed as parameter. |
void |
trace(java.lang.String message)
Writes a trace message. |
void |
warn(java.lang.String message)
Writes a warning message. |
Methods inherited from class org.apache.log4j.Category |
addAppender, assertLog, callAppenders, debug, debug, error, error, exists, fatal, fatal, forcedLog, getAdditivity, getAllAppenders, getAppender, getChainedPriority, getCurrentCategories, getDefaultHierarchy, getEffectiveLevel, getHierarchy, getInstance, getInstance, getLevel, getLoggerRepository, getName, getParent, getPriority, getResourceBundle, getResourceBundleString, getRoot, info, info, isAttached, isDebugEnabled, isEnabledFor, isInfoEnabled, l7dlog, l7dlog, log, log, log, removeAllAppenders, removeAppender, removeAppender, setAdditivity, setLevel, setPriority, setResourceBundle, shutdown, warn, warn |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface com.jagacy.util.Loggable |
isDebugEnabled, isInfoEnabled |
Constructor Detail |
protected Logger(java.lang.String name)
Method Detail |
public static Logger getLogger(java.lang.String name)
name
parameter. If the named logger already exists,
then the existing instance will be returned. Otherwise, a new
instance is created.
By default, loggers do not have a set level but inherit it from their neareast ancestor with a set level. This is one of the central features of log4j.
name
- The name of the logger to retrieve.public static Logger getLogger(java.lang.Class clazz)
getLogger(clazz.getName())
.
clazz
- The name of clazz
will be used as the
name of the logger to retrieve. See getLogger(String)
for more detailed information.public static Logger getRootLogger()
The Logger.getName()
method for the root logger always returns
stirng value: "root". However, calling
Logger.getLogger("root")
does not retrieve the root
logger but a logger just under root named "root".
In other words, calling this method is the only way to retrieve the root logger.
public static Logger getLogger(java.lang.String name, org.apache.log4j.spi.LoggerFactory factory)
getLogger(String)
except that the type of logger
instantiated depends on the type returned by the LoggerFactory.makeNewLoggerInstance(java.lang.String)
method of the
factory
parameter.
This method is intended to be used by sub-classes.
name
- The name of the logger to retrieve.factory
- A LoggerFactory
implementation that will
actually create a new Instance.public void trace(java.lang.Object message)
TRACE
level.
message
- the message object to log.for an explanation of the logic applied.
public void trace(java.lang.Object message, java.lang.Throwable t)
TRACE
level including the
stack trace of the Throwable
t
passed as parameter.
See Category.debug(Object)
form for more detailed information.
message
- the message object to log.t
- the exception to log, including its stack trace.public boolean isTraceEnabled()
isTraceEnabled
in interface Loggable
true
if this category is enabled for level
TRACE, false
otherwise.public void debug(java.lang.String message)
Loggable
debug
in interface Loggable
message
- Message to write.public void error(java.lang.String message)
Loggable
error
in interface Loggable
message
- Message to write.public void fatal(java.lang.String message)
Loggable
fatal
in interface Loggable
message
- Message to write.public void info(java.lang.String message)
Loggable
info
in interface Loggable
message
- Message to write.public boolean isErrorEnabled()
Loggable
isErrorEnabled
in interface Loggable
public boolean isFatalEnabled()
Loggable
isFatalEnabled
in interface Loggable
public boolean isWarnEnabled()
Loggable
isWarnEnabled
in interface Loggable
public void trace(java.lang.String message)
Loggable
trace
in interface Loggable
message
- Message to write.public void warn(java.lang.String message)
Loggable
warn
in interface Loggable
message
- Message to write.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |