8.邮件发送功能

  • 8.邮件发送功能已关闭评论
  • 137 次浏览
  • A+
所属分类:.NET技术
摘要

这里想补充下上个文章,感觉有点不太行。因为每次设计新的表结构就要去更新一下,所以,干脆随着我要做的功能去展示我的表结构设计,最终再把所有的表结构包括sql语句统计出来,感觉这样更新会方便很多~

这里想补充下上个文章,感觉有点不太行。因为每次设计新的表结构就要去更新一下,所以,干脆随着我要做的功能去展示我的表结构设计,最终再把所有的表结构包括sql语句统计出来,感觉这样更新会方便很多~

这个文章主要是发送邮件的功能。之前提过,我不是一下子把后端全部完成,然后再一下子搞定后端。所以我前后端是要一起做,然后去完善接口功能。

登录注册这个功能,90%网站都需要。可以不用,但是不能没有。本篇文章主要是实现注册的验证码发放功能(邮件or手机号)。

因为发短信得收费,咳咳,所以这里先做的邮件发送验证码。这个在网络冲浪的时候要注册某些网站账号的时候一般都会遇上把?之前看有的朋友是后台返回一张验证码的图片,这个我后面应该也会做一下,但我觉得意义不是特别大。就跟死验证一样,这样我怎么判定你输入的邮箱是否是正确真实可用的呢?我不想给数据库搞一堆脏数据,麻烦

之前微软是自带一个邮箱发送的库的,现在好像弃用了,虽然还可以用。但是微软推荐了一个新的开源的第三方库MailKit。使用起来相对来说,代码减少了不少,感觉挺好用的,官网也有案例,所以不会细说,官网的很详细,我也不想写博客都是搬运官网的。我的代码会加上自己的注释。哪怕你不看官网,跟着我这个流程走就100%没问题。

正文开始~ 

先展示下,验证码表的数据库结构:注释说明都有应该无需细说了

8.邮件发送功能

 建表SQL

8.邮件发送功能8.邮件发送功能

create table  dbo.AutoCode (        Id                INT identity(1, 1) not null  /*编号*/,        Code              VARCHAR(20) not null  /*验证码*/,        Phone             VARCHAR(20) null  /*手机号*/,        Email             VARCHAR(100) null  /*邮箱*/,        ExpDate           FLOAT not null  /*过期时间*/,        CreateDate        DATETIME default getdate() null  /*创建日期*/,        UpdateDate        DATETIME default getdate() null  /*修改日期*/ ); alter  table dbo.AutoCode        add constraint PK_AutoCode_Id primary key (Id); EXEC sp_addextendedproperty 'MS_Description', '验证码表', 'user', dbo, 'table', AutoCode, NULL, NULL; EXEC sp_addextendedproperty 'MS_Description', '编号', 'user', dbo, 'table', AutoCode, 'column', Id; EXEC sp_addextendedproperty 'MS_Description', '验证码', 'user', dbo, 'table', AutoCode, 'column', Code; EXEC sp_addextendedproperty 'MS_Description', '手机号', 'user', dbo, 'table', AutoCode, 'column', Phone; EXEC sp_addextendedproperty 'MS_Description', '邮箱', 'user', dbo, 'table', AutoCode, 'column', Email; EXEC sp_addextendedproperty 'MS_Description', '过期时间 (当前时间+过期时间)的时间戳', 'user', dbo, 'table', AutoCode, 'column', ExpDate; EXEC sp_addextendedproperty 'MS_Description', '创建日期 默认为当前时间', 'user', dbo, 'table', AutoCode, 'column', CreateDate; EXEC sp_addextendedproperty 'MS_Description', '修改日期 默认为当前时间', 'user', dbo, 'table', AutoCode, 'column', UpdateDate;

View Code

 使用SQLsugar生成实体到FastEasy.Model类库中。

这里插一句吧,前面不是用T4模板搞了个生成仓储模式4个类的代码生成吗,我可能目前对于T4还是不是很会,在T4模板使用第三方库的时候会报一个找不到netstand程序集的问题,我目前很疑惑。然后看了下别人的代码生成器,好像通过后台管理系统就可以,那目前可能我弄的这个还不是很好,但是也极大的减少了一些工作量,以后我会再学习下这块儿,也搞个更方便的代码生成器。T4模板确实有一些局限性……

