org.apache.logging.log4j.core.impl

Class Log4jContextFactory

java.lang.Object

org.apache.logging.log4j.core.impl.Log4jContextFactory

All Implemented Interfaces:

ShutdownCallbackRegistry, LoggerContextFactory

public class Log4jContextFactory
extends java.lang.Object
implements LoggerContextFactory, ShutdownCallbackRegistry

Factory to locate a ContextSelector and then load a LoggerContext.

Field Summary

Fields

Modifier and Type	Field and Description
private static StatusLogger	LOGGER
private ContextSelector	selector
private static boolean	SHUTDOWN_HOOK_ENABLED
private ShutdownCallbackRegistry	shutdownCallbackRegistry

Fields inherited from interface org.apache.logging.log4j.core.util.ShutdownCallbackRegistry

SHUTDOWN_CALLBACK_REGISTRY, SHUTDOWN_HOOK_MARKER

Constructor Summary

Constructors

Constructor and Description
Log4jContextFactory() Initializes the ContextSelector from system property Constants.LOG4J_CONTEXT_SELECTOR.
Log4jContextFactory(ContextSelector selector) Initializes this factory's ContextSelector with the specified selector.
Log4jContextFactory(ContextSelector selector, ShutdownCallbackRegistry shutdownCallbackRegistry) Constructs a Log4jContextFactory using the provided ContextSelector and ShutdownRegistrationStrategy.
Log4jContextFactory(ShutdownCallbackRegistry shutdownCallbackRegistry) Constructs a Log4jContextFactory using the ContextSelector from Constants.LOG4J_CONTEXT_SELECTOR and the provided ShutdownRegistrationStrategy.

Method Summary

Modifier and Type	Method and Description
Cancellable	addShutdownCallback(java.lang.Runnable callback) Adds a Runnable shutdown callback to this class.
private static ContextSelector	createContextSelector()
private static ShutdownCallbackRegistry	createShutdownCallbackRegistry()
LoggerContext	getContext(java.lang.String fqcn, java.lang.ClassLoader loader, java.lang.Object externalContext, boolean currentContext) Loads the LoggerContext using the ContextSelector.
LoggerContext	getContext(java.lang.String fqcn, java.lang.ClassLoader loader, java.lang.Object externalContext, boolean currentContext, Configuration configuration) Loads the LoggerContext using the ContextSelector using the provided Configuration
LoggerContext	getContext(java.lang.String fqcn, java.lang.ClassLoader loader, java.lang.Object externalContext, boolean currentContext, ConfigurationSource source) Loads the LoggerContext using the ContextSelector.
LoggerContext	getContext(java.lang.String fqcn, java.lang.ClassLoader loader, java.lang.Object externalContext, boolean currentContext, java.util.List<java.net.URI> configLocations, java.lang.String name)
LoggerContext	getContext(java.lang.String fqcn, java.lang.ClassLoader loader, java.lang.Object externalContext, boolean currentContext, java.net.URI configLocation, java.lang.String name) Loads the LoggerContext using the ContextSelector.
ContextSelector	getSelector() Returns the ContextSelector.
ShutdownCallbackRegistry	getShutdownCallbackRegistry() Returns the ShutdownCallbackRegistry
private void	initializeShutdownCallbackRegistry()
void	removeContext(LoggerContext context) Removes knowledge of a LoggerContext.

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

private static final StatusLogger LOGGER

SHUTDOWN_HOOK_ENABLED

private static final boolean SHUTDOWN_HOOK_ENABLED

selector

private final ContextSelector selector

shutdownCallbackRegistry

private final ShutdownCallbackRegistry shutdownCallbackRegistry

Constructor Detail

Log4jContextFactory

public Log4jContextFactory()

Initializes the ContextSelector from system property Constants.LOG4J_CONTEXT_SELECTOR.

Log4jContextFactory

public Log4jContextFactory(ContextSelector selector)

Initializes this factory's ContextSelector with the specified selector.

Parameters:

selector - the selector to use

Log4jContextFactory

public Log4jContextFactory(ShutdownCallbackRegistry shutdownCallbackRegistry)

Constructs a Log4jContextFactory using the ContextSelector from Constants.LOG4J_CONTEXT_SELECTOR and the provided ShutdownRegistrationStrategy.

Parameters:

shutdownCallbackRegistry - the ShutdownRegistrationStrategy to use

Since:

2.1

Log4jContextFactory

