71fbf32c94
The intention is to get rid of the historic and inconsistent naming of some classes and their corresponding files: * EvolutionSyncClient = class derived from Funambol's SyncClient, * SyncEvolutionConfig = SyncEvolution's config With the strict 'namespace SyncEvo' and the syncevo/ path prefix for most header files it is no longer necessary to have "SyncEvolution" or "Evolution" in the names. This patch thus renames as follows: EvolutionSyncClient => SyncContext EvolutionSmartPtr => SmartPtr SyncEvolutionCmdline => Cmdline SyncEvolutionConfig => SyncConfig SyncEvolutionUtil => util The former EvolutionSyncClient always had a role that went beyond just running a sync, for example it also provided config access. With the upcoming server support it also won't be just a client. Thus the new name "SyncContext". The 'syncevo/' prefix is used throughout the code now. removed whenever the prefix made it clear that the file belongs to SyncEvolution. This helps finding incorrect include paths. Quotes should be used exclusively for SyncEvolution files which don't have a specific prefix yet (test.h, config.h) to help identifying them.
206 lines
7.6 KiB
C++
206 lines
7.6 KiB
C++
/*
|
|
* Copyright (C) 2009 Patrick Ohly <patrick.ohly@gmx.de>
|
|
* Copyright (C) 2009 Intel Corporation
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) version 3.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
|
* 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef INCL_LOGGING
|
|
#define INCL_LOGGING
|
|
|
|
#include <stdarg.h>
|
|
|
|
#include <syncevo/declarations.h>
|
|
SE_BEGIN_CXX
|
|
|
|
/**
|
|
* Abstract interface for logging in SyncEvolution. Can be
|
|
* implemented by other classes to add information (like a certain
|
|
* prefix) before passing the message on to a global instance for the
|
|
* actual processing.
|
|
*/
|
|
class Logger
|
|
{
|
|
public:
|
|
/**
|
|
* Which of these levels is the right one for a certain message
|
|
* is a somewhat subjective choice. Here is a definition how they
|
|
* are supposed to be used:
|
|
* - error: severe problem which the user and developer have to
|
|
* know about
|
|
* - warning: a problem that was handled, but users and developers
|
|
* probably will want to know about
|
|
* - info: information about a sync session which the user
|
|
* will want to read during/after each sync session
|
|
* - developer: information about a sync session that is not
|
|
* interesting for a user (for example, because it
|
|
* is constant and already known) but which should
|
|
* be in each log because developers need to know
|
|
* it. Messages logged with this calls will be included
|
|
* at LOG_LEVEL_INFO, therefore messages should be small and
|
|
* not recur so that the log file size remains small.
|
|
* - debug: most detailed logging, messages may be arbitrarily large
|
|
*
|
|
* Here is a decision tree which helps to pick the right level:
|
|
* - an error: => ERROR
|
|
* - a non-fatal error: => WARNING
|
|
* - it changes during each sync or marks important steps
|
|
* in the sync: INFO
|
|
* - small, non-recurring message which is important for developers
|
|
* who read a log produced at LOG_LEVEL_INFO: DEVELOPER
|
|
* - everything else: DEBUG
|
|
*/
|
|
typedef enum {
|
|
/**
|
|
* only error messages printed
|
|
*/
|
|
ERROR,
|
|
/**
|
|
* error and warning messages printed
|
|
*/
|
|
WARNING,
|
|
/**
|
|
* errors and info messages for users and developers will be
|
|
* printed: use this to keep the output consise and small
|
|
*/
|
|
INFO,
|
|
/**
|
|
* important messages to developers
|
|
*/
|
|
DEV,
|
|
/**
|
|
* all messages will be printed, including detailed debug
|
|
* messages
|
|
*/
|
|
DEBUG
|
|
} Level;
|
|
static const char *levelToStr(Level level);
|
|
|
|
virtual ~Logger() {}
|
|
|
|
/**
|
|
* output a single message
|
|
*
|
|
* @param level level for current message
|
|
* @param prefix inserted at beginning of each line, if non-NULL
|
|
* @param file source file where message comes from, if non-NULL
|
|
* @param line source line number, if file is non-NULL
|
|
* @param function surrounding function name, if non-NULL
|
|
* @param format sprintf format
|
|
* @param args parameters for sprintf: consumed by this function,
|
|
* make copy with va_copy() if necessary!
|
|
*/
|
|
virtual void messagev(Level level,
|
|
const char *prefix,
|
|
const char *file,
|
|
int line,
|
|
const char *function,
|
|
const char *format,
|
|
va_list args) = 0;
|
|
|
|
/** default: redirect into messagev() */
|
|
virtual void message(Level level,
|
|
const char *prefix,
|
|
const char *file,
|
|
int line,
|
|
const char *function,
|
|
const char *format,
|
|
...)
|
|
#ifdef __GNUC__
|
|
__attribute__((format(printf, 7, 8)))
|
|
#endif
|
|
;
|
|
};
|
|
|
|
/**
|
|
* Global logging, implemented as a singleton with one instance per
|
|
* process.
|
|
*
|
|
* @TODO avoid global variable
|
|
*/
|
|
class LoggerBase : public Logger
|
|
{
|
|
public:
|
|
LoggerBase() : m_level(INFO) {}
|
|
|
|
/**
|
|
* Grants access to the singleton which implements logging.
|
|
* The implementation of this function and thus the Log
|
|
* class itself is platform specific: if no Log instance
|
|
* has been set yet, then this call has to create one.
|
|
*/
|
|
static LoggerBase &instance();
|
|
|
|
/**
|
|
* Overrides the default Logger implementation. The Logger class
|
|
* itself will never delete the active logger.
|
|
*
|
|
* @param logger will be used for all future logging activities
|
|
*/
|
|
|
|
static void pushLogger(LoggerBase *logger);
|
|
/**
|
|
* Remove the current logger and restore previous one.
|
|
* Must match a pushLogger() call.
|
|
*/
|
|
static void popLogger();
|
|
|
|
virtual void setLevel(Level level) { m_level = level; }
|
|
virtual Level getLevel() { return m_level; }
|
|
|
|
private:
|
|
Level m_level;
|
|
};
|
|
|
|
|
|
/**
|
|
* Vararg macro which passes the message through a specific
|
|
* Logger class instance (if non-NULL) and otherwise calls
|
|
* the global logger directly. Adds source file and line.
|
|
*
|
|
* @TODO make source and line info optional for release
|
|
* @TODO add function name (GCC extension)
|
|
*/
|
|
#define SE_LOG(_level, _instance, _prefix, _format, _args...) \
|
|
do { \
|
|
if (_instance) { \
|
|
static_cast<Logger *>(_instance)->message(_level, \
|
|
_prefix, \
|
|
__FILE__, \
|
|
__LINE__, \
|
|
0, \
|
|
_format, \
|
|
##_args); \
|
|
} else { \
|
|
LoggerBase::instance().message(_level, \
|
|
_prefix, \
|
|
__FILE__, \
|
|
__LINE__, \
|
|
0, \
|
|
_format, \
|
|
##_args); \
|
|
} \
|
|
} while(false)
|
|
|
|
#define SE_LOG_ERROR(_instance, _prefix, _format, _args...) SE_LOG(Logger::ERROR, _instance, _prefix, _format, ##_args)
|
|
#define SE_LOG_WARNING(_instance, _prefix, _format, _args...) SE_LOG(Logger::WARNING, _instance, _prefix, _format, ##_args)
|
|
#define SE_LOG_INFO(_instance, _prefix, _format, _args...) SE_LOG(Logger::INFO, _instance, _prefix, _format, ##_args)
|
|
#define SE_LOG_DEV(_instance, _prefix, _format, _args...) SE_LOG(Logger::DEV, _instance, _prefix, _format, ##_args)
|
|
#define SE_LOG_DEBUG(_instance, _prefix, _format, _args...) SE_LOG(Logger::DEBUG, _instance, _prefix, _format, ##_args)
|
|
|
|
SE_END_CXX
|
|
#endif // INCL_LOGGING
|