blob: 2a372ed76b816557470efbcd53b50a2c5af582b4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
// -*- C++ -*-
//=============================================================================
/**
* @file Log_Msg_Callback.h
*
* $Id$
*
* @author Douglas C. Schmidt <schmidt@cs.wustl.edu>
*/
//=============================================================================
#ifndef ACE_LOG_MSG_CALLBACK_H
#define ACE_LOG_MSG_CALLBACK_H
#include /**/ "ace/pre.h"
#include /**/ "ace/ACE_export.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
ACE_BEGIN_VERSIONED_NAMESPACE_DECL
class ACE_Log_Record;
/**
* @class ACE_Log_Msg_Callback
*
* @brief An interface class used to get logging callbacks.
*
* 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. Moreover,
* ACE_Log_Msg_Callbacks are not inherited when a new thread
* is spawned because it might have been allocated off of the
* stack of the original thread, in which case all hell would
* break loose... Therefore, you'll need to reset these in each
* new thread.
*/
class ACE_Export ACE_Log_Msg_Callback
{
public:
/// No-op virtual destructor.
virtual ~ACE_Log_Msg_Callback (void);
/// 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.
virtual void log (ACE_Log_Record &log_record) = 0;
};
ACE_END_VERSIONED_NAMESPACE_DECL
#include /**/ "ace/post.h"
#endif /* ACE_LOG_MSG_CALLBACK_H */
|
