使用Spring Boot 发送邮件（持续更新...）-阿里云开发者社区

前言

做大学毕设的时候，SSM项目需要向用户的邮箱发送一个验证码，对于当时的我来说，对于这个问题一点思路都没有，所有查找的资料最后都指向了JavaMail，于是当时就在网上找到了一个相关的代码，经过使用确实是好用的。

package tony.common;

import java.util.Properties;

import javax.mail.Authenticator;
import javax.mail.Message;
import javax.mail.PasswordAuthentication;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;

import com.sun.mail.util.MailSSLSocketFactory;

public class MailUtil implements Runnable{

    private String email;
    private String code;
    public  boolean flag;
    
    public MailUtil(String email,String code){
        this.email=email;
        this.code=code;
    }
    
    public void run() {
        // 1.创建连接对象javax.mail.Session
        // 2.创建邮件对象 javax.mail.Message
        // 3.发送一封激活邮件
        String from = "";// 发件人电子邮箱
        String host = "smtp.qq.com"; // 指定发送邮件的主机smtp.qq.com(QQ)|smtp.163.com(网易)

        Properties properties = System.getProperties();// 获取系统属性

        properties.setProperty("mail.smtp.host", host);// 设置邮件服务器
        properties.setProperty("mail.smtp.auth", "true");// 打开认证

        try {
            //QQ邮箱需要下面这段代码，163邮箱不需要
            MailSSLSocketFactory sf = new MailSSLSocketFactory();
            sf.setTrustAllHosts(true);
            properties.put("mail.smtp.ssl.enable", "true");
            properties.put("mail.smtp.ssl.socketFactory", sf);


            // 1.获取默认session对象
            Session session = Session.getDefaultInstance(properties, new Authenticator() {
                public PasswordAuthentication getPasswordAuthentication() {
                    return new PasswordAuthentication("", ""); // 发件人邮箱账号、授权码
                }
            });

            // 2.创建邮件对象
            Message message = new MimeMessage(session);
            // 2.1设置发件人
            message.setFrom(new InternetAddress(from));
            // 2.2设置接收人
            message.addRecipient(Message.RecipientType.TO, new InternetAddress(email));
            // 2.3设置邮件主题
            message.setSubject("账号激活");
            // 2.4设置邮件内容
            String content = "<html><head></head><body><h2>这是一封来自账号激活的邮件</h2><h1>您的验证码是："
                    + code + "</h2></body></html>";
            message.setContent(content, "text/html;charset=UTF-8");
            // 3.发送邮件
            Transport.send(message);
            System.out.println("邮件成功发送!");
            flag=true;
        } catch (Exception e) {
            e.printStackTrace();
        }
        
    }
    
}

这是对JavaMail最基本的封装，当时我并不知道Spring，以及Spring boot对JavaMail也有特别好的封装。
直到前几天我在慕课网上无意间看到了一个课程讲述的是Spring Boot发送邮件，于是便有了这篇文章，也是对那个课程的总结和整理，原课程视频传送门。在此特别感谢这位作者的分享。

正文

在给出代码之前，我们先看看相关的知识。

邮件使用场景

1.注册验证，需要发送一个验证码，或者一个验证的链接
2.网站营销可以发送推销相关的信息，以及服务。
3.可以在忘记密码的时候发送验证码，例如注册。
4.提醒监控系统。

邮件发送原理

传输协议SMTP 和POP3
内容拓展后：IMAP
下面简单说一下发送文件的原理，这里我用一个例子进行讲解，让大家更容易理解：
假设我现在想通过sina邮箱发送邮件到qq邮箱，那么当我在sina客户端发送了一个邮件之后，邮件通过SMTP 协议到达了新浪的SMTP 服务器，但是它发现自己是要发到qq邮箱的，于是会通过SMTP协议继续路由到qq的SMTP服务器上去，然后这个邮箱继续会进入到POP3 服务器中的对用的这个用户的区域中去，可以给它理解为一个消息队列等待着有对应的客户端来取，然后qq邮件客户端会通过POP3协议去POP3服务器中获取获取邮件的列表，获得后返回给客户端。
下面给出相应代码：
我们首先需要获得一个Maven的空项目，这个可以在以下链接下载到Spring Boot 空项目。
然后我们需要在pom.xml中加入以下依赖。

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

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

一个是对Spring Boot对JavaMail的集成，另一个是对thymeleaf模版引擎的集成（为什么要用这个模版引擎，我会在下面说到）
然后在 application.properties中加入以下代码：

spring.mail.host=smtp.qq.com(SMTP服务器的名字)
spring.mail.username=（邮箱名称）
spring.mail.password = （邮箱密码，这里指的是，在邮箱中打开SMTP/POP3验证之后，会给出一个验证码）
spring.mail.default-encoding=UTF-8（编码格式）
spring.mail.port=465（SMTP服务器开放的端口）
spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory

然后是Java代码，我们写了一个service去完成它：

package com.harry.mail.service;

import com.sun.mail.smtp.DigestMD5;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.FileSystemResource;
import org.springframework.mail.MailSender;
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 javax.annotation.Resource;
import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
import java.io.File;
import java.util.Random;

