Class StringMatchFilter

java.lang.Object
org.apache.log4j.spi.Filter
org.apache.log4j.varia.StringMatchFilter

public class StringMatchFilter extends Filter
Simple filter based on string matching.

The filter admits two options StringToMatch and AcceptOnMatch. If there is a match between the value of the StringToMatch option and the message of the LoggingEvent, then the decide(LoggingEvent) method returns Filter.ACCEPT if the AcceptOnMatch option value is true, if it is false then Filter.DENY is returned. If there is no match, Filter.NEUTRAL is returned.

Since:
0.9.0
  • Field Details

    • STRING_TO_MATCH_OPTION

      @Deprecated public static final String STRING_TO_MATCH_OPTION
      Deprecated.
      Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.
      See Also:
    • ACCEPT_ON_MATCH_OPTION

      @Deprecated public static final String ACCEPT_ON_MATCH_OPTION
      Deprecated.
      Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.
      See Also:
    • acceptOnMatch

      boolean acceptOnMatch
    • stringToMatch

      String stringToMatch
  • Constructor Details

    • StringMatchFilter

      public StringMatchFilter()
  • Method Details

    • decide

      public int decide(LoggingEvent event)
      Returns Filter.NEUTRAL is there is no string match.
      Specified by:
      decide in class Filter
      Parameters:
      event - The LoggingEvent to decide upon.
      Returns:
      decision The decision of the filter.
    • getAcceptOnMatch

      public boolean getAcceptOnMatch()
    • getOptionStrings

      @Deprecated public String[] getOptionStrings()
      Deprecated.
      We now use JavaBeans introspection to configure components. Options strings are no longer needed.
    • getStringToMatch

      public String getStringToMatch()
    • setAcceptOnMatch

      public void setAcceptOnMatch(boolean acceptOnMatch)
    • setOption

      @Deprecated public void setOption(String key, String value)
      Deprecated.
      Use the setter method for the option directly instead of the generic setOption method.
    • setStringToMatch

      public void setStringToMatch(String s)