org.apache.logging.log4j.core.async

Class AsyncLoggerContext

java.lang.Object

org.apache.logging.log4j.core.AbstractLifeCycle

org.apache.logging.log4j.core.LoggerContext

org.apache.logging.log4j.core.async.AsyncLoggerContext

All Implemented Interfaces:

AutoCloseable, ConfigurationListener, LifeCycle, LifeCycle2, LoggerContext, Terminable

public class AsyncLoggerContext
extends LoggerContext

LoggerContext that creates AsyncLogger objects.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.logging.log4j.core.LifeCycle

LifeCycle.State

Field Summary

Fields inherited from class org.apache.logging.log4j.core.LoggerContext

PROPERTY_CONFIG

Fields inherited from class org.apache.logging.log4j.core.AbstractLifeCycle

DEFAULT_STOP_TIMEOUT, DEFAULT_STOP_TIMEUNIT, LOGGER

Constructor Summary

Constructors

Constructor and Description
AsyncLoggerContext(String name)
AsyncLoggerContext(String name, Object externalContext)
AsyncLoggerContext(String name, Object externalContext, String configLocn)
AsyncLoggerContext(String name, Object externalContext, URI configLocn)

Method Summary

Methods

Modifier and Type	Method and Description
RingBufferAdmin	createRingBufferAdmin() Creates and returns a new RingBufferAdmin that instruments the ringbuffer of the AsyncLogger objects in this LoggerContext.
protected Logger	newInstance(LoggerContext ctx, String name, MessageFactory messageFactory)
void	setName(String name) Sets the name.
void	setUseThreadLocals(boolean useThreadLocals) Signals this context whether it is allowed to use ThreadLocal objects for efficiency.
void	start()
void	start(Configuration config) Starts with a specific configuration.
boolean	stop(long timeout, TimeUnit timeUnit) Blocks until all tasks have completed execution after a shutdown request, or the timeout occurs, or the current thread is interrupted, whichever happens first.

Methods inherited from class org.apache.logging.log4j.core.LoggerContext

addFilter, addPropertyChangeListener, close, getConfigLocation, getConfiguration, getContext, getContext, getContext, getExecutorService, getExecutorServiceDeamons, getExternalContext, getLogger, getLogger, getLoggers, getName, getRootLogger, hasLogger, hasLogger, hasLogger, onChange, reconfigure, removeFilter, removePropertyChangeListener, setConfigLocation, setExternalContext, submit, submitDaemon, terminate, updateLoggers, updateLoggers

Methods inherited from class org.apache.logging.log4j.core.AbstractLifeCycle

equalsImpl, getState, hashCodeImpl, initialize, isInitialized, isStarted, isStarting, isStopped, isStopping, setStarted, setStarting, setState, setStopped, setStopping, stop, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncLoggerContext

public AsyncLoggerContext(String name)

AsyncLoggerContext

public AsyncLoggerContext(String name,
                  Object externalContext)

AsyncLoggerContext

public AsyncLoggerContext(String name,
                  Object externalContext,
                  URI configLocn)

AsyncLoggerContext

public AsyncLoggerContext(String name,
                  Object externalContext,
                  String configLocn)

Method Detail

newInstance

protected Logger newInstance(LoggerContext ctx,
                 String name,
                 MessageFactory messageFactory)

Overrides:

newInstance in class LoggerContext

setName

public void setName(String name)

Description copied from class: LoggerContext

Sets the name.

Overrides:

setName in class LoggerContext

Parameters:

name - the new LoggerContext name

start

public void start()

Specified by:

start in interface LifeCycle

Overrides:

start in class LoggerContext

start

public void start(Configuration config)

Description copied from class: LoggerContext

Starts with a specific configuration.

Overrides:

start in class LoggerContext

Parameters:

config - The new Configuration.

stop

public boolean stop(long timeout,
           TimeUnit timeUnit)

Description copied from interface: LifeCycle2

Blocks until all tasks have completed execution after a shutdown request, or the timeout occurs, or the current thread is interrupted, whichever happens first.

Specified by:

stop in interface LifeCycle2

Overrides:

stop in class LoggerContext

Parameters:

timeout - the maximum time to wait

timeUnit - the time unit of the timeout argument

Returns:

true if the receiver was stopped cleanly and normally, false otherwise.

createRingBufferAdmin

public RingBufferAdmin createRingBufferAdmin()

Creates and returns a new RingBufferAdmin that instruments the ringbuffer of the AsyncLogger objects in this LoggerContext.

Returns:

a new RingBufferAdmin that instruments the ringbuffer

setUseThreadLocals

public void setUseThreadLocals(boolean useThreadLocals)

Signals this context whether it is allowed to use ThreadLocal objects for efficiency.

Parameters:

useThreadLocals - whether this context is allowed to use ThreadLocal objects