/*

* 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:  AutoInstaller installs theme from given location. It is intended

*                to be used by hspsThemeServer directly. AutoInstaller is initiated

*                when FileChangeListener finds installable theme source on given

*                location. Theme source is set during the SISX-package

*                exctraction. AutoInstaller is deployed by calling its function 

*                InstallThemeL with manifest-file of the installable theme source set.

*                AutoInstaller deploys hspsInstallationHandler. hspsInstallationHandler

*                is asynchronous object, there for AutoInstaller is asynchronous object

*                as well capable to deploy asynchronous installation.

*                When installation ends, AutoInstaller calls its observer with 

*                ThspsServiceCompletedMessage-type parameter. Observer is given on

*                initialising of AutoInstaller and it is allways ChspsThemeServer-type.

*                AutoInstaller have functions to get ODT-header of successfully installed

*                theme and ChspsResult-typed object expressing errors in unsuccessful cases.   

*

*/

#ifndef __hspsAUTOINSTALLER_H__

#define __hspsAUTOINSTALLER_H__

#include <e32base.h>

#include "hspsthememanagement.h"

#ifdef HSPS_LOG_ACTIVE

class ChspsLogBus;

#endif

class ChspsODT;

class ChspsResult;

class ChspsThemeServer;

class ChspsMaintenanceHandler;

class ChspsInstallationHandler;

/**

*  @ingroup group_hspsserver

*  @lib hspsThemeServer.exe

*  @since S60 5.0

*/

class ChspsAutoInstaller : public CActive

    {

    public: // Constructors and destructors

        /**

        * NewL.

        * Two-phased constructor.

        * Creates a ChspsAutoInstaller object using two phase construction,

        * and return a pointer to the created object.

        * @param aObserver The object to be used to handle updates from the server.

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

        */

        static ChspsAutoInstaller* NewL( ChspsThemeServer& aThemeServer );

        /**

        * NewLC.

        * Two-phased constructor.

        * Creates a ChspsClinet object using two phase construction,

        * and return a pointer to the created object.

        * @param aObserver The object to be used to handle updates from the server.

        * @return a pointer to the created instance of ChspsAutoInstaller.

        */

        static ChspsAutoInstaller* NewLC( ChspsThemeServer& aThemeServer );

        /**

        * ~ChspsAutoInstaller.

        * Destructor.

        * Destroys the object and release all memory objects.

        */

        virtual ~ChspsAutoInstaller();

    public: // New functions

        /**

        * UnInstallThemeL

        * @since S60 3.2

        * @param aPathFile a path_*.dat file which describes the theme to be uninstalled

        */

        void UnInstallThemeL( const TDesC& aPathFile );

        /**

        * InstallTheme

        * @since S60 3.1

        * @param aManifestFileName is a name of the manifest file of theme source to be installed.

        */

        TInt InstallThemeL( const TDesC& aManifestFileName ); 

        /**

        * GethspsResultL

        * @since S60 3.1

        * @param aResult is a ChspsResult object containing additional information of the result of query.

        */

        ChspsResult& hspsResult();

#ifdef HSPS_LOG_ACTIVE        

        /** 

        * Set log bus.

        */

        void SetLogBus( ChspsLogBus* aLogBus );

#endif        

    protected: // Functions from base classes

        /**

        * From CActive, RunL.

        * Callback function.

        * Invoked to handle responses from the server.

        */

        void RunL();

        /**

        * From CActive, DoCancel.

        * Cancels any outstanding operation.

        */

        void DoCancel();

        /**

        * From CActive Called when asynchronous request has failed

        * @since S60 3.1

        */

        TInt RunError( TInt aError );

     private: // Constructors and destructors

        /**

        * ChspsAutoInstaller.

        * Performs the first phase of two phase construction.

        * @param aObserver The object to be used to handle updates from the server.

        */

        ChspsAutoInstaller( ChspsThemeServer& aThemeServer );

        /**

        * ConstructL.

        * Performs the second phase construction of a ChspsAutoInstaller object.

        */

        void ConstructL();

    private: // Members

    private: // Data    

        TBuf8<KMaxHeaderDataLength8> iHeaderData;

        ChspsThemeServer& iThemeServer;

        ChspsResult* iResult;

        ChspsInstallationHandler* iInstallationHandler;

        ChspsMaintenanceHandler* iMaintenanceHandler;

#ifdef HSPS_LOG_ACTIVE        

        /**

         * Log bus. Not owned.

         */        

        ChspsLogBus* iLogBus;

#endif

     };

#endif //__hspsAUTOINSTALLER_H__

// End of File