GitHub 地址：
https://github.com/asd821300801/Spring-Boot.git
相信活跃在互联网的大神都知道，现在大部分网站在注册的时候都要求用户填写邮箱进行注册验证，所以说发送邮件应该是网站必备的功能之一。在没有框架之前，我们是通过Java自带的JavaMail类来发送邮件的，后来spring推出了JavaMailSender类大大简化了发送邮件的过程，再到现在的Spring Boot又对其进行封装从而出现了 spring-boot-starter-mail。
前期准备
本章使用的是QQ的邮件服务，所以在这之前需要麻烦读者先去开通腾讯的SMTP功能
开通SMTP功能
QQ邮箱的授权码将作为邮箱密码使用。
如果不会开通，请参考博文：http://blog.csdn.net/caimengyuan/article/details/51224269
pom文件中加入发送邮件相关依赖
<!-- 邮件服务 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>properties文件中添加邮箱配置
- application.properties
#####qq邮箱#####
#QQ邮件服务地址
spring.mail.host=smtp.qq.com
#用户名
spring.mail.username=xxxx@qq.com
#密码（授权码）
spring.mail.password=iwfxjjhkziugechb
#默认编码UTF-8
spring.mail.default-encoding=UTF-8
#端口，这里添加587即可
spring.mail.port=587
#邮件发送人
mail.fromMail.addr=xxxx@qq.com
配置信息这里使用587端口，刚开始用465端口我纠结了好久(使用465端口的错误详情)，用不了，你可以尝试，默认的25端口应该也是不适合的
创建EmailService接口
- EmailService.java
包所在：com.example.email
package com.example.email;
/**
* 发送邮件服务
* @author LingDu
* 2017.8.18
*/
public interface EmailService {
/**
* 发送简单邮件
* @param to
* @param subject
* @param content
*/
public void sendSimpleEmail(String to, String subject, String content);
/**
* 发送html格式邮件
* @param to
* @param subject
* @param content
*/
public void sendHtmlEmail(String to, String subject, String content);
/**
* 发送带附件的邮件
* @param to
* @param subject
* @param content
* @param filePath
*/
public void sendAttachmentsEmail(String to, String subject, String content, String filePath);
/**
* 发送带静态资源的邮件
* @param to
* @param subject
* @param content
* @param rscPath
* @param rscId
*/
public void sendInlineResourceEmail(String to, String subject, String content, String rscPath, String rscId);
}创建EmailServiceImp实现类
- EmailServiceImp.java
包所在：com.example.email
package com.example.email;
import java.io.File;
import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
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.Component;
@Component
public class EmailServiceImp implements EmailService {
private final Logger logger = LoggerFactory.getLogger(this.getClass());
@Autowired
private JavaMailSender mailSender;//spring 提供的邮件发送类
@Value("${mail.fromMail.addr}")
private String from;
@Override
public void sendSimpleEmail(String to, String subject, String content) {
SimpleMailMessage message = new SimpleMailMessage();//创建简单邮件消息
message.setFrom(from);//设置发送人
message.setTo(to);//设置收件人
/* String[] adds = {"xxx@qq.com","yyy@qq.com"}; //同时发送给多人
message.setTo(adds);*/
message.setSubject(subject);//设置主题
message.setText(content);//设置内容
try {
mailSender.send(message);//执行发送邮件
logger.info("简单邮件已经发送。");
} catch (Exception e) {
logger.error("发送简单邮件时发生异常！", e);
}
}
@Override
public void sendHtmlEmail(String to, String subject, String content) {
MimeMessage message = mailSender.createMimeMessage();//创建一个MINE消息
try {
//true表示需要创建一个multipart message
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setFrom(from);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);
mailSender.send(message);
logger.info("html邮件发送成功");
} catch (MessagingException e) {
logger.error("发送html邮件时发生异常！", e);
}
}
@Override
public void sendAttachmentsEmail(String to, String subject, String content, String filePath) {
MimeMessage message = mailSender.createMimeMessage();//创建一个MINE消息
try {
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setFrom(from);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);// true表示这个邮件是有附件的
FileSystemResource file = new FileSystemResource(new File(filePath));//创建文件系统资源
String fileName = filePath.substring(filePath.lastIndexOf(File.separator));
helper.addAttachment(fileName, file);//添加附件
mailSender.send(message);
logger.info("带附件的邮件已经发送。");
} catch (MessagingException e) {
logger.error("发送带附件的邮件时发生异常！", e);
}
}
@Override
public void sendInlineResourceEmail(String to, String subject, String content, String rscPath, String rscId) {
MimeMessage message = mailSender.createMimeMessage();
try {
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));
//添加内联资源，一个id对应一个资源，最终通过id来找到该资源
helper.addInline(rscId, res);//添加多个图片可以使用多条 <img src='cid:" + rscId + "' > 和 helper.addInline(rscId, res) 来实现
mailSender.send(message);
logger.info("嵌入静态资源的邮件已经发送。");
} catch (MessagingException e) {
logger.error("发送嵌入静态资源的邮件时发生异常！", e);
}
}
}编写测试类
- 需要将邮件服务注入进来
@Autowired
private EmailService emailService;
发送简单邮件
@Test
public void sendSimpleMail() throws Exception {
emailService.sendSimpleEmail("821300801@qq.com","this is simple mail"," hello LingDu");
}
发送带html的邮件
@Test
public void sendHtmlMail() throws Exception {
String content="<html>\n" +
"<body>\n" +
" <h3>hello world ! 这是一封Html邮件!</h3>\n" +
"</body>\n" +
"</html>";
emailService.sendHtmlEmail("821300801@qq.com","this is html mail",content);
}
发送带附件的文件
@Test
public void sendAttachmentsMail() {
String filePath="f:\\pikaqiu.png";
emailService.sendAttachmentsEmail("821300801@qq.com", "主题：带附件的邮件", "收到附件，请查收！", filePath);
}
发送带静态资源的文件
@Test
public void sendInlineResourceMail() {
String rscId = "001";
String content="<html><body>这是有图片的邮件：<img src=\'cid:" + rscId + "\' ></body></html>";
String imgPath = "f:\\pikaqiu.png";
emailService.sendInlineResourceEmail("821300801@qq.com", "主题：这是有图片的邮件", content, imgPath, rscId);
}
知识扩充
发送模版邮件
有些时候我还还会收到固定格式的邮件，如：
尊敬的LingDu用户：
恭喜您入住xxx平台VIP会员,您将享受xxx优惠福利，同时感谢您对xxx的关注与支持并欢迎您使用xx的产品与服务。
...
这里假设用户名是经常变动的，如果每次发送邮件都需要手动拼接的话会不够优雅，并且每次模板的修改都需要改动代码的话也很不方便，因此对于这类邮件需求，都建议做成邮件模板来处理。模板的本质很简单，就是在模板中替换变化的参数，转换为html字符串即可，这里以thymeleaf为例来演示。
导入thymeleaf的包
<!-- 引入模板引擎. -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>注意：如果使用thymeleaf模版引擎，请将application.properties中的jsp配置去掉，否则会找不到页面
# 页面默认前缀目录
#spring.mvc.view.prefix=/WEB-INF/page/
# 响应页面默认后缀
#spring.mvc.view.suffix=.jsp
创建邮件模版
- 在resorces/templates下创建email.html
<!DOCTYPE html>
<html lang="zh" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8"/>
<title>Title</title>
</head>
<body>
<h4 th:text="|尊敬的:${username} 用户：|"></h4><br /><br />
恭喜您入住xxx平台VIP会员,您将享受xxx优惠福利，同时感谢您对xxx的关注与支持并欢迎您使用xx的产品与服务。<br />
...
</body>
</html>
注入模版引擎
@Autowired
private TemplateEngine templateEngine;
解析模板并发送
//发送模版消息
@Test
public void sendTemplateMail() {
//创建邮件正文
Context context = new Context();
context.setVariable("username", "LingDu");
String emailContent = templateEngine.process("email", context);
System.out.println(emailContent);
emailService.sendHtmlEmail("821300801@qq.com","主题：这是模板邮件",emailContent);
}注意：Context 类是在org.thymeleaf.context.Context包下的。
- 这样就接收到固定格式的邮件了。
邮件服务注意事项
邮件发送失败
因为各种原因，总会有邮件发送失败的情况，比如：邮件发送过于频繁、网络异常等。在出现这种情况的时候，我们一般会考虑重新重试发送邮件，会分为以下几个步骤来实现：
1、接收到发送邮件请求，首先记录请求并且入库。
2、调用邮件发送接口发送邮件，并且将发送结果记录入库。
3、启动定时系统扫描时间段内，未发送成功并且重试次数小于3次的邮件，进行再次发送
异步发送
很多时候邮件发送并不是我们主业务必须关注的结果，比如通知类、提醒类的业务可以允许延时或者失败。这个时候可以采用异步的方式来发送邮件，加快主交易执行速度，在实际项目中可以采用MQ发送邮件相关参数，监听到消息队列之后启动发送邮件。
扫一扫
332
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
