diff -r 000000000000 -r ba25891c3a9e iaupdate/IAD/engine/controller/inc/iaupdateselfupdaterinitializer.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/iaupdate/IAD/engine/controller/inc/iaupdateselfupdaterinitializer.h Thu Dec 17 08:51:10 2009 +0200 @@ -0,0 +1,206 @@ +/* +* 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 +#include + +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