SpringBoot+JavaMailSender+Thymeleaf实现服务端发送邮件
What-什么是邮件服务
邮件服务在互联⽹早期就已经出现，如今已成为⼈们互联⽹⽣活中必不可少的⼀项服务。那么邮件服务是怎么⼯作的呢？如下给出邮件发送与接收的典型过程：
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 客户端，然后让客户端发送邮件到服务器。
Why-为什么系统要建⽴邮件服务
电⼦邮件具有全世界通⽤的协议。所以你可以使⽤任何⼀种邮件的客户端，以任何⼀种⽅式去查看你的邮件。这个世界上的电⼦邮件客户端不下千种，他们都以不同的⽅式去满⾜了不同需求的⼈，邮件有以下特点:
① 企业内部的沟通，邮件服务还是被认为“正式”的，⽐即时通信“可靠”。
② ⽀持转发/抄送，公开的，统⼀的通信协议，能够存档。
Why-如何实现邮件服务
配置邮件服务器
thymeleaf用法
开启SMTP服务器，设置授权码，后续编写代码需要改授权码，编码中的密码⾮邮箱登录密码⽽是授权码，如：设置授权码为：123456实现邮件客户端
① Gradle添加Spring Mail依赖
compile group: 'org.springframework.boot', name: 'spring-boot-starter-mail'
② 修改application.properties，添加邮箱配置
>>>>>>####---Spring Mail发送邮件--->>>>>>>>>#
# JavaMailSender 邮件发送的配置
spring.mail.default-encoding=UTF-8
spring.mail.host=smtp.163
spring.mail.port=465
spring.mail.username=javalsj@163
# 邮箱开启的授权码
spring.mail.password=123456
spring.mail.properties.smtp.auth=true
spring.mail.properties.able=true
spring.mail.properties.quired=true
spring.mail.properties.mail.able=true
编写发送邮件⼯具JavaMailUtil代码，⽀持发送纯⽂本邮件、html邮件、附件邮件、thymeleaf模板邮件类型。package com.javalsj.blog.mail;
import java.io.File;
import java.util.Map;
import javax.mail.internet.MimeMessage;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import io.FileSystemResource;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Component;
import org.springframework.util.StopWatch;
import org.thymeleaf.TemplateEngine;
import t.Context;
import com.javalsj.blogmon.FileUtil;
/**
* @description 发送邮件⼯具，⽀持发送纯⽂本邮件、html邮件、附件邮件、thymeleaf模板邮件类型。
* @author WANGJIHONG
* @date 2018年3⽉14⽇下午10:17:40
* @Copyright 版权所有 (c) www.javalsj
* @memo ⽆备注说明
*/
@Component
public class JavaMailUtil {
private final Logger logger = Logger(getClass());
/**
* Java邮件发送器
*/
@Autowired
private JavaMailSender mailSender;
/**
* thymeleaf模板引擎
*/
@Autowired
private TemplateEngine templateEngine;
/**
* 发送不含附件，且不含嵌⼊html静态资源页⾯的纯⽂本简单邮件
*
* @param deliver
* 发送⼈邮箱名如： javalsj@163
* @param receiver
* 收件⼈，可多个收件⼈如：11111@qq,2222@163
* @param carbonCopy
* 抄送⼈，可多个抄送⼈如：33333@sohu
* @param subject
* 邮件主题如：您收到⼀封⾼⼤上的邮件，请查收。
* @param text
* 邮件内容如：测试邮件逗你玩的。
*/
public void sendSimpleEmail(String deliver, String[] receivers, String[] carbonCopys, String subject, String text)
throws Exception {
sendMimeMail(deliver, receivers, carbonCopys, subject, text, false, null);
}
/**
* 发送含嵌⼊html静态资源页⾯，但不含附件的邮件
*
* @param deliver
* 发送⼈邮箱名如： javalsj@163
* @param receivers
* 收件⼈，可多个收件⼈如：11111@qq,2222@163
* @param carbonCopys
* 抄送⼈，可多个抄送⼈如：3333@sohu
* @param subject
* 邮件主题如：您收到⼀封⾼⼤上的邮件，请查收。
* @param text
* 邮件内容如： <html><body>
* <h1>213123</h1></body></html>
*/
public void sendHtmlEmail(String deliver, String[] receivers, String[] carbonCopys, String subject, String text)
throws Exception {
sendMimeMail(deliver, receivers, carbonCopys, subject, text, true, null);
}
/**
* 发送含附件，但不含嵌⼊html静态资源页⾯的邮件
*
* @param deliver
* 发送⼈邮箱名如： javalsj@163
* @param receivers
* 收件⼈，可多个收件⼈如：11111@qq,2222@163
* @param carbonCopys
* 抄送⼈，可多个抄送⼈如：3333@sohu
* @param subject
* 邮件主题如：您收到⼀封⾼⼤上的邮件，请查收。
* @param text
* 邮件内容如：测试邮件逗你玩的。
* @param attachmentFilePaths
* 附件⽂件路径如：www.javalsj/resource/test.jpg,
* www.javalsj/resource/test2.jpg
*/
public void sendAttachmentsEmail(String deliver, String[] receivers, String[] carbonCopys, String subject,
String text, String[] attachmentFilePaths) throws Exception {
sendMimeMail(deliver, receivers, carbonCopys, subject, text, false, attachmentFilePaths);
}
/**
* 发送含附件，且含嵌⼊html静态资源页⾯的邮件
*
* @param deliver
* 发送⼈邮箱名如： javalsj@163
* @param receivers
* 收件⼈，可多个收件⼈如：11111@qq,2222@163
* @param carbonCopys
* 抄送⼈，可多个抄送⼈如：33333@jiuqi
* @param subject
* 邮件主题如：您收到⼀封⾼⼤上的邮件，请查收。
* @param text
* <html><body><img src=\"cid:test\"><img
* src=\"cid:test2\"></body></html>
* @param attachmentFilePaths
* 附件⽂件路径如：www.javalsj/resource/test.jpg,
* www.javalsj/resource/test2.jpg
* 需要注意的是addInline函数中资源名称attchmentFileName需要与正⽂中cid:attchmentFileName对应起来 */
public void sendHtmlAndAttachmentsEmail(String deliver, String[] receivers, String[] carbonCopys, String subject, String text, String[] attachmentFilePaths) throws Exception {
sendMimeMail(deliver, receivers, carbonCopys, subject, text, true, attachmentFilePaths);
}
/**
* 发送thymeleaf模板邮件
*
* @param deliver
* 发送⼈邮箱名如： javalsj@163
* @param receivers
* 收件⼈，可多个收件⼈如：11111@qq,2222@163
* @param carbonCopys
* 抄送⼈，可多个抄送⼈如：33333@sohu
* @param subject
* 邮件主题如：您收到⼀封⾼⼤上的邮件，请查收。
* @param thymeleafTemplatePath
* 邮件模板如：mail\mailTemplate.html。
* @param thymeleafTemplateVariable
* 邮件模板变量集
*/
public void sendTemplateEmail(String deliver, String[] receivers, String[] carbonCopys, String subject, String thymeleafTemplatePath, Map<String, Object> thymeleafTemplateVariable) throws Exception {
String text = null;
if (thymeleafTemplateVariable != null && thymeleafTemplateVariable.size() > 0) {
Context context = new Context();
thymeleafTemplateVariable.forEach((key, value)->context.setVariable(key, value));
text = templateEngine.process(thymeleafTemplatePath, context);
}
sendMimeMail(deliver, receivers, carbonCopys, subject, text, true, null);
}
/**
* 发送的邮件(⽀持带附件/html类型的邮件)
*
* @param deliver
* 发送⼈邮箱名如： javalsj@163
* @param receivers
* 收件⼈，可多个收件⼈如：11111@qq,2222@163
* @param carbonCopys
* 抄送⼈，可多个抄送⼈如：3333@sohu
* @param subject
* 邮件主题如：您收到⼀封⾼⼤上的邮件，请查收。
* @param text
* 邮件内容如：测试邮件逗你玩的。 <html><body><img
* src=\"cid:attchmentFileName\"></body></html>
* @param attachmentFilePaths
* 附件⽂件路径如：
* 需要注意的是addInline函数中资源名称attchmentFileName需要与正⽂中cid:attchmentFileName对应起来
* @throws Exception
* 邮件发送过程中的异常信息
*/
private void sendMimeMail(String deliver, String[] receivers, String[] carbonCopys, String subject, String text,
boolean isHtml, String[] attachmentFilePaths) throws Exception {
StopWatch stopWatch = new StopWatch();
try {
stopWatch.start();
MimeMessage mimeMessage = ateMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
helper.setFrom(deliver);
helper.setTo(receivers);
helper.setCc(carbonCopys);
helper.setSubject(subject);
helper.setText(text, isHtml);
// 添加邮件附件
if (attachmentFilePaths != null && attachmentFilePaths.length > 0) {
for (String attachmentFilePath : attachmentFilePaths) {
File file = new File(attachmentFilePath);
if (ists()) {
String attachmentFile = attachmentFilePath
.substring(attachmentFilePath.lastIndexOf(File.separator));
long size = DirSize(file);
if (size > 1024 * 1024) {
String msg = String.format("邮件单个附件⼤⼩不允许超过1MB，[%s]⽂件⼤⼩[%s]。", attachmentFilePath,
FileUtil.formatSize(size));
throw new RuntimeException(msg);
} else {
FileSystemResource fileSystemResource = new FileSystemResource(file);
helper.addInline(attachmentFile, fileSystemResource);
}
}
}
}
mailSender.send(mimeMessage);
stopWatch.stop();
logger.info("邮件发送成功, 花费时间{}秒", TotalTimeSeconds());
} catch (Exception e) {
<("邮件发送失败, 失败原因 :{} 。", e.getMessage(), e);
throw e;
}
}
}
编写简单⽂本邮件发送控制器
@RequestMapping(value = "/sendSimpleEmail", method = RequestMethod.POST, produces = "application/json;charset=UTF-8") @ResponseBody
public Result sendSimpleEmail() {
Result result;
try {
javaMailUtil.sendSimpleEmail("javalsj@163", new String[] { "1111@qq", "2222@qq" },
new String[] { "33333@sohu" }, "您收到⼀封⾼⼤上的邮件，请查收。", "测试邮件逗你玩的。");
result = ResultFactory.buildSuccessResult(null);
} catch (Exception e) {
result = ResultFactory.Message());
}
return result;
}
编写模板引擎页⾯邮件发送
mailTemplate.html页⾯代码：
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论