logger.h

log4cxx 0.10 unix下编译包

        */
        void l7dlog(const LevelPtr& level, const CFStringRef& key,
                    const log4cxx::spi::LocationInfo& locationInfo,
                    const CFStringRef& val1) const;
        /**
        Log a localized and parameterized message.

        First, the user supplied
        <code>key</code> is searched in the resource bundle. Next, the resulting
        pattern is formatted using helpers::StringHelper::format method with the user
        supplied string array <code>params</code>.

        @param level The level of the logging request.
        @param key The key to be searched in the ResourceBundle.
        @param locationInfo The location info of the logging request.
        @param val1 The value for the first placeholder within the pattern.
        @param val2 The value for the second placeholder within the pattern.

        @see #setResourceBundle
        */
        void l7dlog(const LevelPtr& level, const CFStringRef& key,
                    const log4cxx::spi::LocationInfo& locationInfo,
                    const CFStringRef& val1, const CFStringRef& val2) const;
        /**
        Log a localized and parameterized message.

        First, the user supplied
        <code>key</code> is searched in the resource bundle. Next, the resulting
        pattern is formatted using helpers::StringHelper::format method with the user
        supplied string array <code>params</code>.

        @param level The level of the logging request.
        @param key The key to be searched in the ResourceBundle.
        @param locationInfo The location info of the logging request.
        @param val1 The value for the first placeholder within the pattern.
        @param val2 The value for the second placeholder within the pattern.
        @param val3 The value for the third placeholder within the pattern.

        @see #setResourceBundle
        */
        void l7dlog(const LevelPtr& level, const CFStringRef& key,
                    const log4cxx::spi::LocationInfo& locationInfo,
                    const CFStringRef& val1, const CFStringRef& val2, 
                    const CFStringRef& val3) const;
#endif

          /**
        This is the most generic printing method. It is intended to be
        invoked by <b>wrapper</b> classes.

        @param level The level of the logging request.
        @param message The message of the logging request.
        @param location The source file of the logging request, may be null. */
        void log(const LevelPtr& level, const std::string& message,
            const log4cxx::spi::LocationInfo& location) const;
          /**
        This is the most generic printing method. It is intended to be
        invoked by <b>wrapper</b> classes.

        @param level The level of the logging request.
        @param message The message of the logging request.
        */
        void log(const LevelPtr& level, const std::string& message) const;
#if LOG4CXX_WCHAR_T_API
          /**
        This is the most generic printing method. It is intended to be
        invoked by <b>wrapper</b> classes.

        @param level The level of the logging request.
        @param message The message of the logging request.
        @param location The source file of the logging request, may be null. */
        void log(const LevelPtr& level, const std::wstring& message,
            const log4cxx::spi::LocationInfo& location) const;
          /**
        This is the most generic printing method. It is intended to be
        invoked by <b>wrapper</b> classes.

        @param level The level of the logging request.
        @param message The message of the logging request.
        */
        void log(const LevelPtr& level, const std::wstring& message) const;
#endif
#if LOG4CXX_UNICHAR_API
          /**
        This is the most generic printing method. It is intended to be
        invoked by <b>wrapper</b> classes.

        @param level The level of the logging request.
        @param message The message of the logging request.
        @param location The source file of the logging request, may be null. */
        void log(const LevelPtr& level, const std::basic_string<UniChar>& message,
            const log4cxx::spi::LocationInfo& location) const;
          /**
        This is the most generic printing method. It is intended to be
        invoked by <b>wrapper</b> classes.

        @param level The level of the logging request.
        @param message The message of the logging request.
        */
        void log(const LevelPtr& level, const std::basic_string<UniChar>& message) const;
#endif
#if LOG4CXX_CFSTRING_API
          /**
        This is the most generic printing method. It is intended to be
        invoked by <b>wrapper</b> classes.

        @param level The level of the logging request.
        @param message The message of the logging request.
        @param location The source file of the logging request, may be null. */
        void log(const LevelPtr& level, const CFStringRef& message,
            const log4cxx::spi::LocationInfo& location) const;
          /**
        This is the most generic printing method. It is intended to be
        invoked by <b>wrapper</b> classes.

        @param level The level of the logging request.
        @param message The message of the logging request.
        */
        void log(const LevelPtr& level, const CFStringRef& message) const;
