深入Lumisoft.NET实现邮件发送功能的方法详解
在前面的一些文章中，有介绍过DotNet内置SMTP类的邮件发送功能，附件、嵌入图片的模式都有介绍，本文继续介绍Lumisoft.NET这个非常优秀的开源组件，用该组件来设计开发邮件工具，将变得更加方便，功能更加强大。网上很多文章基本介绍如何使用该组件来收取邮件较多，较少介绍使用该组件做邮件发送功能的。本文主要探寻使用该组件实现邮件的发送功能，邮件发送有两种方式，一种是不用发件人即可发送邮件，一种是使用发件人账户密码和SMTP服务器来实现邮件发送的，本文分别对这两种方式进行介绍。
组件下载地址：http://www.lumisoft.ee/lswww/download/downloads/
组件论坛地址：http://www.lumisoft.ee/Forum/default.aspx?g=forum
秉承一贯的做法，先贴出相关的实现图形，感官认识下，在进入详细的介绍说明，以求达到最好的理解深度。
1、 首先是发件人的设置，可以从文本文件的导出，以及新建等操作，以方便用户操作。
2、 内容也支持导入导出，并且保存到数据库，方便进行记录及操作等，另外可以对内容进行随机混淆，混淆的内容在HTML邮件中式隐藏的，方便糊弄一下服务器的识别。
3、 邮件发送可以选择两种方式，下面将分别介绍这两种方式的实现，一种采用该控件封装非常好的邮件直投技术，不需要SMTP账号发送的；一种是普通的SMTP发送方式。当然我们还可以设置更多的参数，例如邮件尾部信息、HTML内容提示、 以及一些发送期间自动拨号的设置操作等。
4、 邮件直投技术，通过模拟账户来附加用户的邮件地址（或者可以成为伪装）。其中我填写了一些常用的SMTP服务器的域名，方便在其中构造合乎要求的邮件格式，还可以设置邮件回执通知，如下图所示。
5、 如果是采用普通发送方式，那么就需要制定用户的账号密码等信息，发送的时候，自动从启动获取发件人信息进行批量发送操作。
6、 最后体验一下少量邮件的发送效果，发送采用多线程发送，多线程采用比较有名的SmartThreadPool组件，并且发送过程总详细记录其中的日志，供参考。
介绍完毕相关的功能效果图，下面我们来分析下主要功能实现的代码：
private TimerHelper timer = null;
private void btnSend_Click(object sender, EventArgs e)
{
//重置计数变量
failedItems = 0;
successItems = 0;
workItemsCompleted = 0;
workItemsGenerated = 0;
Portal.gc.FailedCount = 0;//重置失败次数
STPStartInfo stpStartInfo = new STPStartInfo();
stpStartInfo.IdleTimeout = 10;
stpStartInfo.MaxWorkerThreads = 100;
stpStartInfo.MinWorkerThreads = 0;
//stpStartInfo.StartSuspended = true;
_smartThreadPool = new SmartThreadPool(stpStartInfo);
_workItemsGroup = _smartThreadPool;
workItemsProducerThread = new Thread(new ThreadStart(this.WorkItemsProducer));
workItemsProducerThread.IsBackground = true;
workItemsProducerThread.Start();
RefreshStatusCount();
int intervalRedial = SystemConfig.Default.IntervalRedial * 1000 * 60;
if (intervalRedial > 0)
{
if (timer != null)
{
timer.Stop();
timer.Dispose();
}
timer = new TimerHelper(intervalRedial,false);
timer.Execute += new TimerHelper.TimerExecution(timer_Execute);
timer.Start();
}
}
private static object locker = new object();
private void timer_Execute()
{
if (Monitor.TryEnter(locker))
{
string message = string.Format("在时间 {0} 时刻执行了一次重拨号操作！", DateTime.Now);
ShowSendStatus(message);
string RasName = SystemConfig.Default.RasName;
if (!string.IsNullOrEmpty(RasName))
{
message = string.Format("正在准备重新拨号（{0}）", RasName);
ShowSendStatus(message);
Portal.gc.ReConnect(RasName);
Portal.gc.FailedCount = 0;//重新归零
}
Monitor.Exit(locker);
}
else
{
Monitor.Enter(locker);
Monitor.Exit(locker);
}
}
上面是主要的任务生成操作以及相关的拨号操作，其中任务详细的生成代码如下所示。
private void WorkItemsProducer()
{
CallCtrlWithThreadSafetyEx.SetText(this.txtSendDetail, "");
EnableControl(false, true, true);
string message = string.Format("任务开始");
RecordMessage(message);
#region 生成任务
IWorkItemsGroup workItemsGroup = _workItemsGroup;
if (null == workItemsGroup)
{
return;
}
List<string> addressList = GetAddressList();
List<MyMailInfo> mailInfoList = GetMailInfo();
for (int i = 0; i < addressList.Count; i++)
{
try
{
SendJobInfo jobInfo = new SendJobInfo();
jobInfo.domainList = mailDomainList;
jobInfo.mailTo = addressList[i];
jobInfo.mailInfo = GetOneMail(mailInfoList, i);
jobInfo.ShowSendStatus = ShowSendStatus;
jobInfo.currentDomain = (i % mailDomainList.Count);//设置一个标志，默认那个账户开始发送
jobInfo.UseDirectSendType = SystemConfig.Default.EmailDirectSend;
//如果用户未指定发送账号，那么采用默认的显示名称
//如果为空，发送的时候，会自动采用邮件地址作为显示名称
if (string.IsNullOrEmpty(SystemConfig.Default.UserEmailFrom))
{
jobInfo.mailFromDisplay = SystemConfig.Default.DefaultFromDisplayName;
}
workItemCallback = new WorkItemCallback(this.DoWork);
workItemsGroup.QueueWorkItem(workItemCallback, jobInfo);
Thread.Sleep(100);
}
catch (ObjectDisposedException ex)
{
LogTextHelper.WriteLine(ex.ToString());
continue;
}
Interlocked.Increment(ref workItemsGenerated);
}
#endregion
RefreshStatusCount();
message = string.Format("共有 {0} 个任务，还剩下 {1} 个",
workItemsGenerated, workItemsGenerated - workItemsCompleted);
CallCtrlWithThreadSafetyEx.SetText(this, message);
RecordMessage(message);
try
{
//workItemsGroup.Start();
workItemsGroup.WaitForIdle();
_smartThreadPool.Shutdown();
}
catch (Exception ex)
{
LogTextHelper.WriteLine(ex.ToString());
}
UpdateFinishStatus();
}
由于采用了多线程来处理，所以停止发送的时候，需要把相关的线程对象进行释放，如下代码所示。
private void btnStop_Click(object sender, EventArgs e)
{
try
{
_smartThreadPool.Shutdown();
_smartThreadPool.Dispose();
_smartThreadPool = null;
if (timer != null)
{
timer.Stop();
timer.Dispose();
}
}
catch (Exception ex)
{
LogTextHelper.WriteLine(ex.ToString());
}
UpdateFinishStatus();
}
其中具体的邮件发送功能封装在SendJobInfo中，通过判断不同的类型，进行不同的发送操作。
其中最为关键的发送代码，就是如何利用LumiSoft.NET组件来构造相应的邮件对象，下面先先介绍下邮件直投的发送方式，由于该组件封装比较好，直投发送方式很简单：
Mail_Message message = Create_PlainText_Html_Attachment_Image(mailTo, mailFrom, mailFromDisplay);
SMTP_Client.QuickSend(message);
其中Create_PlainText_Html_Attachment_Image的封装函数详细内容如下所示：
代码
private Mail_Message Create_PlainText_Html_Attachment_Image(string mailTo, string mailFrom, string mailFromDisplay)
{
Mail_Message msg = new Mail_Message();
msg.MimeVersion = "1.0";
msg.MessageID = MIME_Utils.CreateMessageID();
msg.Date = DateTime.Now;
msg.From = new Mail_t_MailboxList();
msg.From.Add(new Mail_t_Mailbox(mailFromDisplay, mailFrom));
msg.To = new Mail_t_AddressList();
msg.To.Add(new Mail_t_Mailbox(mailTo, mailTo));
msg.Subject = mailInfo.Title;
//设置回执通知
string notifyEmail = SystemConfig.Default.DispositionNotificationTo;
if (!string.IsNullOrEmpty(notifyEmail) && ValidateUtil.IsEmail(notifyEmail))
{
msg.DispositionNotificationTo = new Mail_t_Mailbox(notifyEmail, notifyEmail);
}
#region MyRegion
//--- multipart/mixed -----------------------------------
MIME_h_ContentType contentType_multipartMixed = new MIME_h_ContentType(MIME_MediaTypes.Multipart.mixed);
contentType_multipartMixed.Param_Boundary = Guid.NewGuid().ToString().Replace('-', '.');
MIME_b_MultipartMixed multipartMixed = new MIME_b_MultipartMixed(contentType_multipartMixed);
msg.Body = multipartMixed;
//--- multipart/alternative -----------------------------
MIME_Entity entity_multipartAlternative = new MIME_Entity();
MIME_h_ContentType contentType_multipartAlternative = new MIME_h_ContentType(MIME_MediaTypes.Multipart.alternative);
contentType_multipartAlternative.Param_Boundary = Guid.NewGuid().ToString().Replace('-', '.');
MIME_b_MultipartAlternative multipartAlternative = new MIME_b_MultipartAlternative(contentType_multipartAlternative);
entity_multipartAlternative.Body = multipartAlternative;
multipartMixed.BodyParts.Add(entity_multipartAlternative);
//--- text/plain ----------------------------------------
MIME_Entity entity_text_plain = new MIME_Entity();
MIME_b_Text text_plain = new MIME_b_Text(MIME_MediaTypes.Text.plain);
entity_text_plain.Body = text_plain;
//普通文本邮件内容，如果对方的收件客户端不支持HTML，这是必需的
string plainTextBody = "如果你邮件客户端不支持HTML格式，或者你切换到“普通文本”视图，将看到此内容";
if (!string.IsNullOrEmpty(SystemConfig.Default.PlaintTextTips))
{
plainTextBody = SystemConfig.Default.PlaintTextTips;
}
text_plain.SetText(MIME_TransferEncodings.QuotedPrintable, Encoding.UTF8, plainTextBody);
multipartAlternative.BodyParts.Add(entity_text_plain);
//--- text/html -----------------------------------------
string htmlText = mailInfo.Content;//"<html>这是一份测试邮件，<img src=\"cid:test.jpg\">来自<font color=red><b>LumiSoft.Net</b></font></html>";
MIME_Entity entity_text_html = new MIME_Entity();
MIME_b_Text text_html = new MIME_b_Text(MIME_MediaTypes.Text.html);
entity_text_html.Body = text_html;
text_html.SetText(MIME_TransferEncodings.QuotedPrintable, Encoding.UTF8, htmlText);
multipartAlternative.BodyParts.Add(entity_text_html);
//--- application/octet-stream -------------------------
foreach (string attach in mailInfo.Attachments)
{
multipartMixed.BodyParts.Add(Mail_Message.CreateAttachment(attach));
}
foreach (string imageFile in mailInfo.EmbedImages)
{
MIME_Entity entity_image = new MIME_Entity();
entity_image.ContentDisposition = new MIME_h_ContentDisposition(MIME_DispositionTypes.Inline);
string fileName = DirectoryUtil.GetFileName(imageFile, true);
entity_image.ContentID = BytesTools.BytesToHex(Encoding.Default.GetBytes(fileName));
MIME_b_Image body_image = new MIME_b_Image(MIME_MediaTypes.Image.jpeg);
entity_image.Body = body_image;
body_image.SetDataFromFile(imageFile, MIME_TransferEncodings.Base64);
multipartMixed.BodyParts.Add(entity_image);
}
#endregion
return msg;
}
如果使用普通的账号方式发送SMTP邮件，主要代码如下所示，其中可以看出是利用了命令方式一步步和服务器进行交互的。
using (SMTP_Client client = new SMTP_Client())
{
int port = domainInfo.Ssl ? WellKnownPorts.SMTP_SSL : WellKnownPorts.SMTP;
if (domainInfo.Port > 0)
{
port = domainInfo.Port;
}
client.Connect(domainInfo.SmtpServer, port, domainInfo.Ssl);
client.Authenticate(domainInfo.Username, domainInfo.Password);
//string text = client.GreetingText;
client.MailFrom(mailFrom, -1);
client.RcptTo(mailTo);
MemoryStream stream = Create_Html_Attachment_Image(mailTo, mailFrom, mailFromDisplay);
client.SendMessage(stream);
client.Disconnect();
}
其中构造邮件内容的代码和刚才的部分类似，详细代码如下所示。
private MemoryStream Create_Html_Attachment_Image(string mailTo, string mailFrom, string mailFromDisplay)
{
Mime m = new Mime();
MimeEntity mainEntity = m.MainEntity;
mainEntity.From = new AddressList();
mainEntity.From.Add(new MailboxAddress(mailFromDisplay, mailFrom));
mainEntity.To = new AddressList();
mainEntity.To.Add(new MailboxAddress(mailTo, mailTo));
mainEntity.Subject = mailInfo.Title;
mainEntity.ContentType = MediaType_enum.Multipart_mixed;
MimeEntity textEntity = mainEntity.ChildEntities.Add();
textEntity.ContentType = MediaType_enum.Text_html;
textEntity.ContentTransferEncoding = ContentTransferEncoding_enum.QuotedPrintable;
textEntity.DataText = mailInfo.Content;
.........................
MemoryStream msg = new MemoryStream();
m.ToStream(msg);
msg.Position = 0;
return msg;
}
利用Lumisoft.NET这个组件，可以实现很多相关的邮件操作，这里介于兴趣及篇幅原因，主要介绍邮件发送的功能模块，其中贴出的代码，一个是为了和感兴趣的朋友相互交流，一个也是为了自己今后做一个借鉴，并不鼓励大家用此软件或者代码来大批量发送垃圾邮件。