org.mmbase.util.logging.log4j2
Class Log4jImpl

org.mmbase.util.logging.log4j2.Log4jImpl

All Implemented Interfaces:

Logger

public final class Log4jImpl

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

Method Summary

static void	configure(java.lang.String s) Calls the configure method of DOMConfigurator, and redirect standard error to STDERR category.
static java.io.File	getConfigurationFile()
static org.apache.log4j.Category	getInstance(java.lang.String name) This method overrides Category#getInstance 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
void	trace(java.lang.Object message) A new logging method that takes the TRACE priority.

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

debug, error, fatal, info, isDebugEnabled, warn

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.

Parameters:

s: - A string to the xml-configuration file. Can be absolute, or relative to the Logging configuration file.

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

Following copied from interface: org.mmbase.util.logging.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 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

Following copied from interface: org.mmbase.util.logging.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