|
Keel 2.1RC2 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectorg.apache.log.Logger
The object interacted with by client objects to perform logging.
| Field Summary | |
static char |
CATEGORY_SEPARATORSeparator character use to separate different categories |
private static Logger[] |
EMPTY_SET |
private boolean |
m_additivityTrue means LogEvents will be sent to parents LogTargets aswell as the ones set for this Logger. |
private java.lang.String |
m_category |
private Logger[] |
m_children |
private ErrorHandler |
m_errorHandler |
private LoggerListener |
m_loggerListener |
private LogTarget[] |
m_logTargets |
private boolean |
m_logTargetsForceSet |
private Logger |
m_parent |
private Priority |
m_priority |
private boolean |
m_priorityForceSet |
| Constructor Summary | |
(package private) |
Logger(ErrorHandler errorHandler, LoggerListener loggerListener, java.lang.String category, LogTarget[] logTargets, Logger parent)Protected constructor for use inside the logging toolkit. |
| Method Summary | |
void |
debug(java.lang.String message)Log a debug priority event. |
void |
debug(java.lang.String message, java.lang.Throwable throwable)Log a debug priority event. |
void |
error(java.lang.String message)Log a error priority event. |
void |
error(java.lang.String message, java.lang.Throwable throwable)Log a error priority event. |
void |
fatalError(java.lang.String message)Log a fatalError priority event. |
void |
fatalError(java.lang.String message, java.lang.Throwable throwable)Log a fatalError priority event. |
private void |
fireEvent(LogEvent event, LogTarget[] targets) |
java.lang.String |
getCategory()Deprecated. This method violates Inversion of Control principle. If you are relying on its presence then there may be something wrong with the design of your system |
Logger |
getChildLogger(java.lang.String subCategory)Create a new child logger. |
Logger[] |
getChildren()Get all the child Loggers of current logger. |
LogTarget[] |
getLogTargets()Deprecated. This method is deprecated and will be removed in Future version. Previously it allowed unsafe access to logtargets which permitted masqurade attacks. It currently returns a zero sized array. |
Priority |
getPriority()Deprecated. This method violates Inversion of Control principle. It will downgraded to protected access in a future release. When user needs to check priority it is advised that they use the is[Priority]Enabled() functions. |
void |
info(java.lang.String message)Log a info priority event. |
void |
info(java.lang.String message, java.lang.Throwable throwable)Log a info priority event. |
boolean |
isDebugEnabled()Determine if messages of priority DEBUG will be logged. |
boolean |
isErrorEnabled()Determine if messages of priority ERROR will be logged. |
boolean |
isFatalErrorEnabled()Determine if messages of priority FATAL_ERROR will be logged. |
boolean |
isInfoEnabled()Determine if messages of priority INFO will be logged. |
boolean |
isPriorityEnabled(Priority priority)Determine if messages of priority ?will be logged. |
boolean |
isWarnEnabled()Determine if messages of priority WARN will be logged. |
void |
log(Priority priority, java.lang.String message)Log a event at specific priority with a certain message. |
void |
log(Priority priority, java.lang.String message, java.lang.Throwable throwable)Log a event at specific priority with a certain message and throwable. |
private void |
output(LogEvent event) |
private void |
output(Priority priority, java.lang.String message, java.lang.Throwable throwable)Internal method to do actual outputting. |
private void |
resetChildLogTargets(boolean recursive)Update logTargets of children if any. |
private void |
resetChildPriorities(boolean recursive)Update priority of children if any. |
private void |
resetLogTargets(boolean recursive)Update logTarget of this Logger. |
private void |
resetPriority(boolean recursive)Update priority of this Logger. |
private LogTarget[] |
safeGetLogTargets()Retrieve logtarget array contained in logger. |
void |
setAdditivity(boolean additivity)Make this logger additive. |
void |
setLogTargets(LogTarget[] logTargets)Set the log targets for this logger. |
void |
setPriority(Priority priority)Set the priority for this logger. |
private void |
setupErrorHandlers()Set ErrorHandlers of LogTargets if necessary. |
void |
unsetLogTargets()Unset the logtargets for this logger. |
void |
unsetLogTargets(boolean recursive)Unset the logtargets for this logger and all child loggers if recursive is set. |
void |
unsetPriority()Unset the priority of Logger. |
void |
unsetPriority(boolean recursive)Unset the priority of Logger. |
void |
warn(java.lang.String message)Log a warn priority event. |
void |
warn(java.lang.String message, java.lang.Throwable throwable)Log a warn priority event. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
private static final Logger[] EMPTY_SET
public static final char CATEGORY_SEPARATOR
private final ErrorHandler m_errorHandler
private final LoggerListener m_loggerListener
private final Logger m_parent
private final java.lang.String m_category
private Logger[] m_children
private LogTarget[] m_logTargets
private boolean m_logTargetsForceSet
private Priority m_priority
private boolean m_priorityForceSet
private boolean m_additivity
| Constructor Detail |
Logger(ErrorHandler errorHandler,
LoggerListener loggerListener,
java.lang.String category,
LogTarget[] logTargets,
Logger parent)
errorHandler - the ErrorHandler logger uses to log errorscategory - the fully qualified name of categorylogTargets - the LogTargets associated with loggerparent - the parent logger (used for inheriting from)| Method Detail |
public final boolean isDebugEnabled()
public final void debug(java.lang.String message,
java.lang.Throwable throwable)
message - the messagethrowable - the throwablepublic final void debug(java.lang.String message)
message - the messagepublic final boolean isInfoEnabled()
public final void info(java.lang.String message,
java.lang.Throwable throwable)
message - the messagethrowable - the throwablepublic final void info(java.lang.String message)
message - the messagepublic final boolean isWarnEnabled()
public final void warn(java.lang.String message,
java.lang.Throwable throwable)
message - the messagethrowable - the throwablepublic final void warn(java.lang.String message)
message - the messagepublic final boolean isErrorEnabled()
public final void error(java.lang.String message,
java.lang.Throwable throwable)
message - the messagethrowable - the throwablepublic final void error(java.lang.String message)
message - the messagepublic final boolean isFatalErrorEnabled()
public final void fatalError(java.lang.String message,
java.lang.Throwable throwable)
message - the messagethrowable - the throwablepublic final void fatalError(java.lang.String message)
message - the messagepublic final void setAdditivity(boolean additivity)
additivity - true to make logger additive, false otherwisepublic final boolean isPriorityEnabled(Priority priority)
priority - the priority
public final void log(Priority priority,
java.lang.String message,
java.lang.Throwable throwable)
priority - the prioritymessage - the messagethrowable - the throwable
public final void log(Priority priority,
java.lang.String message)
priority - the prioritymessage - the messagepublic void setPriority(Priority priority)
priority - the prioritypublic void unsetPriority()
public void unsetPriority(boolean recursive)
recursive - true to unset priority of all child loggerspublic void setLogTargets(LogTarget[] logTargets)
logTargets - the Log Targetspublic void unsetLogTargets()
public void unsetLogTargets(boolean recursive)
recursive - the recursion policypublic Logger[] getChildren()
public Logger getChildLogger(java.lang.String subCategory)
throws java.lang.IllegalArgumentException
subCategory - the subcategory of this loggerjava.lang.IllegalArgumentException - if subCategory has an empty element namepublic final Priority getPriority()
public final java.lang.String getCategory()
public LogTarget[] getLogTargets()
private final void output(Priority priority,
java.lang.String message,
java.lang.Throwable throwable)
priority - the prioritymessage - the messagethrowable - the throwableprivate final void output(LogEvent event)
private final void fireEvent(LogEvent event,
LogTarget[] targets)
private void resetChildPriorities(boolean recursive)
private void resetPriority(boolean recursive)
private LogTarget[] safeGetLogTargets()
private void resetChildLogTargets(boolean recursive)
private void setupErrorHandlers()
private void resetLogTargets(boolean recursive)
|
Keel 2.1RC2 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||