ch.qos.logback.classic

Class LoggerContext

java.lang.Object

ch.qos.logback.core.ContextBase

ch.qos.logback.classic.LoggerContext

All Implemented Interfaces:

Context, LifeCycle, PropertyContainer, org.slf4j.ILoggerFactory

public class LoggerContext
extends ContextBase
implements org.slf4j.ILoggerFactory, LifeCycle

LoggerContext glues many of the logback-classic components together. In principle, every logback-classic component instance is attached either directly or indirectly to a LoggerContext instance. Just as importantly LoggerContext implements the ILoggerFactory acting as the manufacturing source of Logger instances.

Author:

Ceki Gulcu

Constructor Summary

Constructors

Constructor and Description
LoggerContext()

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(LoggerContextListener listener)
void	addTurboFilter(TurboFilter newFilter)
Logger	exists(String name) Check if the named logger exists in the hierarchy.
List<LoggerContextListener>	getCopyOfListenerList()
List<String>	getFrameworkPackages() List of packages considered part of the logging framework such that they are never considered as callers of the logging framework.
Logger	getLogger(Class clazz)
Logger	getLogger(String name)
LoggerContextVO	getLoggerContextRemoteView()
List<Logger>	getLoggerList()
int	getMaxCallerDataDepth()
TurboFilterList	getTurboFilterList()
boolean	isPackagingDataEnabled()
boolean	isStarted()
void	putProperty(String key, String val)
void	removeListener(LoggerContextListener listener)
void	reset() This method clears all internal properties, except internal status messages, closes all appenders, removes any turboFilters, fires an OnReset event, removes all status listeners, removes all context listeners (except those which are reset resistant).
void	resetTurboFilterList() First stop all registered turbo filters and then clear the registration list.
void	setMaxCallerDataDepth(int maxCallerDataDepth)
void	setName(String name)
void	setPackagingDataEnabled(boolean packagingDataEnabled)
void	start()
void	stop()
String	toString()

Methods inherited from class ch.qos.logback.core.ContextBase

getBirthTime, getConfigurationLock, getCopyOfPropertyMap, getExecutorService, getName, getObject, getProperty, getStatusManager, putObject, setStatusManager

Methods inherited from class java.lang.Object

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

Constructor Detail

LoggerContext

public LoggerContext()

Method Detail

putProperty

public void putProperty(String key,
               String val)

Specified by:

putProperty in interface Context

Overrides:

putProperty in class ContextBase

setName

public void setName(String name)

Specified by:

setName in interface Context

Overrides:

setName in class ContextBase

getLogger

public final Logger getLogger(Class clazz)

getLogger

public final Logger getLogger(String name)

Specified by:

getLogger in interface org.slf4j.ILoggerFactory

exists

public Logger exists(String name)

Check if the named logger exists in the hierarchy. If so return its reference, otherwise returns null.

Parameters:

name - the name of the logger to search for.

getLoggerList

public List<Logger> getLoggerList()

getLoggerContextRemoteView

public LoggerContextVO getLoggerContextRemoteView()

setPackagingDataEnabled

public void setPackagingDataEnabled(boolean packagingDataEnabled)

isPackagingDataEnabled

public boolean isPackagingDataEnabled()

reset

public void reset()

This method clears all internal properties, except internal status messages, closes all appenders, removes any turboFilters, fires an OnReset event, removes all status listeners, removes all context listeners (except those which are reset resistant).

As mentioned above, internal status messages survive resets.

Overrides:

reset in class ContextBase

getTurboFilterList

public TurboFilterList getTurboFilterList()

addTurboFilter

public void addTurboFilter(TurboFilter newFilter)

resetTurboFilterList

public void resetTurboFilterList()

First stop all registered turbo filters and then clear the registration list.

addListener

public void addListener(LoggerContextListener listener)

removeListener

public void removeListener(LoggerContextListener listener)

getCopyOfListenerList

public List<LoggerContextListener> getCopyOfListenerList()

isStarted

public boolean isStarted()

Specified by:

isStarted in interface LifeCycle

start

public void start()

Specified by:

start in interface LifeCycle

stop

public void stop()

Specified by:

stop in interface LifeCycle

toString

public String toString()

Overrides:

toString in class ContextBase

getMaxCallerDataDepth

public int getMaxCallerDataDepth()

setMaxCallerDataDepth

public void setMaxCallerDataDepth(int maxCallerDataDepth)

getFrameworkPackages

public List<String> getFrameworkPackages()

List of packages considered part of the logging framework such that they are never considered as callers of the logging framework. This list used to compute the caller for logging events.

To designate package "com.foo" as well as all its subpackages as being part of the logging framework, simply add "com.foo" to this list.

Returns:

list of framework packages