/*

* Copyright (c) 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:   ?Description

*

*/

#ifndef IA_UPDATE_SELF_UPDATER_INITIALIZER_H

#define IA_UPDATE_SELF_UPDATER_INITIALIZER_H

#include <e32base.h>

#include <f32file.h>

class CIAUpdateNode;

class MIAUpdateSelfUpdaterInitObserver;

class CIAUpdaterFileList;

class MNcdNode;

/**

 * CIAUpdateSelfUpdaterInitializer is used to set file paths for the

 * self updater. Self updater will install these content files when

 * is is started.

 *

 */

class CIAUpdateSelfUpdaterInitializer : public CActive

    {

public:

    /**

     * @param aNode Node that has content file paths for the self update content.

     * @return CIAUpdateSelfUpdaterInitializer* Created object.

     *

     */

    static CIAUpdateSelfUpdaterInitializer* NewL(

                      CIAUpdateNode& aNode, 

                      MIAUpdateSelfUpdaterInitObserver& aObserver );

    /**

     * @see CIAUpdateSelfUpdaterInitializer:: NewL

     *

     */

    static CIAUpdateSelfUpdaterInitializer* NewLC( 

                      CIAUpdateNode& aNode,

                      MIAUpdateSelfUpdaterInitObserver& aObserver );

    /**

     * Destructor

     *

     */

    ~CIAUpdateSelfUpdaterInitializer();

    /**

     * Starts the operation.

     *

     * @exception Leaves with KErrInUse if operation is already going on.

     */

    void StartL();

protected: // CActive

    /**

     * @see CActive::DoCancel

     *

     */

	virtual void DoCancel();

    /**

     * @see CActive::RunL

     *

     */

	virtual void RunL();

    /**

     * @see CActive::RunError

     *

     */

     virtual TInt RunError( TInt aError );

private:

    /**

     * TUpdaterState defines possible states of this active object.

     *

     */

    enum TUpdaterState

        {

        /**

         * No operation is going on.

         *

         */

        ENotStarted,

        /**

         * Initializes everything for the actual self updating.

         * Sets the content file paths for the file list.

         * 

         */

        EInitialize

        };

    /**

     * @see CIAUpdateSelfUpdaterInitializer::NewL

     *

     */

    CIAUpdateSelfUpdaterInitializer( CIAUpdateNode& aNode,

                                     MIAUpdateSelfUpdaterInitObserver& aObserver );

    /**

     * 2nd. phase constructor

     *

     */

    virtual void ConstructL();

    /**

     * @return const TUpdaterState& Current state of this active object.

     *

     */

    const TUpdaterState& State() const;

    /**

     * @return CIAUpdateNode& Node that has content file paths 

     * for the self update content.

     *

     */

    CIAUpdateNode& Node();

    /**

     * @return MIAUpdateSelfUpdaterInitObserver& Operation observer.

     *

     */

    MIAUpdateSelfUpdaterInitObserver& Observer();

    /**

     * @return RFs& File server session for this class object.

     *

     */    

    RFs& FileServer();

    /**

     * Sets the content files to the array from the purchase history.

     *

     */    

    void SetContentFileListL();

    /**

     * This function is called when the initialization has been done.

     * This function will inform the observing node about the completion.

     *

     */    

    virtual void InitCompleteL();

private:

    // Prevent these if not implemented

    CIAUpdateSelfUpdaterInitializer( const CIAUpdateSelfUpdaterInitializer& aObject );

    CIAUpdateSelfUpdaterInitializer operator =( const CIAUpdateSelfUpdaterInitializer& aObject );

private: // data    

    // Node whose content will be installed.

    CIAUpdateNode& iNode;

    // Operation observer.

    MIAUpdateSelfUpdaterInitObserver& iObserver; 

    // State of the updater operation.

    TUpdaterState iState;

    // File server session.

    RFs iFs;

    // List of the content files that should be installed by the self updater.

    // Ownership will be transferred. Owned temporarily.    

    CIAUpdaterFileList* iFileList;

    };

#endif // IA_UPDATE_SELF_UPDATER_INITIALIZER_H