org.apache.log4j.varia

Class LevelRangeFilter

public class LevelRangeFilter extends Filter

This is a very simple filter based on level matching, which can be used to reject messages with priorities outside a certain range.

The filter admits three options LevelMin, LevelMax and AcceptOnMatch.

If the level of the LoggingEvent is not between Min and Max (inclusive), then DENY is returned.

If the Logging event level is within the specified range, then if AcceptOnMatch is true, ACCEPT is returned, and if AcceptOnMatch is false, NEUTRAL is returned.

If LevelMinw is not defined, then there is no minimum acceptable level (ie a level is never rejected for being too "low"/unimportant). If LevelMax is not defined, then there is no maximum acceptable level (ie a level is never rejected for beeing too "high"/important).

Refer to the setThreshold method available to all appenders extending AppenderSkeleton for a more convenient way to filter out events by level.

Author: Simon Kitching based on code by Ceki Gülcü

Method Summary
intdecide(LoggingEvent event)
Return the decision of this filter.
booleangetAcceptOnMatch()
Get the value of the AcceptOnMatch option.
LevelgetLevelMax()
Get the value of the LevelMax option.
LevelgetLevelMin()
Get the value of the LevelMin option.
voidsetAcceptOnMatch(boolean acceptOnMatch)
Set the AcceptOnMatch option.
voidsetLevelMax(Level levelMax)
Set the LevelMax option.
voidsetLevelMin(Level levelMin)
Set the LevelMin option.

Method Detail

decide

public int decide(LoggingEvent event)
Return the decision of this filter.

getAcceptOnMatch

public boolean getAcceptOnMatch()
Get the value of the AcceptOnMatch option.

getLevelMax

public Level getLevelMax()
Get the value of the LevelMax option.

getLevelMin

public Level getLevelMin()
Get the value of the LevelMin option.

setAcceptOnMatch

public void setAcceptOnMatch(boolean acceptOnMatch)
Set the AcceptOnMatch option.

setLevelMax

public void setLevelMax(Level levelMax)
Set the LevelMax option.

setLevelMin

public void setLevelMin(Level levelMin)
Set the LevelMin option.
Copyright 2000-2005 Apache Software Foundation.