Masuit.Tools/Masuit.Tools.Abstractions/Models/Email.cs

using Masuit.Tools.Systems;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Mail;

namespace Masuit.Tools.Models;

public class Email : Disposable
{
    /// <summary>
    /// 发件人用户名
    /// </summary>
    public EmailAddress Username { get; set; }

    /// <summary>
    /// 发件人邮箱密码
    /// </summary>
    public string Password { get; set; }

    /// <summary>
    /// 发送服务器端口号，默认25
    /// </summary>
    public int SmtpPort { get; set; } = 25;

    /// <summary>
    /// 发送服务器地址
    /// </summary>
    public string SmtpServer { get; set; }

    /// <summary>
    /// 邮件标题
    /// </summary>
    public string Subject { get; set; }

    /// <summary>
    /// 邮件正文
    /// </summary>
    public string Body { get; set; }

    /// <summary>
    /// 收件人，多个收件人用英文逗号隔开
    /// </summary>
    public string Tos { get; set; }

    public List<string> CC { get; set; } = new List<string>();

    public List<string> BCC { get; set; } = new List<string>();

    /// <summary>
    /// 是否启用SSL，默认已启用
    /// </summary>
    public bool EnableSsl { get; set; } = true;

    /// <summary>
    /// 附件
    /// </summary>
    public List<Attachment> Attachments { get; set; } = new List<Attachment>();

    private MailMessage _mailMessage;

    private MailMessage MailMessage => _mailMessage ?? GetClient();

    /// <summary>
    /// 邮件消息对象
    /// </summary>
    private MailMessage GetClient()
    {
        if (string.IsNullOrEmpty(Tos)) return null;
        _mailMessage = new MailMessage();

        //多个接收者
        foreach (var str in Tos.Split(','))
        {
            _mailMessage.To.Add(str);
        }

        foreach (var s in CC)
        {
            _mailMessage.CC.Add(s);
        }

        foreach (var s in BCC)
        {
            _mailMessage.Bcc.Add(s);
        }

        _mailMessage.From = new MailAddress(Username, Username);
        _mailMessage.Subject = Subject;
        _mailMessage.Body = Body;
        _mailMessage.IsBodyHtml = true;
        _mailMessage.BodyEncoding = System.Text.Encoding.UTF8;
        _mailMessage.SubjectEncoding = System.Text.Encoding.UTF8;
        _mailMessage.Priority = MailPriority.High;
        foreach (var item in Attachments.AsNotNull().Where(a => a is not null))
        {
            _mailMessage.Attachments.Add(item);
        }

        return _mailMessage;
    }

    private SmtpClient SmtpClient => new()
    {
        UseDefaultCredentials = false,
        EnableSsl = EnableSsl,
        Host = SmtpServer,
        Port = SmtpPort,
        Credentials = new System.Net.NetworkCredential(Username, Password),
        DeliveryMethod = SmtpDeliveryMethod.Network,
    };

    //回调方法
    private Action<string> _actionSendCompletedCallback;

    /// <summary>
    /// 使用异步发送邮件
    /// </summary>
    /// <param name="completedCallback">邮件发送后的回调方法</param>
    /// <returns></returns>
    public void SendAsync(Action<string> completedCallback)
    {
        if (MailMessage == null) return;

        //发送邮件回调方法
        _actionSendCompletedCallback = completedCallback;
        SmtpClient.SendCompleted += SendCompletedCallback;
        SmtpClient.SendAsync(MailMessage, "true"); //异步发送邮件,如果回调方法中参数不为"true"则表示发送失败
    }

    /// <summary>
    /// 使用同步发送邮件
    /// </summary>
    public void Send()
    {
        if (MailMessage == null) return;
        SmtpClient.Send(MailMessage); //异步发送邮件,如果回调方法中参数不为"true"则表示发送失败
        Dispose(true);
    }

    /// <summary>
    /// 异步操作完成后执行回调方法
    /// </summary>
    /// <param name="sender"></param>
    /// <param name="e"></param>
    private void SendCompletedCallback(object sender, System.ComponentModel.AsyncCompletedEventArgs e)
    {
        //同一组件下不需要回调方法,直接在此写入日志即可
        //写入日志
        if (_actionSendCompletedCallback == null) return;
        string message;
        if (e.Cancelled)
        {
            message = "异步操作取消";
        }
        else if (e.Error != null)
        {
            message = $"UserState:{(string)e.UserState},Message:{e.Error}";
        }
        else
        {
            message = (string)e.UserState;
        }

        //执行回调方法
        _actionSendCompletedCallback(message);
        Dispose(true);
    }

    /// <summary>
    /// 释放
    /// </summary>
    /// <param name="disposing"></param>
    public override void Dispose(bool disposing)
    {
        _mailMessage?.Dispose();
        SmtpClient?.Dispose();
        Attachments?.ForEach(a => a?.Dispose());
    }
}