imservices/instantmessagingcache/inc/imcachedebugtrace.h
author hgs
Wed, 03 Nov 2010 22:25:05 +0530
changeset 52 3d676fce9a4e
parent 51 61fad867f68e
permissions -rw-r--r--
201044_02
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
51
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:  logs generation file
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
hgs
parents:
diff changeset
    19
hgs
parents:
diff changeset
    20
#ifndef __IMCACHEDEBUGTRACE_H__
hgs
parents:
diff changeset
    21
#define __IMCACHEDEBUGTRACE_H__
hgs
parents:
diff changeset
    22
hgs
parents:
diff changeset
    23
//  INCLUDES
hgs
parents:
diff changeset
    24
#include  "e32std.h"
hgs
parents:
diff changeset
    25
#include <flogger.h>
hgs
parents:
diff changeset
    26
//  DEFINES
hgs
parents:
diff changeset
    27
// enable logs printing
hgs
parents:
diff changeset
    28
// into  c:\\logs\\instantmessagingcache\\instantmessagingcache.txt
hgs
parents:
diff changeset
    29
//#define IMCHACHE_ENABLE_DEBUG_LOGS
hgs
parents:
diff changeset
    30
#undef IMCHACHE_ENABLE_DEBUG_LOGS
hgs
parents:
diff changeset
    31
hgs
parents:
diff changeset
    32
/**   
hgs
parents:
diff changeset
    33
* Usage of Log MACRO'S
hgs
parents:
diff changeset
    34
* _LIT( KExample, "Example" );
hgs
parents:
diff changeset
    35
*  TXT(s) _L(s)	
hgs
parents:
diff changeset
    36
*  IM_CV_LOGS(TXT("Some text.") );
hgs
parents:
diff changeset
    37
*  IM_CV_LOGS(TXT("Some text: %d"), 100 );
hgs
parents:
diff changeset
    38
*  IM_CV_LOGS(TXT("Some text: %S"), &KExample );
hgs
parents:
diff changeset
    39
*/
hgs
parents:
diff changeset
    40
hgs
parents:
diff changeset
    41
_LIT( KTAdaptDebugOutputDir, "imcache" );
hgs
parents:
diff changeset
    42
_LIT( KTAdaptDebugOutputFileName, "imcache.txt" );
hgs
parents:
diff changeset
    43
const TInt KTAdaptMaxLogLineLength = 250 ;
hgs
parents:
diff changeset
    44
#define T_LIT(s) _L(s)
hgs
parents:
diff changeset
    45
#define TRACE TIMChacheLogger::WriteLog
hgs
parents:
diff changeset
    46
#define PLUGIN_UNUSED_PARAM(p) (void) p
hgs
parents:
diff changeset
    47
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
/**
hgs
parents:
diff changeset
    50
 * IM cache debug logger.
hgs
parents:
diff changeset
    51
 */
hgs
parents:
diff changeset
    52
class TIMChacheLogger
hgs
parents:
diff changeset
    53
    {
hgs
parents:
diff changeset
    54
    public: //Logging functions
hgs
parents:
diff changeset
    55
    	/**
hgs
parents:
diff changeset
    56
        * WriteLog, write the message into c:\\logs\\instantmessagingcache\\instantmessagingcache.txt
hgs
parents:
diff changeset
    57
        * need to create imcv folder into c:\\logs
hgs
parents:
diff changeset
    58
        * @param aFmt, list of messges to print
hgs
parents:
diff changeset
    59
        */
hgs
parents:
diff changeset
    60
		static void WriteLog( TRefByValue<const TDesC> aFmt,... );
hgs
parents:
diff changeset
    61
		
hgs
parents:
diff changeset
    62
    private: //Prohibited
hgs
parents:
diff changeset
    63
    	/**
hgs
parents:
diff changeset
    64
        * construtor
hgs
parents:
diff changeset
    65
        */
hgs
parents:
diff changeset
    66
        TIMChacheLogger();
hgs
parents:
diff changeset
    67
        /**
hgs
parents:
diff changeset
    68
        * destructor
hgs
parents:
diff changeset
    69
        */
hgs
parents:
diff changeset
    70
        ~TIMChacheLogger();
hgs
parents:
diff changeset
    71
    };
