一个简单的邮件收发程序

1. Background

My company decided to use Open Office instead of Ms Office several months ago. Because there is no mail sofware in Open Office, I decided to develop a mail program myself. Finally, my company decided to use Lotus Notes for receiving mails and forbade the port for pop3. Thus, my program doesn't make much sense. Indeed, it needs much work to develop a mail client with high performance. Since I am not so free, I quited after I implemented the basic functions, such as, send a mail and receive mails. I upload my code at http://download.csdn.net/source/1203159.

 

Here, I describe my design briefly. There are two modules, one for sending and receiving mails----SimpleMail, one for caching the mails received---FileStore.

 

2. Reference

Obviously, you need to be familiar with the related mail protocols, such as Smtp and Pop3. The RFC documents present the basic knowledge. The RFC 821, 822, 1939 may be the first three that you should read.

 

3. SimpleMail

The module, SimpleMail, is reponsible for sending and receiving mails. I adopt a layered architecture, though it is so simple. Of course, the layer on the top is for user interface, while the layer at the bottom is responsible for handling the network protocols. The layer in the middle is to hide the detail of the network protocol, and provides the upper layer with fixed interface. As shown in the project, I devided the files into three filters.  The filter named view contains files for user interface. Besides, the other two filters are for Smtp and Pop3 respectively, and they are the principal protocols. The file --MailManager--that is outside the filter comprises the middle layer, which acts as an intermediary between the user interface and the network protocol. Here, I list the interface in the MailManager below which characterizes the main functions of the mail program :

// ///<summary> /// send a mail ///</summary> HRESULT SendMailMessage(IN const CString& strRcs, IN const CString& strCCRcs, IN const CString& strBCCRcs, IN const CString& strSubject, IN const CString& strContent, IN const CStringArray& strAttachFiles); // ///<summary> /// receive the mails ///</summary> ///<param name = pProgressDlg> /// the pointer to the progress dialog ///</param> ///</param> ///<param name = arrPos> /// the position to locate each mail in the file ///</param> ///<param name = arrSize> /// the size of each mail ///</param> /// <returns> /// the value dictating whether it is successful /// </returns> HRESULT RecMail(IN CRecvProgressDlg* pProgressDlg, OUT CArray<MAILPOS>& arrPos, OUT CArray<UINT>& arrSize); ///<summary> /// delete the specified mail ///</summary> ///<param name = arrIndex> /// the index of the mail to be deleted ///</param> /// <returns> /// the value dictating whether it is successful /// </returns> HRESULT DelMail(IN const CArray<UINT>& arrIndex); // ///<summary> /// get the user name ///</summary> CString GetUserName(); ///<summary> /// set the user name ///</summary> void SetUserName(IN const CString& strUserName); ///<summary> /// get the password ///</summary> CString GetPassword(); ///<summary> /// set the password ///</summary> void SetPassword(IN const CString& strPassword); ///<summary> /// get the smtp server address ///</summary> CString GetSmtpServer(); ///<summary> /// set the smtp server address ///</summary> void SetSmtpServer(IN const CString& strSmtpServer); ///<summary> /// get the pop3 server address ///</summary> CString GetPopServer(); ///<summary> /// set the pop3 server address ///</summary> void SetPopServer(IN const CString& strPopServer); ///<summary> /// get the sender address ///</summary> CString GetSendMail(); ///<summary> /// set the sender address ///</summary> void SetSendMail(IN const CString& strSendMail); ///<summary> /// get the setting whether to validate the identity ///</summary> BOOL GetValidate(); ///<summary> /// set whether to validate the identity ///</summary> void SetValidate(IN BOOL bValidate);   

3.1 the View part

However, I think the implementation intended for user interface doesn't need much description. They are mostly commonplace.  But there is an edit box in the send mail dialog. You can drag files into it and select the files in it to delete them. Well, that costed me much time to accomplish those functions. It's worth for you to read it.

 

3.2 the Mail part

Well, the files in connection with the network protocols may refer to some background knowledge.  In fact, those implementation just follow the protocols. Here, I only explain the purpose of several files.

PopReceiveManager.h---implement pop3 protocol for receiving mails

SmtpSendManager.h---implement smtp protocol for sending mails

MIMECode.h, Base64.h---encode and decode the mail content, mainly use the base64 algorithm

AppOctetStream.h, MIMEContentAgent.h, Textplain.h---follow the mail format--MIME

 

4. FileStore

Well, it's necessary to cache the mails received for further use. So I develop this module for that purpose. The design is similiar to the way that the operating system constructs the files system. The basic unit is a block that stores a mail. And a certain number of blocks comprise a heap while a certain number of heaps comprise a cluster. All of these in this hierachical has an according sturcture to store some related information. The block index indicates the position of the mail.  And the header at the head of the file stores the start position to store the mails. The following is the key structures.

///<summary> /// the file header ///</summary> struct FILE_STORE_CLASSEXT SMailFileHeader { UINT m_nHeadSize; //the size of the header BYTE m_byReserve[32]; TCHAR m_szIdentity[8]; //the identity of the file, = _T("MAILFILE") UINT m_nVersion; //the version of the file MAILFILEPOS m_mailClusterHeadPos; //the cluster position MAILFILEPOS m_endFilePos; // the end of the file }; ///<summary> /// a top level structure that contains heaps ///</summary> struct FILE_STORE_CLASSEXT SMailCluster { UINT m_nMailBlockSize; //the size of each block UINT m_nUseHeapCount; //the count of the heaps used MAILFILEPOS m_nextClusterPos; //the position of the next cluster, if there is need for further use MAILFILEPOS m_HeapPos[MAIL_CLUSTER_CAPACITY];//the position of each heap }; ///<summary> /// it consists of blocks, while many heaps comprise a cluster ///</summary> struct FILE_STORE_CLASSEXT SDataHeap { MAILFILEPOS m_blockDataStartPos; //the start position of the real data block BYTE m_UseFlags[MAIL_HEAP_CAPACITY];//the flags to identify the blocks used };