Class UnsynchronizedAppenderBase<E>

java.lang.Object

ch.qos.logback.core.spi.ContextAwareBase

ch.qos.logback.core.UnsynchronizedAppenderBase<E>

All Implemented Interfaces:

Appender<E>, ContextAware, FilterAttachable<E>, LifeCycle

Direct Known Subclasses:

AsyncAppenderBase, OutputStreamAppender

public abstract class UnsynchronizedAppenderBase<E>
extends ContextAwareBase
implements Appender<E>

Similar to AppenderBase except that derived appenders need to handle thread synchronization on their own.

Author:

Ceki Gülcü, Ralph Goers

Field Summary

Fields

Modifier and Type	Field	Description
protected String	name	Appenders are named.
protected boolean	started

Fields inherited from class ContextAwareBase

context

Constructor Summary

Constructors

Constructor	Description
UnsynchronizedAppenderBase()

Method Summary

Modifier and Type	Method	Description
void	addFilter(Filter<E> newFilter)	Add a filter.
protected abstract void	append(E eventObject)
protected ReentryGuard	buildReentryGuard()	Create a ReentryGuard instance used by this appender to prevent recursive/re-entrant calls to doAppend(Object).
void	clearAllFilters()
void	doAppend(E eventObject)	This is where an appender accomplishes its work: format and deliver the provided event to the appender's destination.
List<Filter<E>>	getCopyOfAttachedFiltersList()	Get a copy of all the filters contained within this FilterAttachable object.
FilterReply	getFilterChainDecision(E event)	Loop through the filters in the chain.
String	getName()	Get the name of this appender.
boolean	isStarted()
void	setName(String name)	Set the name of this appender.
void	start()
void	stop()
String	toString()

Methods inherited from class ContextAwareBase

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, getDeclaredOrigin, getStatusManager, setContext

Methods inherited from class Object

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

Methods inherited from interface ContextAware

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, setContext

Field Details

started

protected volatile boolean started

name

protected String name

Appenders are named.

Constructor Details

UnsynchronizedAppenderBase

public UnsynchronizedAppenderBase()

Method Details

getName

public String getName()

Description copied from interface: Appender

Get the name of this appender. The name uniquely identifies the appender within its context and is used for configuration and lookup.

Specified by:

getName in interface Appender<E>

Returns:

the appender name, or null if not set

doAppend

public void doAppend(E eventObject)

Description copied from interface: Appender

This is where an appender accomplishes its work: format and deliver the provided event to the appender's destination.

Implementations should apply any configured filters before outputting the event. Implementations should avoid throwing runtime exceptions; if an error occurs that cannot be handled internally, a LogbackException (or a subtype) may be thrown to indicate a failure during append.

Specified by:

doAppend in interface Appender<E>

Parameters:

eventObject - the event to append; may not be null

append

protected abstract void append(E eventObject)

setName

public void setName(String name)

Set the name of this appender.

Specified by:

setName in interface Appender<E>

Parameters:

name - the new name for this appender; may be null to unset

start

public void start()

Specified by:

start in interface LifeCycle

buildReentryGuard

protected ReentryGuard buildReentryGuard()

Create a ReentryGuard instance used by this appender to prevent recursive/re-entrant calls to doAppend(Object).

The default implementation returns a no-op guard produced by ReentryGuardFactory.makeGuard(ch.qos.logback.core.util.ReentryGuardFactory.GuardType) using GuardType.NOP. Subclasses that require actual re-entry protection (for example using a thread-local or lock-based guard) should override this method to return an appropriate ReentryGuard implementation.

Contract/expectations:

• Called from start() to initialize the appender's guard.
• Implementations should be lightweight and thread-safe.
• Return value must not be null.

Returns:

a non-null ReentryGuard used to detect and prevent re-entrant appends. By default, this is a no-op guard.

Since:

1.5.21

stop

public void stop()

Specified by:

stop in interface LifeCycle

isStarted

public boolean isStarted()

Specified by:

isStarted in interface LifeCycle

toString

public String toString()

Overrides:

toString in class Object

addFilter

public void addFilter(Filter<E> newFilter)

Description copied from interface: FilterAttachable

Add a filter.

Specified by:

addFilter in interface FilterAttachable<E>

clearAllFilters

public void clearAllFilters()

Specified by:

clearAllFilters in interface FilterAttachable<E>

getCopyOfAttachedFiltersList

public List<Filter<E>> getCopyOfAttachedFiltersList()

Description copied from interface: FilterAttachable

Get a copy of all the filters contained within this FilterAttachable object.

Specified by:

getCopyOfAttachedFiltersList in interface FilterAttachable<E>

Returns:

all attached filters as a list

getFilterChainDecision

public FilterReply getFilterChainDecision(E event)

Description copied from interface: FilterAttachable

Loop through the filters in the chain. As soon as a filter decides on ACCEPT or DENY, then that value is returned. If all of the filters return NEUTRAL, then NEUTRAL is returned.

Specified by:

getFilterChainDecision in interface FilterAttachable<E>