一個簡易郵件羣發軟件設計與實現

1 需求概述

指定一批郵箱地址，使用指定的郵箱發送指定的內容。

2 功能需求

配置文件配置用於發送的郵箱信息
郵件發送功能
日誌窗口輸出顯示

3 界面接口

郵件列表框
標題內容輸入框
發送按鈕
日誌輸出框

4 技術選型

.Net 4.0 C# Winform

5 實現

5.1 新建項目

項目命名爲 SimpleEmailSender

5.2 在項目中添加配置文件

配置發件郵箱信息

<configuration>
  <appSettings>
    <add key="email_stmp" value="smtp.****.com"/>
    <add key="send_user_email" value="****@****"/>
    <add key="send_user_pass" value="密碼"/>
    <add key="send_user_disp" value="發件人暱稱" />
  </appSettings>
</configuration>

5.3 製作界面

根據界面接口需求，界面佈局如下：

5.4 郵件發送輔助類

首先完成輔助類開發，最後再跟界面對接完成流程。
因爲讀取了配置文件，需要添加 System.Configuration 程序集的引用。

定義 MailHelper 輔助類，讀取配置參數，向外提供發送郵件功能方法 SendMail。

using System;
using System.Collections.Generic;
using System.Configuration;
using System.Linq;
using System.Net.Mail;
using System.Text;

namespace SimpleEmailSender
{
    public class MailHelper
    {
        public static String EMAIL_USERNAME = ConfigurationManager.AppSettings["send_user_email"];
        public static String EMAIL_DISPNAME = ConfigurationManager.AppSettings["send_user_disp"];
        public static String EMAIL_PASSWORD = ConfigurationManager.AppSettings["send_user_pass"];
        public static String EMAIL_SMTP = ConfigurationManager.AppSettings["email_stmp"];
        public static ValidateResult SendMail(string email, string name, string content)
        {
            return SendMail("系統消息", email, name, content);
        }

        /// <summary>
        /// 發送郵件
        /// </summary>
        /// <param name="title">郵件標題</param>
        /// <param name="email">收件人地址</param>
        /// <param name="name">收件人名稱</param>
        /// <param name="content">郵件內容</param>
        public static ValidateResult SendMail(string title, string email, string name, string content)
        {
            MailAddress from = new MailAddress(EMAIL_USERNAME, EMAIL_DISPNAME); 
            MailMessage mail = new MailMessage();
            //設置郵件的標題
            mail.Subject = title;

            //設置郵件的發件人
            //Pass:如果不想顯示自己的郵箱地址，這裏可以填符合mail格式的任意名稱，真正發mail的用戶不在這裏設定，這個僅僅只做顯示用
            mail.From = from;

            //設置郵件的收件人
            mail.To.Add(new MailAddress(email, name));

            //設置郵件的內容
            mail.Body = content;

            //設置郵件的格式
            mail.BodyEncoding = System.Text.Encoding.UTF8;
            mail.IsBodyHtml = true;
            //設置郵件的發送級別
            mail.Priority = MailPriority.Normal;

            mail.DeliveryNotificationOptions = DeliveryNotificationOptions.OnSuccess;

            SmtpClient client = new SmtpClient();
            //設置用於 SMTP 事務的主機的名稱，填IP地址也可以了
            client.Host = EMAIL_SMTP; 
            //設置用於 SMTP 事務的端口，默認的是 25
            client.Port = 25;
            client.UseDefaultCredentials = false;
            //這裏纔是真正的郵箱登陸名和密碼
            client.Credentials = new System.Net.NetworkCredential(EMAIL_USERNAME, EMAIL_PASSWORD);
            client.DeliveryMethod = SmtpDeliveryMethod.Network;
            //都定義完了，正式發送了，很是簡單吧！


            ValidateResult vr = new ValidateResult(true, "發送成功！");
            try
            {
                client.Send(mail);
                return vr;
            }
            catch (Exception e)
            {
                vr.IsValid = false;
                vr.Message = e.Message;
                return vr;
            }
        }
    }

    public class ValidateResult
    {
        public bool IsValid { get; set; }
        public string Message { get; set; }

        public ValidateResult() {  
        }

        public ValidateResult(bool v, string m)
        {
            IsValid = v;
            Message = m;
        }
    }
}

5.5 清單解析

對於郵箱列表，使用正則表達式從文本框中匹配郵箱形成 List<string> emailList 給後續執行。這樣，對郵箱列表文本框中輸入的格式就沒什麼要求，從其它地方複製粘貼進來，由程序完成格式化顯示即可。

        /// <summary>
        /// 提取郵件列表
        /// </summary>
        /// <param name="mails"></param>
        /// <returns></returns>
        private List<string> ParseEmailList(string mails)
        {
            List<string> list = new List<string>();
            var mc = Regex.Matches(mails, @"\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+", RegexOptions.IgnoreCase);

            foreach (Match c in mc)
            {
                list.Add(c.Value);
            }
            return list;
        }

