org.apache.logging.log4j.spi

Interface LoggerContext

All Known Implementing Classes:

AsyncLoggerContext, LoggerContext, SimpleLoggerContext, SLF4JLoggerContext

public interface LoggerContext

Anchor point for logging implementations.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	getExternalContext() An anchor for some other context, such as a ClassLoader or ServletContext.
ExtendedLogger	getLogger(java.lang.String name) Returns an ExtendedLogger.
ExtendedLogger	getLogger(java.lang.String name, MessageFactory messageFactory) Returns an ExtendedLogger.
default java.lang.Object	getObject(java.lang.String key) Retrieve an object by its name.
boolean	hasLogger(java.lang.String name) Detects if a Logger with the specified name exists.
boolean	hasLogger(java.lang.String name, java.lang.Class<? extends MessageFactory> messageFactoryClass) Detects if a Logger with the specified name and MessageFactory type exists.
boolean	hasLogger(java.lang.String name, MessageFactory messageFactory) Detects if a Logger with the specified name and MessageFactory exists.
default java.lang.Object	putObject(java.lang.String key, java.lang.Object value) Store an object into the LoggerContext by name for later use.
default java.lang.Object	putObjectIfAbsent(java.lang.String key, java.lang.Object value) Store an object into the LoggerContext by name for later use if an object is not already stored with that key.
default java.lang.Object	removeObject(java.lang.String key) Remove an object if it is present.
default boolean	removeObject(java.lang.String key, java.lang.Object value) Remove an object if it is present and the provided object is stored.

Method Detail

getExternalContext

java.lang.Object getExternalContext()

An anchor for some other context, such as a ClassLoader or ServletContext.

Returns:

The external context.

getObject

default java.lang.Object getObject(java.lang.String key)

Retrieve an object by its name.

Parameters:

key - The object's key.

Since:

2.13.0

putObject

default java.lang.Object putObject(java.lang.String key,
                                   java.lang.Object value)

Store an object into the LoggerContext by name for later use.

Parameters:

key - The object's key.

value - The object.

Returns:

The previous object or null.

Since:

2.13.0

putObjectIfAbsent

default java.lang.Object putObjectIfAbsent(java.lang.String key,
                                           java.lang.Object value)

Store an object into the LoggerContext by name for later use if an object is not already stored with that key.

Parameters:

key - The object's key.

value - The object.

Returns:

The previous object or null.

Since:

2.13.0

removeObject

default java.lang.Object removeObject(java.lang.String key)

Remove an object if it is present.

Parameters:

key - The object's key.

Returns:

The object if it was present, null if it was not.

Since:

2.13.0

removeObject

default boolean removeObject(java.lang.String key,
                             java.lang.Object value)

Remove an object if it is present and the provided object is stored.

Parameters:

key - The object's key.

value - The object.

Returns:

The object if it was present, null if it was not.

Since:

2.13.0

getLogger

ExtendedLogger getLogger(java.lang.String name)

Returns an ExtendedLogger.

Parameters:

name - The name of the Logger to return.

Returns:

The logger with the specified name.

getLogger

ExtendedLogger getLogger(java.lang.String name,
                         MessageFactory messageFactory)

Returns an ExtendedLogger.

Parameters:

name - The name of the Logger to return.

messageFactory - The message factory is used only when creating a logger, subsequent use does not change the logger but will log a warning if mismatched.

Returns:

The logger with the specified name.

hasLogger

boolean hasLogger(java.lang.String name)

Detects if a Logger with the specified name exists.

Parameters:

name - The Logger name to search for.

Returns:

true if the Logger exists, false otherwise.

hasLogger

boolean hasLogger(java.lang.String name,
                  MessageFactory messageFactory)

Detects if a Logger with the specified name and MessageFactory exists.

Parameters:

name - The Logger name to search for.

messageFactory - The message factory to search for.

Returns:

true if the Logger exists, false otherwise.

Since:

2.5

hasLogger

boolean hasLogger(java.lang.String name,
                  java.lang.Class<? extends MessageFactory> messageFactoryClass)

Detects if a Logger with the specified name and MessageFactory type exists.

Parameters:

name - The Logger name to search for.

messageFactoryClass - The message factory class to search for.

Returns:

true if the Logger exists, false otherwise.

Since:

2.5