// Copyright (c) 2002-2009 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:
//

#ifndef __LOGSERVDATABASETRANSACTIONINTERFACE_H__
#define __LOGSERVDATABASETRANSACTIONINTERFACE_H__

#include <d32dbms.h>
#include "LogServShared.h"
#include "logservsecurity.h"

// Classes referenced
class CLogServCacheTypes;
class CLogServCacheConfig;
class CLogServCacheStrings;
class CLogServResourceInterpreter;
class MLogServDatabaseChangeInterface;

/**
Interface class offering methods for:
 - beginning, committing and rolling back a transaction;
 - accessors to config, types and strings caches;
 - accessors to the resource interpreter and and the change interface;
 
@see CLogServResourceInterpreter  
@see MLogServDatabaseChangeInterface
@see CLogServCacheStrings
@see CLogServCacheTypes
@see CLogServCacheConfig
@internalComponent
*/
class MLogServDatabaseTransactionInterface
	{
public:
	virtual TInt DTIBegin() = 0;//Start a new transaction
	virtual TInt DTICommitAndEnd() = 0;//End an existing transaction
	virtual void DTIRollBack() = 0;//Roll back the current transaction
	virtual TInt DTIExecuteSql(const TDesC& aStatement, TDbTextComparison aComparison = EDbCompareNormal) = 0;//Run some arbitrary SQL
	virtual TBool DTIInTransaction() const = 0;//Is the database in an existing transaction
	virtual TBool DTIDatabaseIsDamaged() const = 0;//Is the database in an existing transaction

	virtual CLogServResourceInterpreter& DTIResourceInterface() const = 0;//Access the resource interface
	virtual MLogServDatabaseChangeInterface& DTIChangeInterface() const = 0;//Acess the change submission interface
	virtual CLogServCacheStrings& DTICacheStrings() const = 0;//Access the string table cache
	virtual CLogServCacheTypes& DTICacheTypes() const = 0;//Access the type table cache
	virtual CLogServCacheConfig& DTICacheConfig() const = 0;//Access the config table cache
	virtual RDbDatabase& DTIDatabase() = 0;//Access the database
	
	virtual TBool DTIIsAllowed(TEventOp aEventOp, const RMessage2& aMessage, TUid aEventType, const char* aDiagnostic = 0) const = 0;//Check client capability
	virtual const RArray<TUid>& DTIUidsOfStandardTypes() = 0;//Returns a collection of built-in TUids of built-types - those defined in Logwrap.rss

	void DTIBeginWithRollBackProtectionLC();//Start a transaction with roll-back protection (cleanup)
	void DTICommitAndCancelRollbackProtectionL();//End a transaction previously started with roll-back protection

private:
	static void RollBackDatabase(TAny* aObject);

	};

#endif