Spring Boot 发送邮件功能案例分析

邮件服务简介

邮件服务在互联网早期就已经出现，如今已成为人们互联网生活中必不可少的一项服务。那么邮件服务是怎么工作的呢？如下给出邮件发送与接收的典型过程：

1、发件人使用smtp协议传输邮件到邮件服务器a；

2、邮件服务器a根据邮件中指定的接收者，投送邮件至相应的邮件服务器b；

3、收件人使用pop3协议从邮件服务器b接收邮件。

smtp（simple mail transfer protocol）是电子邮件（email）传输的互联网标准，定义在rfc5321，默认使用端口25；
pop3（post office protocol - version 3）主要用于支持使用客户端远程管理在服务器上的电子邮件。定义在rfc 1939，为pop协议的第三版（最新版）。

这两个协议均属于tcp/ip协议族的应用层协议，运行在tcp层之上。

我们日常收发邮件使用的客户端、web mail的背后都在运行着这两个协议，完成收发邮件的过程。而现在我们需要使用

smtp协议来把发送给用户的邮件传输到邮件服务器。

从客户端传输邮件到服务器需要双方的配合，而规则就定义在smtp协议中。我们现在需要做的是找一个smtp服务器，再实现一个smtp客户端，然后让客户端发送邮件到服务器。 

正文如下

spring框架使用javamailsender接口为发送邮件提供了一个简单的抽象，并且spring boot也为它提供了自动配置和一个starter模块。

如果spring.mail.host和相关的库（通过spring-boot-starter-mail定义）都存在，一个默认的javamailsender将被创建。该sender可以通过spring.mail命名空间下的配置项进一步自定义，下面本站素文宅博客具体讲述一下spring boot如何实现发送邮件。

引入spring-boot-starter-mail依赖，在pom.xml配置文件中增加如下内容（基于之前章节“spring boot 构建框架”中的pom.xml文件）：

<dependency>
  <groupid>org.springframework.boot</groupid>
  <artifactid>spring-boot-starter-mail</artifactid>
</dependency>

应用发送邮件案例

在 application.properties 配置文件中加入如下配置（注意替换自己的用户名和密码）：

spring.mail.host=smtp.qq.com 
spring.mail.username=用户名 //发送方的邮箱
spring.mail.password=密码 //对于qq邮箱而言 密码指的就是发送方的授权码
spring.mail.properties.mail.smtp.auth=true 
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true

邮件service服务代码，具体如下：

@service 
public class mailservice { 
  private final logger logger = loggerfactory.getlogger(this.getclass()); 
  @autowired 
  private javamailsender sender; 
  @value("${spring.mail.username}") 
  private string from; 
  /** 
   * 发送纯文本的简单邮件 
   * @param to 
   * @param subject 
   * @param content 
   */ 
  public void sendsimplemail(string to, string subject, string content){ 
    simplemailmessage message = new simplemailmessage(); 
    message.setfrom(from); 
    message.setto(to); 
    message.setsubject(subject); 
    message.settext(content); 
    try { 
      sender.send(message); 
      logger.info("简单邮件已经发送。"); 
    } catch (exception e) { 
      logger.error("发送简单邮件时发生异常！", e); 
    } 
  } 
  /** 
   * 发送html格式的邮件 
   * @param to 
   * @param subject 
   * @param content 
   */ 
  public void sendhtmlmail(string to, string subject, string content){ 
    mimemessage message = sender.createmimemessage(); 
    try { 
      //true表示需要创建一个multipart message 
      mimemessagehelper helper = new mimemessagehelper(message, true); 
      helper.setfrom(from); 
      helper.setto(to); 
      helper.setsubject(subject); 
      helper.settext(content, true); 
      sender.send(message); 
      logger.info("html邮件已经发送。"); 
    } catch (messagingexception e) { 
      logger.error("发送html邮件时发生异常！", e); 
    } 
  } 
  /** 
   * 发送带附件的邮件 
   * @param to 
   * @param subject 
   * @param content 
   * @param filepath 
   */ 
  public void sendattachmentsmail(string to, string subject, string content, string filepath){ 
    mimemessage message = sender.createmimemessage(); 
    try { 
      //true表示需要创建一个multipart message 
      mimemessagehelper 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 = filepath.substring(filepath.lastindexof(file.separator)); 
      helper.addattachment(filename, file); 
      sender.send(message); 
      logger.info("带附件的邮件已经发送。"); 
    } catch (messagingexception e) { 
      logger.error("发送带附件的邮件时发生异常！", e); 
    } 
  } 
  /** 
   * 发送嵌入静态资源（一般是图片）的邮件 
   * @param to 
   * @param subject 
   * @param content 邮件内容，需要包括一个静态资源的id，比如：<img src=\"cid:rscid01\" > 
   * @param rscpath 静态资源路径和文件名 
   * @param rscid 静态资源id 
   */ 
  public void sendinlineresourcemail(string to, string subject, string content, string rscpath, string rscid){ 
    mimemessage message = sender.createmimemessage(); 
    try { 
      //true表示需要创建一个multipart message 
      mimemessagehelper helper = new mimemessagehelper(message, true); 
      helper.setfrom(from); 
      helper.setto(to); 
      helper.setsubject(subject); 
      helper.settext(content, true); 
      filesystemresource res = new filesystemresource(new file(rscpath)); 
      helper.addinline(rscid, res); 
      sender.send(message); 
      logger.info("嵌入静态资源的邮件已经发送。"); 
    } catch (messagingexception e) { 
      logger.error("发送嵌入静态资源的邮件时发生异常！", e); 
    } 
  } 
}

简单测试代码如下：

public class mailtests extends basicutclass{ 
  @autowired 
  private mailservice mailservice; 
  private string to = "[e-mail]"; 
  @test 
  public void sendsimplemail() { 
    mailservice.sendsimplemail(to, "主题：简单邮件", "测试邮件内容"); 
  } 
}

总结

以上所述是小编给大家介绍的spring boot 发送邮件功能案例分析，希望对大家有所帮助