SPSmtpServer: 一个基于 SPServer 的 SMTP 服务器框架

在 SPServer 中增加了一个 smtp 服务器框架。在框架中把 smtp 协议相关的内容做了封装，基于这个框架来实现各种 smtp 服务器（反垃圾网关，或者用于投递邮件的mta），可以减少工作量。

http://spserver.googlecode.com/files/spserver-0.9.4.src.tar.gz

有了这个框架之后，要实现一个简单的 smtp 服务器，就非常简单了。下面这段代码就是一个简单的例子。

class SP_FakeSmtpHandler : public SP_SmtpHandler {
public:
    SP_FakeSmtpHandler(){}

    virtual ~SP_FakeSmtpHandler() {}

    virtual int from( const char * args, SP_Buffer * reply ) {
        reply->printf( "250 %s, sender ok\r\n", args );

        return eAccept;
    }

    virtual int rcpt( const char * args, SP_Buffer * reply ) {
        reply->printf( "250 %s, recipient ok\r\n", args );

        return eAccept;
    }

    virtual int data( const char * data, SP_Buffer * reply ) {
        reply->append( "250 Requested mail action okay, completed.\r\n" );

        return eAccept;
    }
};

class SP_FakeSmtpHandlerFactory : public SP_SmtpHandlerFactory {
public:
    SP_FakeSmtpHandlerFactory() {}
    virtual ~SP_FakeSmtpHandlerFactory(){}

    virtual SP_SmtpHandler * create() const {
        return new SP_FakeSmtpHandler();
    }
};

int main( int argc, char * argv[] )
{
    SP_Server server( "", 1025, new SP_SmtpHandlerAdapterFactory(
            new SP_FakeSmtpHandlerFactory() ) );
    server.runForever();

    return 0;
}

要实现一个 smtp 服务器，需要实现 SP_SmtpHandler 和 SP_SmtpHandlerFactory 的子类。

SP_SmtpHandler 的定义如下：

class SP_SmtpHandler {
public:

	//所有的方法都可能返回如下的 3 个值
	// eAccept 表明指令成功
	// eReject 表明指令被拒绝
	// eClose  表明需要断开当前的连接
	enum {
		eAccept = 0,  // command accepted
		eReject = -1, // command rejected
		eClose  = -2  // force to close the connection
	};

	//在成功 accept 到一个连接之后，调用 welcome 方法，并把 clientIP 作为参数；
	virtual int welcome( const char * clientIP, SP_Buffer * reply );
	//在成功收到 EHLO 指令之后，调用 ehlo 方法；
	virtual int ehlo( const char * args, SP_Buffer * reply );
	//在成功完成 AUTH LOGIN 指令交互，收集了 user/pass 之后，调用 auth 方法；
	virtual int auth( const char * user, const char * pass, SP_Buffer * reply );

	//在成功收到 MAIL FROM 指令，获得发件人之后，调用 from 方法；
	virtual int from( const char * args, SP_Buffer * reply ) = 0;
	//在成功收到 RCPT TO 指令，获得一个收件人之后，调用 rcpt 方法，
	//如果有多个 RCPT TO 指令，那么调用 rcpt 多次；
	virtual int rcpt( const char * args, SP_Buffer * reply ) = 0;
	//在成功收到了邮件内容之后，调用 data 方法。
	virtual int data( const char * data, SP_Buffer * reply ) = 0;
};

如果是一个内部使用的，用于投递邮件的 mta ，不需要 smtp auth ，那么只需要实现 from/rcpt/data 这 3 个函数就可以了。
如果是一个用于反垃圾的网关，那么根据具体的反垃圾策略，可能需要实现 welcome/ehlo/auth 这些指令。
在 welcome 函数中，可以对 clientIP 进行检查，如果是一个非法的 ip ，那么可以返回 eClose ，以关闭当前连接。
如果需要支持 smtp auth ，那么需要实现 ehlo ，在返回的信息中，表明支持 smtp auth 。同时实现 auth 函数，对 user/pass 进行校验。

SPSmtpServer 用一个独立的线程处理前端的网络 IO ，再使用一个线程池来执行 SP_SmtpHandler 的各个函数。因此可以在 SP_SmtpHandler 的各个函数中进行各种操作，包括访问数据库这些耗时的操作。