org.apache.logging.log4j
Class LogManager

java.lang.Object
  org.apache.logging.log4j.LogManager

public class LogManager
extends Object

The anchor point for the logging system.

Field Summary

static String

ROOT_LOGGER_NAME The name of the root Logger.

Constructor Summary

protected

LogManager() Prevents instantiation

Method Summary

static LoggerContext	getContext() Returns the current LoggerContext.
static LoggerContext	getContext(boolean currentContext) Returns a LoggerContext.
static LoggerContext	getContext(ClassLoader loader, boolean currentContext) Returns a LoggerContext.
protected static LoggerContext	getContext(String fqcn, boolean currentContext) Returns a LoggerContext
protected static LoggerContext	getContext(String fqcn, ClassLoader loader, boolean currentContext) Returns a LoggerContext
static LoggerContextFactory	getFactory() Returns the LoggerContextFactory.
static Logger	getLogger(Class<?> clazz) Returns a Logger using the fully qualified name of the Class as the Logger name.
static Logger	getLogger(Object value) Returns a Logger using the fully qualified class name of the value as the Logger name.
static Logger	getLogger(String name) Returns a Logger with the specified name.
protected static Logger	getLogger(String fqcn, String name) Returns a Logger with the specified name.

Methods inherited from class java.lang.Object

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

Field Detail

ROOT_LOGGER_NAME

public static final String ROOT_LOGGER_NAME

The name of the root Logger.

See Also:

Constant Field Values

Constructor Detail

LogManager

protected LogManager()

Prevents instantiation

Method Detail

getFactory

public static LoggerContextFactory getFactory()

Returns the LoggerContextFactory.

Returns:

The LoggerContextFactory.

getLogger

public static Logger getLogger(String name)

Returns a Logger with the specified name.

Parameters:

name - The logger name.

Returns:

The Logger.

getLogger

public static Logger getLogger(Class<?> clazz)

Returns a Logger using the fully qualified name of the Class as the Logger name.

Parameters:

clazz - The Class whose name should be used as the Logger name.

Returns:

The Logger.

getLogger

public static Logger getLogger(Object value)

Returns a Logger using the fully qualified class name of the value as the Logger name.

Parameters:

value - The value whose class name should be used as the Logger name.

Returns:

The Logger.

getLogger

protected static Logger getLogger(String fqcn,
                                  String name)

Returns a Logger with the specified name.

Parameters:

fqcn - The fully qualified class name of the class that this method is a member of.

name - The logger name.

Returns:

The Logger.

getContext

public static LoggerContext getContext()

Returns the current LoggerContext.

WARNING - The LoggerContext returned by this method may not be the LoggerContext used to create a Logger for the calling class.

Returns:

The current LoggerContext.

getContext

public static LoggerContext getContext(boolean currentContext)

Returns a LoggerContext.

Parameters:

currentContext - if false the LoggerContext appropriate for the caller of this method is returned. For example, in a web application if the caller is a class in WEB-INF/lib then one LoggerContext may be returned and if the caller is a class in the container's classpath then a different LoggerContext may be returned. If true then only a single LoggerContext will be returned.

Returns:

a LoggerContext.

getContext

public static LoggerContext getContext(ClassLoader loader,
                                       boolean currentContext)

Returns a LoggerContext.

Parameters:

loader - The ClassLoader for the context. If null the context will attempt to determine the appropriate ClassLoader.

currentContext - if false the LoggerContext appropriate for the caller of this method is returned. For example, in a web application if the caller is a class in WEB-INF/lib then one LoggerContext may be returned and if the caller is a class in the container's classpath then a different LoggerContext may be returned. If true then only a single LoggerContext will be returned.

Returns:

a LoggerContext.

getContext

protected static LoggerContext getContext(String fqcn,
                                          boolean currentContext)

Returns a LoggerContext

Parameters:

fqcn - The fully qualified class name of the Class that this method is a member of.

currentContext - if false the LoggerContext appropriate for the caller of this method is returned. For example, in a web application if the caller is a class in WEB-INF/lib then one LoggerContext may be returned and if the caller is a class in the container's classpath then a different LoggerContext may be returned. If true then only a single LoggerContext will be returned.

Returns:

a LoggerContext.

getContext

protected static LoggerContext getContext(String fqcn,
                                          ClassLoader loader,
                                          boolean currentContext)

Returns a LoggerContext

Parameters:

fqcn - The fully qualified class name of the Class that this method is a member of.

loader - The ClassLoader for the context. If null the context will attempt to determine the appropriate ClassLoader.

currentContext - if false the LoggerContext appropriate for the caller of this method is returned. For example, in a web application if the caller is a class in WEB-INF/lib then one LoggerContext may be returned and if the caller is a class in the container's classpath then a different LoggerContext may be returned. If true then only a single LoggerContext will be returned.

Returns:

a LoggerContext.