// Copyright (c) 2001-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 __CNTVIEWPRIVATE_H__
#define __CNTVIEWPRIVATE_H__

#include <cntviewbase.h>
#include "CNTPHBKSYNCWATCHER.H"

/** 
 * This class adds the ability to change sort orders to the functionality
 * provided by CContactLocalView. If the sort order is changed, a notification
 * will be sent to all observers. This class is only intended for use by the 
 * contact server. Clients should use CContactNamedRemoteView.
 */
class CContactNamedLocalView : public CContactLocalView
	{
public:
	IMPORT_C static CContactNamedLocalView* NewL(MContactViewObserver& aObserver,const TDesC& aName,const CContactDatabase& aDb,const RContactViewSortOrder& aSortOrder,TContactViewPreferences aContactTypeToInclude);
	IMPORT_C static CContactNamedLocalView* NewL(MContactViewObserver& aObserver,const TDesC& aName,const CContactDatabase& aDb,const RContactViewSortOrder& aSortOrder,TContactViewPreferences aContactTypeToInclude, const TDesC8& aSortPluginName);
	IMPORT_C static CContactNamedLocalView* NewL(MContactViewObserver& aObserver,const TDesC& aName,const CContactDatabase& aDb,const RContactViewSortOrder& aSortOrder,TContactViewPreferences aContactTypeToInclude, MLplPersistenceLayerFactory* aFactory, const TDesC8& aSortPluginName);
	IMPORT_C const TDesC& Name();
	IMPORT_C void ChangeSortOrderL(RContactViewSortOrder& aSortOrder);
private:
	~CContactNamedLocalView();
	CContactNamedLocalView(const CContactDatabase& aDb,TContactViewPreferences aContactTypes,MLplPersistenceLayerFactory* aFactory);
	CContactNamedLocalView(const CContactDatabase& aDb,TContactViewPreferences aContactTypeToInclude);
	void ConstructL(MContactViewObserver& aObserver,const TDesC& aName,const RContactViewSortOrder& aSortOrder,
										TBool aUseNamedPlugin, const TDesC8& aSortPluginName);
private:
	HBufC* iName;
	};

/** 
 * This class is owned by CContactRemoteViewBase and is used to 
 * receive view events
 */
NONSHARABLE_CLASS (CContactRemoteViewNotifier) : public CActive
	{
public:
	CContactRemoteViewNotifier(RContactRemoteView& aView,TCallBack aCallBack);
	~CContactRemoteViewNotifier();
	void Start();
	const TContactViewEvent& Event() const;
private: // From CActive.
	void RunL();
	void DoCancel();
private:
	RContactRemoteView& iView;
	TPckgBuf<TContactViewEvent> iEvent;
	TCallBack iCallBack;
	};

	
class MContactViewSortObserver;

/** 
 * This class extends CAsyncOneShot to allow an initial notification request 
 * to be made to the phonebook synchroniser plug-in for ICC views.
 * 
 * This allows delaying the construction of the view until the ICC 
 * is synchronised and the phonebook synchroniser is in a cache-valid
 * state.
 */
NONSHARABLE_CLASS (CIdleContactSorter) : public CAsyncOneShot, public MContactPhbkSyncObserver
	{
private:
	enum TSorterState
		{
		EInsertSortFinal,
		EInsertContactsOnlyIccLocked,
		EWaitingForInitialICCReady,
		EContactsReadyWaitICCUnlock,
		ESortAllDone
		};

public:
	static CIdleContactSorter* NewL(MContactViewSortObserver& aObserver, MLplPersistenceLayerFactory& aFactory, TContactViewPreferences aRequestedViewPrefs);
	~CIdleContactSorter();
	TBool IsICCSynchronised() const;
	TContactViewPreferences SortViewPreferences() const;
	TBool InsertViewPreferences(TContactViewPreferences &aInsertView) const;
	void Start();
	void Stop();
	
private: // From CAsyncOneShot
	CIdleContactSorter(MContactViewSortObserver& aObserver, TContactViewPreferences aRequestedViewPrefs);
	void ConstructL(MLplPersistenceLayerFactory& aFactory);
	
	void DoCancel();
	void RunL();
	TInt RunError(TInt aError);

	void ChangeSortState(TSorterState aNewSortState);
	
	// From MContactPhbkSyncObserver
	void ContactPhbkSyncEventHandler(TPhonebookState aPhbkState);

private:
	MContactViewSortObserver&	iSortObserver;
	
	// requested view
	TContactViewPreferences iRequestedView;
	// non-NULL if ICC contacts are included in view, & therefore a sync is expected
	CContactPhbkSyncWatcher* iPhbkSyncWatcher;
	
	// subset of view we are actually insert sorting now
	TContactViewPreferences iSortView;
	TSorterState iSortState;
	};

	
/**
 * Template classes to call ResetAndDestroy on array classes
 * automatically, when ::PopAndDestroy'ing from the cleanup stack.
 */
template <class T>
class CleanupResetAndDestroy
	{
public:
	inline static void PushL(T& aRef);
private:
	static void ResetAndDestroy(TAny *aPtr);
	};
template <class T>
inline void CleanupResetAndDestroyL(T& aRef);

// Template class CleanupClose
template <class T>
inline void CleanupResetAndDestroy<T>::PushL(T& aRef)
	{CleanupStack::PushL(TCleanupItem(&ResetAndDestroy, &aRef));}
template <class T>
void CleanupResetAndDestroy<T>::ResetAndDestroy(TAny *aPtr)
	{static_cast<T*>(aPtr)->ResetAndDestroy();}
template <class T>
inline void CleanupResetAndDestroyPushL(T& aRef)
	{CleanupResetAndDestroy<T>::PushL(aRef);}

#endif //__CNTVIEWPRIVATE_H__
