1 martin 1.4 //%LICENSE////////////////////////////////////////////////////////////////
 2            // 
 3            // Licensed to The Open Group (TOG) under one or more contributor license
 4            // agreements.  Refer to the OpenPegasusNOTICE.txt file distributed with
 5            // this work for additional information regarding copyright ownership.
 6            // Each contributor licenses this file to you under the OpenPegasus Open
 7            // Source License; you may not use this file except in compliance with the
 8            // License.
 9            // 
10            // Permission is hereby granted, free of charge, to any person obtaining a
11            // copy of this software and associated documentation files (the "Software"),
12            // to deal in the Software without restriction, including without limitation
13            // the rights to use, copy, modify, merge, publish, distribute, sublicense,
14            // and/or sell copies of the Software, and to permit persons to whom the
15            // Software is furnished to do so, subject to the following conditions:
16            // 
17            // The above copyright notice and this permission notice shall be included
18            // in all copies or substantial portions of the Software.
19            // 
20            // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
21            // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
22 martin 1.4 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
23            // IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
24            // CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
25            // TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
26            // SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

27 r.kieninger 1.1 // 

28 martin      1.4 //////////////////////////////////////////////////////////////////////////

29 r.kieninger 1.1 //
30                 //%/////////////////////////////////////////////////////////////////////////////
31                 
32                 
33                 #ifndef Pegasus_TraceHandler_h
34                 #define Pegasus_TraceHandler_h
35                 
36                 #include <cstdarg>
37                 #include <cstdio>
38                 #include <Pegasus/Common/String.h>
39                 #include <Pegasus/Common/Linkage.h>
40                 
41                 PEGASUS_NAMESPACE_BEGIN
42                 
43                 /** TraceHandler is an abstract base class for all kinds of trace handlers.
44                  */
45                 
46                 class PEGASUS_COMMON_LINKAGE TraceHandler
47                 {
48                 public:
49                 
50 r.kieninger 1.1     /** Writes message with format string to the tracing facility
51                         @param    message  message to be written

52 thilo.boehm 1.2         @param    msgLen   lenght of message without terminating '\0'

53 r.kieninger 1.1         @param    fmt      printf style format string
54                         @param    argList  variable argument list
55                      */
56                     virtual void handleMessage(const char* message,

57 thilo.boehm 1.2                                Uint32 msgLen,

58 r.kieninger 1.1                                const char* fmt,
59                                                va_list argList) = 0;
60                 
61                     /** Writes simple message to the tracing facility.
62                         @param    message  message to be written

63 thilo.boehm 1.2         @param    msgLen   lenght of message without terminating '\0'

64 r.kieninger 1.1      */

65 thilo.boehm 1.2     virtual void handleMessage(const char* message,
66                                                Uint32 msgLen) = 0;

67 r.kieninger 1.1 
68                 

69 thilo.boehm 1.3     /** Informs the message handler that the configuraion 
70                         of the trace has been updated.

71 r.kieninger 1.1      */

72 thilo.boehm 1.3     virtual void configurationUpdated() {return;};

73 r.kieninger 1.1 

74 thilo.boehm 1.2     /** Flushes the trace
75                      */
76                     virtual void flushTrace() {return;};
77                     

78 r.kieninger 1.1     TraceHandler() {};
79                 
80                     virtual ~TraceHandler() {};
81                 
82                     
83                 };
84                 
85                 PEGASUS_NAMESPACE_END
86                 
87                 #endif /* Pegasus_TraceHandler_h */