source: pacpusframework/branches/2.0-beta1/3rd/apache-log4cxx/include/log4cxx/filter/expressionfilter.h@ 89

/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef _LOG4CXX_FILTER_EXPRESSIONFILTER_H
#define _LOG4CXX_FILTER_EXPRESSIONFILTER_H

#if defined(_MSC_VER)
#pragma warning ( push )
#pragma warning ( disable: 4231 4251 4275 4786 )
#endif


#include <log4cxx/spi/filter.h>

namespace log4cxx
{
    namespace rule
    {
        class Rule;
        typedef helpers::ObjectPtrT < Rule > RulePtr;
    }


    namespace filter
    {


/**
 *A filter supporting complex expressions - supports both infix and postfix
 * expressions (infix expressions must first be converted to postfix prior
 * to processing).
 *
 * <p>See <code>org.apache.log4j.chainsaw.LoggingEventFieldResolver.java</code>
 * for the correct names for logging event fields used when building expressions.
 *
 * <p>See <code>org.apache.log4j.chainsaw.rule</code> package for a list of available
 * rules which can be applied using the expression syntax.
 *
 * <p>See <code>org.apache.log4j.chainsaw.RuleFactory</code> for the symbols
 * used to activate the corresponding rules.
 *
 *NOTE:  Grouping using parentheses is supported - all tokens must be separated by spaces, and
 *operands which contain spaces are not yet supported.
 *
 *Example:
 *
 *In order to build a filter that displays all messages with infomsg-45 or infomsg-44 in the message,
 *as well as all messages with a level of WARN or higher, build an expression using
 *the LikeRule (supports ORO-based regular expressions) and the InequalityRule.
 * <b> ( MSG LIKE infomsg-4[4,5] ) && ( LEVEL >= WARN ) </b>
 *
 *Three options are required:
 *  <b>Expression</b> - the expression to match
 *  <b>ConvertInFixToPostFix</b> - convert from infix to posfix (default true)
 *  <b>AcceptOnMatch</b> - true or false (default true)
 *
 * Meaning of <b>AcceptToMatch</b>:
 * If there is a match between the value of the
 * Expression option and the {@link log4cxx::spi::LoggingEvent} and AcceptOnMatch is true,
 * the {@link #decide} method returns {@link log4cxx::spi::Filter#ACCEPT}.
 *
 * If there is a match between the value of the
 * Expression option and the {@link log4cxx::spi::LoggingEvent} and AcceptOnMatch is false,
 * {@link log4cxx::spi::Filter#DENY} is returned.
 *
 * If there is no match, {@link log4cxx::spi::Filter#NEUTRAL} is returned.
 *
 * 
 */
        class LOG4CXX_EXPORT ExpressionFilter:public log4cxx::spi::Filter
        {
          private:
            bool acceptOnMatch;
            bool convertInFixToPostFix;
            LogString expression;
                      log4cxx::rule::RulePtr expressionRule;
                      ExpressionFilter(const ExpressionFilter &);
                  ExpressionFilter & operator=(const ExpressionFilter &);

          public:
                  DECLARE_LOG4CXX_OBJECT(ExpressionFilter)
                  BEGIN_LOG4CXX_CAST_MAP()
                  LOG4CXX_CAST_ENTRY(log4cxx::spi::Filter)
                  END_LOG4CXX_CAST_MAP()


                  ExpressionFilter();

            void activateOptions(log4cxx::helpers::Pool & p);

            void setExpression(const LogString & expression);

            LogString getExpression() const;

            void setConvertInFixToPostFix(bool convertInFixToPostFix);

            bool getConvertInFixToPostFix() const;

            void setAcceptOnMatch(bool acceptOnMatch);

            bool getAcceptOnMatch() const;

  /**
     Returns {@link log4cxx::spi::Filter#NEUTRAL} is there is no string match.
   */
            FilterDecision decide(const spi::LoggingEventPtr & event) const;
        };
    }
}

#if defined(_MSC_VER)
#pragma warning ( pop )
#endif


#endif