Class RewriteAppender

  extended by org.apache.logging.log4j.core.AbstractLifeCycle
      extended by org.apache.logging.log4j.core.filter.AbstractFilterable
          extended by org.apache.logging.log4j.core.appender.AbstractAppender
              extended by org.apache.logging.log4j.core.appender.rewrite.RewriteAppender
All Implemented Interfaces:
Serializable, Appender, Filterable, LifeCycle

public final class RewriteAppender
extends AbstractAppender

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

See Also:
Serialized Form

Nested Class Summary
Nested classes/interfaces inherited from interface org.apache.logging.log4j.core.LifeCycle
Field Summary
Fields inherited from class org.apache.logging.log4j.core.AbstractLifeCycle
Method Summary
 void append(LogEvent event)
          Modify the event and pass to the subordinate Appenders.
static RewriteAppender createAppender(String name, String ignore, AppenderRef[] appenderRefs, Configuration config, RewritePolicy rewritePolicy, Filter filter)
          Create a RewriteAppender.
 void start()
          Make the Filter available for use.
 void stop()
          Cleanup the Filter.
Methods inherited from class org.apache.logging.log4j.core.appender.AbstractAppender
error, error, error, getHandler, getLayout, getName, ignoreExceptions, parseInt, setHandler, toString
Methods inherited from class org.apache.logging.log4j.core.filter.AbstractFilterable
addFilter, getFilter, hasFilter, isFiltered, removeFilter
Methods inherited from class org.apache.logging.log4j.core.AbstractLifeCycle
equalsImpl, getState, hashCodeImpl, isInitialized, isStarted, isStarting, isStopped, isStopping, setStarted, setStarting, setState, setStopped, setStopping
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.apache.logging.log4j.core.LifeCycle
getState, isStarted, isStopped

Method Detail


public void start()
Description copied from class: AbstractFilterable
Make the Filter available for use.

Specified by:
start in interface LifeCycle
start in class AbstractFilterable


public void stop()
Description copied from class: AbstractFilterable
Cleanup the Filter.

Specified by:
stop in interface LifeCycle
stop in class AbstractFilterable


public void append(LogEvent event)
Modify the event and pass to the subordinate Appenders.

event - The LogEvent.


public static RewriteAppender createAppender(@PluginAttribute(value="name")
                                                           String name,
                                                           String ignore,
                                                           AppenderRef[] appenderRefs,
                                                           Configuration config,
                                                           RewritePolicy rewritePolicy,
                                                           Filter filter)
Create a RewriteAppender.

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.
The created RewriteAppender.

Copyright © 1999-2015 Apache Software Foundation. All Rights Reserved.
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather logo, the Apache Logging project logo, and the Apache Log4j logo are trademarks of The Apache Software Foundation.