使用springboot JavaMailSender发送带html格式的邮件，同时支持异步发送邮件

近期在项目中使用到了邮件发送功能，经过各方面的资料搜索完成了这个功能

1.首先在项目中引入springboot发送邮件的依赖，freemarker模板依赖（如果你使用的模板不是freemarker，就引入你对应的模板框架就行了）

 

  
            org.springframework.boot
            spring-boot-starter-mail
  
 
            org.springframework.boot
            spring-boot-starter-freemarker
            2.1.5.RELEASE
 

2.在yml中配置好发送email的各种账号信息，此处根据各自的邮件方式来设置，如果使用qq邮件，则在密码的位置输入的是qq的授权码

3.在代码中注入freemarker和mailSender对象，写下senEmail这个方法

    @Autowired
    private FreeMarkerConfigurer freeMarkerConfigurer;
    @Autowired
    private MailProperties properties;

    @Override
//参数说明  subject 邮件主题
//         templateName 模板名称
//         admin 是我要发送的一个用户对象，这里面其实就只有一些我这个系统中用户的基本信息
//         data  需要写入到模板中的参数
    public void sendEmail(String subject, String templateName, Admin admin, Map data) throws MessagingException, IOException, TemplateException {
        MimeMessage mimeMessage = javaMailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);

        //设置时间
        data.put("date", DateUtil.nowStr());

        //获取模板信息
        Template template = freeMarkerConfigurer.getConfiguration().getTemplate(templateName);
        String text = FreeMarkerTemplateUtils.processTemplateIntoString(template, data);

        helper.setSentDate(DateUtil.now());
        helper.setFrom(properties.getUsername());
        helper.setTo(admin.getEmail());
        helper.setSubject(subject);
        //注意此处，sendText是个重载函数，也可以不带后面这个参数，为true时表示发送html格式的邮       件，为false是为文本模式的邮件，默认为false，也就是文本模式的邮件，最开始就是没注意这一点儿导致发送出去的html格式的邮件全都显示不出来
        helper.setText(text,true);

        javaMailSender.send(mimeMessage);
    }

4.写下模板邮件，放在template文件夹下的 mail/mail.ftl  ，如我写的模板如下

    
    




尊敬的${name}用户：
　　您好！
 　　这是一条验证用户邮箱的注册信息，请在2小时之内进入以下链接，完成密码修改或绑定邮箱功能
    （请千万不要将此链接泄露给他人）:
　　${domain ! ''}/active?update=true&token=${token ! ''}
　　如果浏览器不允许直接跳转，请将地址复制到浏览器的地址栏中访问
    如果您没有***系统管理员，那么这条邮件属于操作人员的失误，请您忽略此消息即可！
    (此邮件为系统自动发送，请勿回复)
*****系统
    ${date ! ''}

5.调用的时候，写下这样一个函数，即可完成邮件发送了

//admin为需要收到邮件的用户
  public void sendForgetPassWordEmail(Admin admin) throws MessagingException, IOException, TemplateException {
        //data为绑定到freemarker模板中的函数
        Map data = new HashMap<>();
        //        map.put("title", "注册通知");
        data.put("name", admin.getAdminName());
        String token = StringUtil.getRandomToken();
        //写入网站域名
        data.put("domain",domain);
        data.put("token",token);
        //把token存储到redis中
        saveToRedis(token, admin);
        //第一个参数为邮件主题，第二个参数为模板路径
        sendEmail("更改密码", "/mail/mail.ftl", admin, data);
    }

6.发送邮件的客户端一定要做行为验证，防止机器恶意的发送邮件，并对访问频率做限制

7.实际操作的时候发现后台发送一封邮件的速度有点慢，因此考虑使用线程池去异步发送，直接返回发送成功的结果给客户端，邮件的发送由服务器端的线程池异步进行，springboot线程池的使用如下

//定义一个线程池的配置类，配置线程池的名称 大小 超时时间 前缀等等信息
@EnableAsync
@Configuration
public class TaskPoolConfigure {

    @Bean("taskExecutor")
    public Executor taskExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(10);
        executor.setMaxPoolSize(20);
        executor.setQueueCapacity(200);
        executor.setKeepAliveSeconds(60);
        executor.setThreadNamePrefix("taskExecutor-");
        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
        return executor;
    }

}

8.在要使用异步发送邮件的方法上只需要加入一个注解即可了

如我是在sendEmail方法上加上 @Async注解即可的  其中的参数是你定义的线程池的名字，比如我定义的线程池名就是"taskExcutor"

//admin为需要收到邮件的用户
@Async("taskExecutor")
public void sendForgetPassWordEmail(Admin admin) throws MessagingException, IOException, TemplateException {
        //data为绑定到freemarker模板中的函数
        Map data = new HashMap<>();
        //        map.put("title", "注册通知");
        data.put("name", admin.getAdminName());
        String token = StringUtil.getRandomToken();
        //写入网站域名
        data.put("domain",domain);
        data.put("token",token);
        //把token存储到redis中
        saveToRedis(token, admin);
        //第一个参数为邮件主题，第二个参数为模板路径
        sendEmail("更改密码", "/mail/mail.ftl", admin, data);
    }

注意：

 如果部署到服务器上，可能出现邮件发送不出去的情况，原因是想阿里云腾讯云的服务器默认都没有开放邮件传输协议的端口 25  ，需要在服务器控制台上手动去放行25端口