|
引言
对于某些项目来说，需要发送邮件来完成，例如，发送验证码，发送附件（文档，压缩包之类的），发送链接。本博客利用163邮箱来实现功能需求。
前期准备
修改163邮箱的POP3配置，并备份授权码，方便项目中使用  
代码编写
01、pom文件
org.springframework.boot
spring-boot-starter-thymeleaf
org.springframework.boot
spring-boot-starter-web
org.springframework.boot
spring-boot-starter-mail
02、application.properties文件
# 邮箱配置
spring.mail.host=smtp.163.com
# 你的163邮箱
[email protected]
# 注意这里不是邮箱密码，而是SMTP授权密码
spring.mail.password=xxxxx
spring.mail.port=25
spring.mail.protocol=smtp
spring.mail.default-encoding=UTF-8
 03、邮件工具类
package com.information.util;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
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.stereotype.Service;
import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
import java.io.File;
/**
* Description
* Author 流星
* Date 2022/1/13 22:06
**/
@Service
public class MailUtil {
private final Logger logger = LoggerFactory.getLogger(this.getClass());
@Value("${spring.mail.username}")
private String from;
@Autowired
private JavaMailSender mailSender;
/**
* 简单文本邮件
* @param to 接收者邮件
* @param subject 邮件主题
* @param content 邮件内容
*/
public void sendSimpleMail(String to, String subject, String content){
SimpleMailMessage message = new SimpleMailMessage();
message.setTo(to);
message.setSubject(subject);
message.setText(content);
message.setFrom(from);
mailSender.send(message);
}
/**
* HTML 文本邮件
* @param to 接收者邮件
* @param subject 邮件主题
* @param content HTML内容
* @throws MessagingException
*/
public void sendHtmlMail(String to, String subject, String content) throws MessagingException {
MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);
helper.setFrom(from);
mailSender.send(message);
}
/**
* 附件邮件
* @param to 接收者邮件
* @param subject 邮件主题
* @param content HTML内容
* @param filePath 附件路径
* @throws MessagingException
*/
public void sendAttachmentsMail(String to, String subject, String content,
String filePath) throws MessagingException {
MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);
helper.setFrom(from);
FileSystemResource file = new FileSystemResource(new File(filePath));
String fileName = file.getFilename();
helper.addAttachment(fileName, file);
mailSender.send(message);
}
/**
* 图片邮件
* @param to 接收者邮件
* @param subject 邮件主题
* @param content HTML内容
* @param rscPath 图片路径
* @param rscId 图片ID
* @throws MessagingException
*/
public void sendInlinkResourceMail(String to, String subject, String content,
String rscPath, String rscId) {
logger.info("发送静态邮件开始: {},{},{},{},{}", to, subject, content, rscPath, rscId);
MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper = null;
try {
helper = new MimeMessageHelper(message, true);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);
helper.setFrom(from);
FileSystemResource res = new FileSystemResource(new File(rscPath));
helper.addInline(rscId, res);
mailSender.send(message);
logger.info("发送静态邮件成功!");
} catch (MessagingException e) {
logger.info("发送静态邮件失败: ", e);
}
}
}
04、controller
package com.information.controller;
import com.information.util.MailUtil;
import org.springframework.beans.factory.annotation.Autowired;
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.annotation.Resource;
import javax.mail.MessagingException;
/**
* Description
* Author 流星
* Date 2022/1/13 22:11
**/
@RestController
@RequestMapping
public class MailTestController {
@Autowired
private MailUtil mailUtil;
@Resource
private TemplateEngine templateEngine;
/**
* 测试一个简单的、由自己撰写邮件标题和内容的邮件
**/
@RequestMapping("mail01")
public String sendSimpleMail() {
mailUtil.sendSimpleMail("[email protected]","测试spring boot mail-主题","测试spring boot mail - 内容");
return "发送成功";
}
/**
* 测试一个简单的html邮件
**/
@RequestMapping("mail02")
public String sendHtmlMail() throws MessagingException {
String content = "\n" +
"\n" +
"hello world\n" +
"html\n" +
"\n" +
"\n";
mailUtil.sendHtmlMail("[email protected]","hello world邮件",content);
return "发送成功";
}
/**
* 测试文档之类附件传输的邮件
**/
@RequestMapping("mail03")
public String sendAttachmentsMail() throws MessagingException {
String filePath = "src/main/resources/static/redis.docx";
String content = "\n" +
"\n" +
"hello world\n" +
"html\n" +
"附件传输\n" +
"\n" +
"\n";
mailUtil.sendAttachmentsMail("[email protected]","附件传输",content, filePath);
return "发送成功";
}
/**
* 测试图片之类的、且显示在邮件内容上的邮件
**/
@RequestMapping("mail04")
public String sendInlinkResourceMail() throws MessagingException {
//TODO 相对路径
String imgPath = "src/main/resources/static/test01.png";
String rscId = "test";
String content = "" +
"" +
"hello world" +
"html" +
"图片邮件" +
"![](cid:"/spanspan+/spanrscIdspan+/spanspan") " +
"" +
"";
mailUtil.sendInlinkResourceMail("[email protected]","这是一封图片邮件",content, imgPath, rscId);
return "发送成功";
}
/**
* 测试一个HTML模板的邮件
**/
@RequestMapping("mail05")
public String testTemplateMailTest() throws MessagingException {
Context context = new Context();
context.setVariable("id","liuxing121380110");
String emailContent = templateEngine.process("emailTemplate", context);
mailUtil.sendHtmlMail("[email protected]","这是一封HTML模板邮件",emailContent);
return "发送成功";
}
}
05、emailTemplate.html
注册-测试邮件模板
你好，感谢你的注册，这是一封验证邮件，请点击下面的连接完成注册，感谢您的支持。
测试结果（postman测试）
 
