FrostySun

Spring Boot项目中发送邮件

Spring Boot项目中发送邮件

邮件发送关键点

  • 使用spring boot 项目，我们可以节约很多的工作，spring boot将一些基础的配置都帮我们约束好了，我们只需要按照标准去配置即可。

  • 项目主配置文件配置（application.yml ),这里我将演示三种不同类型的邮箱账号发送邮件:

    • QQ 企业邮箱
# QQ企业邮箱
spring:
   mail:
     host: smtp.exmail.qq.com  # 对应各邮箱官方提示
     username: tangz***g@wei***ada.net  # 账号
     password: ETQpK***gxYGd  # 企业邮箱为 客户端专用密码
     properties:
           mail:
             smtp:
               auth: true # 使用
               starttls: # 使用 SSL 安全协议，必须配置如下
                 enable: true
                 required: true
     port: 465  # 端口
     protocol: smtps # 协议

 # 配置常量
 mail:
   fromMail:
     addr: tang***ng@w***.net  # 发送人
   receptionMail:
     addr: 332***4141@qq.com  # 接收人
-  QQ 普通邮箱
# 普通QQ邮箱
spring:
  mail:
    host: smtp.qq.com
    username: 191***933@qq.com # 邮箱账号
    password: twuhvbfgndkwbgbf # 授权码（下面将会告诉你怎么申请）
    properties:
          mail:
            smtp:
              auth: true
              starttls:
                enable: true
                required: true
mail:
  fromMail:
    addr: 191****33@qq.com
  • 网易 163 邮箱
# 网易 163 邮箱
spring:
  mail:
    host: smtp.163.com
    username: 1****61@163.com # 邮箱登录账号
    password: ****.  # 邮箱登录密码
mail:
  fromMail:
    addr: 1****61@163.com

QQ企业邮箱客户端专用码申请（关于申请 QQ企业邮箱不做多的介绍）

  • 第一步：登录企业邮箱后点击 设置 并找到 客户端设置确定开启了 POP/SMTP服务。
  • 第二步：开启安全登录，并生产 客户端专用密码。


QQ普通邮箱开启授权码

  • 第一步：点击 设置 > 账户 ，向下拉，找到 POOP/SMTP服务并开启。
  • 第二步：点击 生成授权码,按照官方的提示完成验证即可生成 授权码。

项目pom.xml文件准备

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

<!--spring boot mail 集成jar-->
<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>

mail 服务接口定义

public interface MailService {

    /**
     * 发送纯文本邮件
     * @param toAddr 发送给谁
     * @param title 标题
     * @param content 内容
     */
    public void sendTextMail(String toAddr, String title, String content);

    /**
     * 发送 html 邮件
     * @param toAddr
     * @param title
     * @param content 内容（HTML）
     */
    public void sendHtmlMail(String toAddr, String title, String content);

    /**
     *  发送待附件的邮件
     * @param toAddr
     * @param title
     * @param content
     * @param filePath 附件地址
     */
    public void sendAttachmentsMail(String toAddr, String title, String content, String filePath);

    /**
     *  发送文本中有静态资源（图片）的邮件
     * @param toAddr
     * @param title
     * @param content
     * @param rscPath 资源路径
     * @param rscId 资源id (可能有多个图片)
     */
    public void sendInlineResourceMail(String toAddr, String title, String content, String rscPath, String rscId);

}

服务接口的实现

@Component
public class MailServiceImpl implements MailService {

    private final Logger logger = LoggerFactory.getLogger(this.getClass());

    @Autowired
    private JavaMailSender mailSender;

    // 注入常量
    @Value("${mail.fromMail.addr}")
    private String from;

    /**
     * 发送文本邮件
     * @param toAddr
     * @param title
     * @param content
     */
    @Override
    public void sendTextMail(String toAddr, String title, String content) {
        // 纯文本邮件对象
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(from);
        message.setTo(toAddr);
        message.setSubject(title);
        message.setText(content);

        try {
            mailSender.send(message);
            logger.info("Text邮件已经发送。");
        } catch (Exception e) {
            logger.error("发送Text邮件时发生异常！", e);
        }

    }

