org.slf4j

Class LoggerFactory

java.lang.Object

org.slf4j.LoggerFactory

public final class LoggerFactory
extends Object

This shadowing LoggerFactory is customized to support accessing an SLF4J implementation that is on the classpath of a child class loader.

Thus, the preferred class loader for binding with the SLF4J implementation (which implies loading the org.slf4j.impl.StaticLoggerBinder class) is the context class loader of the thread that triggers the logging system initialization. This will typically be the Catalina class loader, which defaults to the common class loader in Tomcat.

After it is loaded, the access to the separate StaticLoggerBinder class is delegated to the SeparateSLF4JImplBridge helper.

This class is supposed to shadow the original LoggerFactory. Thus, the juli-to-slf4j.jar should be placed before the slf4j-api.jar on the Catalina startup classpath (see the catalina.sh startup script for more details).

Inherited documentation from SLF4J API:

The LoggerFactory is a utility class producing Loggers for various logging APIs, most notably for log4j, logback and JDK 1.4 logging. Other implementations such as org.slf4j.impl.NOPLogger and org.slf4j.impl.SimpleLogger are also supported.

LoggerFactory is essentially a wrapper around an ILoggerFactory instance bound with LoggerFactory at compile time.

Please note that all methods in LoggerFactory are static.

Which is unfortunately incorrect: the ILoggerFactory instance is bound at runtime.

Since:

1.1.0

Author:

Alexander Dorokhine, Robert Elliot, Ceki Gülcü, Benjamin Gandon

Method Summary

Modifier and Type	Method and Description
static org.slf4j.ILoggerFactory	getILoggerFactory() Return the ILoggerFactory instance in use.
static org.slf4j.Logger	getLogger(Class<?> clazz) Return a logger named corresponding to the class passed as parameter, using the statically bound ILoggerFactory instance.
static org.slf4j.Logger	getLogger(String name) Return a logger named according to the name parameter using the statically bound ILoggerFactory instance.

Methods inherited from class java.lang.Object

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

Method Detail

getLogger

public static org.slf4j.Logger getLogger(String name)

Return a logger named according to the name parameter using the statically bound ILoggerFactory instance.

Parameters:

name - The name of the logger.

Returns:

logger

getLogger

public static org.slf4j.Logger getLogger(Class<?> clazz)

Return a logger named corresponding to the class passed as parameter, using the statically bound ILoggerFactory instance.

In case the the clazz parameter differs from the name of the caller as computed internally by SLF4J, a logger name mismatch warning will be printed but only if the slf4j.detectLoggerNameMismatch system property is set to true. By default, this property is not set and no warnings will be printed even in case of a logger name mismatch.

Parameters:

clazz - the returned logger will be named after clazz

Returns:

logger

See Also:

Detected logger name mismatch

getILoggerFactory

public static org.slf4j.ILoggerFactory getILoggerFactory()

Return the ILoggerFactory instance in use.

ILoggerFactory instance is bound with this class at compile time.

Returns:

the ILoggerFactory instance in use