--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/emailservices/emailcommon/inc/CFSMailRequestHandler.h	Fri Apr 16 14:51:52 2010 +0300
@@ -0,0 +1,205 @@
+/*
+* Copyright (c) 2007-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:  plugin request handler
+*
+*/
+
+
+#ifndef CFSMAILREQUESTHANDLER_H
+#define CFSMAILREQUESTHANDLER_H
+
+//  INCLUDES
+//<cmail>
+#include "CFSMailPlugin.h"
+//</cmail>
+#include "CFSMailPluginData.h"
+
+#include "emailcommondef.h"
+
+// FORWARD DECLARATIONS
+class CFSMailRequestObserver;
+
+/**
+ *  asynchronous request progress indicator
+ *
+ *  @lib FSFWCommonLib
+ *  @since S60 v3.1
+ */
+class TFSPendingRequest
+    {
+
+public:
+
+    /** request status */
+    enum TFSRequestStatus
+    {
+        EFSRequestPending = 1,
+        EFSRequestComplete,
+        EFSRequestCancelled,
+    };
+
+public: // data
+		        
+    /** request id */
+    TInt                       iRequestId;
+
+    /** plugin uid */
+    TUid                       iPluginId;
+
+    /** request status */
+    TFSRequestStatus           iRequestStatus;
+
+    /** request observer */
+    CFSMailRequestObserver*    iObserver;
+    };
+
+/**
+ *  email framework asynchronous request handler
+ *
+ *  @lib FSFWCommonLib
+ *  @since S60 v3.1
+ */ 
+class EMAILCOMMON_EXPORT CFSMailRequestHandler : public CBase
+	{
+
+public:
+  
+    /**
+     * destructor.
+     */
+      ~CFSMailRequestHandler();
+
+    /**
+     * two based constructor
+     *
+     * @param aPluginInfo plugin information table
+     * @param aPlugins plugin instances table
+     */
+      static CFSMailRequestHandler* NewL( RPointerArray<CImplementationInformation>&	aPluginInfo,
+                                                  RPointerArray<CFSMailPlugin>& aPlugins );
+    /**
+     * two based constructor
+     *
+     * @param aPluginInfo plugin information table
+     * @param aPlugins plugin instances table
+     */
+      static CFSMailRequestHandler* NewLC( RPointerArray<CImplementationInformation>& aPluginInfo,
+                                                   RPointerArray<CFSMailPlugin>& aPlugins );
+    /**
+     * starts asynchronous request
+     *
+     * @param aPluginId id of the target plugin request is accessed to
+     * @param aOperationObserver observer to forward request progress events
+     * to user from plugin
+     *
+     * @return request data
+     */
+      TFSPendingRequest InitAsyncRequestL( TUid aPluginId,
+                                                   MFSMailRequestObserver& aOperationObserver );
+
+    /**
+     * completes asynchronous request
+     *
+     * @param aRequestId id of the request to be completed
+     */
+      void CompleteRequest( TInt aRequestId );
+
+    /**
+     * cancels pending asynchronous request
+     *
+     * @param aRequestId id of the request to be cancelled
+     */
+      void CancelRequestL( TInt aRequestId );
+	 
+    /**
+     * cancels all pending asynchronous requests
+     *
+     */
+      void CancelAllRequestsL( );
+
+    /**
+     * returns plugin pointer related to plugin id
+     *
+     * @param aPluginId plugin id
+     * @return plugin pointer
+     */
+      CFSMailPlugin* GetPluginByUid( TFSMailMsgId aPluginId );
+
+    /**
+     * adds new plugin to plugin list
+     *
+     * @param aPluginId uid of the new plugin
+     * @param aPlugin plugin instance
+     */
+      void AddPluginL( TUid aPluginId, CFSMailPlugin* aPlugin );
+
+     /**
+      * cleans temp dir
+      * 
+      */
+      void CleanTempDirL( );
+
+     /**
+      * returns temp dir path
+      * 
+      */
+      TDesC& GetTempDirL( );
+
+     /**
+      * opens or creates file
+      * 
+      * @param aFileName file name
+      */
+     // <qmail>
+      RFile GetTempFileL( TFSMailMsgId aContentId,TFileName aFileName );
+     // </qmail>
+protected:
+
+    /**
+     * C++ default constructor.
+     */
+  	 CFSMailRequestHandler();
+  	 
+    /**
+     * two based constructor
+     */
+     void ConstructL( RPointerArray<CImplementationInformation> aPluginInfo,
+                      RPointerArray<CFSMailPlugin> aPlugins );
+
+protected: // data
+
+    /** list of loaded plugins */
+    RPointerArray<CFSMailPluginData>    iPluginList;
+
+private: 
+
+    /** removes all asynchronous requests */
+    void RemoveAllRequests();
+
+private: // data
+
+    /** list of pending requests */
+    RArray<TFSPendingRequest>           iPendingRequests;
+    
+    /** request id counter       */
+    TUint                                iRequestId;
+
+    /** temp directory files handling        */ 
+    RFs                                  iFs;
+    HBufC                                *iTempDirName;
+    };
+
+#endif
+  
+// End of File