If the level of the {@link LoggerLoggingEvent} is not between Min and Max * (inclusive), then {@link LOG4PHP_LOGGER_FILTER_DENY} is returned.
* *If the Logging event level is within the specified range, then if * AcceptOnMatch is true, * {@link LOG4PHP_LOGGER_FILTER_ACCEPT} is returned, and if * AcceptOnMatch is false, * {@link LOG4PHP_LOGGER_FILTER_NEUTRAL} is returned.
* *If LevelMin is not defined, then there is no * minimum acceptable level (i.e. 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 being too "high"/important).
* *Refer to the {@link LoggerAppenderSkeleton::setThreshold()} method * available to all appenders extending {@link LoggerAppenderSkeleton} * for a more convenient way to filter out events by level.
* * @log4j-class org.apache.log4j.varia.LevelRangeFilter * @log4j-author Simon Kitching * @log4j-author based on code by Ceki Gülcü * * @author Marco Vassura * @version $Revision: 635069 $ * @package log4php * @subpackage varia * @since 0.6 */ class LoggerLevelRangeFilter extends LoggerFilter { /** * @var boolean */ var $acceptOnMatch = true; /** * @var LoggerLevel */ var $levelMin; /** * @var LoggerLevel */ var $levelMax; /** * @return boolean */ function getAcceptOnMatch() { return $this->acceptOnMatch; } /** * @param boolean $acceptOnMatch */ function setAcceptOnMatch($acceptOnMatch) { $this->acceptOnMatch = LoggerOptionConverter::toBoolean($acceptOnMatch, true); } /** * @return LoggerLevel */ function getLevelMin() { return $this->levelMin; } /** * @param string $l the level min to match */ function setLevelMin($l) { $this->levelMin = LoggerOptionConverter::toLevel($l, null); } /** * @return LoggerLevel */ function getLevelMax() { return $this->levelMax; } /** * @param string $l the level max to match */ function setLevelMax($l) { $this->levelMax = LoggerOptionConverter::toLevel($l, null); } /** * Return the decision of this filter. * * @param LoggerLoggingEvent $event * @return integer */ function decide($event) { $level = $event->getLevel(); if($this->levelMin !== null) { if ($level->isGreaterOrEqual($this->levelMin) == false) { // level of event is less than minimum return LOG4PHP_LOGGER_FILTER_DENY; } } if($this->levelMax !== null) { if ($level->toInt() > $this->levelMax->toInt()) { // level of event is greater than maximum // Alas, there is no Level.isGreater method. and using // a combo of isGreaterOrEqual && !Equal seems worse than // checking the int values of the level objects.. return LOG4PHP_LOGGER_FILTER_DENY; } } if ($this->getAcceptOnMatch()) { // this filter set up to bypass later filters and always return // accept if level in range return LOG4PHP_LOGGER_FILTER_ACCEPT; } else { // event is ok for this filter; allow later filters to have a look.. return LOG4PHP_LOGGER_FILTER_NEUTRAL; } } }