diff -r 000000000000 -r ba25891c3a9e ncdengine/provider/client/inc/ncdinstalloperationproxy.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/ncdengine/provider/client/inc/ncdinstalloperationproxy.h Thu Dec 17 08:51:10 2009 +0200 @@ -0,0 +1,289 @@ +/* +* 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 + +#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 iMimeTypes; + RArray iPurposes; + + // File(s) currently being installed + CNcdInstallInfo* iCurrentInfo; + + TInt iInstallationError; + + }; + +#endif // C_NCDINSTALLOPERATIONPROXY_H