MCL/sf/app/commonemail: comparison emailservices/emailserver/cmailhandlerplugin/inc/cmailcpshandler.h

equal deleted inserted replaced

-:e7aa27f58ae1
+:e1b6206813b4
 #ifndef __CMAILCPSHANDLER_H__
 #define __CMAILCPSHANDLER_H__
 #include <aknappui.h>
+#include <memailobserverlistener.h> // base class
 // FSMailServer classes (base classes and callback interfaces)
 #include "fsnotificationhandlerbase.h"
 #include "fsnotificationhandlernotifierinitiator.h"
 #include "fsnotificationhandlernotifierinitiatorobserver.h"
 // Member classes
 class CMailCpsIf;
 class CFSMailBox;
 class CMailMailboxDetails;
 class CMailCpsSettings;
+class CMailExternalAccount;
+class CMailPluginProxy;
+class CEmailObserverPlugin;
 /**
 * CMail ContentPublishingService Handler class
 * Class implementing a handler functionality towards rest of the MailServer
 *
 *  @lib fsmailserver.exe
 *  @since S60 v5.1
 */
 NONSHARABLE_CLASS( CMailCpsHandler ) :
 public CFSNotificationHandlerBase,
-public MMailCpsSettingsCallback
+public MMailCpsSettingsCallback,
+public EmailInterface::MEmailObserverListener
 {
 public:
 /**
 * Two-phased constructor.
 *
 */
 void UpdateMailboxesL(TInt aInstance, const TDesC& aContentId);
 /**
+* Updates external (3rd party) account based on contentId
+* @param aContentId specifies the widget and account related to it
+*/
+void UpdateExtAccountL( const TDesC& aContentId );
+/**
 *
 */
 void LaunchWidgetSettingsL( const TDesC& aContentId );
 /**
 /**
 *
 */
 void LaunchEmailWizardL();
+/**
+* Launches an application based on the given contentId
+* This method is for external (3rd party) accounts
+* @param aContentId specifies the widget that was pressed by the user
+*/
+void LaunchExtAppL( const TDesC& aContentId );
 /**
 *
 */
 TBool AssociateWidgetToSetting( const TDesC& aContentId );
 *
 */
 void DissociateWidgetFromSettingL( const TDesC& aContentId );
 /**
-*
+* Return total number of mailboxes (native+3rd party) in the system
+*/
+TInt TotalMailboxCountL();
+/**
+* Return total number of native mailboxes in the system
 */
-TInt GetMailboxCount();
+TInt TotalIntMailboxCount();
+/**
+* Return total number of 3rd party mailboxes in the system
+*/
+TInt TotalExtMailboxCountL();
 /**
 *
 */
 void ManualAccountSelectionL( const TDesC& aContentId );
+	/**
+* Gets correct localised format for time (or date) string
+*/
+static HBufC* GetMessageTimeStringL( TTime aMessageTime );
+// From MEmailObserverListener
+void EmailObserverEvent( EmailInterface::MEmailData& aData );
 protected:
 /**
 * From CFSNotificationHandlerBase
 * see baseclass for details
 */
 * Resets everything
 */
 void Reset();
 /**
-* Initializes everything
+* Initializes native accounts
 */
 void InitializeL();
+/**
+* Initializes external accounts
+*/
+void InitializeExternalAccountsL();
 // Creation methods
 /**
 * Creates an instance of mailboxdetails based on parameters
 * @param aMailbox mailbox
 */
 	void UpdateMessagesL( const TInt aMailBoxNumber,
 const TInt aWidgetInstance,
 	                      const TInt aMessageNumber,
 const TInt aFirstRow );
-/**
-* Gets correct localised format for time (or date) string
-*/
-	HBufC* GetMessageTimeStringL( TTime aMessageTime );
 	/**
 *
 */
 	void UpdateEmptyMessagesL( const TInt aWidgetInstance,
 * @param aMailbox specifies the mailboxdetails object where duplicate is searched from
 * @param aMsgId Id of the new message
 * @return ETrue if duplicate, EFalse if new message
 */
 TBool IsDuplicate( const CMailMailboxDetails& aMailbox, const TFSMailMsgId& aMsgId );
-/**
+//
-*
+// Private methods related to 3rd party email widget publishers
-*/
+//
+/**
+* Removes all plugin proxies (and plugins) that are not listed in aAccounts
+* @param aAccounts up-to-date list of external (3rd party) email accounts
+*        that are specified in settings
+*/
+void RemoveUnusedPluginsL( RPointerArray<CMailExternalAccount>& aAccounts );
+/**
+* Goes through the array of external accounts and instantiates (newly added)
+* 3rd party plugins
+* @param aAccounts up-to-date list of external (3rd party) email accounts
+*        that are specified in settings
+*/
+void AddNewPluginsL( RPointerArray<CMailExternalAccount>& aAccounts );
+/**
+* Goes through the array of existing 3rd party plugin (proxies) and
+* lets them take the accounts given in the param array.
+* Plugin proxies also update the widget data.
+* @param aAccounts up-to-date list of external (3rd party) email accounts
+*        that are specified in settings
+*/
+void SelectAndUpdateExtAccountsL( RPointerArray<CMailExternalAccount>& aAccounts );
 TBool FirstBootL();
+/**
+* Checks whether aAccounts array has entries relating to plugin with id aPluginId
+* @param aPluginId 3rd party plugin identifier (implementation uid)
+* @param aAccounts array of 3rd party email account information
+* @return true or false
+*/
+TBool IsPluginInArray( const TInt aPluginId, RPointerArray<CMailExternalAccount>& aAccounts );
+/**
+* Checks whether aPlugins array has entries relating to plugin with id aPluginId
+* @param aPluginId 3rd party plugin identifier (implementation uid)
+* @param aPlugins array of plugin proxies
+* @return true or false
+*/
+TBool IsPluginInArray( const TInt aPluginId, RPointerArray<CMailPluginProxy>& aPlugins );
+/**
+* Goes through iExternalPlugins array and finds correct entry
+* @param aContentId specifying a widget/account
+* @return correct plugin proxy instance pointer (ownership not transferred)
+*         if not found, NULL is retuned
+*/
+CMailPluginProxy* GetExtPluginL( const TDesC& aContentId );
 private: // data
 CEikonEnv* iEnv;
 // pointer to liw wrapper that handles actual publishing
 CMailCpsIf*                        iLiwIf;
 // pointer to settings class that handles settings loading and observing logic
 CMailCpsSettings*                  iSettings;
 // local cache of mailbox details
 RPointerArray<CMailMailboxDetails> iAccountsArray;
+// array of plugin proxies. One plugin proxy handles one 3rd party plugin and its accounts
+RPointerArray<CMailPluginProxy> iExternalPlugins;
 };
 #endif  //__CMAILCPSHANDLER_H__

branch	RCL_3
changeset 8	e1b6206813b4
parent 3	a4d6f1ea0416
child 10	f5907b1a1053