Class RewriteAppender

java.lang.Object

org.apache.logging.log4j.core.AbstractLifeCycle

org.apache.logging.log4j.core.filter.AbstractFilterable

org.apache.logging.log4j.core.appender.AbstractAppender

org.apache.logging.log4j.core.appender.rewrite.RewriteAppender

All Implemented Interfaces:

Appender, Filterable, LocationAware, LifeCycle, LifeCycle2

@Plugin(name="Rewrite",
        category="Core",
        elementType="appender",
        printObject=true)
public final class RewriteAppender
extends AbstractAppender

This Appender allows the logging event to be manipulated before it is processed by other Appenders.

Nested Class Summary

Nested classes/interfaces inherited from class AbstractAppender

AbstractAppender.Builder<B>

Nested classes/interfaces inherited from interface LifeCycle

LifeCycle.State

Field Summary

Fields

Modifier and Type	Field	Description
private final AppenderRef[]	appenderRefs
private final ConcurrentMap<String, AppenderControl>	appenders
private final Configuration	config
private final RewritePolicy	rewritePolicy

Fields inherited from class AbstractLifeCycle

DEFAULT_STOP_TIMEOUT, DEFAULT_STOP_TIMEUNIT, LOGGER

Fields inherited from interface Appender

ELEMENT_TYPE, EMPTY_ARRAY

Constructor Summary

Constructors

Modifier	Constructor	Description
private	RewriteAppender(String name, Filter filter, boolean ignoreExceptions, AppenderRef[] appenderRefs, RewritePolicy rewritePolicy, Configuration config, Property[] properties)

Method Summary

Modifier and Type	Method	Description
void	append(LogEvent event)	Modifies the event and pass to the subordinate Appenders.
static RewriteAppender	createAppender(String name, String ignore, AppenderRef[] appenderRefs, Configuration config, RewritePolicy rewritePolicy, Filter filter)	Creates a RewriteAppender.
boolean	requiresLocation()
void	start()	Make the Filter available for use.

Methods inherited from class AbstractAppender

error, error, error, getHandler, getLayout, getName, ignoreExceptions, parseInt, setHandler, toSerializable, toString

Methods inherited from class AbstractFilterable

addFilter, getFilter, getPropertyArray, hasFilter, isFiltered, removeFilter, stop, stop

Methods inherited from class AbstractLifeCycle

equalsImpl, getState, getStatusLogger, hashCodeImpl, initialize, isInitialized, isStarted, isStarting, isStopped, isStopping, setStarted, setStarting, setState, setStopped, setStopping, stop, stop

Methods inherited from class Object

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

Methods inherited from interface LifeCycle

getState, initialize, isStarted, isStopped, stop

Field Details

config

private final Configuration config

appenders

private final ConcurrentMap<String, AppenderControl> appenders

rewritePolicy

private final RewritePolicy rewritePolicy

appenderRefs

private final AppenderRef[] appenderRefs

Constructor Details

RewriteAppender

private RewriteAppender(String name,
 Filter filter,
 boolean ignoreExceptions,
 AppenderRef[] appenderRefs,
 RewritePolicy rewritePolicy,
 Configuration config,
 Property[] properties)

Method Details

start

public void start()

Description copied from class: AbstractFilterable

Make the Filter available for use.

Specified by:

start in interface LifeCycle

Overrides:

start in class AbstractFilterable

append

public void append(LogEvent event)

Modifies the event and pass to the subordinate Appenders.

Parameters:

event - The LogEvent.

createAppender

@PluginFactory
public static RewriteAppender createAppender(@PluginAttribute("name")
 String name,
 @PluginAttribute("ignoreExceptions")
 String ignore,
 @PluginElement("AppenderRef")
 AppenderRef[] appenderRefs,
 @PluginConfiguration
 Configuration config,
 @PluginElement("RewritePolicy")
 RewritePolicy rewritePolicy,
 @PluginElement("Filter")
 Filter filter)

Creates a RewriteAppender.

Parameters:

name - The name of the Appender.

ignore - If "true" (default) exceptions encountered when appending events are logged; otherwise they are propagated to the caller.

appenderRefs - An array of Appender names to call.

config - The Configuration.

rewritePolicy - The policy to use to modify the event.

filter - A Filter to filter events.

Returns:

The created RewriteAppender.

requiresLocation

public boolean requiresLocation()

Specified by:

requiresLocation in interface LocationAware

Overrides:

requiresLocation in class AbstractAppender