VC中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公司 http://www.dimac.net/
VC知识库 http://www.vckbase.com/tools

1.2 快速邮件发送程序MINI版

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

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

void main()
{
	CoInitialize(NULL); 	// COM的初始化
	{
		// 创建SpeedMailer实例
		jmail::ISpeedMailerPtr pSpeedMailer("JMail.SpeedMailer");	
		
		// 发送邮件
		pSpeedMailer->SendMail("[email protected]",		// 发件人邮箱
					"[email protected]",		// 收件人邮箱
					"主题:你好!",				// 主题
					"正文:大家好才是真的好!",	// 正文
					"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 = "[email protected]";

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

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

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

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

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

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

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

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

// 如有必要,可以再添加一些正文
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">这种方式
来引用该图像,请看如下代码片断:
......
// 这里添加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, "<IMG SRC=''cid:");
strcat(pImgHTML, (char*)bstrCID);
strcat(pImgHTML, "''>");

// 添加HTML正文内容
pMessage->HTMLBody = "<H2>VC知识库</H2>";
pMessage->AppendHTML("<BR>www.VCKBASE.com ");
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", "[email protected]");
[email protected]是回复收条的邮箱。

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


一些SMTP服务器需要认证信息,您需要在Send时提供用户名与密码,例如:
pMessage->Send("username:[email protected]")

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, 要往[email protected]发信,代码如下:
......
pMessage->AddRecipient("[email protected]","","");
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服务器时,试图发送一封错误邮件地址的信,
例如:[email protected] 将返回如下错误信息:
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信箱会对一些发件人信箱进行过滤,例如您将发件人信箱设为[email protected],或者发件人信箱与收件人信箱一致,
发信时将返回:554<[email protected]>:Sender address rejected:Access denied
 

你可能感兴趣的:(VC中JMail组件的应用(上))