Spring Boot 配置邮件发送

1.前言

       邮件发送这一功能在实际的项目中使用的是非常普遍的，用户忘记账户、忘记密码等很多操作都是通过邮件的方式来交互，因此邮件发送在 web 开发中是必不可少一个功能模块，本文就主要介绍如何在Spring boot中发送不同类型的邮件。

2.Spring Boot配置步骤

       Spring 本身提供了很好用的org.springframework.mail.javamail.JavaMailSender接口来实现邮件发送功能。Spring boot中也为此提供了自动化配置，所以我们使用起来非常方便。

Ⅰ.添加依赖

  首先在pom.xml文件中添加如下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>

Ⅱ.修改配置文件

  添加依赖之后就需要在项目配置文件application.properties中配置发送邮件相关的参数，具体如下：

spring.mail.host=smtp.163.com
spring.mail.username=xxx
spring.mail.password=xxx
spring.mail.default-encoding=UTF-8
# 启动如果报错：530。则还需要配置一个SSL安全链接(eg:比如qq邮箱则需要ssl配置)
spring.mail.properties.mail.smtp.ssl.enable=true

重要的参数就这些，其它的使用默认的即可，以下为解释：

• spring.mail.host：邮箱服务器地址，这个根据自己使用什么邮箱有区别，比如：
  • smtp.163.com：163邮箱
  • smtp.126.com：126邮箱
  • smtp.qq.com：qq邮箱
• spring.mail.username：邮箱登陆用户名。
• spring.mail.password：第三方登陆授权码（下面会具体介绍该授权码的获取方式）。
• spring.mail.default-encoding：编码方式

Ⅲ.POP3/SMTP服务

       上面提到了授权码的概念，首先要明确一个概念就是授权码跟我们直接登陆邮箱的密码不是一样的，授权码可以理解为第三方客户端登陆邮箱的密码，要想获取授权码需要我们去自己所用邮箱的官网设置开启POP3/SMTP以及IMAP/SMTP服务，我这里就以自己使用的163账号为例介绍打开该服务以及获取授权码的步骤，如图：

       登陆163邮箱官网，按照图示步骤进行操作，在选择了服务之后会给你发送验证码，输入验证码之后就会让你自己设置授权码，这里的授权码就是上边配置文件中spring.mail.password需要填写的值。

提示： qq邮箱设置：登录邮箱，然后在设置---->账户---->POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务----> 生成授权码执行一系列操作即可(如果发送失败的话，建议以上开启那些服务)。

Ⅳ.封装邮件工具类

  对邮件的操作最好是封装一个类以便代码重用以及维护，我这里封装成一个service层。

1.定义接口IMailService.interface：

package com.web.springbootmail.service;
/** * @author Promise * @createTime 2019年3月30日 下午3:14:14 * @description */
public interface IMailService {
   

    /** * 简单文本邮件 * @param toUser 邮件接收者 */
    void simpleMil(String toUser)throws Exception;

    /** * html邮件 * @param toUser 邮件接收者 */
    void htmlMail(String toUser) throws Exception;

    /** * 带附件邮件 * @param toUser 邮件接收者 */
    void attachmentMail(String toUser)throws Exception;

    /** * 带图片邮件 * @param toUser 邮件接收者 */
    void imgMail(String toUser)throws Exception;

    /** * 模板邮件 * @param toUser 邮件接收者 */
    void TemplateMail(String toUser)throws Exception;

}

2.实现类MailServiceimpl.java:

package com.web.springbootmail.service.impl;

import java.io.File;

import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.FileSystemResource;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;
import org.thymeleaf.TemplateEngine;
import org.thymeleaf.context.Context;

import com.web.springbootmail.service.IMailService;

/** * @author Promise * @createTime 2019年3月30日 下午3:14:37 * @description 邮件发送服务类 */
@Service("mailService")
public class MailServiceImpl implements IMailService{
   

    @Autowired
    private JavaMailSender jms;

    @Autowired
    private TemplateEngine templateEngine;

    @Value("${spring.mail.username}")
    private String from;

    @Override
    public void simpleMil(String toUser) {
   

    }

    @Override
    public void htmlMail(String toUser) {
   
        // TODO Auto-generated method stub

    }

