Log4j 1.3alpha-5

org.apache.log4j.spi
Class RootLogger

java.lang.Object
  |
  +--org.apache.log4j.Category
        |
        +--org.apache.log4j.Logger
              |
              +--org.apache.log4j.spi.RootLogger
All Implemented Interfaces:
AppenderAttachable, ULogger

public final class RootLogger
extends Logger

RootLogger sits at the top of the category hierachy. It is a regular logger except that it provides several guarantees.

First, it cannot be assigned a null level. Second, since root logger cannot have a parent, the getChainedLevel() method always returns the value of the level field without walking the hierarchy.

Author:
Ceki Gülcü

Field Summary
 
Fields inherited from class org.apache.log4j.Category
additive, level, lock, name, parent, repository, resourceBundle
 
Constructor Summary
RootLogger(Level level)
          The root category names itself as "root".
 
Method Summary
 Level getChainedLevel()
          Return the assigned level value without walking the category hierarchy.
 void setLevel(Level level)
          Setting a null value to the level of the root logger may have catastrophic results.
 
Methods inherited from class org.apache.log4j.Logger
fatal, getLogger, getLogger, getLogger, getRootLogger, trace, trace, trace, trace
 
Methods inherited from class org.apache.log4j.Category
addAppender, assertLog, callAppenders, debug, debug, debug, debug, error, error, error, error, exists, fatal, fatal, fatal, forcedLog, getAdditivity, getAllAppenders, getAppender, getChainedPriority, getCurrentCategories, getDefaultHierarchy, getEffectiveLevel, getHierarchy, getInstance, getInstance, getLevel, getLoggerRepository, getName, getParent, getPriority, getResourceBundle, getResourceBundleString, getRoot, info, info, info, info, isAttached, isDebugEnabled, isEnabledFor, isEnabledFor, isErrorEnabled, isInfoEnabled, isTraceEnabled, isWarnEnabled, l7dlog, l7dlog, log, log, log, log, log, log, removeAllAppenders, removeAppender, removeAppender, setAdditivity, setResourceBundle, shutdown, warn, warn, warn, warn
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

RootLogger

public RootLogger(Level level)
The root category names itself as "root". However, the root category cannot be retrieved by name.

Method Detail

getChainedLevel

public final Level getChainedLevel()
Return the assigned level value without walking the category hierarchy.


setLevel

public final void setLevel(Level level)
Setting a null value to the level of the root logger may have catastrophic results. We prevent this here.

Overrides:
setLevel in class Category
Since:
0.8.3

Log4j 1.3alpha-5

Copyright 2000-2005 Apache Software Foundation.