1          概述

郵件解析庫API完全使用面向對象技術設計，使用C++語言開發的用于郵件解析和組裝的庫。它提供了一些類用來解析和組裝Internet郵件，如MimeMessage和MimeBodyPart，用于Internet郵件協議實現并且遵循RFC822和RFC2045規范。這些API庫用于應用程序的開發。

1.1        術語

RFC：Request For Comments, 請求注解, Internet標準(草案)

MIME：Multipurpose Internet Mail Extension protocol, 多用途的網際郵件擴充協議

2          郵件解析庫的實現

2.1        實現過程

本郵件解析庫（FastMail）參考JavaMail的結構設計，有與之類似的接口和類。本解析庫用到基礎庫Fast庫參考ACE庫和STL、Java Framework庫設計，包含一些字符串處理和容器的類。設計它們的目的是為了簡化庫的接口，并且盡量與Java庫的接口兼容，同時使用完全標準的C++特性，使庫更易維護更穩固。

這兩個庫從2004-6月底開始開發設計至2004-10-10完成，歷時3個多月，由于不是全力投入，實際耗時約2個月，由于有JavaMail、ACE和STL庫的借鑒，所以設計起來還比較順利。兩個庫的代碼量約有32000行代碼。類設計合理并且提供豐富的接口供二次開發和改造。

下面是兩個庫的文件列表以及郵件解析庫的類的介紹（Fast庫另有文檔專門介紹）：

2.2        文件列表

FAST基礎庫

       comm.\

       comm.\FastArray.h               數組類

       comm.\FastAutoPtr.h            自動管理指針類

       comm.\FastBase.h                FAST庫公共定義，包含一個完整的內存分配器類

       comm.\FastHashMap.h         HashMap容器類

       comm.\FastMap.h                Map容器類

       comm.\FastString.h                     FastString字符串處理類

       comm.\FastVector.h                     Vector容器類

郵件解析引擎FastMail庫

       mime\

       mime\CharsetUtils.cpp          字符串編碼和解碼工具

       mime\CharsetUtils.h

       mime\MimeActivation.cpp     郵件解析初始化工具

       mime\MimeActivation.h

       mime\MimeBase.h                郵件解析公共定義

       mime\MimeContainer.cpp      郵件解析Multipart容器

       mime\MimeContainer.h

       mime\MimeEntity.cpp           郵件解析MIME實體類

       mime\MimeEntity.h

       mime\MimeMessage.cpp       郵件解析MIME郵件類

       mime\MimeMessage.h

       mime\MimeObject.cpp          郵件解析MIME對象類

       mime\MimeObject.h

       mime\MimeParser.cpp          郵件解析工具類

       mime\MimeParser.h

       mime\MimeUtility.cpp           郵件解析工具類

       mime\MimeUtility.h

3          郵件解析庫的類

3.1        類的實現

郵件解析庫包含一系列的類，主要有MimeMessage（郵件實現類）、MimeBodyPart（郵件正文段體類）、MimeMultipart（郵件多部段體類）、InternetHeaders（郵件頭類）、InternetAddress（郵件地址類）和ContentType（段體類型類）等。解析和組裝郵件主要使用這些類進行組裝和分解。

下面是所有的類的說明：

3.2        類圖

3.3        MimeMessage類

現在介紹一下最主要的也是提供主要的調用接口API的類MimeMessage。

MimeMessage提供了一系列的方法供調用者使用，如定義了獲取地址信息和獲取郵件正文內容的結構（可以為具體的數據也可以為一個MimeMultipart對象），用來實現RFC822和MIME規范。

一個MimeMessage對象里保存了一個郵件內容數據（Content），以及一些記錄特定的郵件地址信息（如發件人（Sender）和收件人（recipients））的屬性（InternetHeaders）。還有關于這封郵件的結構信息（structural information），以及它的郵件主體（body）的段體類型（Content-Type）。

下面用圖來描述一個MimeMessage對象內部可能的結構：

3.4        MimeMessage類結構圖

 
。。。未完待續

4          參考文獻

[1]《JavaMail 1.2》

[2]《JavaMailTM API Design Specification Version 1.2》

[3]《C++網絡編程 卷1：運用ACE和模式消除復雜性》

[4] http://www.faqs.org/rfcs/