@Service
public class MailService {

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

    @Autowired
    private JavaMailSender mailSender;

    @Autowired
    private MailSender sender;

    @Resource
    private TemplateEngine templateEngine;

    //这是发送一个文本邮件
    public void sendSimpleMail(String to,String subject,String content){
        SimpleMailMessage mail =new SimpleMailMessage();
        mail.setTo(to);
        mail.setSubject(subject);
        mail.setText(content);
        mail.setFrom(from);
        sender.send(mail);
    }

    //发送html邮件
    public void sendHtmlMail(String to , String subject , String content){
        MimeMessage message =mailSender.createMimeMessage();
        try {
            MimeMessageHelper helper =new MimeMessageHelper(message,true);
            helper.setFrom(from);
            helper.setTo(to);
            helper.setSubject(subject);
            helper.setText(content,true);
            mailSender.send(message);
        } catch (MessagingException e) {
            e.printStackTrace();
        }
    }

    //带有附件的邮件
    //可以把附件装进list集合中，然后放入多个附件
    public void sendAttachmentsMail(String to ,String subject,String content , String filePath){

        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper helper = null;
        try {
            helper = new MimeMessageHelper(message,true);
            helper.setFrom(from);
            helper.setTo(to);
            helper.setSubject(subject);
            helper.setText(content,true);
            FileSystemResource file =new FileSystemResource(new File(filePath));
            String fileName = file.getFilename();
            //在这里可以add 多个附件，我这里就是为了测试说明，放了两个相同的文件，但是名字不同的。
            helper.addAttachment(fileName,file);
            helper.addAttachment(fileName+"_2",file);
            mailSender.send(message);
        } catch (MessagingException e) {
            e.printStackTrace();
        }

    }

    //带有图片的邮件
    public void sendImageMail(String to ,String subject,String content , String filePath,String srcId){

        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper helper = null;
        try {
            helper = new MimeMessageHelper(message,true);
            helper.setFrom(from);
            helper.setTo(to);
            helper.setSubject(subject);
            helper.setText(content,true);
            FileSystemResource file =new FileSystemResource(new File(filePath));
            helper.addInline(srcId,file);
            mailSender.send(message);
        } catch (MessagingException e) {
            e.printStackTrace();
        }

    }
//使用模版发送邮件
    public void sendTemplateMail(String to ,String subject, String content){
        Context context = new Context();
        context.setVariable("validvalue", new Random().nextInt(999999));

        String templateContext = templateEngine.process("emailTemplate",context);
        sendHtmlMail(to,subject,templateContext);
    }
}

我们可以看出来使用模版发送邮件调用了上面的使用html发送邮件的方法，而这个模版就是我们上面要使用的thymeleaf，那么我们为什么需要模版呢，正是因为，我们很多使用场景，大致的内容都是相同的，只是里面的参数不同罢了，就是我们的例子中一样，我们只是想要不同的验证码，没必要每一次都把html代码重新写一遍对吧，下面给出html模版代码：

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>邮件模版</title>
</head>
<body>
    <p>
        你好，欢迎你的到来你的验证码为：
    </p>
    <h3 th:text="${validvalue}"></h3>
</body>
</html>

最后是测试类：
在test文件夹下面建造自己的

package com.harry.mail.service;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import org.thymeleaf.TemplateEngine;

import javax.annotation.Resource;

@RunWith(SpringRunner.class)
@SpringBootTest
public class HelloTest {

    @Autowired
    private MailService mailService;

    @Resource
    private TemplateEngine templateEngine;

    @Test
    public void sendSimpleMailTest(){
        mailService.sendSimpleMail("要发送给你的邮箱账户","主题","内容");
    }

    @Test
    public void sendHtmlMailTest(){
        mailService.sendHtmlMail("要发送给你的邮箱账户","主题","内容（应当为html形式的）");
    }

    @Test
    public void sendAttachment(){

        mailService.sendAttachmentsMail(""要发送给你的邮箱账户","主题","内容","文件的路径");
    }

    @Test
    public void sendImageMail(){
        String srcId = "harryImage";
        String htmlContent = "<html><body><h3>this is a image:</h3> <img src = \'cid:{srcId}\'></body></html>".replace("{srcId}",srcId);
        mailService.sendImageMail("要发送给你的邮箱账户","主题",htmlContent,"图片路径",srcId(赋予图片一个标实码));
    }
    @Test
    public  void sendTemplateMail(){
        mailService.sendTemplateMail("发送到的邮箱账户","主题",null(内容从模版中读，所以为空));
    }
}

我把代码放在了下面github上，如果有需要可以去看一下。
https://github.com/luckypoison/mailProject

后记

在之后，我会把这些代码进行封装然后提供给大家，有什么需要补充的，我也会持续更新在这个文章中，谢谢大家，希望对大家有帮助。

使用Spring Boot 发送邮件（持续更新...）

前言

正文

邮件使用场景

邮件发送原理

后记

热门文章

最新文章

相关课程

相关电子书

相关实验场景

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

使用Spring Boot 发送邮件（持续更新...）

前言

正文

邮件使用场景

邮件发送原理

后记

热门文章

最新文章

相关课程

相关电子书

相关实验场景