利用JMail组件快速构建邮件程序(上)

当你需要在VC程序中提供邮件支持功能的时候，你有许多种选择：
1） 根据SMTP,POP3,MIME等协议从零开始实现。这要求熟悉RFC 821,RFC 822,RFC 1123, RFC 1652, RFC 1939, RFC2045-2049等一系列协议, 您可以实现一切可能实现的功能，但同时需要花大量的时间。
2）利用一些免费的封装类，比如CSMTP,CPOP3。虽然可以达到快速实现的目的，但功能非常有限。
3）利用MAPI调用支持MAPI的邮件发送程序( 例如:Outlook )发送邮件，这种实现方式需要客户端安装指定的邮件发送程序，不够灵活
4）利用现成的组件例如：w3 JMail组件来构建您的系统，JMail组件功能强大，可以轻松完成邮件发送、接收、加密、集群传输等工作。

虽然JMail用得最多的是ASP下的应用，但它在其它语言中都能够很好地工作，本文将针对w3 JMail 4.3在VC中的使用展开讨论。

一、准备篇

1.1 组件的安装

因为JMail4.3与以前的版本相比接口有了变动，所以推荐您使用4.3版本,您可以到以下网址下载JMail 4.3
DIMAC公司
VC知识库

1.2 快速邮件发送程序MINI版

我们从这个小例子大致了解一下JMail组件的工作过程

#import "jmail.dll"   // 导入jmail.dll, 假如jmail.dll不在工程目录下，您需要写上完整路径

void main()
{
 CoInitialize(NULL);  // COM的初始化
 {
  // 创建SpeedMailer实例
  jmail::ISpeedMailerPtr pSpeedMailer("JMail.SpeedMailer"); 
  
  // 发送邮件
  pSpeedMailer->SendMail("[e-mail]",  // 发件人邮箱
     "[e-mail]",  // 收件人邮箱
     "主题：你好!",    // 主题
     "正文：大家好才是真的好!", // 正文
     "smtp.163.com");   // SMTP服务器
 }
 CoUninitialize();
}

看了上述代码您肯定会说真的很容易，这个例子是利用了ISpeedMailer接口来发送简单的邮件，我想大家一看就清楚。
为了使这个流程看起来不至于令人生畏，我把异常捕捉省略了，在实际使用中应该加入异常捕捉，具体方法请见下文。

1.3 异常捕捉
这里的异常捕捉与我们所使用的捕获COM异常没有两样，在这里稍加描述只是提高本文的完整性,请看如下代码：

try
{
 ...
 ... 发送代码
 ...
}
catch( _com_error & e)
{
 cerr << "错误号: 0x" << hex << e.Error() << endl;
 cerr << "错误信息: " << e.ErrorMessage() << endl;
 cerr << "错误描述: " << e.Description() << endl;
}

二、邮件发送篇

下图是本文附带的邮件发送程序运行效果图:


2.1 利用IMessage接口发送带附件的邮件

在前面我们用ISpeedMailer接口来发送邮件，但功能有限，IMessage接口为我们提供了功能完备的发送功能，请看下面的例子：

jmail::IMessagePtr pMessage("JMail.Message");

// 发件人邮箱
pMessage->From = "[e-mail]";

// 发件人姓名
pMessage->FromName = "我的名字";

// 添加收件人1, 无收件人姓名与PGP KEY
pMessage->AddRecipient("[e-mail]","","");

// 添加收件人2, 无PGP KEY
pMessage->AddRecipient("[e-mail]","收件人名字","");

// 添加收件人3，这里的PGP KEY只是作为示例，实际中需要用PGP软件生成
pMessage->AddRecipient("[e-mail]","收件人名字","R9Rb7decrQWINuce3uFc0xDG");

// 优先级设置,1-5逐次降低, 3为中级
pMessage->Priority = 3;

// 编码方式设置, 默认是iso-8859-1
pMessage->Charset = "GB2312";

// 主题
pMessage->Subject = "邮件主题";

// 正文
pMessage->Body = "邮件正文\r\n";

// 如有必要，可以再添加一些正文
pMessage->AppendText("VC知识库欢迎您! 祝您身体健康!");

// 添加附件
pMessage->AddAttachment("C:\\CONFIG.SYS", VARIANT_FALSE, "application/octet-stream");
pMessage->AddAttachment("C:\\test.gif", VARIANT_TRUE, "image/gif");

// 开始发送
pMessage->Send("mailserver.com", VARIANT_FALSE);

2.2 发送HTML格式的邮件

