/*

* Copyright (c) 2008 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:  Installs HSPS configurations.

*

*

*/

#ifndef C_CHSPSINSTALLER_H

#define C_CHSPSINSTALLER_H

#include <e32base.h>

#include <f32file.h>

#include "hspsthememanagement.h"

class ChspsThemeServer;

class ChspsInstallationHandler;

/**

 * @ingroup group_hspsserver

 * HSPS Installer

 * @lib hspsThemeServer.exe

 * @since S60 5.0

 */

class CHSPSInstaller : public CActive

    {

    public: // Constructors and destructors

        /**

        * NewL.

        * Two-phased constructor.

        * Creates a CHSPSInstaller object using two phase construction,

        * and return a pointer to the created object.

        * @since S60 5.0

        * @param aServer is a reference to HSPS Theme Server

        * @return A pointer to the created instance of CHSPSInstaller.

        */

        static CHSPSInstaller* NewL( 

            ChspsThemeServer& aServer );

        /**

        * ~CHSPSInstaller.

        * Destructor.

        * Destroys the object and release all memory objects.

        * @since S60 5.0

        */

        virtual ~CHSPSInstaller();

    public: // New functions

        /**

         * InstallConfigurationL

         * Synchronous service for installing configurations from provided manifest files.         

         * @since S60 5.0

         * @param aFileName is name of the manifest file (full path) to be installed.

         * @return ThspsServiceCompletedMessage error code 

         */

        ThspsServiceCompletedMessage InstallConfigurationL( 

            const TDesC& aFileName ); 

    public: // Functions from base classes

        /**

         * RunL.

         * From CActive, callback function.

         * Invoked to handle responses from the server.

         * @since S60 5.0

         */

        void RunL();

        /**

         * DoCancel.         

         * From CActive, cancels any outstanding operation.

         * @since S60 5.0

         */

        void DoCancel();

        /**

         * RunError.

         * From CActive Called when asynchronous request has failed

         * @since S60 5.0

         */

        TInt RunError( 

            TInt aError );

    private: 

        /**

        * CHSPSInstaller.

        * Performs the first phase of two phase construction.

        * @since S60 5.0

        * @param aServer is a reference to the HSPS Theme Server

        */

        CHSPSInstaller(

            ChspsThemeServer& aServer );

        /**

        * ConstructL.

        * Performs the second phase construction of a CHSPSInstaller object.

        * @since S60 5.0

        */

        void ConstructL();           

    private: // Data    

        // Reference to HSPS Theme Server

        ChspsThemeServer& iServer;

        // Installation handler

        ChspsInstallationHandler* iInstallationHandler;

        // Installation status

        ThspsServiceCompletedMessage iRet;

        // Required by the installation process

        TBuf8<KMaxHeaderDataLength8> iHeaderData;

        // Active scheduler nested wait loop

        CActiveSchedulerWait* iLoop;

    };

#endif // C_CHSPSINSTALLER_H

// End of File