Package org.apache.logging.log4j.core.selector

Interface ContextSelector

All Known Subinterfaces:

NamedContextSelector

All Known Implementing Classes:

AsyncLoggerContextSelector, BasicContextSelector, BundleContextSelector, ClassLoaderContextSelector, JndiContextSelector

public interface ContextSelector

Interface used to locate a LoggerContext.

Field Summary

Fields

Modifier and Type	Field	Description
static long	DEFAULT_STOP_TIMEOUT

Method Summary

Modifier and Type	Method	Description
LoggerContext	getContext(java.lang.String fqcn, java.lang.ClassLoader loader, boolean currentContext)	Returns the LoggerContext.
LoggerContext	getContext(java.lang.String fqcn, java.lang.ClassLoader loader, boolean currentContext, java.net.URI configLocation)	Returns the LoggerContext.
java.util.List<LoggerContext>	getLoggerContexts()	Returns a List of all the available LoggerContexts.
default boolean	hasContext(java.lang.String fqcn, java.lang.ClassLoader loader, boolean currentContext)	Checks to see if a LoggerContext is installed.
void	removeContext(LoggerContext context)	Remove any references to the LoggerContext.
default void	shutdown(java.lang.String fqcn, java.lang.ClassLoader loader, boolean currentContext, boolean allContexts)	Shuts down the LoggerContext.

Field Detail

DEFAULT_STOP_TIMEOUT

static final long DEFAULT_STOP_TIMEOUT

See Also:

Constant Field Values

Method Detail

shutdown

default void shutdown(java.lang.String fqcn,
                      java.lang.ClassLoader loader,
                      boolean currentContext,
                      boolean allContexts)

Shuts down the LoggerContext.

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

allContexts - if true all LoggerContexts that can be located will be shutdown.

Since:

2.13.0

hasContext

default boolean hasContext(java.lang.String fqcn,
                           java.lang.ClassLoader loader,
                           boolean currentContext)

Checks to see if a LoggerContext is installed. The default implementation returns false.

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.

Returns:

true if a LoggerContext has been installed, false otherwise.

Since:

2.13.0

getContext

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

Returns the LoggerContext.

Parameters:

fqcn - The fully qualified class name of the caller.

loader - 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.

Returns:

The LoggerContext.

getContext

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

Returns the LoggerContext.

Parameters:

fqcn - The fully qualified class name of the caller.

loader - 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.

configLocation - The location of the configuration for the LoggerContext.

Returns:

The LoggerContext.

getLoggerContexts

java.util.List<LoggerContext> getLoggerContexts()

Returns a List of all the available LoggerContexts.

Returns:

The List of LoggerContexts.

removeContext

void removeContext(LoggerContext context)

Remove any references to the LoggerContext.

Parameters:

context - The context to remove.