    /**
     * 发送html邮件
     * @param toAddr
     * @param title
     * @param content
     */
    @Override
    public void sendHtmlMail(String toAddr, String title, String content) {
        // html 邮件对象
        MimeMessage message = mailSender.createMimeMessage();

        try {
            //true表示需要创建一个multipart message
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(from);
            helper.setTo(toAddr);
            helper.setSubject(title);
            helper.setText(content, true);

            mailSender.send(message);
            logger.info("html邮件发送成功");
        } catch (MessagingException e) {
            logger.error("发送html邮件时发生异常！", e);
        }
    }


    /**
     * 发送带附件的邮件
     * @param toAddr
     * @param title
     * @param content
     * @param filePath
     */
    public void sendAttachmentsMail(String toAddr, String title, String content, String filePath){
        MimeMessage message = mailSender.createMimeMessage();

        try {
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(from);
            helper.setTo(toAddr);
            helper.setSubject(title);
            helper.setText(content, true);

            FileSystemResource file = new FileSystemResource(new File(filePath));
            String fileName = filePath.substring(filePath.lastIndexOf(File.separator));
            helper.addAttachment(fileName, file);
            //helper.addAttachment("test"+fileName, file);

            mailSender.send(message);
            logger.info("带附件的邮件已经发送。");
        } catch (MessagingException e) {
            logger.error("发送带附件的邮件时发生异常！", e);
        }
    }


    /**
     * 发送正文中有静态资源（图片）的邮件
     * @param toAddr
     * @param title
     * @param content
     * @param rscPath
     * @param rscId
     */
    public void sendInlineResourceMail(String toAddr, String title, String content, String rscPath, String rscId){
        MimeMessage message = mailSender.createMimeMessage();

        try {
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(from);
            helper.setTo(toAddr);
            helper.setSubject(title);
            helper.setText(content, true);

            FileSystemResource res = new FileSystemResource(new File(rscPath));
            helper.addInline(rscId, res);

            mailSender.send(message);
            logger.info("嵌入静态资源的邮件已经发送。");
        } catch (MessagingException e) {
            logger.error("发送嵌入静态资源的邮件时发生异常！", e);
        }
    }
}

测试类

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

    @Value("${mail.receptionMail.addr}")
    private String receptionMailAddr;

    @Autowired
    private MailService mailService;

    @Autowired
    private TemplateEngine templateEngine;

    /**
     * 测试 文本邮件
     * @throws Exception
     */
    @Test
    public void testSimpleMail() throws Exception {
        mailService.sendTextMail(receptionMailAddr,"测试文本邮箱发送","你好你好！");
    }

    /**
     * 测试 html 邮箱
     * @throws Exception
     */
    @Test
    public void testHtmlMail() throws Exception {
        String content="<html>\n" +
                "<body>\n" +
                "    <h3>hello world ! 这是一封html邮件!</h3>\n" +
                "</body>\n" +
                "</html>";
        mailService.sendHtmlMail(receptionMailAddr,"test simple mail",content);
    }

    @Test
    public void sendAttachmentsMail() {
        String filePath="C:\\\\Users\\\\Administrator\\\\Desktop\\\\java并发学习.txt";
        mailService.sendAttachmentsMail(receptionMailAddr, "主题：带附件的邮件", "有附件，请查收！", filePath);
    }


    @Test
    public void sendInlineResourceMail() {
        String rscId = "neo006";
        String content="<html><body>这是有图片的邮件：<img src=\'cid:" + rscId + "\' ></body></html>";
        String imgPath = "C:\\\\Users\\\\Administrator\\\\Desktop\\\\testMail.png";

        mailService.sendInlineResourceMail(receptionMailAddr, "主题：这是有图片的邮件", content, imgPath, rscId);
    }


    @Test
    public void sendTemplateMail() {
        //创建邮件正文
        Context context = new Context();
        context.setVariable("id", "006");

        // 传递 emailTemplate.html 模板需要的值，并将模板转换为 String
        String emailContent = templateEngine.process("emailTemplate", context);

        mailService.sendHtmlMail(receptionMailAddr,"主题：这是模板邮件",emailContent);
    }

}


陕ICP备19022109号-1