Examples of org.apache.log4j.spi.Filter

org.apache.log4j.spi.Filter
Users should extend this class to implement customized logging event filtering. Note that {@link org.apache.log4j.Category} and {@link org.apache.log4j.AppenderSkeleton}, the parent class of all standard appenders, have built-in filtering rules. It is suggested that you first use and understand the built-in rules before rushing to write your own custom filters.
This abstract class assumes and also imposes that filters be organized in a linear chain. The {@link #decide decide(LoggingEvent)} method of each filter is called sequentially,in the order of their addition to the chain.
The {@link #decide decide(LoggingEvent)} method must return oneof the integer constants {@link #DENY}, {@link #NEUTRAL} or {@link #ACCEPT}.
If the value {@link #DENY} is returned, then the log event isdropped immediately without consulting with the remaining filters.
If the value {@link #NEUTRAL} is returned, then the next filterin the chain is consulted. If there are no more filters in the chain, then the log event is logged. Thus, in the presence of no filters, the default behaviour is to log all logging events.
If the value {@link #ACCEPT} is returned, then the logevent is logged without consulting the remaining filters.
The philosophy of log4j filters is largely inspired from the Linux ipchains.
Note that filtering is only supported by the {@link org.apache.log4j.xml.DOMConfigurator DOMConfigurator}. The {@link org.apache.log4j.PropertyConfigurator PropertyConfigurator} does notsupport filters. @author Ceki Gülcü @since 0.9.0


      if (!isAsSevereAsThreshold(event.getLevel())) {
        return;
      }


      Filter f = this.headFilter;


FILTER_LOOP: 
      while (f != null) {
        switch (f.decide(event)) {
        case Filter.DENY:
          return;


        case Filter.ACCEPT:
          break FILTER_LOOP;


        case Filter.NEUTRAL:
          f = f.getNext();
        }
      }


      this.append(event);
    } finally {

View Full Code Here

     Used internally to parse a filter element.
   */
  protected
  void parseFilters(Element element, Appender appender) {
    String clazz = subst(element.getAttribute(CLASS_ATTR));
    Filter filter = (Filter) OptionConverter.instantiateByClassName(clazz,
                                                Filter.class, null);
    
    if(filter != null) {
      PropertySetter propSetter = new PropertySetter(filter);
      NodeList children = element.getChildNodes();
      final int length   = children.getLength();


      for (int loop = 0; loop < length; loop++) {
  Node currentNode = children.item(loop);
  if (currentNode.getNodeType() == Node.ELEMENT_NODE) {
    Element currentElement = (Element) currentNode;
    String tagName = currentElement.getTagName();
    if(tagName.equals(PARAM_TAG)) {
            setParameter(currentElement, propSetter);
    } else {
            quietParseUnrecognizedElement(filter, currentElement, props);
      }
  }
      }
      propSetter.activate();
      LogLog.debug("Adding filter of type ["+filter.getClass()
       +"] to appender named ["+appender.getName()+"].");
      appender.addFilter(filter);
    }    
  }

View Full Code Here

    while (g.hasMoreElements()) {
      String key = (String) g.nextElement();
      String clazz = props.getProperty(key);
      if (clazz != null) {
        LogLog.debug("Filter key: ["+key+"] class: ["+props.getProperty(key) +"] props: "+filters.get(key));
        Filter filter = (Filter) OptionConverter.instantiateByClassName(clazz, Filter.class, null);
        if (filter != null) {
          PropertySetter propSetter = new PropertySetter(filter);
          Vector v = (Vector)filters.get(key);
          Enumeration filterProps = v.elements();
          while (filterProps.hasMoreElements()) {
            NameValue kv = (NameValue)filterProps.nextElement();
            propSetter.setProperty(kv.key, kv.value);
          }
          propSetter.activate();
          LogLog.debug("Adding filter of type ["+filter.getClass()
           +"] to appender named ["+appender.getName()+"].");
          appender.addFilter(filter);
        }
      } else {
        LogLog.warn("Missing class definition for filter: ["+key+"]");

View Full Code Here

    
    if(!isAsSevereAsThreshold(event.level)) {
      return;
    }


    Filter f = this.headFilter;
    
    FILTER_LOOP:
    while(f != null) {
      switch(f.decide(event)) {
      case Filter.DENY: return;
      case Filter.ACCEPT: break FILTER_LOOP;
      case Filter.NEUTRAL: f = f.next;
      }
    }

View Full Code Here


      if (!isAsSevereAsThreshold(event.getLevel())) {
        return;
      }


      Filter f = this.headFilter;


FILTER_LOOP: 
      while (f != null) {
        switch (f.decide(event)) {
        case Filter.DENY:
          return;


        case Filter.ACCEPT:
          break FILTER_LOOP;


        case Filter.NEUTRAL:
          f = f.getNext();
        }
      }


      this.append(event);
    } finally {

View Full Code Here


    if(!isAsSevereAsThreshold(event.level)) {
      return;
    }


    Filter f = this.headFilter;
    
    FILTER_LOOP:
    while(f != null) {
      switch(f.decide(event)) {
      case Filter.DENY: return;
      case Filter.ACCEPT: break FILTER_LOOP;
      case Filter.NEUTRAL: f = f.next;
      }
    }

View Full Code Here

   * 
   * Returns {@link Filter#NEUTRAL}
   */
  public int decide(final LoggingEvent event) {
    boolean accepted = true;
    Filter f = headFilter;
    while (f != null) {
      accepted = accepted && (Filter.ACCEPT == f.decide(event));
      f = f.next;
    }
    if (accepted) {
      if(acceptOnMatch) {
        return Filter.ACCEPT;

View Full Code Here

    
    if(!isAsSevereAsThreshold(event.level)) {
      return;
    }


    Filter f = this.headFilter;
    
    FILTER_LOOP:
    while(f != null) {
      switch(f.decide(event)) {
      case Filter.DENY: return;
      case Filter.ACCEPT: break FILTER_LOOP;
      case Filter.NEUTRAL: f = f.next;
      }
    }

View Full Code Here

     Used internally to parse a filter element.
   */
  protected
  void parseFilters(Element element, Appender appender) {
    String clazz = subst(element.getAttribute(CLASS_ATTR));
    Filter filter = (Filter) OptionConverter.instantiateByClassName(clazz,
                                                Filter.class, null);
    
    if(filter != null) {
      PropertySetter propSetter = new PropertySetter(filter);
      NodeList children = element.getChildNodes();

View Full Code Here


    if(!isAsSevereAsThreshold(event.priority)) {
      return;
    }


    Filter f = this.headFilter;
    
    FILTER_LOOP:
    while(f != null) {
      switch(f.decide(event)) {
      case Filter.DENY: return;
      case Filter.ACCEPT: break FILTER_LOOP;
      case Filter.NEUTRAL: f = f.next;
      }
    }

View Full Code Here

0 1 2 3

TOP

Related Classes of org.apache.log4j.spi.Filter

com.crashnote.log4j.CrashAppender

org.apache.log4j.AppenderSkeleton

org.apache.log4j.extras.DOMConfigurator

org.apache.log4j.filter.AndFilter

org.apache.log4j.filter.AndFilterTest

org.apache.log4j.filter.DenyAllFilterTest

org.apache.log4j.filter.LoggerMatchFilterTest

org.apache.log4j.filter.StringMatchFilterTest

org.apache.log4j.PropertyConfigurator

org.apache.log4j.xml.DOMConfigurator

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.