文章感谢
导入jar
<!--邮件依赖-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
<!--用于实现模板邮件-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
添加邮件配置信息
spring:
mail:
host: smtp.163.com #smtp.qq.com
protocol: smtp #smtp
default-encoding: UTF-8
username: *********@163.com #7557*****@qq.com
password: ******* #jwgteykojlf*****
test-connection: true
thymeleaf:
cache: false #开发时关闭缓存
邮件发送
接口类
package com.saninco.app.service;
import com.saninco.app.model.RphSystemSettingsDomain;
import com.saninco.demo.ImageResource;
import org.thymeleaf.context.Context;
import java.util.Set;
public interface MailRphService {
/**
* 发送一个简单的文本邮件，可以附带附件：文本邮件发送的基本方法
* @param userEmail:发件人账号
* @param userEmailPwd:发件人密码
* @param systemDemo:系统配置信息
* @param subject：邮件主题，即邮件的邮件名称
* @param content：邮件内容
* @param toWho：需要发送的人
* @param ccPeoples：需要抄送的人
* @param bccPeoples：需要密送的人
* @param attachments：需要附带的附件，附件请保证一定要存在，否则将会被忽略掉
*/
public void sendSimpleTextMailActual(String userEmail,String userEmailPwd, RphSystemSettingsDomain systemDemo, String subject, String content, String[] toWho, String[] ccPeoples, String[] bccPeoples, String[] attachments);
/**
* 可以用来发送带有图片的HTML模板邮件
* @param userEmail:发件人账号
* @param userEmailPwd:发件人密码
* @param systemDemo:系统配置信息
* @param subject：邮件主题
* @param toWho：收件人
* @param ccPeoples：抄送人
* @param bccPeoples：暗送人
* @param attachments：附件
* @param templateName：模板名称
* @param context：模板解析需要的数据
* @param imageResourceSet：图片资源的资源对象
*/
public void sendHtmlTemplateMailActual(String userEmail,String userEmailPwd, RphSystemSettingsDomain systemDemo, String subject, String[] toWho, String[] ccPeoples, String[] bccPeoples, String[] attachments, String templateName, Context context, Set<ImageResource> imageResourceSet);
/**
* 根据id获取服务器设置信息
* @param id
* @return
*/
public RphSystemSettingsDomain getRphSystemSettingsMapperByid(Integer id);
}
实现类
package com.saninco.app.service;
import com.saninco.app.dao.RphSystemSettingsMapper;
import com.saninco.app.model.RphSystemSettingsDomain;
import com.saninco.demo.ImageResource;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.io.FileSystemResource;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSenderImpl;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;
import org.thymeleaf.TemplateEngine;
import org.thymeleaf.context.Context;
import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
import java.io.File;
import java.util.Arrays;
import java.util.Objects;
import java.util.Properties;
import java.util.Set;
/**
* 邮件服务，实现简单文本邮件，HTML文件和附件邮件，模板邮件的发送
* 支持的环境：JDK 1.8,SpringBoot 1.5.10,需要 mail-start，需要 thymeleaf 模板支持
*/
@Service
public class MailRphServiceImp implements MailRphService{
//默认编码
public static final String DEFAULT_ENCODING = "UTF-8";
//记录日志
private Logger logger = LoggerFactory.getLogger(MailRphServiceImp.class);
//模板引擎解析对象，用于解析模板
@Autowired
private TemplateEngine templateEngine;
@Autowired
private RphSystemSettingsMapper rphSystemSettingsMapper;//报错不影响
//邮件发送的对象，用于邮件发送
private JavaMailSenderImpl mJavaMailSenderImpl;
/**
* 发送一个简单的文本邮件，可以附带附件：文本邮件发送的基本方法
* @param userEmail:发件人账号
* @param userEmailPwd:发件人密码
* @param systemDemo:系统配置信息
* @param subject：邮件主题，即邮件的邮件名称
* @param content：邮件内容
* @param toWho：需要发送的人
* @param ccPeoples：需要抄送的人
* @param bccPeoples：需要密送的人
* @param attachments：需要附带的附件，附件请保证一定要存在，否则将会被忽略掉
*/
public void sendSimpleTextMailActual(String userEmail,String userEmailPwd, RphSystemSettingsDomain systemDemo,String subject,String content,String[] toWho,String[] ccPeoples,String[] bccPeoples,String[] attachments){
//检验参数：邮件主题、收件人、邮件内容必须不为空才能够保证基本的逻辑执行
if(subject == null||toWho == null||toWho.length == 0||content == null){
logger.error("邮件-> {} 无法继续执行，因为缺少基本的参数：邮件主题、收件人、邮件内容",subject);
throw new RuntimeException("模板邮件无法继续发送，因为缺少必要的参数！");
}
logger.info("开始发送简单文本邮件：主题->{}，收件人->{}，抄送人->{}，密送人->{}，附件->{}",subject,toWho,ccPeoples,bccPeoples,attachments);
mJavaMailSenderImpl=getJavaMailSender( userEmail, userEmailPwd,systemDemo);
//附件处理，需要处理附件时，需要使用二进制信息，使用 MimeMessage 类来进行处理
if(attachments != null&&attachments.length > 0){
try{
//附件处理需要进行二进制传输
MimeMessage mimeMessage = mJavaMailSenderImpl.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(mimeMessage,true,DEFAULT_ENCODING);
//设置邮件的基本信息：这些函数都会在后面列出来
boolean continueProcess = handleBasicInfo(helper,userEmail,subject,content,toWho,ccPeoples,bccPeoples,false);
//如果处理基本信息出现错误
if(!continueProcess){
logger.error("邮件基本信息出错: 主题->{}",subject);
return;
}
//处理附件
handleAttachment(helper,subject,attachments);
//发送该邮件
mJavaMailSenderImpl.send(mimeMessage);
logger.info("发送邮件成功: 主题->{}",subject);
}catch(MessagingException e){
e.printStackTrace();
logger.error("发送邮件失败: 主题->{}",subject);
}
}else{
//创建一个简单邮件信息对象
SimpleMailMessage simpleMailMessage = new SimpleMailMessage();
//设置邮件的基本信息
handleBasicInfo(userEmail,simpleMailMessage,subject,content,toWho,ccPeoples,bccPeoples);
//发送邮件
mJavaMailSenderImpl.send(simpleMailMessage);
logger.info("发送邮件成功: 主题->{}",subject,toWho,ccPeoples,bccPeoples,attachments);
}
}
/**
* 处理二进制邮件的基本信息，比如需要带附件的文本邮件、HTML文件、图片邮件、模板邮件等等
*
* @param mimeMessageHelper：二进制文件的包装类
* @param address:发件人地址
* @param subject：邮件主题
* @param content：邮件内容
* @param toWho：收件人
* @param ccPeoples：抄送人
* @param bccPeoples：暗送人
* @param isHtml：是否是HTML文件，用于区分带附件的简单文本邮件和真正的HTML文件
*
* @return ：返回这个过程中是否出现异常，当出现异常时会取消邮件的发送
*/
private boolean handleBasicInfo(MimeMessageHelper mimeMessageHelper,String address,String subject,String content,String[] toWho,String[] ccPeoples,String[] bccPeoples,boolean isHtml){
try{
//设置必要的邮件元素
//设置发件人
mimeMessageHelper.setFrom(address);
//设置邮件的主题
mimeMessageHelper.setSubject(subject);
//设置邮件的内容，区别是否是HTML邮件
mimeMessageHelper.setText(content,isHtml);
//设置邮件的收件人
mimeMessageHelper.setTo(toWho);
//设置非必要的邮件元素，在使用helper进行封装时，这些数据都不能够为空
if(ccPeoples != null){
//设置邮件的抄送人：MimeMessageHelper # Assert.notNull(cc, "Cc address array must not be null");
mimeMessageHelper.setCc(ccPeoples);
}
if(bccPeoples != null){
//设置邮件的密送人：MimeMessageHelper # Assert.notNull(bcc, "Bcc address array must not be null");
mimeMessageHelper.setBcc(bccPeoples);
}
return true;
}catch(MessagingException e){
e.printStackTrace();
logger.error("邮件基本信息出错->{}",subject);
}
return false;
}
/**
* 用于填充简单文本邮件的基本信息
* @param address:发件人地址
* @param simpleMailMessage：文本邮件信息对象
* @param subject：邮件主题
* @param content：邮件内容
* @param toWho：收件人
* @param ccPeoples：抄送人
* @param bccPeoples：暗送人
*/
private void handleBasicInfo(String address,SimpleMailMessage simpleMailMessage,String subject,String content,String[] toWho,String[] ccPeoples,String[] bccPeoples){
//设置发件人
simpleMailMessage.setFrom(address);
//simpleMailMessage
//设置邮件的主题
simpleMailMessage.setSubject(subject);
//设置邮件的内容
simpleMailMessage.setText(content);
//设置邮件的收件人
simpleMailMessage.setTo(toWho);
//设置邮件的抄送人
if(ccPeoples!=null){
simpleMailMessage.setCc(ccPeoples);
}
//设置邮件的密送人
if(bccPeoples!=null){
simpleMailMessage.setBcc(bccPeoples);
}
}
/**
* 用于处理附件信息，附件需要 MimeMessage 对象
*
* @param mimeMessageHelper：处理附件的信息对象
* @param subject：邮件的主题，用于日志记录
* @param attachmentFilePaths：附件文件的路径，该路径要求可以定位到本机的一个资源
*/
private void handleAttachment(MimeMessageHelper mimeMessageHelper,String subject,String[] attachmentFilePaths){
//判断是否需要处理邮件的附件
if(attachmentFilePaths != null&&attachmentFilePaths.length > 0){
FileSystemResource resource;
String fileName;
//循环处理邮件的附件
for(String attachmentFilePath : attachmentFilePaths){
//获取该路径所对应的文件资源对象
resource = new FileSystemResource(new File(attachmentFilePath));
//判断该资源是否存在，当不存在时仅仅会打印一条警告日志，不会中断处理程序。
// 也就是说在附件出现异常的情况下，邮件是可以正常发送的，所以请确定你发送的邮件附件在本机存在
if(!resource.exists()){
logger.warn("邮件->{} 的附件->{} 不存在！",subject,attachmentFilePath);
//开启下一个资源的处理
continue;
}
//获取资源的名称
fileName = resource.getFilename();
try{
//添加附件
mimeMessageHelper.addAttachment(fileName,resource);
}catch(MessagingException e){
e.printStackTrace();
logger.error("邮件->{} 添加附件->{} 出现异常->{}",subject,attachmentFilePath,e.getMessage());
}
}
}
}
/**
* 可以用来发送带有图片的HTML模板邮件
* @param userEmail:发件人账号
* @param userEmailPwd:发件人密码
* @param systemDemo:系统配置信息
* @param subject：邮件主题
* @param toWho：收件人
* @param ccPeoples：抄送人
* @param bccPeoples：暗送人
* @param attachments：附件
* @param templateName：模板名称
* @param context：模板解析需要的数据
* @param imageResourceSet：图片资源的资源对象
*/
public void sendHtmlTemplateMailActual(String userEmail,String userEmailPwd, RphSystemSettingsDomain systemDemo,String subject, String[] toWho, String[] ccPeoples, String[] bccPeoples, String[] attachments, String templateName, Context context, Set<ImageResource> imageResourceSet){
//检验参数：邮件主题、收件人、模板名称必须不为空才能够保证基本的逻辑执行
if(subject == null||toWho == null||toWho.length == 0||templateName == null){
logger.error("邮件-> {} 无法继续执行，因为缺少基本的参数：邮件主题、收件人、模板名称",subject);
throw new RuntimeException("模板邮件无法继续发送，因为缺少必要的参数！");
}
//日志这个邮件的基本信息
logger.info("发送HTML模板邮件：主题->{}，收件人->{}，抄送人->{}，密送人->{}，附件->{}，模板名称->{}，模板解析参数->{}，图片资源->{}）",subject,toWho,ccPeoples,bccPeoples,attachments,templateName,context,imageResourceSet);
try{
//context不能够为空，需要进行检查
if(context == null){
context = new Context();
logger.info("邮件->{} 的context为空！",subject);
}
//模板引擎处理模板获取到HTML字符串，这里会可能会抛出一个继承于RuntimeException的模板引擎异常
String content = templateEngine.process(templateName,context);
mJavaMailSenderImpl=getJavaMailSender(userEmail,userEmailPwd,systemDemo);
MimeMessage mimeMessage = mJavaMailSenderImpl.createMimeMessage();
//默认编码为UTF-8
MimeMessageHelper helper = new MimeMessageHelper(mimeMessage,true,DEFAULT_ENCODING);
//处理内联的图片资源的占位转换
content = handleInLineImageResourceContent(helper,subject,content,imageResourceSet);
logger.info("解析邮件结果->{}",content);
//处理基本信息
boolean continueProcess = handleBasicInfo(helper,userEmail,subject,content,toWho,ccPeoples,bccPeoples,true);
if(!continueProcess){
logger.error("邮件基本信息出错：主题->{}",subject);
return;
}
//内联资源的资源附加，这个必须要放置在设置基本信息的操作后面，或者是全部内容解析完毕后才可以，不能边解析，边占位
handleInLineImageResource(helper,subject,imageResourceSet);
//处理附件
handleAttachment(helper,subject,attachments);
//发送该邮件
mJavaMailSenderImpl.send(mimeMessage);
logger.info("发送邮件成功：主题->{}",subject);
}catch(MessagingException e){
e.printStackTrace();
logger.error("发送邮件失败：邮件主题->{}",subject);
}
}
/**
* 处理内嵌图片的模板HTML邮件，返回一个已经修改过后的HTML字符串
*
* @param mimeMessageHelper：邮件信息包装类
* @param subject：邮件主题
* @param originContent：模板引擎所解析出来的原始HTML邮件
* @param imageResourceSet：图片资源集合，用于字符集站位填充
*
* @return ：返回处理后的邮件内容
*/
private String handleInLineImageResourceContent(MimeMessageHelper mimeMessageHelper,String subject,String originContent,Set<ImageResource> imageResourceSet){
//处理内嵌的HTML图片文件
if(imageResourceSet != null&&imageResourceSet.size() > 0){
//资源的占位符ID
String rscId;
//资源的路径
String resourcePath = null;
//图片的位置信息
String placeHolder;
//图片资源文件
FileSystemResource resource;
for(ImageResource imageResource : imageResourceSet){
//获取图片资源的基本信息
rscId = imageResource.getId();
placeHolder = imageResource.getPlaceholder();
resourcePath = imageResource.getImageFilePath();
resource = new FileSystemResource(new File(resourcePath));
//判断图片资源是否存在
if(!resource.exists()){
logger.warn("邮件->{} 内联图片->{} 找不到",subject,resourcePath);
continue;
}
//替换图片资源在HTML中的位置
originContent = originContent.replace("\"" + ImageResource.PLACEHOLDERPREFIX + placeHolder + "\"","\'cid:" + rscId + "\'");
}
}
return originContent;
}
/**
* 填充文本数据，因为数据填充必须在设置基本数据后面进行，所以讲内容和数据的填充进行分离
*
* @param mimeMessageHelper
* @param subject：邮件主题，用于日志记录
* @param imageResourceSet：资源
*/
private void handleInLineImageResource(MimeMessageHelper mimeMessageHelper, String subject, Set<ImageResource> imageResourceSet){
if(imageResourceSet != null&&imageResourceSet.size() > 0){
FileSystemResource resource;
for(ImageResource imageResource : imageResourceSet){
resource = new FileSystemResource(new File(imageResource.getImageFilePath()));
if(!resource.exists()){
logger.warn("邮件->{} 的内联图片文件->{} 不存在！",subject,imageResource);
continue;
}
try{
//添加内联资源
mimeMessageHelper.addInline(imageResource.getId(),resource);
}catch(MessagingException e){
e.printStackTrace();
logger.error("邮件->{} 的内联图片文件->{} 添加错误！",subject,imageResource);
}
}
}
}
/**
* 传入的参数不能够为null
*
* @param args
*
* @return
*/
private boolean assertNotNull(Object... args){
return Arrays.stream(args).noneMatch(Objects::isNull);
}
/**
* 创建邮件链接信息
* @param userEmail:发件人邮箱账号
* @param userEmailPwd:发件人邮箱密码
* @param systemDemo:系统设置信息
* @return
*/
private JavaMailSenderImpl getJavaMailSender(String userEmail,String userEmailPwd, RphSystemSettingsDomain systemDemo){
JavaMailSenderImpl mJavaMailSenderImpl=new JavaMailSenderImpl();
//设置服务器地址
mJavaMailSenderImpl.setDefaultEncoding("utf-8");
mJavaMailSenderImpl.setUsername(userEmail);//发件人账号
mJavaMailSenderImpl.setPassword(userEmailPwd);//发件人密码
Properties props = new Properties();
props.setProperty("mail.transport.protocol", "smtp"); // 使用的协议（JavaMail规范要求）
props.setProperty("mail.smtp.host",systemDemo.getHost() ); // 发件人的邮箱的 SMTP 服务器地址
props.setProperty("mail.smtp.port", systemDemo.getPort());//连接的服务端口
props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
props.setProperty("mail.smtp.auth", "true"); // 需要请求认证
props.setProperty("mail.smtp.ssl.enable", "true");// 开启ssl
mJavaMailSenderImpl.setJavaMailProperties(props);
return mJavaMailSenderImpl;
}
/**
* 根据id获取服务器设置信息
* @param id
* @return
*/
public RphSystemSettingsDomain getRphSystemSettingsMapperByid(Integer id){
RphSystemSettingsDomain sysTemDemo =rphSystemSettingsMapper.selectById(id);
return sysTemDemo;
}
}
系统测试类
package com.saninco.app.model;
public class RphSystemSettingsDomain {
private Integer id;
private String host;//邮件服务器服务地址
private String port;//邮件服务器端口
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getHost() {
return host;
}
public void setHost(String host) {
this.host = host;
}
public String getPort() {
return port;
}
public void setPort(String port) {
this.port = port;
}
@Override
public String toString() {
return "RphSystemSettingsDomain{" +
"id=" + id +
", host='" + host + '\'' +
", port='" + port + '\'' +
'}';
}
}
模板类
package com.saninco.demo;
/**
*用于支撑HTML内嵌图片的支持类，拥有可以传输内联图片的全部基本信息
* 邮件发送模板使用
*/
public class ImageResource {
//占位符的前缀符号，用于替换字符串定位，比如：image1 在模板文件里面需要写成 #image1
public static final String PLACEHOLDERPREFIX = "#";
//用于文件区分，实现图片文件内联邮件发送
private final String id;
//这个图片需要填充到那个地方去，这个地方是一个标识，为了和其他标签区别开来，使用前缀加上标识符来进行区分，比如 ：#imageOrigin
private final String placeholder;
//图片的文件路径，该文件路径必须是本机文件系统的绝对路径，即可以直接 new File 的文件系统路径
private final String imageFilePath;
public ImageResource(String placeholder, String imageFilePath) {
this.placeholder = placeholder;
this.imageFilePath = imageFilePath;
//自动生成id，用于区分图片文件
this.id = String.valueOf(System.nanoTime());
}
public String getId() {
return id;
}
public String getPlaceholder() {
return placeholder;
}
public String getImageFilePath() {
return imageFilePath;
}
@Override
public String toString() {
return "ImageResource{" + "id=" + id + ", placeholder='" + placeholder + '\'' + ", imageFilePath='" + imageFilePath + '\'' + '}';
}
}
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8" />
<title>邮件模板</title>
</head>
<body>
<h2>你好！看见请回复！阿萨德刚应该好好奥斯卡了的豪华，爱的机会深V，是的妇女，似懂非懂速率辛苦，都市复仇</h2>
<p>这里更改一下 <span th:text="${name}"></span></p><br/>
<p>不知道我是<span th:text="${age}"></span></p><br/>
<p>怎么会被提档<span th:text="${sex}"></span></p><br/>
<img src="#sdm" width="100px" height="100px"/><br/>
<img src="#cyf" width="100px" height="100px"/><br/>
</body>
</html>
测试
package com.saninco.app.service;
import com.saninco.app.model.RphSystemSettingsDomain;
import com.saninco.app.model.RphUserDomain;
import com.saninco.demo.ImageResource;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.test.context.junit4.SpringRunner;
import org.thymeleaf.context.Context;
import javax.mail.MessagingException;
import java.util.HashSet;
import java.util.Set;
@RunWith(SpringRunner.class)
@SpringBootTest
public class MailRphServiceTest {
@Autowired
private MailRphService mailService;
@Autowired
private UserService userService;
@Autowired
private JavaMailSender mailSender;
//请把如下的信息写成你自己的邮箱信息
private String mailQQ = "*****@qq.com";
private String mail163 = "******@163.com";
private String mail139 = "******@139.com";
private String mailOutLook = "******@qq.com";//接收方
private String zipFile = "E:\\sum\\aasd.zip";
private String pngFile = "E:/sum/df.png";
private String jpgFile = "E:/sum/asd.jpg";
private String content = "还的哈可视对讲看见爱上看到就看见俺看到萨科技的发生科" +
"技发空间十分简单刷卡缴费吗，阿萨德佛is地方isif就爱看深V价值。\n家对改变行程中和回家奥斯卡接电" +
"飒飒回复克里斯多夫看了下处女座水电费看看吧菜鸟四东方红\n你发给话" +
"东方精工招待费管理会计赶快来记得发这个招待费高科技地" +
"大家是否考虑看的啥风科技很快就会阿斯蒂芬快乐哈市打分卡上的\n分开了花阿斯蒂芬好可怜爱德华分开了" +
"啊是的金凤凰看来还是到合肥会计核算的快捷回复还是到付款计划\n方改地址发来挂机了地址发过来看";
@Test
/**
* 测试发送文本邮件的接口
*/
public void sendSimpleTextMail() throws InterruptedException{
RphSystemSettingsDomain systemDemo =mailService.getRphSystemSettingsMapperByid(1);
RphUserDomain userDomain=userService.findRphUserByid(5);
mailService.sendSimpleTextMailActual(userDomain.getUserRphEmail(),userDomain.getUserRphEmailPwd(),systemDemo,"测试文件发送tt",content,new String[]{mailOutLook},
null,null,new String[]{zipFile});
}
@Test
/***
* 测试模板HTML邮件
*/
public void sendHtmlTemplateMail() throws MessagingException {
//模板解析的上下文
Context context = new Context();
context.setVariable("name","不讲理啊");
context.setVariable("age","4546");
context.setVariable("sex","大沙发斯蒂芬");
//设置内联的图片资源
ImageResource imageResource = new ImageResource("sdm",jpgFile);
ImageResource imageResource1 = new ImageResource("cyf",pngFile);
Set<ImageResource> imageResources = new HashSet<>();
imageResources.add(imageResource);
imageResources.add(imageResource1);
RphSystemSettingsDomain systemDemo =mailService.getRphSystemSettingsMapperByid(1);
RphUserDomain userDomain=userService.findRphUserByid(5);
mailService.sendHtmlTemplateMailActual(userDomain.getUserRphEmail(),userDomain.getUserRphEmailPwd(),systemDemo,"新一轮测试学生信息",new String[]{mailOutLook},new String[]{mail163},
null,new String[]{zipFile},
"mailTest",context,imageResources);
}
}
![Springboot项目启动后自动创建多表关联的数据库与表的方案[图]](data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=)