    @Override
    public void attachmentMail(String toUser) {
   
        // TODO Auto-generated method stub

    }

    @Override
    public void imgMail(String toUser) {
   
        // TODO Auto-generated method stub

    }

    @Override
    public void TemplateMail(String toUser) {
   
        // TODO Auto-generated method stub

    }
}

 这里只给出了框架，具体实现下面依次介绍，上面还注入了三个变量：

• jms：邮件发送接口
• templateEngine：发送模板邮件时解析模板
• from：读取配置文件中配置的邮件发送者的账号

下面介绍每一种邮件的具体实现：

2.1.简单文本邮件

这一类邮件最简单，使用SimpleMailMessage对象，代码如下：

@Override
public void simpleMil(String toUser) {
   
    // TODO Auto-generated method stub
    //初始化简单邮件对象
    SimpleMailMessage message = new SimpleMailMessage();
    //邮件发送者
    message.setFrom(from);
    //邮件接收者
    message.setTo(toUser);
    //邮件标题
    message.setSubject("简单邮件");
    //邮件内容
    message.setText("简单内容");
    //发送邮件
    jms.send(message);
}

2.2 html邮件

这一类邮件使用的是MimeMessage对象，可丰富页面样式，代码如下：

@Override
public void htmlMail(String toUser) throws MessagingException {
   
    // TODO Auto-generated method stub
    MimeMessage message = jms.createMimeMessage();
    MimeMessageHelper helper = new MimeMessageHelper(message, true);
    helper.setFrom(from);
    helper.setTo(toUser);
    helper.setSubject("html格式邮件");
    //内容为html格式
    String content = "<p style='color:yellow;'>这是一封html格式的文件</p><h1>这是一封html格式的文件</h1>";
    //true表示以html格式发送邮件
    helper.setText(content, true);
    jms.send(message);
}

2.3 带附件的邮件

这一类邮件多了添加附件的过程，也使用MimeMessage对象，代码如下：

@Override
public void attachmentMail(String toUser) throws MessagingException {
   
    // TODO Auto-generated method stub
    MimeMessage message = jms.createMimeMessage();
    MimeMessageHelper helper = new MimeMessageHelper(message, true);
    helper.setFrom(from);
    helper.setTo(toUser);
    helper.setSubject("带附件邮件");
    //加载绝对路径资源
    FileSystemResource fs = new FileSystemResource(new File("D:\\DownLoad\\file\\阿里巴巴Java开发手册v1.2.0.pdf"));
    helper.setText("这是一封带附件的邮件！");
    //添加附件资源
    helper.addAttachment("阿里巴巴Java开发手册v1.2.0.pdf", fs);
    helper.addAttachment("高清图片.jpg", new File("C:\Users\a\Desktop\Docker基础命令.png"));
    jms.send(message);
}

2.4 带图片的邮件

这一类邮件多了添加图片的过程，也使用MimeMessage对象，代码如下：

@Override
public void imgMail(String toUser) throws MessagingException {
   
    // TODO Auto-generated method stub
    MimeMessage message = jms.createMimeMessage();
    MimeMessageHelper helper = new MimeMessageHelper(message, true);
    helper.setFrom(from);
    helper.setTo(toUser);
    helper.setSubject("带图片邮件");
    //设置资源的cid
    String content = "<html><body>博客头像<img src='cid:img'/></body></html>";
    helper.setText(content, true);
    FileSystemResource fs = new FileSystemResource(new File("D:\\DownLoad\\img\\20171123181522_c48800.jpg"));
    //和上边的cid要对应
    helper.addInline("img", fs);
    jms.send(message);
}

其实这种方式也是html邮件，只是多了静态资源，比如我们这里就在页面上添加了一张图片，步骤跟添加附件有点类似，但是需要注意的是静态资源需要给静态资源设置cid，以便存在多个静态资源区分。

2.5 模板邮件

       模板邮件指的是邮件的主体内容都是一样的，只是有一部分不一样，这样我们就可以定义一个邮件的模板，发送邮件的时候我们直接传入参数就可以了，是一种很好的封装。

       这里我使用的模板解析框架为 thymeleaf，所以需要先在项目pom.xml文件中添加 Thymeleaf 依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

接下来在src/main/resources/templates目录下新建MailTemplate.html文件，内容如下：