#endif
          /**
        This is the most generic printing method. It is intended to be
        invoked by <b>wrapper</b> classes.

        @param level The level of the logging request.
        @param message The message of the logging request.
        @param location The source file of the logging request, may be null. */
        void logLS(const LevelPtr& level, const LogString& message,
            const log4cxx::spi::LocationInfo& location) const;



        /**
        Remove all previously added appenders from this logger
        instance.
        <p>This is useful when re-reading configuration information.
        */
        void removeAllAppenders();

        /**
        Remove the appender passed as parameter form the list of appenders.
        */
        void removeAppender(const AppenderPtr& appender);

        /**
        Remove the appender with the name passed as parameter form the
        list of appenders.
         */
        void removeAppender(const LogString& name);

       /**
        Set the additivity flag for this Logger instance.
         */
        void setAdditivity(bool additive);

    protected:
        friend class Hierarchy;
        /**
        Only the Hierarchy class can set the hierarchy of a logger.*/
        void setHierarchy(spi::LoggerRepository * repository);

        public:
        /**
        Set the level of this Logger.

        <p>As in <pre> &nbsp;&nbsp;&nbsp;logger->setLevel(Level::getDebug()); </pre>

        <p>Null values are admitted.  */
        virtual void setLevel(const LevelPtr& level);

        /**
        Set the resource bundle to be used with localized logging methods.
        */
        inline void setResourceBundle(const helpers::ResourceBundlePtr& bundle)
                { resourceBundle = bundle; }

#if LOG4CXX_WCHAR_T_API
        /**
        Log a message string with the WARN level.

        <p>This method first checks if this logger is <code>WARN</code>
        enabled by comparing the level of this logger with the
        WARN level. If this logger is
        <code>WARN</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        @param location location of source of logging request.
        */
        void warn(const std::wstring& msg, const log4cxx::spi::LocationInfo& location) const;
        /**
        Log a message string with the WARN level.

        <p>This method first checks if this logger is <code>WARN</code>
        enabled by comparing the level of this logger with the
        WARN level. If this logger is
        <code>WARN</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        */
        void warn(const std::wstring& msg) const;
#endif
#if LOG4CXX_UNICHAR_API
        /**
        Log a message string with the WARN level.

        <p>This method first checks if this logger is <code>WARN</code>
        enabled by comparing the level of this logger with the
        WARN level. If this logger is
        <code>WARN</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        @param location location of source of logging request.
        */
        void warn(const std::basic_string<UniChar>& msg, const log4cxx::spi::LocationInfo& location) const;
        /**
        Log a message string with the WARN level.

        <p>This method first checks if this logger is <code>WARN</code>
        enabled by comparing the level of this logger with the
        WARN level. If this logger is
        <code>WARN</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        */
        void warn(const std::basic_string<UniChar>& msg) const;
#endif
#if LOG4CXX_CFSTRING_API
        /**
        Log a message string with the WARN level.

        <p>This method first checks if this logger is <code>WARN</code>
        enabled by comparing the level of this logger with the
        WARN level. If this logger is
        <code>WARN</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        @param location location of source of logging request.
        */
        void warn(const CFStringRef& msg, const log4cxx::spi::LocationInfo& location) const;
        /**
        Log a message string with the WARN level.

        <p>This method first checks if this logger is <code>WARN</code>
        enabled by comparing the level of this logger with the
        WARN level. If this logger is
        <code>WARN</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        */
        void warn(const CFStringRef& msg) const;
#endif
        /**
        Log a message string with the WARN level.

        <p>This method first checks if this logger is <code>WARN</code>
        enabled by comparing the level of this logger with the
        WARN level. If this logger is
        <code>WARN</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        @param location location of source of logging request.
        */
        void warn(const std::string& msg, const log4cxx::spi::LocationInfo& location) const;
        /**
        Log a message string with the WARN level.

        <p>This method first checks if this logger is <code>WARN</code>
        enabled by comparing the level of this logger with the
        WARN level. If this logger is
        <code>WARN</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        */
        void warn(const std::string& msg) const;

#if LOG4CXX_WCHAR_T_API
        /**
        Log a message string with the TRACE level.

        <p>This method first checks if this logger is <code>TRACE</code>
        enabled by comparing the level of this logger with the
        TRACE level. If this logger is
        <code>TRACE</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        @param location location of source of logging request.
        */
        void trace(const std::wstring& msg, const log4cxx::spi::LocationInfo& location) const;
        /**
        Log a message string with the TRACE level.

        <p>This method first checks if this logger is <code>TRACE</code>
        enabled by comparing the level of this logger with the
        TRACE level. If this logger is
        <code>TRACE</code> enabled, it proceeds to call all the
        registered appenders in this logger and also higher in the
        hierarchy depending on the value of the additivity flag.

        @param msg the message string to log.
        */
        void trace(const std::wstring& msg) const;
#endif
#if LOG4CXX_UNICHAR_API
        /**
        Log a message string with the TRACE level.

        <p>This method first checks if this logger is <code>TRACE</code>
        enabled by comparing the