org.apache.avalon.excalibur.logger.util

Class LoggerSwitch

java.lang.Object

org.apache.avalon.excalibur.logger.util.LoggerSwitch

public class LoggerSwitch
extends java.lang.Object

A proxy logger that switches between two underlying loggers with recursive invocation detection.

This class is intended to be used by o.a.a.e.logger.AbstractLoggerManager. all the logger switching is done in it during the "warm-up" phase (constructor, enableLogging, contextualize, configure, start). All these operations are held our on a single thread and the object is not exposed to other threads untill (in strict synchronization sense) it has been fully configured. That's why there is no synchronization in this class. If the switching was to occur in a mulitythreaded fasion we would have to synchronize access to m_fallback and m_preferred.

Author:

Avalon Development Team

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	LoggerSwitch.BooleanThreadLocal
private static class	LoggerSwitch.SwitchingLogger

Field Summary

Fields

Modifier and Type	Field and Description
private LoggerSwitch.SwitchingLogger	m_switch
protected static org.apache.avalon.framework.logger.Logger	SHARED_NULL

Constructor Summary

Constructors

Constructor and Description
LoggerSwitch(org.apache.avalon.framework.logger.Logger fallback)
LoggerSwitch(org.apache.avalon.framework.logger.Logger fallback, org.apache.avalon.framework.logger.Logger preferred)

Method Summary

Methods

Modifier and Type	Method and Description
org.apache.avalon.framework.logger.Logger	get() We create a logger with no methods for changing m_fallback and m_preferred for security reasons.
void	setFallback(org.apache.avalon.framework.logger.Logger fallback)
void	setPreferred(org.apache.avalon.framework.logger.Logger preferred)

Methods inherited from class java.lang.Object

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

Field Detail

SHARED_NULL

protected static final org.apache.avalon.framework.logger.Logger SHARED_NULL

m_switch

private LoggerSwitch.SwitchingLogger m_switch

Constructor Detail

LoggerSwitch

public LoggerSwitch(org.apache.avalon.framework.logger.Logger fallback)

LoggerSwitch

public LoggerSwitch(org.apache.avalon.framework.logger.Logger fallback,
            org.apache.avalon.framework.logger.Logger preferred)

Method Detail

get

public org.apache.avalon.framework.logger.Logger get()

We create a logger with no methods for changing m_fallback and m_preferred for security reasons. All the control is done by the parent class that does not implement Logger itself.

setFallback

public void setFallback(org.apache.avalon.framework.logger.Logger fallback)

setPreferred

public void setPreferred(org.apache.avalon.framework.logger.Logger preferred)