那我是又在base基类添加了一个方法,CreateModels。我这个数据库空空如也,所以选择了全部生成,当然也可以根据条件去筛选生成,甚至重命名,修改字段名,诸如此类的。这是sqlsugar提供的,真的很强大,可以去学习一下。中秋的时候阿妮亚又更新了一个功能,可以把增删改写成一个方法,但我目前还是没看,只是看到了介绍,这个以后再去看一下,nb~

8.邮件发送功能

代码只有一句:第一个参数是生成的目录路径,第二个是命名空间
    public void CreateModels()     {         db.DbFirst.IsCreateAttribute().CreateClassFile(@"D:FastEasyAPIFastEasy.ModelModels", "FastEasy.Model.Models");     }

 如何使用呢。因为是要继承base基类,所以得有个实体,所以我就手动创建了一个空的base类。然后用T4代码生成器分别生成了仓储层和服务层的接口和实现类。主要是避免没有泛型传入,注入的时候报错。然后直接调用这个方法就好了,base类在这里没有作用!只是避免注入解析的时候不报错!

其实应该稍微感觉的出来这样好像有点麻烦……无奈现在手里活不够多,经验欠缺,暂时没有想到别的思路,但我们有代码生成器,终归也麻烦不到哪去,一分钟就搞定了

8.邮件发送功能

 到这里,我们生成了实体,然后通过T4代码生成器,同样根据数据库生成了各自的仓储层和服务层。这里就不得不提一个弊端了。但是这只能说目前的,就是要先生成实体,因为T4模板不需要运行就可以生成,所以没实体的话,依赖注入会找不到实体而报错,这样就没法运行程序生成实体了。除非就是说,咱们搞个控制台程序单独运行下?反正上边也提到了,这个T4我弄的确实不到位,只是最基础的一些功能,还需继续完善呀~~~


 

言归正传,这篇文章主要说的是发送邮件!

上面简单提到了,我们使用的是微软推荐的一个第三方库:MailKit+MimeKit。NuGet管理器自行下载。

MailKit是用于向邮箱服务端发送消息的。

MimeKit则是创建邮件实例的(包括并不局限:发送人接收人邮件内容等……)。

再简单点理解就是,通过MailKIt把MimeKit创建的邮件实例发送给邮箱服务端,然后根据你的邮件实例解析发送相应的邮件。似乎我这么说有点绕嘴,但我是这么理解的。甚至一开始我都很好奇,为什么要分成两个包安装呀,或者你内置进去呗?不过他这些个库不仅仅支持你发送邮件,好像还能下载邮件,删除邮件,挺多功能的,确实np,但这些我好像也用不上,有兴趣的同学就自行学习吧~

实现注册发送邮件验证码的功能。其实很简单。首先搞清楚,我们需要的情景是如何的:

  1. 用户填写邮箱
  2. 发送验证码到邮箱
  3. 正则匹配输入的是否正确格式
  4. 生成随机验证码
  5. 新增到数据库
  6. 返回结果给前端成功还是失败

正则也没啥可说的,因为你百度邮箱正则就找到了匹配规则拿过来用就好了。随机验证码这个更没什么可说的Random……当然你可以搞更复杂的,但我觉得我这样应该足够了。

我把这两个方法写在了Common类库中。因为他们不涉及业务逻辑,是可公用的。因此做成静态类方法直接调用就好。

        /// <summary>         /// 检验是否手机号         /// </summary>         /// <param name="number">号码</param>         /// <returns></returns>         public static bool IsPhone(string number)         {             string phoneRegex = @"^1d{10}$";             return Regex.IsMatch(number, phoneRegex);         }          /// <summary>         /// 检验是否邮箱         /// </summary>         /// <param name="number">号码</param>         /// <returns></returns>         public static bool IsEmail(string number)         {             string emailRegex = @"^S+@S+.S+$";             return Regex.IsMatch(number, emailRegex);         }

        /// <summary>         /// 创建一个4位随机验证码         /// </summary>         /// <returns></returns>         public static string CreateRandomCode()         {             int num = 4;             const string chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"; // 根据需要修改字符集合             Random random = new();             char[] code = new char[num];              for (int i = 0; i < num; i++)             {                 code[i] = chars[random.Next(chars.Length)];             }             return new string(code);         }

 

