org.apache.log4j.spi

Class RootLogger

Implemented Interfaces:
AppenderAttachable

public final class RootLogger
extends Logger

RootLogger sits at the top of the logger 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, name, parent, repository, resourceBundle

Constructor Summary

RootLogger(Level level)
The root logger names itself as "root".

Method Summary

Level
getChainedLevel()
Return the assigned level value without walking the logger 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

getLogger, getLogger, getLogger, getRootLogger, isTraceEnabled, trace, trace

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

Constructor Details

RootLogger

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

Method Details

getChainedLevel

public final Level getChainedLevel()
Return the assigned level value without walking the logger 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 interface Category
Since:
0.8.3

Copyright 2000-2005 Apache Software Foundation.