/*
* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
* Logging macros for APControl List Plugin
*
*/
#ifndef APCONROL_LIST_PLUGIN_LOGGER_H
#define APCONROL_LIST_PLUGIN_LOGGER_H
// INCLUDES
#ifdef _DEBUG
#include <e32std.h>
#include <e32def.h>
#include <flogger.h>
// TYPES
enum TAPControlListPluginLogMask ///< Log mask bits.
{
ELogOff = 0x00000000, ///< Don't log.
EApUi = 0x00000001, ///< Log transaction activity.
ESelector = 0x00000002, ///< Log Selection activity.
EEditing = 0x00000004, ///< Log editing activity.
EModel = 0x00000008, ///< Log model activity.
EProtection = 0x00000020, ///< Log protection activity.
EApItem = 0x00000040, ///< Log ApItem activity.
ECommons = 0x00000080, ///< Log transaction activity.
EActiveDb = 0x000000F0, ///< Log active db¬ific. activity.
ELogAll = 0xFFFFFFFF ///< Log all.
};
// MACROS
/// Determines what to log. Construct this from TApEngineLogMask values.
#define APCONTROL_LIST_LOG_MASK ELogAll
/// Determines log detail (0==basic level).
#define APCONTROL_LIST_LOG_LEVEL 4
// CLASS DECLARATION
/**
* Logger class.
*/
NONSHARABLE_CLASS( APControlListPluginLogger )
{
public: // new methods
/**
* Write formatted log.
* @param aMask Log mask.
* @param aLevel Log level.
* @param aFmt Format string.
*/
static void Write
( TInt32 aMask, TInt aLevel,
TRefByValue<const TDesC16> aFmt, ... );
/**
* Write formatted log.
* @param aMask Log mask.
* @param aLevel Log level.
* @param aFmt Format string.
* @param aList Variable argument list.
*/
static void Write
(
TInt32 aMask,
TInt aLevel,
TRefByValue<const TDesC16> aFmt,
VA_LIST& aList
);
/**
* Write formatted log.
* @param aMask Log mask.
* @param aLevel Log level.
* @param aFmt Format string.
*/
static void Write
( TInt32 aMask, TInt aLevel,
TRefByValue<const TDesC8> aFmt, ... );
/**
* Write formatted log.
* @param aMask Log mask.
* @param aLevel Log level.
* @param aFmt Format string.
* @param aList Variable argument list.
*/
static void Write
(
TInt32 aMask,
TInt aLevel,
TRefByValue<const TDesC8> aFmt,
VA_LIST& aList
);
/**
* Write hex dump.
* @param aMask Log mask.
* @param aLevel Log level.
* @param aHeader Header string.
* @param aMargin Margin.
* @param aPtr Data.
* @param aLen Data length.
*/
static void HexDump
(
TInt32 aMask,
TInt aLevel,
const TText* aHeader,
const TText* aMargin,
const TUint8* aPtr,
TInt aLen
);
/**
* Create log dir.
*/
static void FCreate();
};
#define CLOG_CREATE() {APControlListPluginLogger::FCreate();}
/// Write formatted to log.
#define CLOG( body ) APControlListPluginLogger::Write body
/// Write hex dump.
#define CDUMP( body ) APControlListPluginLogger::HexDump body
#else /* not defined _DEBUG */
/// Do nothing (log disabled).
#define CLOG( body )
/// Do nothing (log disabled).
#define CDUMP( body )
#define CLOG_CREATE()
#endif /* def _DEBUG */
#endif /* def APCONROL_LIST_PLUGIN_LOGGER_H */