TinyMail研究—邮件的表示与解析
转载时请注明出处和作者联系方式：http://blog.csdn.net/absurd
作者联系方式：李先静<xianjimli at hotmail dot com>
更新时间：2007-4-17
TinyMail是一套针对移动设备设计的邮件系统框架，为了达到最大的灵活性，它采用了很多设计模式和先进的编程技术，让框架的每一部分都可以定制和配置。TinyMail流行的趋势非常明显，Nokia770/800和GPE Phone Edition等项目中都使用了它。因为我们也要开发邮件系统，所以花了几天时间去研究它的实现，这里记录一些研究笔记，供有兴趣的朋友参考。本文介绍一下邮件的表示与解析。
在TinyMail中，表示邮件的类以及它们之间的关系如下图所示：
CamelObject是所有类的基类，它提供类型系统的实现、引用计数、signal机制等基本功能。
CamelDataWrapper 它提供了对数据对象的包装，可以调用set_mime_type/ get_mime_type去设置/获取数据对象的类型，可以调用write_to_stream/ decode_to_stream把数据对象写到流中去，也可以调用construct_from_stream从流中构造数据对象。这些函数都是虚函数，可以在子类中重载。
CamelMedium 它提供了邮件的基本雏形：邮件头和邮件体。可以调用add_header/ set_header/ remove_header/ get_header/ free_headers/ get_headers去操作邮件头，可以调用set_content_object /get_content_object去存取邮件体。
CamelMimePart 它代表Mime邮件的一个Part，每个Part都有自己的邮件头来描述Content-Type和Content-ID等信息，也都有自己的邮件体（通常是一个文件），所以它继承了CamelMedium接口。
CamelMimeMessage 它代表一个完整的Mime邮件，它没有自己的虚函数，只是实现了CamelMedium定义的接口函数，并包装了一些实用的函数。
CamelMultipart 它代表multipart/*类型的Mime-Message的邮件体，可以调用add_part/add_part_at/remove_part/remove_part_at去增删其中的CamelMimePart对象，可以调用get_part/get_number去访问中的CamelMimePart对象。
CamelMultipartSigned/CamelMultipartEncrypted 它们实现了CamelMultipart，用于表示mutlipart/signed和mutlipart/encrypted类型的MultiPart邮件。
下面是一个创建邮件的例子：
|
create_mail.c #include <string.h> #include <camel/camel.h> int main(int argc, char* argv[]) { CamelMimeMessage *msg; CamelInternetAddress *addr; const char *text; CamelMultipart *mp; CamelMimePart *part; CamelStream* stream; msg = camel_mime_message_new(); camel_mime_message_set_subject(msg, "Talking to myself again"); addr = camel_internet_address_new(); camel_internet_address_add(addr, "NotZed", "notzed@somewhere.com"); camel_mime_message_set_from(msg, addr); camel_address_remove(CAMEL_ADDRESS(addr), -1); camel_internet_address_add(addr, "NotZed", "notzed@somewhere.else.com"); camel_mime_message_set_recipients(msg, "To", addr); camel_object_unref(addr); mp = camel_multipart_new(); camel_data_wrapper_set_mime_type(CAMEL_DATA_WRAPPER(mp), "multipart/alternative"); camel_multipart_set_boundary(mp, NULL); camel_multipart_set_preface(mp, "This is a message in MIME format. Get with the decade/n"); camel_multipart_set_postface(mp, "/nSome useless after-message text you should never see/n/n"); part = camel_mime_part_new(); text = "Hello NotZed,/nTalking to yourself again?/n/n NotZed/n"; camel_mime_part_set_content(part, text, strlen(text), "text/plain"); camel_multipart_add_part(mp, part); camel_object_unref(part); part = camel_mime_part_new(); text = "<html>/n<body>/nHello NotZed,<br>/nTalking to yourself again?<br>/n NotZed<br>/n</body>/n</html>/n"; camel_mime_part_set_content(part, text, strlen(text), "text/html"); camel_multipart_add_part(mp, part); camel_object_unref(part); camel_medium_set_content_object(CAMEL_MEDIUM(msg), CAMEL_DATA_WRAPPER(mp)); stream = camel_stream_fs_new_with_name("./test.eml", O_CREAT|O_RDWR, 0664); camel_data_wrapper_write_to_stream(CAMEL_DATA_WRAPPER(msg), stream); camel_object_unref(msg); camel_stream_close(stream); return 0; } Makefile: export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig FLAGS=-g `pkg-config --libs --cflags camel-lite-1.2 glib-2.0` all: gcc $(FLAGS) create_mail.c -o create_mail.exe clean: rm -f *.exe
|
邮件的解析是由CamelMimeParser完成，它采用了基于栈的下推自动机实现。其状态转换如下图所示：
参考资料：
~~end~~