开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > Symbian > 查看源码
EmailExampleEngine.h
资源名称：Source Code.rar　[点击查看]
上传用户：sempras
上传日期：2007-03-04
资源大小：821k
文件大小：4k
源码类别：

Symbian

开发平台：

C/C++

EmailExampleEngine.h：源码内容
  1. #ifndef __EMAILEXAMPLEENGINE_H__
  2. #define __EMAILEXAMPLEENGINE_H__
  4. #include <e32base.h>
  5. #include <msvapi.h>
  7. #include <imapset.h>
  8. #include <pop3set.h>
  11. enum TProtocolType
  12. {
  13. EProtocolPop3,
  14. EProtocolImap4
  15. };
  17. enum TEmailExampleEngineEvent
  18. {
  19. ERemoteCountChanged,
  20. };
  22. /*
  23. * ============================================================================
  24. *  Name     : MEmailExampleEngineObserver from EmailExampleEngine.h
  25. *  Part of  : EmailExample
  26. *  Created  : 09/11/2003 by Forum Nokia
  27. *  Implementation notes:
  28. * Common observer to handle asynchronous events conserning engine
  29. *
  30. *  Version  : 1.0
  31. *  Copyright: Nokia Corporation
  32. * ============================================================================
  33. */
  35. class MEmailExampleEngineObserver
  36. {
  37. public:
  38. virtual void HandleEngineChangedEventL(TEmailExampleEngineEvent aEvent)=0;
  39. };
  41. class CBaseMtm;
  42. class CMtmStore;
  43. class CClientMtmRegistry;
  44. class CImap4Mail;
  45. class CPop3Mail;
  47. /*
  48. * ============================================================================
  49. *  Name     : CEmailExampleEngine from EmailExampleEngine.h
  50. *  Part of  : EmailExample
  51. *  Created  : 09/11/2003 by Forum Nokia
  52. *  Implementation notes:
  53. * Statemachine which handles events common for both
  54. * implemented protocols IMAP and POP.
  55. * Note for instructional purposes the structure is kept
  56. * so that most functions are implemented in 2 versions
  57. * one for imap one for pop. Leaving other protocol out
  58. * for advanced exercises is though trivial.
  59. *
  60. *  Version  : 1.0
  61. *  Copyright: Nokia Corporation
  62. * ============================================================================
  63. */
  65. class CEmailExampleEngine : public CActive, public MMsvSessionObserver
  66. {
  67. public:
  68. // creational
  69. static CEmailExampleEngine* NewL(MEmailExampleEngineObserver& aObserver);
  70. ~CEmailExampleEngine();
  72. // interface
  74.     /*
  75.     * HandleCmdRemoteFetchL()
  76.     *
  77.     * Calls remote mailbox download function of selected protocol type.
  78. *
  79.     * Returns:
  80.     * KErrNone if everything went like planned
  81.     *
  82.     */
  83. TInt  HandleCmdRemoteFetchL();
  85. /*
  86.     * RemoteOpenEmailL(TInt aIndex)
  87.     *
  88.     * Uses generic messaging architecture and opens selected message entry.
  89. * May generate dial-up connection to fetch message body.
  90.     *
  91.     * Params:
  92.     * (1) TInt aIndex index to message entry to be opened
  93.     *
  94.     */
  95. void  RemoteOpenEmailL(TInt aIndex);
  97. /*
  98.     * Settings()
  99.     *
  100.     * Initiates selection dialog which gives user the possibility
  101. * to change internet email protocol used.
  102.     *
  103.     */
  104. void Settings();
  106. TBool HandleAccountNotDefined();
  107. TPtrC RemoteEmailTextL(TInt aIndex);
  108. TPtrC RemoteEmailSenderL(TInt aIndex);
  109. TInt  RemoteEmailCount();
  111. // private functions
  112. private:
  113. CEmailExampleEngine(MEmailExampleEngineObserver& aObserver);
  114. void ConstructL();
  115. CMsvEntrySelection* UpdateEntriesL(const TMsvId& aServiceId);
  116. void OpenEmailL(TMsvId& aEntryId);
  118. //IMAP/POP common
  119. void UpdateRemoteCountL();
  121. //IMAP specific
  122. TBool Imap4AccountNotDefined();
  123. TInt SyncWithRemoteServerImap4L();
  124. void UpdateRemoteCountImap4L();
  126. //POP specific
  127. TBool Pop3AccountNotDefined();
  128. TInt  FetchRemoteMailPop3L();
  129. void UpdateRemoteCountPop3L();
  131. void SetProtocolType( TInt aProtocolType );
  133. // from CActive
  134. void RunL();
  135. void DoCancel();
  136. TInt RunError(TInt aError);
  138. // from MMsvSessionObserver
  139.     void HandleSessionEventL(TMsvSessionEvent aEvent,TAny* aArg1,TAny* aArg2,TAny* aArg3);
  141. // private types
  142. private:
  143. // internal state indication
  144. enum TInternalState
  145. {
  146. EInitialising,
  147. EReadyButNeedsUpdating,
  148. EReady,
  149. EEditing,
  150. EWaitingForImap4,
  151. ESyncImap4,
  152. EWaitingForPop3,
  153. EFetchingPop3,
  154. };
  155. // private data
  156. private:
  157. MEmailExampleEngineObserver& iObserver;
  158.     CMsvSession* iMsvSession;
  159. CClientMtmRegistry* iMtmReg;
  160. CMtmStore* iMtmStore;
  161. TInternalState iState;
  162. CMsvEntry* iEntry;
  163. CMsvEntrySelection* iRemoteEntries;
  164. TInt iRemoteCount;
  166. CImap4Mail* iImapMail;
  167. TBool iNoImap4defined;
  169. CPop3Mail* iPopMail;
  170. TBool iNoPop3defined;
  172. public:
  173. TInt iSettingProtocolType;
  174. TInt iProtocolType;
  175. };
  177. #endif // __EMAILEXAMPLEENGINE_H__