25、springboot发送邮件（springboot email）

虽然现在短信验证已经最流行也是最常用的验证方式；但是邮件验证还是必不可少，依然是网站的必备功能之一。什么注册验证，忘记密码或者是给用户发送营销信息都是可以使用邮件发送功能的。最早期使用JavaMail的相关api来进行发送邮件的功能开发，后来spring整合了JavaMail的相关api推出了JavaMailSender更加简化了邮件发送的代码编写，现在springboot对此进行了封装就有了现在的spring-boot-starter-mail。

1、新建项目sc-mail，对应的pom.xml文件如下

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 <modelVersion>4.0.0</modelVersion>
 <groupId>spring-cloud</groupId>
 <artifactId>sc-mail</artifactId>
 <version>0.0.1-SNAPSHOT</version>
 <packaging>jar</packaging>
 <name>sc-mail</name>
 <url>http://maven.apache.org</url>
 <parent>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-parent</artifactId>
 <version>2.0.4.RELEASE</version>
 </parent>
 <dependencyManagement>
 <dependencies>
 <dependency>
 <groupId>org.springframework.cloud</groupId>
 <artifactId>spring-cloud-dependencies</artifactId>
 <version>Finchley.RELEASE</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 </dependencies>
 </dependencyManagement>
 <properties>
 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 <maven.compiler.source>1.8</maven.compiler.source>
 <maven.compiler.target>1.8</maven.compiler.target>
 </properties>
 <dependencies>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-mail</artifactId>
 </dependency>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-test</artifactId>
 <scope>test</scope>
 </dependency>
 </dependencies>
</project>

2、新建配置文件application.yml

spring:
 application:
 name: sc-mail
 mail:
 host: smtp.qq.com #邮箱服务器地址
 port: 465
 username: 515768476@qq.com #用户名
 password: vfcqhwsnnwugbhcx #密码 （改成自己的密码）
 default-encoding: UTF-8
 properties:
 mail:
 smtp:
 ssl:
 enable:
 true

3、新建邮件发送服务类

package sc.mail.service.impl;
import java.io.File;
import javax.mail.internet.MimeMessage;
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.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;
import sc.mail.service.MailService;
@Service
public class MailServiceImpl implements MailService {
 private final Logger logger = LoggerFactory.getLogger(this.getClass());
 @Autowired
 private JavaMailSender mailSender;
 /**
 * 文本
 * @param from
 * @param to
 * @param subject
 * @param content
 */
 @Override
 public void sendSimpleMail(String from, String to, String subject, String content) {
 SimpleMailMessage message = new SimpleMailMessage();
 message.setFrom(from);
 message.setTo(to);
 message.setSubject(subject);
 message.setText(content);
 try {
 mailSender.send(message);
 logger.info("simple mail had send。");
 } catch (Exception e) {
 logger.error("send mail error", e);
 }
 }
 /**
 * @param from
 * @param to
 * @param subject
 * @param content
 */
 public void sendTemplateMail(String from, String to, String subject, String content) {
 MimeMessage message = mailSender.createMimeMessage();
 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("send template success");
 } catch (Exception e) {
 logger.error("send template eror", e);
 }
 }
 /**
 * 附件
 * 
 * @param from
 * @param to
 * @param subject
 * @param content
 * @param filePath
 */
 public void sendAttachmentsMail(String from, String to, String subject, String content, String filePath){
 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 file = new FileSystemResource(new File(filePath));
 String fileName = filePath.substring(filePath.lastIndexOf(File.separator));
 helper.addAttachment(fileName, file);
 mailSender.send(message);
 logger.info("send mail with attach success。");
 } catch (Exception e) {
 logger.error("send mail with attach success", e);
 }
 }
 /**
 * 发送内嵌图片
 * 
 * @param from
 * @param to
 * @param subject
 * @param content
 * @param imgPath
 * @param imgId
 */
 public void sendInlineResourceMail(String from, String to, String subject, String content,
 String imgPath, String imgId){
 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(imgPath));
 helper.addInline(imgId, res);
 mailSender.send(message);
 logger.info("send inner resources success。");
 } catch (Exception e) {
 logger.error("send inner resources fail", e);
 }
 }
}

4、新建测试类

package sc.mail;
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.test.context.junit4.SpringRunner;
import sc.mail.service.MailService;
@RunWith(SpringRunner.class)
@SpringBootTest
public class MailSendTest {
 @Autowired
 private MailService mailService;
 @Test
 public void sendSimpleMailTest() {
 mailService.sendSimpleMail("515768476@qq.com", "happy.huangjinjin@163.com", 
 "sendSimpleMailTest", "sendSimpleMailTest from 515768476@qq.com");
 }
 @Test
 public void sendTemplateMailTest() {
 String html = "<html><body>"
 + " <div> "
 + " sendTemplateMailTest from 515768476@qq.com </br>"
 + " <b>这是模板邮件</b>"
 + "</div>"
 + "</body></html>";
 mailService.sendTemplateMail("515768476@qq.com", "happy.huangjinjin@163.com", 
 "sendTemplateMailTest", html);
 }
 @Test
 public void sendAttachmentsMailTest() {
 String filePath = "D:\\springcloudws\\sc-mail\\src\\main\\java\\sc\\mail\\service\\impl\\MailServiceImpl.java";
 mailService.sendAttachmentsMail("515768476@qq.com", "happy.huangjinjin@163.com", 
 "sendAttachmentsMailTest", "sendAttachmentsMailTest from 515768476@qq.com", filePath);
 }
 @Test
 public void sendInlineResourceMailTest() {
 String imgId = "img1";
 String content = "<html><body>"
 + "sendInlineResourceMailTest：<img src=\'cid:" + imgId + "\' >"
 + "</body></html>";
 String imgPath = "D:\\springcloudws\\sc-mail\\src\\main\\resources\\20181015223228.jpg";
 mailService.sendInlineResourceMail("515768476@qq.com", "happy.huangjinjin@163.com", 
 "sendAttachmentsMailTest", content, imgPath, imgId);
 }
}

5、运行测试类验证是否发送邮件成功

登录happy.huangjinjin@163.com邮箱

简单邮件

模板邮件

附件邮件

内嵌图片邮件