org.mmbase.util.logging.log4j
Class Log4jImpl

java.lang.Object
  org.apache.log4j.Category
      org.apache.log4j.Logger
          org.mmbase.util.logging.log4j.Log4jImpl

All Implemented Interfaces:

org.apache.log4j.spi.AppenderAttachable, Logger

public final class Log4jImpl

extends org.apache.log4j.Logger

implements Logger

This Logger implementation extends the Logger class from the log4j project (version >= 1.2). It has the following extra functionality. First of all it uses the LoggerLevel class for Level, and so has two extra priorities, namely 'trace' and 'service'. Further it instantiates one object of itself, named `STDERR' to which stderr will be redirected. Normally this will happen with priority `info' but Exceptions will get priorty `fatal'. It also has a static member method `configure', which calls the configure of DOMConfigurator, in this way log4j classes are used only here, and the rest of MMBase can use only `Logger'.

Author:

Michiel Meeuwissen

Field Summary

Fields inherited from class org.apache.log4j.Category

additive, level, name, parent, resourceBundle

Constructor Summary

protected

Log4jImpl(java.lang.String name) Constructor, like the constructor of Logger.

Method Summary

static void	configure(java.lang.String s) Calls the configure method of DOMConfigurator, and redirect standard error to STDERR category.
protected static void	doConfigure(java.io.File f) Performs the actual parsing of the log4j configuration file and handles the errors
static java.io.File	getConfigurationFile()
static org.apache.log4j.Category	getInstance(java.lang.String name) This method overrides Category.getInstance(java.lang.String) by supplying its own factory type as a parameter.
static org.apache.log4j.Logger	getLogger(java.lang.String name)
static Log4jImpl	getLoggerInstance(java.lang.String name) As getLogger, but casted to MMBase Logger already.
boolean	isServiceEnabled() Returns true if for this category (Logger), a call to service (debug or trace) would do something.
void	service(java.lang.Object message) A new logging method that takes the SERVICE priority.
void	setLevel(Level p) If you want to override the level in the configuration file fixed for this category, you can do it with this method.
void	setPriority(Level p) Deprecated. use setLevel
static void	shutdown()
void	trace(java.lang.Object message) A new logging method that takes the TRACE priority.

Methods inherited from class org.apache.log4j.Logger

getLogger, getLogger, getRootLogger

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, 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, warn, warn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.mmbase.util.logging.Logger

debug, error, fatal, info, isDebugEnabled, warn

Constructor Detail

Log4jImpl

protected Log4jImpl(java.lang.String name)

Constructor, like the constructor of Logger.

Method Detail

getLoggerInstance

public static Log4jImpl getLoggerInstance(java.lang.String name)

As getLogger, but casted to MMBase Logger already. And the possible ClassCastException is caught.

configure

public static void configure(java.lang.String s)

Calls the configure method of DOMConfigurator, and redirect standard error to STDERR category. It also starts up the FileWatcher. The 'configureAndWatch' method of DOMConfigurator used to be used, but it is not feasible anymore because 1. cannot give the repository then. 2. Cannot log the happening on normal way.

doConfigure

protected static void doConfigure(java.io.File f)

Performs the actual parsing of the log4j configuration file and handles the errors

getConfigurationFile

public static java.io.File getConfigurationFile()

setPriority

public void setPriority(Level p)

Deprecated. use setLevel

Specified by:

setPriority in interface Logger

setLevel

public void setLevel(Level p)

Description copied from interface: Logger

If you want to override the level in the configuration file fixed for this category, you can do it with this method. This could be usefull for example to switch on all debug logging when something has gone wrong.

Specified by:

setLevel in interface Logger

Parameters:

p - The level of the priority. One of the constants Level.TRACE, Level.DEBUG, Level.SERVICE, Level.INFO, Level.WARN, Level.ERROR or Level.FATAL.

getInstance

public static org.apache.log4j.Category getInstance(java.lang.String name)

This method overrides Category.getInstance(java.lang.String) by supplying its own factory type as a parameter.

getLogger

public static org.apache.log4j.Logger getLogger(java.lang.String name)

trace

public final void trace(java.lang.Object message)

A new logging method that takes the TRACE priority.

Specified by:

trace in interface Logger

See Also:

Logger.debug(java.lang.Object)

service

public final void service(java.lang.Object message)

A new logging method that takes the SERVICE priority.

Specified by:

service in interface Logger

isServiceEnabled

public final boolean isServiceEnabled()

Description copied from interface: Logger

Returns true if for this category (Logger), a call to service (debug or trace) would do something.

Specified by:

isServiceEnabled in interface Logger

shutdown

public static void shutdown()