【标题】：TinyMail研究—Stream及相关设计模式
【关键字】：TinyMail,Stream
【来源】：http://blog.csdn.net/absurd/archive/2007/04/12/1562647.aspx

TinyMail研究—Stream及相关设计模式

转载时请注明出处和作者联系方式：http://blog.csdn.net/absurd

作者联系方式：Li XianJing <xianjimli at hotmail dot com>

更新时间：2007-4-12

TinyMail是一套针对移动设备设计的邮件系统框架，为了达到最大的灵活性，它采用了很多设计模式和先进的编程技术，让框架的每一部分都可以定制和配置。TinyMail流行的趋势非常明显，Nokia770/800和GPE Phone Edition等项目中都使用了它。因为我们也要开发邮件系统，所以花了几天时间去研究它的实现，这里记录一些研究笔记，供有兴趣的朋友参考。本文介绍一下Stream及相关设计模式。

Stream是对输入/输出的抽象，为使用者提供一个统一的接口，使用者使用这个接口而不必关心它的实现，这是针对接口编程的典型例子。TinyMail实现了很多Stream，它们的关系如下：

CamelStream接口要求实现下列虚函数：

ssize_t (*read) (CamelStream *stream, char *buffer, size_t n);

ssize_t (*write) (CamelStream *stream, const char *buffer, size_t n);

int (*close) (CamelStream *stream);

int (*flush) (CamelStream *stream);

gboolean (*eos) (CamelStream *stream);

int (*reset) (CamelStream *stream);

CamelSeekableStream接口要求实现下列虚函数：

off_t (*seek) (CamelSeekableStream *stream, off_t offset, CamelStreamSeekPolicy policy);

off_t (*tell) (CamelSeekableStream *stream);

int (*set_bounds) (CamelSeekableStream *stream, off_t start, off_t end);

CamelTcpStream接口要求实现下列虚函数：

int (*connect) (CamelTcpStream *stream, struct addrinfo *host);

int (*getsockopt) (CamelTcpStream *stream, CamelSockOptData *data);

int (*setsockopt) (CamelTcpStream *stream, const CamelSockOptData *data);

struct sockaddr * (*get_local_address) (CamelTcpStream *stream, socklen_t *len);

struct sockaddr * (*get_remote_address) (CamelTcpStream *stream, socklen_t *len);

ssize_t (*read_nb) (CamelTcpStream *stream, char *buffer, size_t n);

这其中使用了不少设计模式，其中包括：

1. Adapter模式

Stream的整个设计都是基于Adapter模式的，Target是CamelSeekableStream、CamelStream和CamelTcpStream三个接口，Adapter是CamelStreamMem、CamelStreamFs和CamelTcpStreamSSL之类的具体实现，而adaptee则是内存、文件和Socket之的Stream。