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/