5.6 日誌輸出方法準備

在日誌框中輸出內容，爲了能在線程中調用，使用了 Invoke 方式執行。

/// <summary>
/// 日誌輸出支持線程中執行
/// </summary>
/// <param name="message"></param>
private void Log(string message)
{
    Invoke(new MethodInvoker(delegate
    {
        txtLog.AppendText(message + "\r\n");
    }));
}

5.7 線程發送

發送方案設計

基本描述：給定郵箱列表，標題與內容，以線程方式執行發送，給出執行統計與狀態。
具體實現：使用線程池，但一組做爲一個任務，全部完成才接收下一個任務，通過完成數量與郵箱列表長度的比較來判斷是否全部完成，信息通過日誌輸出的方式查看，形式上通過回調將日誌信息傳遞給調用者。

爲此，這裏專門定義一個發送器，在應用中，定義一個實例來發起任務。儘管只定義一個實例，但這裏並不需要定義爲設計模式中的單例模式，事實上，它是可以多實例運行。具體代碼說話！

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading;

namespace SimpleEmailSender
{
    public class EmailSender
    {
        #region 運行時數據
        // 郵箱列表
        private List<string> _EmailList = new List<string>();
        // 完成數量
        private volatile int _OverCount = 0;
        // 郵件標題
        private string _Title;
        // 郵件內容
        private string _Content;
        // 完成回調（主要是爲了寫日誌）
        private Action<string> _Callback;
        #endregion

        /// <summary>
        /// 是否全部完成
        /// </summary>
        /// <returns></returns>
        public bool IsOver()
        {
            return _OverCount == _EmailList.Count;
        }

        /// <summary>
        /// 發起任務（如果不符合發起條件，則返回 false）
        /// </summary>
        /// <param name="emails"></param>
        /// <param name="title"></param>
        /// <param name="content"></param>
        /// <param name="callback"></param>
        /// <returns></returns>
        public bool Send(List<string> emails, string title, string content, Action<string> callback)
        {
            if (!IsOver())
            {
                return false;
            }

            _EmailList = emails;
            _OverCount = 0;
            _Title = title;
            _Content = content;
            _Callback = callback;

            Start();
            return true;
        }

        /// <summary>
        /// 啓動任務
        /// 
        /// 以線程池方式運行，每個郵箱不論成敗完成數加1，並回調通知。
        /// </summary>
        private void Start()
        {
            foreach (string email in _EmailList)
            {
                var _email = email;
                ThreadPool.QueueUserWorkItem(t =>
                {
                    var vr = MailHelper.SendMail(_Title, _email, "", _Content);
                    _OverCount++;
                    _Callback(String.Format("進度[{3}/{4}] {0} 發送 {1}，返回：{2}", _email, vr.IsValid ? "成功" : "失敗", vr.Message, _OverCount, _EmailList.Count));
                });
            }
        }


    }
}

5.8 按鈕事件

發送按鈕執行的流程爲：如果之前的任務尚未完成，則等待。否則，首先提取郵箱列表，並格式化顯示，然後發起任務，觀察日誌即可。

        private EmailSender _Sender = new EmailSender(); 

        // 發送按鈕
        private void btnSend_Click(object sender, EventArgs e)
        {
            if (!_Sender.IsOver())
            {
                Log("之前的任務尚未完成，請等待完成！");
                return;
            }

            // 1. 提取郵件列表並格式化顯示
            string mails = txtEmailList.Text.Trim();
            var list = ParseEmailList(mails);
            // 2. 格式化顯示一下
            txtEmailList.Clear();
            foreach (var mail in list)
            {
                txtEmailList.AppendText(mail + "\r\n");
            }
            // 3. 發起任務
            var b = _Sender.Send(list, txtTitle.Text.Trim(), txtContent.Text, Log);
            Log(b ? "發起成功" : "發起失敗");
        }

6 運行結果

6.1 配置信息錯誤時

6.2 配置信息正確時

7 項目源代碼

https://github.com/triplestudio/SimpleEmailSender

一個簡易郵件羣發軟件設計與實現

1 需求概述

2 功能需求

3 界面接口

4 技術選型

5 實現

6 運行結果

7 項目源代碼

效率工具-掃一掃、搜設備

C# 與 Go 的互通代碼筆記

一分鐘圖表：簡易統計圖表模型設計與實現

C# 調用百度 API 活體檢測

去除圖片背景保留人物或其它前景事物

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結