Class ServletAppender
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.web.appender.ServletAppender
- All Implemented Interfaces:
Appender,Filterable,LocationAware,LifeCycle,LifeCycle2
@Plugin(name="Servlet",
category="Core",
elementType="appender",
printObject=true)
public class ServletAppender
extends AbstractAppender
Logs using the ServletContext's log method
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classServletAppender.Builder<B extends ServletAppender.Builder<B>>Nested classes/interfaces inherited from interface org.apache.logging.log4j.core.LifeCycle
LifeCycle.State -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final booleanprivate final jakarta.servlet.ServletContextFields inherited from class org.apache.logging.log4j.core.AbstractLifeCycle
DEFAULT_STOP_TIMEOUT, DEFAULT_STOP_TIMEUNIT, LOGGERFields inherited from interface org.apache.logging.log4j.core.Appender
ELEMENT_TYPE, EMPTY_ARRAY -
Constructor Summary
ConstructorsModifierConstructorDescriptionprivateServletAppender(String name, Layout<? extends Serializable> layout, Filter filter, jakarta.servlet.ServletContext servletContext, boolean ignoreExceptions, boolean logThrowables) -
Method Summary
Modifier and TypeMethodDescriptionvoidLogs a LogEvent using whatever logic this Appender wishes to use.static ServletAppendercreateAppender(Layout<? extends Serializable> layout, Filter filter, String name, boolean ignoreExceptions) Deprecated.static <B extends ServletAppender.Builder<B>>
BMethods inherited from class org.apache.logging.log4j.core.appender.AbstractAppender
error, error, error, getHandler, getLayout, getName, ignoreExceptions, parseInt, requiresLocation, setHandler, toSerializable, toStringMethods inherited from class org.apache.logging.log4j.core.filter.AbstractFilterable
addFilter, getFilter, getPropertyArray, hasFilter, isFiltered, removeFilter, start, stop, stopMethods inherited from class org.apache.logging.log4j.core.AbstractLifeCycle
equalsImpl, getState, getStatusLogger, hashCodeImpl, initialize, isInitialized, isStarted, isStarting, isStopped, isStopping, setStarted, setStarting, setState, setStopped, setStopping, stop, stop
-
Field Details
-
servletContext
private final jakarta.servlet.ServletContext servletContext -
logThrowables
private final boolean logThrowables
-
-
Constructor Details
-
ServletAppender
private ServletAppender(String name, Layout<? extends Serializable> layout, Filter filter, jakarta.servlet.ServletContext servletContext, boolean ignoreExceptions, boolean logThrowables)
-
-
Method Details
-
newBuilder
-
append
Description copied from interface:AppenderLogs a LogEvent using whatever logic this Appender wishes to use. It is typically recommended to use a bridge pattern not only for the benefits from decoupling an Appender from its implementation, but it is also handy for sharing resources which may require some form of locking.- Parameters:
event- The LogEvent.
-
createAppender
@Deprecated public static ServletAppender createAppender(Layout<? extends Serializable> layout, Filter filter, String name, boolean ignoreExceptions) Deprecated.UsenewBuilder().Creates a Servlet Appender.- Parameters:
layout- The layout to use (required). Must extendAbstractStringLayout.filter- The Filter or null.name- The name of the Appender (required).ignoreExceptions- Iftrue(default) exceptions encountered when appending events are logged; otherwise they are propagated to the caller.- Returns:
- The ServletAppender.
-
newBuilder().