<!DOCTYPE html>
<html lang="zh" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8"/>
<title>Insert title here</title>
</head>
<body>
    <h2>您好,<span th:text="${username}"></span>:这是来自测试的邮件模板！</h2>
</body>
</html>

使用具体代码如下：

@Override
public void TemplateMail(String toUser) throws MessagingException {
   
    // TODO Auto-generated method stub
    MimeMessage message = jms.createMimeMessage();
    MimeMessageHelper helper = new MimeMessageHelper(message, true);
    helper.setFrom(from);
    helper.setTo(toUser);
    helper.setSubject("模板邮件");
    Context context = new Context();
    //给模板传入参数，username要与模板中变量名一致，promise为测试数据
    context.setVariable("username", "追梦者");
    //thymeleaf模板默认会从src/main/resources/tempaltes目录下寻找文件，填入我们定义的模板名，不需要写后缀。
    String template = templateEngine.process("MailTemplate", context);
    helper.setText(template, true);
    jms.send(message);
}

3.controller调用

  封装好了发送邮件的工具类之后，我们直接在controller调用即可，代码如下：

package com.web.springbootmail.controller;

import java.util.HashMap;
import java.util.Map;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.web.springbootmail.service.IMailService;

/** * @author Promise * @createTime 2019年4月1日 下午9:30:38 * @description 邮件发送 */
@RequestMapping("/mail")
@RestController
public class EmailController {
   

    @Autowired
    private IMailService mailService;

    @GetMapping("/simple")
    public Map<String, Object> sendSimpleMail() {
   
        Map<String, Object> map =new HashMap<>();
        try {
   
            //参数就是接收邮件的邮箱，根据自己实际填写
            mailService.simpleMil("*****@qq.com");
            map.put("res", "success");
        } catch (Exception e) {
   
            // TODO Auto-generated catch block
            e.printStackTrace();
            map.put("res", "error");
        }
        return map;
    }

    @GetMapping("/htmlMail")
    public Map<String, Object> htmlMail(){
   
        Map<String, Object> map =new HashMap<>();
        try {
   
            mailService.htmlMail("*****@qq.com");
            map.put("res", "success");
        } catch (Exception e) {
   
            // TODO Auto-generated catch block
            e.printStackTrace();
            map.put("res", "error");
        }
        return map;
    }

    @GetMapping("/attachmentsMail")
    public Map<String, Object> attachmentsMail(){
   
        Map<String, Object> map =new HashMap<>();
        try {
   
            mailService.attachmentMail("*****@qq.com");
            map.put("res", "success");
        } catch (Exception e) {
   
            // TODO Auto-generated catch block
            e.printStackTrace();
            map.put("res", "error");
        }
        return map;
    }

    @GetMapping("/imgMail")
    public Map<String, Object> imgMail(){
   
        Map<String, Object> map =new HashMap<>();
        try {
   
            mailService.imgMail("*****@qq.com");
            map.put("res", "success");
        } catch (Exception e) {
   
            // TODO Auto-generated catch block
            e.printStackTrace();
            map.put("res", "error");
        }
        return map;
    }

    @GetMapping("/templateMail")
    public Map<String, Object> templateMail(){
   
        Map<String, Object> map =new HashMap<>();
        try {
   
            mailService.TemplateMail("*****@qq.com");
            map.put("res", "success");
        } catch (Exception e) {
   
            // TODO Auto-generated catch block
            e.printStackTrace();
            map.put("res", "error");
        }
        return map;
    }
}

4.测试结果

4.1 简单邮件结果

启动项目，访问localhost:8080/mail/simple，此时我的收件箱收到如下邮件：

4.2 html邮件

访问localhost:8080/mail/htmlMail，效果如下：

4.3 带附件邮件

访问localhost:8080/mail/attachmentsMail，效果如下：

4.4 带图片邮件

访问localhost:8080/mail/imgMail，效果如下：

4.5 模板邮件

访问localhost:8080/mail/templateMail，效果如下：

3.结束语

    好了，关于Spring boot配置邮件发送功能就到这里了，感谢阅读，bye~

博主这篇文章写得挺全面的，故转载过来留作学习。

如果本文对你有所帮助，那就给我点个赞呗

End