public Log4jContextFactory(ContextSelector selector,
                           ShutdownCallbackRegistry shutdownCallbackRegistry)

Constructs a Log4jContextFactory using the provided ContextSelector and ShutdownRegistrationStrategy.

Parameters:

selector - the selector to use

shutdownCallbackRegistry - the ShutdownRegistrationStrategy to use

Since:

2.1

Method Detail

createContextSelector

private static ContextSelector createContextSelector()

createShutdownCallbackRegistry

private static ShutdownCallbackRegistry createShutdownCallbackRegistry()

initializeShutdownCallbackRegistry

private void initializeShutdownCallbackRegistry()

getContext

public LoggerContext getContext(java.lang.String fqcn,
                                java.lang.ClassLoader loader,
                                java.lang.Object externalContext,
                                boolean currentContext)

Loads the LoggerContext using the ContextSelector.

Specified by:

getContext in interface LoggerContextFactory

Parameters:

fqcn - The fully qualified class name of the caller.

loader - The ClassLoader to use or null.

currentContext - If true returns the current Context, if false returns the Context appropriate for the caller if a more appropriate Context can be determined.

externalContext - An external context (such as a ServletContext) to be associated with the LoggerContext.

Returns:

The LoggerContext.

getContext

public LoggerContext getContext(java.lang.String fqcn,
                                java.lang.ClassLoader loader,
                                java.lang.Object externalContext,
                                boolean currentContext,
                                ConfigurationSource source)

Loads the LoggerContext using the ContextSelector.

Parameters:

fqcn - The fully qualified class name of the caller.

loader - The ClassLoader to use or null.

externalContext - An external context (such as a ServletContext) to be associated with the LoggerContext.

currentContext - If true returns the current Context, if false returns the Context appropriate for the caller if a more appropriate Context can be determined.

source - The configuration source.

Returns:

The LoggerContext.

getContext

public LoggerContext getContext(java.lang.String fqcn,
                                java.lang.ClassLoader loader,
                                java.lang.Object externalContext,
                                boolean currentContext,
                                Configuration configuration)

Loads the LoggerContext using the ContextSelector using the provided Configuration

Parameters:

fqcn - The fully qualified class name of the caller.

loader - The ClassLoader to use or null.

externalContext - An external context (such as a ServletContext) to be associated with the LoggerContext.

currentContext - If true returns the current Context, if false returns the Context appropriate for the caller if a more appropriate Context can be determined.

configuration - The Configuration.

Returns:

The LoggerContext.

getContext

public LoggerContext getContext(java.lang.String fqcn,
                                java.lang.ClassLoader loader,
                                java.lang.Object externalContext,
                                boolean currentContext,
                                java.net.URI configLocation,
                                java.lang.String name)

Loads the LoggerContext using the ContextSelector.

Specified by:

getContext in interface LoggerContextFactory

Parameters:

fqcn - The fully qualified class name of the caller.

loader - The ClassLoader to use or null.

externalContext - An external context (such as a ServletContext) to be associated with the LoggerContext.

currentContext - If true returns the current Context, if false returns the Context appropriate for the caller if a more appropriate Context can be determined.

configLocation - The location of the configuration for the LoggerContext (or null).

name - The name of the context or null.

Returns:

The LoggerContext.

getContext

public LoggerContext getContext(java.lang.String fqcn,
                                java.lang.ClassLoader loader,
                                java.lang.Object externalContext,
                                boolean currentContext,
                                java.util.List<java.net.URI> configLocations,
                                java.lang.String name)

getSelector

public ContextSelector getSelector()

Returns the ContextSelector.

Returns:

The ContextSelector.

getShutdownCallbackRegistry

public ShutdownCallbackRegistry getShutdownCallbackRegistry()

Returns the ShutdownCallbackRegistry

Returns:

the ShutdownCallbackRegistry

Since:

2.4

removeContext

public void removeContext(LoggerContext context)

Removes knowledge of a LoggerContext.

Specified by:

removeContext in interface LoggerContextFactory

Parameters:

context - The context to remove.

addShutdownCallback

public Cancellable addShutdownCallback(java.lang.Runnable callback)

Description copied from interface: ShutdownCallbackRegistry

Adds a Runnable shutdown callback to this class.

Specified by:

addShutdownCallback in interface ShutdownCallbackRegistry

Parameters:

callback - the shutdown callback to be executed upon shutdown.

Returns:

a Cancellable wrapper of the provided callback or null if the shutdown hook is disabled and cannot be added.