发送邮件

文档目录

 

• 简介
• IEmailSender
  • ISmtpEmailSender
  • NullEmailSender
• 配置
• 集成 MailKit
  • 安装
  • 集成
  • 用法
  • 定制

 

简介

发送邮件是一个很经常使用的任务，几乎每一个应用都须要。Abp提供了一个基本的框架，用于简单地发送邮件并为它分离出了邮件服务的配置。

 

IEmailSender

它是一个你无需了解它的细节就能简单地用来发送邮件的服务，用法以下所示：

public class TaskManager : IDomainService
{
    private readonly IEmailSender _emailSender;     public TaskManager(IEmailSender emailSender)
    {
        _emailSender = emailSender;
    }

    public void Assign(Task task, Person person)
    {
        //Assign task to the person
        task.AssignedTo = person;

        //Send a notification email
 _emailSender.Send( to: person.EmailAddress, subject: "You have a new task!", body: $"A new task is assigned for you: <b>{task.Title}</b>", isBodyHtml: true );
    }
}

咱们简单地注入IEmailSender，并使用Send方法，该方法有几个重载版本，其中也有能接受MailMessage对象的重载（.net core里不能用，由于.net core不包含SmtpClient和MailMessage）。

 

ISmtpEmailSender

一样也有一个ISmtpEmailSender，它扩展了IEmailSender，添加了BuildClient方法，用来建立一个SmtpClient，而后能够直接使用SmtpClient（.net core里不能用，由于.net core不包含SmtpClient和MailMessage）。大部分状况下使用ISmtpEmailSender就已足够。

 

NullEmailSender

NullEmailSender是IEmailSender 的Null对象设计模式的实现，可用在单元测试和属性依赖注入中。

 

配置

邮件发送使用了设置管理系统来读取邮件发送的配置，全部设置的名称都以常量的形式定义在Abp.Net.Mail.EmailSettingNames类里。下列是它的值和描述：

• Abp.Net.Mail.DefaultFromAddress：默认的邮件发送者的地址（如上面的示例）。
• Abp.Net.Mail.DefaultFromDisplayName：默认的邮件发送者显示的名称（如上面的示例）。
• Abp.Net.Mail.Smtp.Host: SMTP服务器的IP或域名（默认为127.0.0.1）。
• Abp.Net.Mail.Smtp.Port: SMTP服务器的端口（默认为25）。
• Abp.Net.Mail.Smtp.UserName: 当SMTP服务器要求认证时，须要提供的用户名。
• Abp.Net.Mail.Smtp.Password: 当SMTP服务器要求认证时，须要提供的密码。
• Abp.Net.Mail.Smtp.Domain: 当SMTP服务器要求认证时，须要提供的域名。
• Abp.Net.Mail.Smtp.EnableSsl: 代表一个SMTP服务器是（true）否（false）须要使用SSL链接（默认为false）。
• Abp.Net.Mail.Smtp.UseDefaultCredentials: 为True时使用默认的凭证代替提供的用户和密码（默认为true）。

 

集成 MailKit

因为.net core不支持标准的System.Net.Mail.SmtpClient，因此咱们须要第三方供应商来发送邮件，幸运地是，MailKit 是默认的Smtpclient的一个很好的代替，并且微软也建议使用它。

Abp.MailKit 包优雅地集成到了Abp的邮件发送系统里，因此，你仍可像前面的方式经过MailKit使用IEmailSender。

 

安装

首先，安装Abp.MailKit 包到你的项目：

Install-Package Abp.MailKit

 

集成

添加AbpMailKitModule 依赖到你的模块：

[DependsOn(typeof(AbpMailKitModule))] public class MyProjectModule : AbpModule
{
    //...
}

 

用法

你能够像前面描述的那样使用IEmailSender，由于Abp.MailKit包为它注册了MailKit的实现。也使用上面定义的配置。

 

定制

在建立MailKit的SmtpClient时，你可能会有额外的配置或本身的定制，此时，你能够用你本身的实现替换IMailKitSmtpBuilder 接口的注册，不过能够经过继承DefaultMailKitSmtpBuilder 更简单。好比，你想为全部的SSL链接提供一个凭证，这种状况下，你能够重写ConfigureClient方法，以下所示：

public class MyMailKitSmtpBuilder : DefaultMailKitSmtpBuilder
{
    public MyMailKitSmtpBuilder(ISmtpEmailSenderConfiguration smtpEmailSenderConfiguration) 
        : base(smtpEmailSenderConfiguration)
    {
    }

    protected override void ConfigureClient(SmtpClient client)
    {
        client.ServerCertificateValidationCallback = (sender, certificate, chain, errors) => true;         base.ConfigureClient(client);
    }
}

而后在你的模块的PreInitialize方法中用你上面的实现替换IMailKitStmpBuilder接口的实现：

[DependsOn(typeof(AbpMailKitModule))]
public class MyProjectModule : AbpModule
{
    public override void PreInitialize()
    {
        Configuration.ReplaceService<IMailKitSmtpBuilder, MyMailKitSmtpBuilder>();
    }

    //...
}

（记得添加"using Abp.Configuration.Startup;"声明，由于ReplaceService 的扩展方法定义在这个命名空间里）。