包括发送邮件的功能,也理所应当的放在Common类库中。目前因为针对发送邮件的功能,可能封装的方法自由度不高,我贴的代码只做参考,可以根据自己需求完善
邮件实例是用MimeKit中的MimeMessage创建的。里面包含了发送人,接收人,邮件内容等。原本我想传递这个类型的参数,但是官方的这个实例中,发送人和接收人是不能直接赋值的,要Add添加进去。这对我们来说还是有点麻烦的 ,主要是传参太麻烦了。所以自己创建了一个新的实体类型Mime,主要用来传递参数。
using MimeKit;  namespace FastEasy.Common.Extension.Mail {     public class Mime     {         /// <summary>         /// 主题         /// </summary>         public string Subject { get; set; }          /// <summary>         /// 消息内容         /// </summary>         public TextPart Body { get; set; }          /// <summary>         /// 发送人,默认为“官方”         /// </summary>         public MailboxAddress From { get; set; } = new MailboxAddress("神里凌华", "XXXXXX@163.com");          /// <summary>         /// 邮箱SMTP授权码         /// </summary>         public string Code { get; set; } = "XXXXX";          /// <summary>         /// 接收人         /// </summary>         public MailboxAddress To { get; set; }          /// <summary>         /// 465加密25不加密         /// </summary>         public  int Port { get; set; } = 465;     } }

 发送邮件方法:通过上面的注释应该都可以看懂,所以不过多解释废话了

        /// <summary>         /// 发送邮件         /// </summary>         /// <param name="mime">邮件消息体</param>         /// <returns></returns>         public static async Task<bool> SendMail(Mime mime)         {             //邮件实例             MimeMessage message = new()             {                                 Subject = mime.Subject,                 Body = mime.Body,             };             message.To.Add(mime.To);             message.From.Add(mime.From);             try             {                 using var client = new SmtpClient();                 client.Connect("smtp.163.com", mime.Port, mime.Port == 465);                 client.Authenticate(mime.From.Address, mime.Code);                 await client.SendAsync(message);                 client.Disconnect(true);             }             catch             {                 return false;             }             return true;         }

 

由此看来,该功能并未涉及程序本身的业务逻辑,因此只要在API程序层调用相应的公共方法,然后调用基类的新增方法即可完成。
API程序层代码:
 

        /// <summary>         /// 发送验证码         /// </summary>         /// <param name="user">邮箱或者手机号</param>         /// <returns></returns>         [HttpPost]         [SwaagerRoute(SwaggerVersion.FastEasy, "CreateCode")]         public async Task<ResultDto> CreateCode(string user)         {             var result = new ResultDto();             var code = RandomCode.CreateRandomCode();              if (RegexMatch.IsPhone(user))             {                 result.State = false;                 result.Message = "暂不支持手机号注册";             }             else if (RegexMatch.IsEmail(user))             {                 var mime = new Mime                 {                     Body = new MimeKit.TextPart()                     {                         Text = code                     },                     Subject = "验证码",                     To = new MimeKit.MailboxAddress(user, user),                 };                 var autocode = new AutoCode                 {                     Code = code,                     CreateDate = DateTime.Now,                     Email = user,                     ExpDate = DateTimeOffset.Now.AddMinutes(10).ToUnixTimeSeconds(),                     UpdateDate = DateTime.Now                 };                 if (await EmailKit.SendMail(mime) && await service.CreateEntityAsync(autocode))                 {                     result.State = true;                     result.Message = "发送成功请查收";                 }                 else                 {                     result.State = false;                     result.Message = "发送失败";                 }             }             else             {                 result.State = false;                 result.Message = "请输入正确的注册号码";             };             return result;         }

我承认我废话太多了,我本意想讲的详细点……看效果:

8.邮件发送功能

 掰掰,中秋国庆快乐……我还没买到票……