org.apache.juli.logging.impl

Class PreBootstrapLogger

java.lang.Object

org.slf4j.helpers.MarkerIgnoringBase

org.apache.juli.logging.impl.PreBootstrapLogger

All Implemented Interfaces:

Serializable, org.slf4j.Logger, org.slf4j.spi.LocationAwareLogger

public class PreBootstrapLogger
extends org.slf4j.helpers.MarkerIgnoringBase
implements org.slf4j.spi.LocationAwareLogger, org.slf4j.Logger

An underlying logger implementation that collaborates with SLF4JDelegatingLog to temporarily store logging events before the actual logging system is loaded.

At instance level, we only implement a LocationAwareLogger. The rest of the Logger interface is not implemented. This is a very limited implementation that is tailored for the only use of SLF4JDelegatingLog.

We only implement LocationAwareLogger because before the actual logging system is bootstrapped, we cannot tell if actual loggers will be location aware loggers or not, so we assume they will be. The same goes for loggers activation. We make no assumption on activated log levels, so this implementation acts as if all log levels where enabled.

At class level, all created instances are registered in a collection, so that they can be swapped in their respective SLF4JDelegatingLog by an actual SLF4J logger. When the Logback bootstrapping has started, a call to swapLoggers() runs this swapping process.

This class does not implement thread safety. It's the responsibility of client code to properly synchronize calls to these three methods, using a single lock:

• PreBootstrapLogger(SLF4JDelegatingLog, String) (constructor)
• log(Marker, String, int, String, Object[], Throwable) (instance method)
• swapLoggers() (class method)

Typically, facade loggers SLF4JDelegatingLog do (globally) synchronize access to the three methods above.

Diagnostics can be activated by lowering the SLF4JDelegatingLog.diagnostics level.

Since:

1.1.0

Author:

Benjamin Gandon

See Also:

PreBootstrapLoggingEvent, SLF4JDelegatingLog, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected String	name

Fields inherited from interface org.slf4j.spi.LocationAwareLogger

DEBUG_INT, ERROR_INT, INFO_INT, TRACE_INT, WARN_INT

Fields inherited from interface org.slf4j.Logger

ROOT_LOGGER_NAME

Constructor Summary

Constructors

Constructor and Description
PreBootstrapLogger(SLF4JDelegatingLog facade, String name) Creates a new pre-bootstrap logger.

Method Summary

Modifier and Type	Method and Description
void	debug(String msg)
void	debug(String format, Object... arguments)
void	debug(String format, Object arg)
void	debug(String format, Object arg1, Object arg2)
void	debug(String msg, Throwable t)
void	error(String msg)
void	error(String format, Object... arguments)
void	error(String format, Object arg)
void	error(String format, Object arg1, Object arg2)
void	error(String msg, Throwable t)
void	info(String msg)
void	info(String format, Object... arguments)
void	info(String format, Object arg)
void	info(String format, Object arg1, Object arg2)
void	info(String msg, Throwable t)
boolean	isDebugEnabled()
boolean	isErrorEnabled()
boolean	isInfoEnabled()
boolean	isTraceEnabled()
boolean	isWarnEnabled()
void	log(org.slf4j.Marker marker, String fqcn, int level, String msg, Object[] args, Throwable t) This implementations just stores a pre-bootstrap logging event.
protected Object	readResolve()
void	trace(String msg)
void	trace(String format, Object... args)
void	trace(String format, Object arg)
void	trace(String format, Object arg1, Object arg2)
void	trace(String msg, Throwable t)
void	warn(String msg)
void	warn(String format, Object... arguments)
void	warn(String format, Object arg)
void	warn(String format, Object arg1, Object arg2)
void	warn(String msg, Throwable t)

Methods inherited from class org.slf4j.helpers.MarkerIgnoringBase

debug, debug, debug, debug, debug, error, error, error, error, error, info, info, info, info, info, isDebugEnabled, isErrorEnabled, isInfoEnabled, isTraceEnabled, isWarnEnabled, toString, trace, trace, trace, trace, trace, warn, warn, warn, warn, warn

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.slf4j.Logger

debug, debug, debug, debug, debug, error, error, error, error, error, getName, info, info, info, info, info, isDebugEnabled, isErrorEnabled, isInfoEnabled, isTraceEnabled, isWarnEnabled, trace, trace, trace, trace, trace, warn, warn, warn, warn, warn

Field Detail

name

protected String name

Constructor Detail

PreBootstrapLogger

public PreBootstrapLogger(SLF4JDelegatingLog facade,
                          String name)

Creates a new pre-bootstrap logger.

Parameters:

facade - the facade for the underlying logger to create

name - the logger name

Method Detail

log

public void log(org.slf4j.Marker marker,
                String fqcn,
                int level,
                String msg,
                Object[] args,
                Throwable t)

This implementations just stores a pre-bootstrap logging event.

Specified by:

log in interface org.slf4j.spi.LocationAwareLogger

isTraceEnabled

public boolean isTraceEnabled()

Specified by:

isTraceEnabled in interface org.slf4j.Logger

trace

public void trace(String msg)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(String format,
                  Object arg)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(String format,
                  Object arg1,
                  Object arg2)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(String format,
                  Object... args)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(String msg,
                  Throwable t)

Specified by:

trace in interface org.slf4j.Logger

isDebugEnabled

public boolean isDebugEnabled()

Specified by:

isDebugEnabled in interface org.slf4j.Logger

debug

public void debug(String msg)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(String format,
                  Object arg)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(String format,
                  Object arg1,
                  Object arg2)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(String format,
                  Object... arguments)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(String msg,
                  Throwable t)

Specified by:

debug in interface org.slf4j.Logger

isInfoEnabled

public boolean isInfoEnabled()

Specified by:

isInfoEnabled in interface org.slf4j.Logger

info

public void info(String msg)

Specified by:

info in interface org.slf4j.Logger

info

public void info(String format,
                 Object arg)

Specified by:

info in interface org.slf4j.Logger

info

public void info(String format,
                 Object arg1,
                 Object arg2)

Specified by:

info in interface org.slf4j.Logger

info

public void info(String format,
                 Object... arguments)

Specified by:

info in interface org.slf4j.Logger

info

public void info(String msg,
                 Throwable t)

Specified by:

info in interface org.slf4j.Logger

isWarnEnabled

public boolean isWarnEnabled()

Specified by:

isWarnEnabled in interface org.slf4j.Logger

warn

public void warn(String msg)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(String format,
                 Object arg)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(String format,
                 Object... arguments)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(String format,
                 Object arg1,
                 Object arg2)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(String msg,
                 Throwable t)

Specified by:

warn in interface org.slf4j.Logger

isErrorEnabled

public boolean isErrorEnabled()

Specified by:

isErrorEnabled in interface org.slf4j.Logger

error

public void error(String msg)

Specified by:

error in interface org.slf4j.Logger

error

public void error(String format,
                  Object arg)

Specified by:

error in interface org.slf4j.Logger

error

public void error(String format,
                  Object arg1,
                  Object arg2)

Specified by:

error in interface org.slf4j.Logger

error

public void error(String format,
                  Object... arguments)

Specified by:

error in interface org.slf4j.Logger

error

public void error(String msg,
                  Throwable t)

Specified by:

error in interface org.slf4j.Logger

readResolve

protected Object readResolve()
                      throws ObjectStreamException

Throws:

ObjectStreamException