在这里我们需要完成的功能是发送一封带图像的HTML邮件，图像存储在本地邮件附件里，而不是通过远地链接，实现的关键是如何引用
附件中的图像：
在调用AddAttachment时它会返回一个称为content id的字串，比如它返回的是"AABBCCDD",则我们用这种方式
来引用该图像，请看如下代码片断：

......
// 这里添加Body是为了使邮件浏览者在没有切换到HTML时给予提醒
pMessage->Body = "邮件采用HTML格式，请切换到HTML模式。\r\n";

// 添加附件
_bstr_t bstrCID = pMessage->AddAttachment("D:\\logo.gif", VARIANT_TRUE, "image/gif"); // 返回content id

// 根据content id 生成IMG HTML标记
char pImgHTML[200];
strcpy(pImgHTML, "");

// 添加HTML正文内容
pMessage->HTMLBody = "
VC知识库
";
pMessage->AppendHTML("
 ");
pMessage->AppendHTML(pImgHTML);

// 开始发送
pMessage->Send("", VARIANT_FALSE);

关于content id更详细的内容请阅读MIME协议

2.3 特殊邮件头的构造

To,From,Subject,Message-ID,Date,Received等是标准的邮件头，自定义邮件头会自动在前面加X, 例如X-Originating-IP

// 标准邮件头
pMessage->AddNativeHeader("Message-ID", "VCKBASE:ABCDEFG1234567");
pMessage->AddNativeHeader("Date", "1800-1-1");

// 自定义邮件头
pMessage->AddHeader("Originating-IP", "123.345.567.789");  // 给它个假冒伪劣IP
pMessage->AddHeader("Mailer", "MyMailBox 1.0");     // 邮件发送器名称
pMessage->AddHeader("Company", "MyCompany");   // 随便加点定制信息

有时收到邮件的时候会提示：发件人请求一个收条以表示你已经阅读过这封邮件，您愿意发送一个收条吗？
发送这样的信，我们只需要:

pMessage->AddNativeHeader("Disposition-Notification-To", "[e-mail]");

[e-mail]是回复收条的邮箱。

2.4 邮件服务器需要发信认证的处理

一些SMTP服务器需要认证信息，您需要在Send时提供用户名与密码，例如：

pMessage->Send("username:[e-mail]")

2.5 不通过SMTP中继服务器发送邮件

在发信时我们一般把信件提交给SMTP中继服务器，SMTP中继服务器负责和目标邮局联系，并最终将信件提交到收件人所在的邮件服务器。
在没有可利用的SMTP中继服务器时，我们可以将服务器名设置为空，例如：

pMessage->Send("", VARIANT_FALSE);

这样，组件会通过DNS查询目标域（例如：163.com）中的MX记录，直接将信件提交到MX记录中所指定的邮件服务器中。

2.6 经代理网关发送邮件

上文所说的SMTP中继服务器上的邮件传输代理程序(MTA)，与WINGATE,CPROXY等代理软件提供的SMTP代理工作原理是一样的，
所以具体的发送过程也一样，例如：
代理网关地址 192.16.10.11, 要往[e-mail]发信，代码如下：

......
pMessage->AddRecipient("[e-mail]","","");
pMessage->Send("192.16.10.11", VARIANT_FALSE);

2.7 关于邮件的加密传输与集群发送

JMail的免费版本并没有提供加密传输与集群发送功能，要想使用这些功能，您需要安装无限制的JMail标准版或专业版。
对于加密传输，您还需要安装PGP软件，例如：PGPFreeware
集群发送功能在拥有成千上万个客户时是非常有用的，定制好模板后，数据库中的记录自动填入模板生成信件发送。
由于笔者只有免费版本的JMail,所以这一功能未能尝试。

虽然免费版未提供集群发送功能，但我们可以只使用IMessage接口结合数据库来实现集群发送功能.

2.8 邮件发送时的常见错误

当所设置的SMTP服务器不存在，错误信息：
The message was undeliverable. All servers failed to receive the message

如果没有设置SMTP服务器时，试图发送一封错误邮件地址的信,
例如：[e-mail] 将返回如下错误信息：
WSAGetLastError() returned 11001, Host not found

许多SMTP服务器不支持转发，或支持转发但不转发MAIL FROM不是本地帐号的信，错误信息：
The message was undeliverable. All servers failed to receive the message

许多SMTP服务器不接收外部的邮件，例如smtp.sohu.com，所以想要向SOHU发信你可以不设邮件服务器, 而是通过
DNS查询邮件交换服务器，或者直接将邮件服务器设置为sohumx.sohu.com。

像SOHU信箱会对一些发件人信箱进行过滤，例如您将发件人信箱设为[e-mail],或者发件人信箱与收件人信箱一致，
发信时将返回：554:Sender address rejected:Access denied

(未完待续...)