当你需要在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公司 http://www.dimac.net/
VC知识库 http://www.vckbase.com/tools
1.2 快速邮件发送程序MINI版
我们从这个小例子大致了解一下JMail组件的工作过程
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
#import "jmail.dll" // 导入jmail.dll, 假如jmail.dll不在工程目录下,您需要写上完整路径
void main()
{
CoInitialize(NULL); // COM的初始化
{
// 创建SpeedMailer实例
jmail::ISpeedMailerPtr pSpeedMailer("JMail.SpeedMailer");
// 发送邮件
pSpeedMailer->SendMail("yourmail@163.com", // 发件人邮箱
"webmaster@163.com", // 收件人邮箱
"主题:你好!", // 主题
"正文:大家好才是真的好!", // 正文
"smtp.163.com"); // SMTP服务器
}
CoUninitialize();
}
|
为了使这个流程看起来不至于令人生畏,我把异常捕捉省略了,在实际使用中应该加入异常捕捉,具体方法请见下文。
1.3 异常捕捉
这里的异常捕捉与我们所使用的捕获COM异常没有两样,在这里稍加描述只是提高本文的完整性,请看如下代码:
1
2
3
4
5
6
7
8
9
10
11
12
|
try
{
...
... 发送代码
...
}
catch( _com_error & e)
{
cerr << "错误号: 0x" << hex << e.Error() << endl;
cerr << "错误信息: " << e.ErrorMessage() << endl;
cerr << "错误描述: " << e.Description() << endl;
}
|
二、邮件发送篇
下图是本文附带的邮件发送程序运行效果图:
2.1 利用IMessage接口发送带附件的邮件
在前面我们用ISpeedMailer接口来发送邮件,但功能有限,IMessage接口为我们提供了功能完备的发送功能,请看下面的例子:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
jmail::IMessagePtr pMessage("JMail.Message");
// 发件人邮箱
pMessage->From = "mymail@mydomain.com";
// 发件人姓名
pMessage->FromName = "我的名字";
// 添加收件人1, 无收件人姓名与PGP KEY
pMessage->AddRecipient("yourmail1@yourdomain.com","","");
// 添加收件人2, 无PGP KEY
pMessage->AddRecipient("yourmail2@yourdomain.com","收件人名字","");
// 添加收件人3,这里的PGP KEY只是作为示例,实际中需要用PGP软件生成
pMessage->AddRecipient("yourmail3@yourdomain.com","收件人名字","R9Rb7decrQWINuce3uFc0xDG");
// 优先级设置,1-5逐次降低, 3为中级
pMessage->Priority = 3;
// 编码方式设置, 默认是iso-8859-1
pMessage->Charset = "GB2312";
// 主题
pMessage->Subject = "邮件主题";
// 正文
pMessage->Body = "邮件正文rn";
// 如有必要,可以再添加一些正文
pMessage->AppendText("VC知识库www.VCKBASE.com欢迎您! 祝您身体健康!");
// 添加附件
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",则我们用<IMG SRC="cid:AABBCCDD">这种方式 来引用该图像,请看如下代码片断:
2.3 特殊邮件头的构造 To,From,Subject,Message-ID,Date,Received等是标准的邮件头,自定义邮件头会自动在前面加X, 例如X-Originating-IP
发送这样的信,我们只需要:
2.4 邮件服务器需要发信认证的处理 一些SMTP服务器需要认证信息,您需要在Send时提供用户名与密码,例如:
2.5 不通过SMTP中继服务器发送邮件 在发信时我们一般把信件提交给SMTP中继服务器,SMTP中继服务器负责和目标邮局联系,并最终将信件提交到收件人所在的邮件服务器。 在没有可利用的SMTP中继服务器时,我们可以将服务器名设置为空,例如:
2.6 经代理网关发送邮件 上文所说的SMTP中继服务器上的邮件传输代理程序(MTA),与WINGATE,CPROXY等代理软件提供的SMTP代理工作原理是一样的, 所以具体的发送过程也一样,例如: 代理网关地址 192.16.10.11, 要往yourmail@yourdomain.com发信,代码如下:
JMail的免费版本并没有提供加密传输与集群发送功能,要想使用这些功能,您需要安装无限制的JMail标准版或专业版。 对于加密传输,您还需要安装PGP软件,例如:PGPFreeware 集群发送功能在拥有成千上万个客户时是非常有用的,定制好模板后,数据库中的记录自动填入模板生成信件发送。 由于笔者只有免费版本的JMail,所以这一功能未能尝试。 虽然免费版未提供集群发送功能,但我们可以只使用IMessage接口结合数据库来实现集群发送功能. 2.8 邮件发送时的常见错误 当所设置的SMTP服务器不存在,错误信息: The message was undeliverable. All servers failed to receive the message 如果没有设置SMTP服务器时,试图发送一封错误邮件地址的信, 例如:webmaster@sohusohu.com 将返回如下错误信息: 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信箱会对一些发件人信箱进行过滤,例如您将发件人信箱设为test@163.com,或者发件人信箱与收件人信箱一致, 发信时将返回:554<test@163.com>:Sender address rejected:Access denied (未完待续...)
上文《利用JMail组件快速构建邮件程序(上)》中介绍了邮件的发送,本文将介绍邮件的接收过程,示例代码运行效果图如下: 三、邮件接收篇 3.1 利用IPOP3接收邮件 接收邮件时用到的接口是IPOP3, 首先连接上邮件服务器,从Messages中得到邮件信息集合,然后就可以通过遍历集合取得每条Message中的具体内容。 请看如下代码:
3.2、实现类似Foxmail的远程管理功能 Foxmail的远程管理功能非常好用,特别是面对垃圾邮件成灾的时候,如果直接收取全部邮件内容无疑会浪费宝贵的时间,所以只要读取邮件头的信息我们就可以进行取舍,我们可以利用JMail提供的DownloadHeaders方法来实现这样的功能,请参考如下代码:
3.3、邮件头详细信息的读取 通过IMessage::Headers得到邮件头对象,然后用IHeaders::GetText()得到全部头部信息,或者用IHeaders::GetHeader()得到指定的头部信息,例如:
3.4、通过代理接收邮件 通过POP3代理收邮件,程序代码不需要变动,只需将邮件服务器设置为代理服务器地址,帐号后面加上真实POP3主机的地址即可,例如:代理服务器地址192.16.10.1,需要收取test@163.com中的信, 则设置如下: 邮件服务器: 192.16.10.1 帐号: test#pop3.163.com 3.5、邮件的删除 在上面我们曾经讲到删除单个邮件的方法:DeleteSingleMessage(long MessageID),如果想清空邮箱则只需要执行DeleteMessages(), 详细请参考3.2中的代码。 3.6、一点说明 IPOP3的DownloadMessages方法可以收取所有邮件中的所有数据,当我们通过Connect连接上服务器后,如果不执行DownloadMessages或者DownloadHeaders,则在执行pMessages->Item[i];时它会动态从服务器读取当前该封邮件的全部数据。 四、关于程序的分发 在发行你的程序时不需安装整个JMail,只需将jmail.dll注册一下即可。 例如:regsvr32.exe c:windowssystem32jmail.dll (全文完) |