Module ch.qos.logback.classic

Package ch.qos.logback.classic.pattern

Class NamedConverter

java.lang.Object

ch.qos.logback.core.pattern.Converter<ILoggingEvent>

ch.qos.logback.core.pattern.FormattingConverter<ILoggingEvent>

ch.qos.logback.core.pattern.DynamicConverter<ILoggingEvent>

ch.qos.logback.classic.pattern.ClassicConverter

ch.qos.logback.classic.pattern.NamedConverter

All Implemented Interfaces:

ContextAware, LifeCycle

Direct Known Subclasses:

ClassOfCallerConverter, LoggerConverter

public abstract class NamedConverter
extends ClassicConverter

In case abbreviation service is requested, NamedConverter will convert fully qualified class names to their abbreviated from. NamedConverter instances will store abbreviated names in an internal LRU cache. The cache will double in size if he cache miss rate is consistently above 30%. Assuming a high miss rate, the doubling until a maximum size of 2048 is attained. If at this point the cache miss rate is still too high, NamedConverter will revert to non cached behavior. The general assumption here is that a large majority of logger names are concentrated within a group of approximately 1000 logger names.

Author:

Ceki Gulcu

Field Summary

Fields inherited from class ch.qos.logback.core.pattern.DynamicConverter

started

Constructor Summary

Constructors

Constructor	Description
NamedConverter()

Method Summary

Modifier and Type	Method	Description
String	convert(ILoggingEvent event)	The convert method is responsible for extracting data from the event and storing it for later use by the write method.
int	getCacheMisses()
double	getCacheMissRate()
protected abstract String	getFullyQualifiedName(ILoggingEvent event)	Gets fully qualified name from event.
void	start()	Components that depend on options passed during configuration can override this method in order to make appropriate use of those options.

Methods inherited from class ch.qos.logback.core.pattern.DynamicConverter

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, getFirstOption, getOptionList, isStarted, setContext, setOptionList, stop

Methods inherited from class ch.qos.logback.core.pattern.FormattingConverter

getFormattingInfo, setFormattingInfo, write

Methods inherited from class ch.qos.logback.core.pattern.Converter

getNext, setNext

Methods inherited from class java.lang.Object

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

Constructor Details

NamedConverter

public NamedConverter()

Method Details

getFullyQualifiedName

protected abstract String getFullyQualifiedName(ILoggingEvent event)

Gets fully qualified name from event.

Parameters:

event - The LoggingEvent to process, cannot not be null.

Returns:

name, must not be null.

start

public void start()

Description copied from class: DynamicConverter

Components that depend on options passed during configuration can override this method in order to make appropriate use of those options. For simpler components, the trivial implementation found in this abstract class will be sufficient.

Specified by:

start in interface LifeCycle

Overrides:

start in class DynamicConverter<ILoggingEvent>

convert

public String convert(ILoggingEvent event)

Description copied from class: Converter

The convert method is responsible for extracting data from the event and storing it for later use by the write method.

Specified by:

convert in class Converter<ILoggingEvent>

Parameters:

event -

getCacheMissRate

public double getCacheMissRate()

getCacheMisses

public int getCacheMisses()