iaupdate/IAD/engine/controller/inc/iaupdateselfupdaterinitializer.h
changeset 0 ba25891c3a9e
--- /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 <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