|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.avalon.excalibur.logger.decorator.LoggerManagerDecorator
public abstract class LoggerManagerDecorator
This is the base class to create LoggerManager decorators. It passes all lifecycle and LoggerManagerc calls onto the wrapped object.
Decorators are expected to be slim - be able to run for instance both with and without having their enableLogging() method called.
This constraint is imposed to allow decorators to be applicable to an object both at its burth, like
C c = new C(); DecoratorX d = new DecoratorX( c ); x.enableLogging( logger );and after the object has been completely configured
C c = (C)manager.lookup( C.ROLE ); DecoratorX d = new DecoratorX( c );If this constrianed is not obeyed this should be clearly stated in the javadocs. For instance, LogToSelfDecorator _only_ makes sense if it passes the
enableLogging
call through it.
This implementation is incomplete,
it passes only those calls that are needed in
org.apache.avalon.excalibur.logger.decorator.*
and
org.apache.avalon.excalibur.logger.adapter.*
:
LogEnabled Contextualizable Configurable Startable DisposableThis object differes from LoggerManagerTee by being abstract, by absence of addTee() public method and by implementation. LoggerManagerTee might be used instead of this but maintaining it as a separate class seemed cleaner.
Field Summary | |
---|---|
protected LoggerManager |
m_loggerManager
The wrapped-in LoggerManager. |
Fields inherited from interface org.apache.avalon.excalibur.logger.LoggerManager |
---|
ROLE |
Constructor Summary | |
---|---|
LoggerManagerDecorator(LoggerManager loggerManager)
|
Method Summary | |
---|---|
void |
configure(Configuration configuration)
|
void |
contextualize(Context context)
|
void |
dispose()
|
void |
enableLogging(Logger logger)
|
Logger |
getDefaultLogger()
Return the default Logger. |
Logger |
getLoggerForCategory(String categoryName)
Return the Logger for the specified category. |
void |
start()
|
void |
stop()
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected final LoggerManager m_loggerManager
Constructor Detail |
---|
public LoggerManagerDecorator(LoggerManager loggerManager)
Method Detail |
---|
public void enableLogging(Logger logger)
enableLogging
in interface LogEnabled
public void contextualize(Context context) throws ContextException
contextualize
in interface Contextualizable
ContextException
public void configure(Configuration configuration) throws ConfigurationException
configure
in interface Configurable
ConfigurationException
public void start() throws Exception
start
in interface org.apache.avalon.framework.activity.Startable
Exception
public void stop() throws Exception
stop
in interface org.apache.avalon.framework.activity.Startable
Exception
public void dispose()
dispose
in interface org.apache.avalon.framework.activity.Disposable
public Logger getLoggerForCategory(String categoryName)
getLoggerForCategory
in interface LoggerManager
public Logger getDefaultLogger()
getDefaultLogger
in interface LoggerManager
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |