SpringBoot邮件推送功能

2023-08-03 19:48:10

鞠躬,道歉

抱歉，迟到了近一年的更新，这一年挺忙的，发生了很多事情，就厚脸皮拖更了，抱歉。

现在状态回来了，打算分享下近期学到的东西，这一年期间学到的东西可能会随意更新，其实也就是玩了下C# + unity3D，本来打算做个长期项目，但是申报比赛连预选都没有过，预选都是垫底的。项目展示视频见这个。还有就是和学院老师做了智慧博物馆的项目，文物的建模与AR以及互动小游戏都有参与。

but，从去年10月份开始又重新开始学Java和SSM的一些东西，上面说的以后应该没有机会玩了，AR倒是有时间可以分享给大家，但是项目那些演示视频暂时不方便公开。教程的话网上蛮多的，我用的是Vuforia这个，和unity3D契合度蛮高的。想玩的朋友可以去弄弄，挺简单的。

之前一个unity3D项目的展示视频。

正题

挺长时间了，一直在学Spring、SpringMVC、SpringBoot、Mybatis这些，但是感觉学了蛮久但不精通，也就不敢乱分享高深的。现在在做一个系统，需要发送邮件给用户，网上找了一圈相关博客，参考大佬做了自己的一个记录。也借机回归一周一更的状态，不写点东西对不起大家，嘿嘿。

在我们平时，时常需要利用邮箱注册各种各样的账号或者接收一些通知信息。这使得一个功能完善的系统必然会有一个邮件发送功能。下面就是我近期学习的一个邮件发送系统demo。

介绍

Spring项目中，邮件发送使用Spring提供的org.springframework.mail.javamail.JavaMailSender，它提供了一些简单易用的方法，可以发送简单邮件、带附件的邮件、HTML格式的邮件、以及依靠固定模板的邮件。

引入pom.xml依赖

<dependency>

	<groupId>org.springframework.boot</groupId>

	<artifactId>spring-boot-starter-mail</artifactId>

</dependency>

配置（记得重新配置发件邮箱及密码）

请修改username及password为你的发件邮箱，各平台发件密码规格不一样，切需要卡通smtp功能，请看各平台要求。

之前用QQ邮箱要求配置后，测试好多次都无法发送，建议使用其他邮箱，笔者用163邮箱，但各位注意163邮箱默认在邮件后附带推广，记得在设置中关闭，之前测试的时候很坑。

server:

  port: 8080

spring:

  mail:

    host: smtp.163.com

    username: 123456789@163.com

    password: 123456789

    properties:

      mail:

        smtp:

          auth: true

          starttls:

            enable: true

            required: true

发送简单邮件代码展示

// 简单邮件

@RequestMapping("sendSimpleEmail")

public String sendSimpleEmail() {

    try {

        SimpleMailMessage message = new SimpleMailMessage();

        message.setFrom(from);

        message.setTo(toEmail); // 接收地址,可传入数组进行群发

        message.setSubject("新年好"); // 标题

        message.setText("新年快乐，完事大吉\n 新年新气象"); // 内容

        javaMailSender.send(message);

        return "发送成功";

    } catch (Exception e) {

        e.printStackTrace();

        return e.getMessage();

    }

}

启动项目,发送 http://localhost:8080/email/sendSimpleEmail 即可发送邮件

结果如下：

完整示例（记得更换目标邮箱）

请看以下代码，或GitHub地址clone项目查看，有完整注释。

package com.mxwbq.demo.controller;

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.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

import org.thymeleaf.TemplateEngine;

import org.thymeleaf.context.Context;

import javax.mail.internet.MimeMessage;

import java.io.File;

/**

 * Created by mxwbq on 2019/3/29.

 */

@RestController

@RequestMapping("/email")

public class EmailController {

    @Autowired

    private JavaMailSender javaMailSender;

    @Value("${spring.mail.username}")

    private String from;

    // 目标邮箱地址，记得更换

    private String toEmail = "123456789@163.com";

    @Autowired

    private TemplateEngine templateEngine;

    // 简单邮件

    @RequestMapping("sendSimpleEmail")

    public String sendSimpleEmail() {

        try {

            SimpleMailMessage message = new SimpleMailMessage();

            message.setFrom(from);

            message.setTo(toEmail); // 接收地址,可传入数组进行群发,下同

            message.setSubject("新年好"); // 标题

            message.setText("新年快乐，完事大吉\n 新年新气象"); // 内容

            javaMailSender.send(message);

            return "发送成功";

        } catch (Exception e) {

            e.printStackTrace();

            return e.getMessage();

        }

    }

    // 发送Html格式邮件

    @RequestMapping("sendHtmlEmail")

    public String sendHtmlEmail() {

        MimeMessage message = null;

        try {

            message = javaMailSender.createMimeMessage();

            MimeMessageHelper helper = new MimeMessageHelper(message, true);

            helper.setFrom(from);

            helper.setTo(toEmail); // 接收地址

            helper.setSubject("HTML格式的邮件"); // 标题

            // 带HTML格式的内容

            StringBuffer sb = new StringBuffer(

                    "<h1><p style='color:#42b983'>使用Spring Boot发送HTML格式邮件</p></h1>" +

                    "<p>这里是正文:</p>" +

                    "<p>这里是听雨轩地址:www.nucode.cn</p>");

            helper.setText(sb.toString(), true);  // 第二个参数 true 代表规定邮件格式为HTML

            javaMailSender.send(message);

            return "发送成功";

        } catch (Exception e) {

            e.printStackTrace();

            return e.getMessage();

        }

    }

    // 发送邮件携带附件

    @RequestMapping("sendAttachmentsMail")

    public String sendAttachmentsMail() {

        MimeMessage message = null;

        try {

            message = javaMailSender.createMimeMessage();

            MimeMessageHelper helper = new MimeMessageHelper(message, true);

            helper.setFrom(from);

            helper.setTo(toEmail); // 接收地址

            helper.setSubject("带附件的邮件"); // 标题

            helper.setText("详情参见附件内容！"); // 内容

            // 传入附件

            FileSystemResource file = new FileSystemResource(new File("src\\main\\resources\\static\\file\\SpringBoot_Email文档.docx"));

            helper.addAttachment("SpringBoot_Email文档.docx", file);

            javaMailSender.send(message);

            return "发送成功";

        } catch (Exception e) {

            e.printStackTrace();

            return e.getMessage();

        }

    }

    // 发送附带静态资源的邮件

    @RequestMapping("sendInlineMail")

    public String sendInlineMail() {

        MimeMessage message = null;

        try {

            message = javaMailSender.createMimeMessage();

            MimeMessageHelper helper = new MimeMessageHelper(message, true);

            helper.setFrom(from);

            helper.setTo(toEmail); // 接收地址

            helper.setSubject("带静态资源的邮件"); // 标题

            helper.setText("<html><body>生日快乐：<img src='cid:img'/></body></html>", true); // 内容

            // 传入附件

            FileSystemResource file = new FileSystemResource(new File("src/main/resources/static/img/礼物.jpg"));

            helper.addInline("img", file);

            javaMailSender.send(message);

            return "发送成功";

        } catch (Exception e) {

            e.printStackTrace();

            return e.getMessage();

        }

    }

    // 发送模板邮件

    @RequestMapping("sendTemplateEmail")

    public String sendTemplateEmail(String registerURL) {

        MimeMessage message = null;

        try {

            message = javaMailSender.createMimeMessage();

            MimeMessageHelper helper = new MimeMessageHelper(message, true);

            helper.setFrom(from);

            helper.setTo(toEmail); // 接收地址

            helper.setSubject("邮件模板测试"); // 标题

            // 处理邮件模板

            Context context = new Context();

            context.setVariable("registerURL", registerURL);

            String template = templateEngine.process("register", context);

            helper.setText(template, true);

            javaMailSender.send(message);

            return "发送成功";

        } catch (Exception e) {

            e.printStackTrace();

            return e.getMessage();

        }

    }

}

项目GitHub地址

https://github.com/mxbq/SpringBoot_Study

说明

本文参考自MrBird大佬的博客：https://mrbird.cc/Spring-Boot-Email.html，有删改及自我实操问题汇总。

附

新的开始，不再颓废。

谢谢大家

以上

码农公寓