扩展资料
电子邮件服务器
用户要在Internet上提供电子邮件功能，必须有专门的电子邮件服务器。这些邮件服务器就类似于现实生活中的邮局，它主要负责接收用户投递过来的邮件，并把邮件投递到邮件接收者的电子邮箱中。 邮件服务器就好像是互联网世界的邮局。按照功能划分，邮件服务器可以划分为两种类型： 1、SMTP邮件服务器：用户替用户发送邮件和接收外面发送给本地用户的邮件。 2、POP3/IMAP邮件服务器：用户帮助用户读取SMTP邮件服务器接收进来的邮件。
电子邮箱
电子邮箱也称为E-mail地址，用户可以通过E-mail地址来标识自己发送的电子邮件，也可以通过这个地址接收别人发来的电子邮件。电子邮箱需要到邮件服务器进行申请，也就是说，电子邮箱其实就是用户在邮件服务器上申请的账户。 邮件服务器会把接收到的邮件保存到为该账户所分配的邮箱空间中，用户通过用户名密码登录到邮件服务器查收该地址已经收到的邮件。 一般来讲，邮件服务器为用户分配的邮箱空间是有限的。
邮件传输协议
电子邮件需要在邮件客户端和邮件服务器之间，以及两个邮件服务器之间进行邮件传递，那就必须要遵守一定的规则，这个规则就是邮件传输协议。下面我们分别简单介绍几种协议：
SMTP协议：全称为 Simple Mail Transfer Protocol，简单邮件传输协议。它定义了邮件客户端软件和SMTP邮件服务器之间，以及两台SMTP邮件服务器之间的通信规则。POP3协议：全称为 Post Office Protocol，邮局协议。它定义了邮件客户端软件和POP3邮件服务器的通信规则。IMAP协议：全称为 Internet Message Access Protocol,Internet消息访问协议，它是对POP3协议的一种扩展，也是定义了邮件客户端软件和IMAP邮件服务器的通信规则。
附：源代码
163邮箱发送邮件
|