【Springboot实战】发送邮件

摘要：
          项目中，有可能需要通过一个请求，然后想客户或者某某的邮箱发送邮件。本章将介绍如何通过springboot来发送邮件。
 

第一步：pom文件中引入依赖

    4.0.0
    com.jp
    giftshow
    1.0-SNAPSHOT
    
        org.springframework.boot
        spring-boot-starter-parent
        2.3.1.RELEASE
    
    
        1.0.26
    
    
        
            org.springframework.boot
            spring-boot-starter
        
        
            org.springframework.boot
            spring-boot-starter-web
        
        
            org.springframework.boot
            spring-boot-starter-mail
        
        
            org.springframework.boot
            spring-boot-devtools
        
        
        
            org.springframework.boot
            spring-boot-starter-freemarker
        
    
    
        
            
                org.apache.maven.plugins
                maven-compiler-plugin
                2.5.1
                
                    1.8
                    1.8
                    UTF-8
                    true
                
            
        
    

 这里依赖的spring-boot-starter-mail是springframework中的JavaMailSender 来实现邮件发送。springboot会自动对其进行配置

第二步：配置yml文件

application.yml
server:
  port: 8081

spring:
  mail:
    host: smtp.163.com #发送邮件服务器
    username: ****@163.com #你的邮箱地址
    password: 123RYGGQ321  #邮箱里设置的授权码，不是登录密码，授权码需要自己到邮箱里面设置
    protocol: smtp #发送邮件协议
#    properties.mail.smtp.auth: true
#    properties.mail.smtp.port: 994 #465或者994
#    properties.mail.display.sendmail: aaa #可以任意
#    properties.mail.display.sendname: bbb #可以任意
#    properties.mail.smtp.starttls.enable: true
#    properties.mail.smtp.starttls.required: true
#    properties.mail.smtp.ssl.enable: true #开启SSL
    default-encoding: utf-8
  #制作邮件的模板
  freemarker:
      cache: false # 缓存配置 开发阶段应该配置为false 因为经常会改
      suffix: .html # 模版后缀名 默认为ftl
      charset: UTF-8 # 文件编码
      template-loader-path: classpath:/templates/email/  # 存放模板的文件夹，以resource文件夹为相对路径

第三步：创建启动类:

@SpringBootApplication
public class ApplicationRunner{
    public static void main(String[] args) {
        SpringApplication.run(ApplicationRunner.class, args);
    }
}

第四步：创建controller，实现邮件发送功能

package com.qq.test.controller;

import freemarker.template.Template;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.ui.freemarker.FreeMarkerTemplateUtils;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer;

import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
import java.util.HashMap;
import java.util.Map;


@RestController
public class TestController {
  @Autowired
  private JavaMailSender mailSender;

  /**
   * 发送最简单的邮件，仅发送文字
  **/
  @GetMapping("/email")
  public String sendEmail() {
    SimpleMailMessage message = new SimpleMailMessage();
    message.setTo("[email protected]");
    message.setFrom("[email protected]");
    message.setSubject("邮件测试");
    message.setText("你收到一条邮件");

    mailSender.send(message);
    return String.format("emial is sent!");
  }

  /**
   * 发送html格式的邮件
  **/
  @GetMapping("/htmlemail")
  public void sendHtmlMail(){
    MimeMessage message = mailSender.createMimeMessage();
    String content="\n"+
        "\n"+
        "
hello 明天要加油哦！
\n"+
        "\n"+
        "";
    try {
      MimeMessageHelper helper = new MimeMessageHelper(message,true);
      helper.setTo("[email protected]");
      helper.setFrom("[email protected]");
      helper.setSubject("邮件测试");
      helper.setText(content,true);
      mailSender.send(message);

    } catch (MessagingException e) {
      e.printStackTrace();
    }
  }

  @Autowired
  private FreeMarkerConfigurer freeMarkerConfigurer;
  /**
   * 发送一个freemark制作的html模板作为邮件内容的邮件。
  **/
  @GetMapping("/tempemail")
  public void sendFreemarkMail() throws Exception{
    // 获得模板
    Template template = freeMarkerConfigurer.getConfiguration().getTemplate("temp1.html");
    // 使用Map作为数据模型，定义属性和值
    Map model = new HashMap<>();
    model.put("myname","ZYF");
    // 传入数据模型到模板，替代模板中的占位符，并将模板转化为html字符串
    String templateHtml = FreeMarkerTemplateUtils.processTemplateIntoString(template,model);

    // 该方法本质上还是发送html邮件，调用之前发送html邮件的方法
    MimeMessage message = mailSender.createMimeMessage();
    try {
      MimeMessageHelper helper = new MimeMessageHelper(message,true);
      helper.setTo("[email protected]");
      helper.setFrom("[email protected]");
      helper.setSubject("邮件测试");
      helper.setText(templateHtml,true);
      mailSender.send(message);

    } catch (MessagingException e) {
      e.printStackTrace();
    }
  }


}

模板temp1.html内容

  
  


Hello Freemarker
My name is ${myname}