Spring Boot实战之发送邮件示例代码

Z时代
2024-01-10
分类：IT

一、邮件服务简介

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

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客户端，然后让客户端发送邮件到服务器。

二、配置邮件服务器

本文使用126邮箱测试，在以下界面中开启smtp服务器，设置授权码，在后面代码中会使用到

三、实现邮件客户端

1）修改pom.xml，添加依赖库


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

2）修改application.properties，添加邮箱配置

spring.mail.host=smtp.126.com

spring.mail.username=****@126.com

spring.mail.password=password #上面获取设置的授权码

spring.mail.default-encoding=UTF-8

3）新增MailController


package com.xiaofangtech.sunt.controller; 
import javax.mail.internet.MimeMessage; 
import org.springframework.beans.factory.annotation.Autowired; 
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 com.xiaofangtech.sunt.utils.ResultMsg; 
import com.xiaofangtech.sunt.utils.ResultStatusCode; 
@RestController 
@RequestMapping("mail") 
public class MailController { 
  @Autowired 
  JavaMailSender mailSender; 
  @RequestMapping("sendemail") 
  public Object sendEmail() 
  { 
    try 
    { 
      final MimeMessage mimeMessage = this.mailSender.createMimeMessage(); 
      final MimeMessageHelper message = new MimeMessageHelper(mimeMessage); 
      message.setFrom("****@126.com"); 
      message.setTo("****@example.com"); 
      message.setSubject("测试邮件主题"); 
      message.setText("测试邮件内容"); 
      this.mailSender.send(mimeMessage); 
      ResultMsg resultMsg = new ResultMsg(ResultStatusCode.OK.getErrcode(), 
          ResultStatusCode.OK.getErrmsg(), null); 
      return resultMsg; 
    } 
    catch(Exception ex) 
    { 
      ResultMsg resultMsg = new ResultMsg(ResultStatusCode.SYSTEM_ERR.getErrcode(), 
          ResultStatusCode.SYSTEM_ERR.getErrmsg(), null); 
      return resultMsg; 
    } 
  } 
}