NAME
ACE_Log_Msg_Callback - An interface class used for getting logging callbacks.
SYNOPSIS
#include <ace/Log_Msg.h>
class ACE_Log_Msg_Callback
{
public:
virtual ~ACE_Log_Msg_Callback (void);
virtual void log (ACE_Log_Record &log_record) = 0;
};
DESCRIPTION
Users who are interested in getting the logging messages directly, can subclass this interface and override the log() method. They must then register their subclass with the Log_Msg class and make sure that they turn on the ACE_Log_Msg::MSG_CALLBACK flag.
Your log routine is called with an instance of ACE_Log_Record. From this class, you can get the log message, the verbose log message, message type, message priority, and so on.
Remember that there is one Log_Msg object per thread. Therefore, you may need to register your callback object with many ACE_Log_Msg objects (and have the correct synchronization in the log method) or have a separate callback object per Log_Msg object.
PUBLIC MEMBERS
virtual ~ACE_Log_Msg_Callback (void);
No-op virtual destructor.
virtual void log (ACE_Log_Record &log_record) = 0;
Callback routine. This is called when we want to log a message. Since this routine is pure virtual, it must be overwritten by the subclass.
AUTHOR
Doug Schmidt
LIBRARY
ace