hgs
parents:
diff changeset
    72
hgs
parents:
diff changeset
    73
#endif // __IMCACHEDEBUGTRACE_H__
hgs
parents:
diff changeset
    74
hgs
parents:
diff changeset
    75
hgs
parents:
diff changeset
    76
hgs
parents:
diff changeset
    77
/**
hgs
parents:
diff changeset
    78
 * Handler used by logger to truncate the string
hgs
parents:
diff changeset
    79
 * rather than panic in case of buffer overflow.
hgs
parents:
diff changeset
    80
*/
hgs
parents:
diff changeset
    81
hgs
parents:
diff changeset
    82
NONSHARABLE_CLASS ( TAdaptOverflowTruncate ) : public TDes16Overflow
hgs
parents:
diff changeset
    83
	{
hgs
parents:
diff changeset
    84
hgs
parents:
diff changeset
    85
public:
hgs
parents:
diff changeset
    86
	void Overflow ( TDes16& /*aDes*/ ) {}
hgs
parents:
diff changeset
    87
	};
hgs
parents:
diff changeset
    88
hgs
parents:
diff changeset
    89
hgs
parents:
diff changeset
    90
// ============================ MEMBER FUNCTIONS ===============================
hgs
parents:
diff changeset
    91
hgs
parents:
diff changeset
    92
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
    93
// TIMChacheLogger::WriteLog()
hgs
parents:
diff changeset
    94
// -----------------------------------------------------------------------------
hgs
parents:
diff changeset
    95
//
hgs
parents:
diff changeset
    96
inline void TIMChacheLogger::WriteLog ( TRefByValue<const TDesC> aFmt, ... )
hgs
parents:
diff changeset
    97
	{
hgs
parents:
diff changeset
    98
	#ifdef IMCHACHE_ENABLE_DEBUG_LOGS
hgs
parents:
diff changeset
    99
		( void ) aFmt;//Suppress unused formal parameter warning
hgs
parents:
diff changeset
   100
		TBuf< KTAdaptMaxLogLineLength > buffer;
hgs
parents:
diff changeset
   101
		buffer.Append ( _L ( "[" ) );           // CSI: 78 #
hgs
parents:
diff changeset
   102
		buffer.Append ( RThread().Name() );
hgs
parents:
diff changeset
   103
		buffer.Append ( _L ( "] " ) );          // CSI: 78 #
hgs
parents:
diff changeset
   104
		TAdaptOverflowTruncate overflow;
hgs
parents:
diff changeset
   105
		VA_LIST list;
hgs
parents:
diff changeset
   106
		VA_START ( list, aFmt );
hgs
parents:
diff changeset
   107
		buffer.AppendFormatList ( aFmt, list, &overflow );
hgs
parents:
diff changeset
   108
		RFileLogger logger;
hgs
parents:
diff changeset
   109
hgs
parents:
diff changeset
   110
		if ( logger.Connect() == KErrNone )
hgs
parents:
diff changeset
   111
			{
hgs
parents:
diff changeset
   112
			logger.SetDateAndTime ( ETrue, ETrue );
hgs
parents:
diff changeset
   113
			logger.CreateLog ( KTAdaptDebugOutputDir, KTAdaptDebugOutputFileName,
hgs
parents:
diff changeset
   114
			                   EFileLoggingModeAppend );
hgs
parents:
diff changeset
   115
			logger.Write ( buffer );
hgs
parents:
diff changeset
   116
			logger.CloseLog();
hgs
parents:
diff changeset
   117
			logger.Close();
hgs
parents:
diff changeset
   118
			}
hgs
parents:
diff changeset
   119
	#endif
hgs
parents:
diff changeset
   120
hgs
parents:
diff changeset
   121
	}
hgs
parents:
diff changeset
   122
hgs
parents:
diff changeset
   123
hgs
parents:
diff changeset
   124
// End of File
hgs
parents:
diff changeset
   125
hgs
parents:
diff changeset
   126