/*

* Copyright (c) 2004-2005 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:    LandmarksUi Content File -    This class wraps functionality related to landmark database

*                initialization into a simpler interface.

*

*/

#ifndef CLMKDBINITIALIZER_H

#define CLMKDBINITIALIZER_H

//  INCLUDES

#include "MLmkAOOperationObserver.h"

// FORWARD DECLARATIONS

class CLmkDbUtils;

class CPosLandmarkDatabase;

// CLASS DECLARATION

/**

 * This class wraps landmark database initialization and compacting

 * into a simple helper class.

 * The database initialization and the database compaction operations

 * are performed in executing two methods of CPosLandmarkDatabase class

 * asynchronously

 */

class CLmkDbInitializer : public CBase, public MLmkAOOperationObserver

    {

	public:  // Constructors and destructor

		/**

		* Create CLmkDbInitializer object

        * @param aDb - landmark database which needs to be initialized

        * @param aObserver - caller class/object which sets itself as observer to

        *                  the CLmkDbInitializer class

        * @param aProgressNote - Note showing the progress of database initialise

        *					   operation

		* @return newly instantiated object

		*/

		static CLmkDbInitializer* NewL( CPosLandmarkDatabase& aDb,

                                        MLmkAOOperationObserver& aObserver,

                                        TBool aProgressNote );

		/**

		* Destructor. Cancels possibly ongoing operation.

		*/

		~CLmkDbInitializer();

    public: // New functions

        /**

        * Start the database initialize followed by the compact operation

        * This is done in two asynchronous calls, one for initialize and the other

        * for compacting

        */

        void StartInitAndCompactL();

    protected: //from MLmkAOOperationObserver

        void HandleOperationL( TOperationTypes aType,

                               TReal32 aProgress,

                               TInt aStatus );

    private:  // Constructors and destructor

        /**

        * C++ default constructor.

        * @param aObserver - caller class or object setting itself as observer

        *                    for this class

        * @param aProgressNote -- Note showing the progress of the database

        *                         initialize operation

        * @return newly instantiated object

        */

        CLmkDbInitializer( MLmkAOOperationObserver& aObserver,

                           TBool aProgressNote );

        /**

		* By default Symbian 2nd phase constructor is private.

        * @param aDb

		*/

        void ConstructL( CPosLandmarkDatabase& aDb );

    private:    // Data

        ///Ref:

        MLmkAOOperationObserver& iObserver;

        ///Own:

        CLmkDbUtils* iDbUtils;

        TBool iProgressNote;

    };

#endif      // CLMKDBINITIALIZER_H

// End of File