/*

* Copyright (c) 2006-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:   CNcdInstallOperationProxy declaration

*

*/

#ifndef C_NCDINSTALLOPERATIONPROXY_H	

#define C_NCDINSTALLOPERATIONPROXY_H	

#include <f32file.h>

#include "ncdoperationimpl.h"

#include "ncdbaseoperationproxy.h"

#include "ncdinstalloperation.h"

#include "ncdoperationdatatypes.h"

#include "ncdinstallationserviceobserver.h"

#include "ncditempurpose.h"

class MNcdInstallationService;

class MNcdInstallOperationObserver;

class CNcdNodeProxy;

class CNcdInstallInfo;

class CNcdFileInfo;

class CNcdInstallOperationProxy : 

    public CNcdOperation< MNcdInstallOperation >,

    public MNcdInstallationServiceObserver

    {

public:

    /**

     * Constructor

     *

     * @param aSession is the session that is used between

     *                 the proxy and the server.

     * @param aDownloadType Download type

     * @param aHandle is the handle that identifies the serverside

     *                object that this proxy uses.

     * @param aRemoveHandler An observer that is called during destruction.

     * @param aNode The node this operation was started from.

     */    

    static CNcdInstallOperationProxy* NewLC( MCatalogsClientServer& aSession,                        

                        TInt aHandle,

                        MNcdOperationProxyRemoveHandler* aRemoveHandler,

                        CNcdNodeProxy* aNode,

                        CNcdNodeManagerProxy* aNodeManager,

                        MNcdInstallOperationObserver* aObserver,

                        MNcdInstallationService& aInstallationService );

public: // From MNcdInstallOperation

    /**

     * @see MNcdInstallOperation::FileCount()

     */

    TInt FileCount();

    /**

     * @see MNcdInstallOperation::CurrentFile()

     */

    TInt CurrentFile();    

public: // From MNcdOperation

    /**

     * @see MNcdOperation::OperationType();

     */

    void StartOperationL();

   /**

     * @see MNcdOperation::CancelOperation()

     */

    void CancelOperation();

    /**

     * @see MNcdOperation::OperationType()

     */

    TNcdInterfaceId OperationType() const;

protected: // Constructor and destructor

    /**

     * Constructor

     *

     */

    CNcdInstallOperationProxy( MNcdInstallationService& aInstallationService );

    virtual ~CNcdInstallOperationProxy();

    /**

     * ConstructL

     *

     * @param aSession is the session that is used between

     *                 the proxy and the server.

     * @param aHandle is the handle that identifies the serverside

     *                object that this proxy uses.

     * @param aRemoveHandler An observer that is called during destruction.

     * @param aNode The node this operation was started from.

     */

    void ConstructL( MCatalogsClientServer& aSession,

                    TInt aHandle,

                    MNcdOperationProxyRemoveHandler* aRemoveHandler,

                    CNcdNodeProxy* aNode,

                    CNcdNodeManagerProxy* aNodeManager,

                    MNcdInstallOperationObserver* aObserver );

protected: // From CNcdBaseOperationProxy

    /**

     * @see CNcdBaseOperationProxy::ProgressCallback()

     */

    void ProgressCallback();

    /**

     * @see CNcdBaseOperationProxy::QueryReceivedCallback()

     */

    void QueryReceivedCallback( CNcdQuery* aQuery );

    /**

     * @see CNcdBaseOperationProxy::CompleteCallback()

     */

    void CompleteCallback( TInt aError );

    /**

     * @see CNcdBaseOperationProxy::CreateInitializationBufferL()

     */    

    HBufC8* CreateInitializationBufferL();

    /**

     * @see CNcdBaseOperationProxy::InitializationCallback()    

     */

    void InitializationCallback( RReadStream& aReadStream, 

        TInt aDataLength );    

protected: // MNcdInstallationServiceObserver

    /**

     * @see MNcdInstallationServiceObserver::InstallationCompleteL()

     */

    void InstallationCompleteL( const TDesC& aFileName,

                                const TUid& aAppUid,

                                TInt aError );

protected: // CActive

    /**

     * @see CActive::RunL

     */

    void RunL();

    /**

     * @see CActive::DoCancel

     */    

    void DoCancel();

    /**

     * @see CActive::RunError

     */

    TInt RunError( TInt aError );

protected:

    /**

     * This function uses the correct installer functions that are class

     * specific. Child classes may have their own implementations that

     * are automatically used when installation is handled.

     * 

     * @param aFile The file that is going to be installed.

     */ 

    virtual void UseInstallServiceL( const CNcdFileInfo& aFile );

    /** 

     * @return MNcdInstallationService& Service that is used to

     * handle the installation of the files.

     */

    MNcdInstallationService& Installer();

    /**

     * @return CNcdInstallInfo& File(s) currently being installed.

     */

    CNcdInstallInfo& CurrentInfo();

    /**

     * Updates the file's information to the server side.

     * This should be called only after succesfull installation

     * because iCurrentFile count is increased by one.

     *

     * For parameter descriptions:

     * @see MNcdInstallationServiceObserver::InstallationCompleteL

     */

    void UpdateInfoToServerL( const TDesC& aFileName,

                              const TUid& aAppUid,

                              TInt aError );

    /**

     * @aErrorCode Current error code for the installation operation.

     */

    void SetInstallationErrorCode( const TInt& aErrorCode );

    /**

     * @return TInt Current error code for the installation operation.

     */

    TInt InstallationErrorCode() const;

    /**

     * Inform server side install report that the installing has been started.

     */

    void StartInstallReportL();

    /**

     * Inform server side install report that the installing has been completed

     * with the given error code.

     */

    void CompleteInstallReportL( TInt aErrorCode );

    /**

     * Deletes the current content file that has been set for the installation.

     */ 

    void DeleteCurrentFileL();

private: // new methods

    void InstallNextFileL();

    CNcdInstallInfo* InstallInfoL( TInt aIndex );

    RFile OpenFileL( TInt aFileIndex );

    void DeleteFileL( TInt aFileIndex );

protected: // data

    RFile iFileHandle; // file that is currently being installed    

private: // data

    /**

     * Operation observer, for callbacks.

     * Observer not own.

     */    

    MNcdInstallOperationObserver* iObserver;        

    // Installer, not own

    MNcdInstallationService* iInstaller;

    // Total number of files      

    TInt iFileCount;

    // Number of the currently downloaded file

    TInt iCurrentFile;                

    RPointerArray<HBufC> iMimeTypes;

    RArray<TNcdItemPurpose> iPurposes;

    // File(s) currently being installed

    CNcdInstallInfo* iCurrentInfo;

    TInt iInstallationError;        

    };

#endif // C_NCDINSTALLOPERATIONPROXY_H