-
/*! \file
-
\brief Class creaMessageManager and Macros for outputing messages in crea
-
There are 4 kinds of messages :
- Messages (normal messages)
- Debug messages (not compiled in release)
-The first string is the type of the message (the category which will be used to generate a message of this type)
-The second string is help string
-The integer is the initial level for the messages of this type (see below).
-
To generate a message of a known type then use one of the macros :
creaMessage, creaDebugMessage, creaWarning, creaError or their variants.
-
example :
-
creaMessage("Kernel",4,"problem with "<<GetName()<<creaendl);
-
will push the 3rd argument in std::cout if the message level of "Kernel" messages is greater or equal to 4.
which means that it generates a message of level 4 (0 : very important/always displayed ... 9 : deep debug message).
-
At run time, one is able to change the level of the messages displayed by using a command like :
-
crea::MessageManager::SetMessageLevel("Kernel",5);
-
which tells the manager to display all Kernel messages of level up to 5.
-
Variants :
-
crea*Cont : continues a previous creaMessage on the same line (without rewriting the type and level)
crea*Inc / Dec : displays the message and then increments/decrement the messages tabulation
-
*/
+
//===========================================================
/**
\class crea::MessageManager
\brief Manages the messages displayed by crea
*/
-
#ifndef __creaMessageManager_h__
#define __creaMessageManager_h__
// The do { } while(0) statement in macros is made to "swallow the semicolon"
// see http://gcc.gnu.org/onlinedocs/cpp/Swallowing-the-Semicolon.html#Swallowing-the-Semicolon
-
#include "creaSystem.h"
#include "creaRTTI.h" // for CREA_GET_CURRENT_OBJECT_NAME
// Signal/slot mechanism for message events
#include <boost/signal.hpp>
#include <boost/bind.hpp>
-
#include <string>
#include <map>
#include <iostream>
#include <sstream>
-
// Comment out these symbols to prevent compilation
//#define CREA_COMPILE_MESSAGES
//#define CREA_COMPILE_DEBUG_MESSAGES
//#define CREA_COMPILE_WARNING_MESSAGES
//#define CREA_COMPILE_ERROR_MESSAGES
-
-
#define creaOnMessageLevel(key,value) \
int __creaOnMessageLevelVariable = \
crea::MessageManager::GetMessageLevel(key); \
#else
#define creaMessageSpace(value) ""
#endif
+
+
+
//===========================================================
+
#ifdef CREA_COMPILE_MESSAGES
// Macro for messages
} \
while (0)
+
+
// Macro for continuing a message (when one wants to split the macro
// call into multiple lines)
#define creaMessageCont(key,value,MESSAGE) \
} \
while (0)
+
#define creaMessageInc(key,value,MESSAGE) \
do \
{ \
} \
while (0)
+
#define creaMessageDec(key,value,MESSAGE) \
do \
{ \
} \
while (0)
+
#define creaDecTab(key,value) \
do \
{ \
} \
while (0)
+
#define creaIncTab(key,value) \
do \
{ \
} \
while (0)
+
#define creaResetTab() \
do \
{ \
#define creaIncTab(key,value)
#define creaResetTab()
#endif
+
//===========================================================
+
+
+
+
//===========================================================
+
// Macros for debug messages
+
#ifdef CREA_COMPILE_DEBUG_MESSAGES
+
#define creaDebugMessage(key,value,MESSAGE) creaMessage(key,value,MESSAGE)
+
#define creaDebugMessageCont(key,value,MESSAGE) creaMessageCont(key,value,MESSAGE)
+
#define creaDebugMessageInc(key,value,MESSAGE) creaMessageInc(key,value,MESSAGE)
+
#define creaDebugMessageDec(key,value,MESSAGE) creaMessageDec(key,value,MESSAGE)
+
#define creaDebugDecTab(key,value) creaDecTab(key,value)
+
#define creaDebugIncTab(key,value) creaIncTab(key,value)
+
#define creaDebugResetTab() creaResetTab()
+
#else
+
#define creaDebugMessage(key,value,MESSAGE)
+
#define creaDebugMessageCont(key,value,MESSAGE)
+
#define creaDebugMessageInc(key,value,MESSAGE)
+
#define creaDebugMessageDec(key,value,MESSAGE)
+
#define creaDebugDecTab(key,value)
+
#define creaDebugIncTab(key,value)
+
#endif
+
//===========================================================
+
+
//===========================================================
+
#ifdef CREA_COMPILE_WARNING_MESSAGES
#define creaWarning(MESSAGE) \
do \
#else
#define creaWarning(MESSAGE)
#endif
+
//===========================================================
+
+
+
//===========================================================
+
#ifdef CREA_COMPILE_ERROR_MESSAGES
//#include "creaWx.h"
#define creaError(MESSAGE) \
} \
while (0)
+
+
#define creaGlobalError(MESSAGE) \
do \
{ \
} \
while (0)
+
+
#define CREA_INTERNAL_ERROR_MESSAGE \
"\n\n***********************************************\n**** THIS IS AN INTERNAL ERROR TO crea ****\n**** Please send a full bug report to : ****\n**** creatools@creatis.insa-lyon.fr ****\n***********************************************\n\n"
} \
while (0)
+
+
#else
#define creaError(MESSAGE)
#define creaGlobalError(MESSAGE)
#define creaInternalError(MESSAGE)
#endif
+
//===========================================================
+
+
//===========================================================
+
#define creaendl std::endl
+
//===========================================================
+
+
+
namespace crea
+
{
+
+
class CREA_EXPORT MessageManager
+
{
+
public:
+
//=============================================
+
typedef boost::signal<void (const std::string&)> MessageSignalType;
+
typedef MessageSignalType::slot_function_type MessageCallbackType;
+
//=============================================
+
///
+
MessageManager();
+
///
+
~MessageManager();
+
///
+
static MessageManager* GetInstance();
+
///
+
static void RegisterMessageType(const std::string& key,
+
const std::string& help,
+
unsigned char default_level = 9);
+
///
+
static void SetMessageLevel(const std::string& key, unsigned char level);
+
///
+
static int GetMessageLevel(const std::string& key);
+
///
+
static void SendMessage(const std::string& key, const std::string& mess);
+
///
+
static void AddMessageObserver(const std::string& key, MessageCallbackType callback );
+
///
+
static void SendMessagesToCout(bool v = true);
+
///
+
static std::string& GetTab() { static std::string s; return s; }
+
///
+
static std::string GetSpace(int n) {
+
std::string s; s.insert(0," ",n); return s; }
+
///
+
static void IncTab() { GetTab() += std::string(" "); }
+
///
+
static void DecTab() { GetTab() = GetTab().substr(0,GetTab().length()-1); }
+
///
+
static void ResetTab() { GetTab() = std::string(""); }
+
///
+
static void PrintInfo();
+
///
+
+
private:
+
struct MessageType
+
{
+
MessageType(int l, const std::string& h) : Level(l), Help(h) {}
+
int Level;
+
std::string Help;
+
MessageSignalType Signal;
+
};
+
typedef std::map<std::string,MessageType*> MessageMapType;
+
MessageMapType mMessageMap;
+
unsigned int mMaxMessageLength;
+
bool mSendToCout;
+
};
+
//===========================================================
+
+
}
+
+
#include "creaException.h"
+
+
#endif
+