FunGame-Core/Library/Common/Network/MailObject.cs

using System.Net.Mail;
using Milimoe.FunGame.Core.Api.Transmittal;
using Milimoe.FunGame.Core.Library.Constant;

namespace Milimoe.FunGame.Core.Library.Common.Network
{
    public class MailObject
    {
        /// <summary>
        /// 发件人邮箱
        /// </summary>
        public string Sender { get; } = "";

        /// <summary>
        /// 发件人名称
        /// </summary>
        public string SenderName { get; } = "";

        /// <summary>
        /// 邮件主题
        /// </summary>
        public string Subject { get; } = "";

        /// <summary>
        /// 邮件内容
        /// </summary>
        public string Body { get; } = "";

        /// <summary>
        /// 邮件优先级
        /// </summary>
        public MailPriority Priority { get; } = MailPriority.Normal;

        /// <summary>
        /// 内容是否支持HTML
        /// </summary>
        public bool HTML { get; } = true;

        /// <summary>
        /// 收件人列表
        /// </summary>
        public List<string> ToList { get; } = [];

        /// <summary>
        /// 抄送列表
        /// </summary>
        public List<string> CCList { get; } = [];

        /// <summary>
        /// 密送列表
        /// </summary>
        public List<string> BCCList { get; } = [];

        public MailObject()
        {

        }

        /// <summary>
        /// 使用MailSender工具类创建邮件对象
        /// </summary>
        /// <param name="sender"></param>
        public MailObject(MailSender sender)
        {
            this.Sender = sender.SmtpClientInfo.SenderMailAddress;
            this.SenderName = sender.SmtpClientInfo.SenderName;
        }

        /// <summary>
        /// 使用地址和名称创建邮件对象
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="senderName"></param>
        public MailObject(string sender, string senderName)
        {
            this.Sender = sender;
            this.SenderName = senderName;
        }

        /// <summary>
        /// 使用地址和名称创建邮件对象，同时写主题、内容、单个收件人
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="subject"></param>
        /// <param name="body"></param>
        /// <param name="to"></param>
        public MailObject(MailSender sender, string subject, string body, string to)
        {
            this.Sender = sender.SmtpClientInfo.SenderMailAddress;
            this.SenderName = sender.SmtpClientInfo.SenderName;
            this.Subject = subject;
            this.Body = body;
            ToList.Add(to);
        }

        /// <summary>
        /// 使用地址和名称创建邮件对象，同时写主题、内容、单个收件人、单个抄送
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="subject"></param>
        /// <param name="body"></param>
        /// <param name="to"></param>
        /// <param name="cc"></param>
        public MailObject(MailSender sender, string subject, string body, string to, string cc)
        {
            this.Sender = sender.SmtpClientInfo.SenderMailAddress;
            this.SenderName = sender.SmtpClientInfo.SenderName;
            this.Subject = subject;
            this.Body = body;
            ToList.Add(to);
            CCList.Add(cc);
        }

        /// <summary>
        /// 完整的创建邮件对象
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="subject"></param>
        /// <param name="body"></param>
        /// <param name="priority"></param>
        /// <param name="html"></param>
        /// <param name="toList"></param>
        /// <param name="ccList"></param>
        /// <param name="bccList"></param>
        public MailObject(MailSender sender, string subject, string body, MailPriority priority, bool html, string[] toList, string[]? ccList = null, string[]? bccList = null)
        {
            Sender = sender.SmtpClientInfo.SenderMailAddress;
            SenderName = sender.SmtpClientInfo.SenderName;
            Subject = subject;
            Body = body;
            Priority = priority;
            HTML = html;
            AddTo(toList);
            if (ccList != null) AddCC(ccList);
            if (bccList != null) AddBCC(bccList);
        }

        /// <summary>
        /// 发送邮件
        /// -- 适合创建一次性邮件并发送 --
        /// </summary>
        /// <param name="sender"></param>
        /// <returns></returns>
        public MailSendResult Send(MailSender sender)
        {
            return sender.Send(this);
        }

        /// <summary>
        /// 添加收件人
        /// </summary>
        /// <param name="to"></param>
        public void AddTo(string to)
        {
            if (!ToList.Contains(to)) ToList.Add(to);
        }

        /// <summary>
        /// 添加多个收件人
        /// </summary>
        /// <param name="to"></param>
        public void AddTo(params string[] to)
        {
            foreach (string t in to) AddTo(t);
        }

        /// <summary>
        /// 添加抄送
        /// </summary>
        /// <param name="cc"></param>
        public void AddCC(string cc)
        {
            if (!CCList.Contains(cc)) CCList.Add(cc);
        }

        /// <summary>
        /// 添加多个抄送
        /// </summary>
        /// <param name="cc"></param>
        public void AddCC(params string[] cc)
        {
            foreach (string c in cc) AddCC(c);
        }

        /// <summary>
        /// 添加密送
        /// </summary>
        /// <param name="bcc"></param>
        public void AddBCC(string bcc)
        {
            if (!BCCList.Contains(bcc)) BCCList.Add(bcc);
        }

        /// <summary>
        /// 添加多个密送
        /// </summary>
        /// <param name="bcc"></param>
        public void AddBCC(params string[] bcc)
        {
            foreach (string b in bcc) AddBCC(b);
        }
    }
}