|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.log4j.AppenderSkeleton
public abstract class AppenderSkeleton
Abstract superclass of the other appenders in the package. This class provides the code for common functionality, such as support for threshold filtering and support for general filters.
Field Summary | |
---|---|
protected boolean |
closed
Is this appender closed? |
protected ErrorHandler |
errorHandler
It is assumed and enforced that errorHandler is never null. |
protected Filter |
headFilter
The first filter in the filter chain. |
protected Layout |
layout
The layout variable does not need to be set if the appender implementation has its own layout. |
protected String |
name
Appenders are named. |
protected Filter |
tailFilter
The last filter in the filter chain. |
protected Priority |
threshold
There is no level threshold filtering by default. |
Constructor Summary | |
---|---|
|
AppenderSkeleton()
Create new instance. |
protected |
AppenderSkeleton(boolean isActive)
Create new instance. |
Method Summary | |
---|---|
void |
activateOptions()
Derived appenders should override this method if option structure requires it. |
void |
addFilter(Filter newFilter)
Add a filter to end of the filter list. |
protected abstract void |
append(LoggingEvent event)
Subclasses of AppenderSkeleton should implement this
method to perform actual logging. |
void |
clearFilters()
Clear the filters chain. |
void |
doAppend(LoggingEvent event)
This method performs threshold checks and invokes filters before delegating actual logging to the subclasses specific append(org.apache.log4j.spi.LoggingEvent) method. |
void |
finalize()
Finalize this appender by calling the derived class' close method. |
ErrorHandler |
getErrorHandler()
Return the currently set ErrorHandler for this
Appender. |
Filter |
getFilter()
Returns the head Filter. |
Filter |
getFirstFilter()
Return the first filter in the filter chain for this Appender. |
Layout |
getLayout()
Returns the layout of this appender. |
String |
getName()
Returns the name of this appender. |
Priority |
getThreshold()
Returns this appenders threshold level. |
boolean |
isAsSevereAsThreshold(Priority priority)
Check whether the message level is below the appender's threshold. |
void |
setErrorHandler(ErrorHandler eh)
Set the ErrorHandler for this Appender. |
void |
setLayout(Layout layout)
Set the layout for this appender. |
void |
setName(String name)
Set the name of this Appender. |
void |
setThreshold(Priority threshold)
Set the threshold level. |
Methods inherited from class java.lang.Object |
---|
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface org.apache.log4j.Appender |
---|
close, requiresLayout |
Field Detail |
---|
protected Layout layout
protected String name
protected Priority threshold
protected ErrorHandler errorHandler
protected Filter headFilter
null
initially.
protected Filter tailFilter
protected boolean closed
Constructor Detail |
---|
public AppenderSkeleton()
protected AppenderSkeleton(boolean isActive)
isActive
- true if appender is ready for use upon construction.
Not used in log4j 1.2.x.Method Detail |
---|
public void activateOptions()
activateOptions
in interface OptionHandler
public void addFilter(Filter newFilter)
addFilter
in interface Appender
protected abstract void append(LoggingEvent event)
AppenderSkeleton
should implement this
method to perform actual logging. See also AppenderSkeleton.doAppend
method.
public void clearFilters()
clearFilters
in interface Appender
public void finalize()
close
method.
finalize
in class Object
public ErrorHandler getErrorHandler()
ErrorHandler
for this
Appender.
getErrorHandler
in interface Appender
public Filter getFilter()
getFilter
in interface Appender
public final Filter getFirstFilter()
null
if no is
filter is set.
public Layout getLayout()
getLayout
in interface Appender
public final String getName()
getName
in interface Appender
public Priority getThreshold()
setThreshold(org.apache.log4j.Priority)
method for the meaning of this option.
public boolean isAsSevereAsThreshold(Priority priority)
true
.
public void doAppend(LoggingEvent event)
append(org.apache.log4j.spi.LoggingEvent)
method.
doAppend
in interface Appender
public void setErrorHandler(ErrorHandler eh)
ErrorHandler
for this Appender.
setErrorHandler
in interface Appender
public void setLayout(Layout layout)
SocketAppender
ignores the layout set
here.
setLayout
in interface Appender
public void setName(String name)
setName
in interface Appender
public void setThreshold(Priority threshold)
In configuration files this option is specified by setting the value of the Threshold option to a level string, such as "DEBUG", "INFO" and so on.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |