JavaMailSender
我们知道 Spring 提供了非常好用的 JavaMailSender 接口实现邮件发送。在 Spring Boot 中也有提供对应 Starter 模块为此提供了自动化配置。这里简单介绍在 spring boot 中使用 spring 提供的 JavaMailSender 发送邮件。
添加依赖
Spring 框架通过 JavaMailSender 接口为发送邮件提供了一个简单的抽象，并且 SpringBoot 也为它提供了自动配置和一个 starter 模块。在 pom 中添加以下依赖后，Spring Boot 将创建一个默认的 JavaMailSender，该 sender 可以通过 spring.mail 命名空间下的配置项进一步自定义。
<!-- JavaMail -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
配置
# 这里注意默认的超时时间是无穷大，避免线程被阻塞尽量手动设置超时时间
spring.mail.properties.mail.smtp.connectiontimeout=10000
spring.mail.properties.mail.smtp.timeout=10000
spring.mail.properties.mail.smtp.writetimeout=10000
# 认证
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
# 账号、服务器信息
spring.mail.host=smtp.163.com # smtp服务器
spring.mail.username=jverson@163.com # 邮箱地址
spring.mail.password=******* #邮箱密码
注意有些邮件服务器（例如qq）邮箱密码项spring.mail.password需要设置为授权码，而非真正的邮箱密码
发送简单邮件
@Autowired
private JavaMailSender mailSender; //spring boot auto configure
@Value("${spring.mail.username}")
private String senderEmailAddr; //发件人需要和配置文件中配的保持一致
public void sendSimpleMail(String to, String subject, String content) {
SimpleMailMessage message = new SimpleMailMessage();
message.setFrom(senderEmailAddr);
message.setTo(to);
message.setSubject(subject);
message.setText(content);
try {
mailSender.send(message);
logger.info("sendSimpleMail done!");
} catch (Exception e) {
logger.error("sendSimpleMail exception！", e);
}
}
@Test
public void send(){
mailSenderService.sendSimpleMail("jverson@126.com", "sendSimpleMail Test", "hello this mail is from spring javaMail");
}
由于Spring Boot的starter模块提供了自动化配置，所以在引入了spring-boot-starter-mail依赖之后，会根据配置文件中的内容去创建JavaMailSender实例，因此我们可以直接在需要使用的地方直接@Autowired来引入邮件发送对象。
发送html邮件
public void sendHtmlMail(String to, String subject, String content) {
MimeMessage message = mailSender.createMimeMessage();
try {
//true表示需要创建一个multipart message
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setFrom(senderEmailAddr);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);
mailSender.send(message);
logger.info("sendHtmlMail done!");
} catch (MessagingException e) {
logger.error("sendHtmlMail exception！", e);
}
}
注意MimeMessageHelper helper = new MimeMessageHelper(message, true);第二个参数设为true表示邮件支持多媒体内容，例如附件、html及图片等，即whether to create a multipart message that
supports alternative texts, inline elements and attachments。
这个方法可以将写好的html静态页面以邮件正文形式发送出去，但更多的是用在模板邮件中，一般都会需要在模板中填充一些动态数据，例如下面就是使用FreeMaker创建的模板邮件的示例。
发送模板邮件
通常我们需要通过一个固定的模板给用户发送邮件，在Spring Boot中可以使用模板引擎来实现模板化的邮件发送。
@Autowired
private Configuration configuration; //freeMarker configuration
public void sendFreeMarkerTemplateMail(String to, String subject, String templateName, @SuppressWarnings("rawtypes") Map model){
Template t;
try {
t = configuration.getTemplate(templateName); // freeMarker template
String content = FreeMarkerTemplateUtils.processTemplateIntoString(t, model); //渲染模板
this.sendHtmlMail(to, subject, content);
logger.info("sendFreeMarkerTemplateMail done!");
} catch (IOException | TemplateException e) {
logger.info("sendFreeMarkerTemplateMail exception!");
e.printStackTrace();
}
}
@Test
public void sendTemplateMail(){
Map<String, Object> model = new HashMap<String, Object>();
model.put("name", "jverson");
mailSenderService.sendFreeMarkerTemplateMail("jverson@126.com", "sendFreeMarkerTemplateMail Test", "welcome.ftl", model);
}
模板文件位于classpath的templates目录下 
发送带附件的邮件
通过MimeMessageHelper来发送一封带有附件的邮件。
public void sendAttachmentsMail(String to, String subject, String content, String filename){
MimeMessage message = mailSender.createMimeMessage();
try {
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setFrom(senderEmailAddr);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);
//从classpath下加载附件文件
ClassLoader classLoader = getClass().getClassLoader();
URL url = classLoader.getResource(filename);
FileSystemResource file = new FileSystemResource(new File(url.getFile()));
helper.addAttachment(filename, file);
mailSender.send(message);
logger.info("sendAttachmentsMail done!");
} catch (MessagingException e) {
logger.error("sendAttachmentsMail exception！", e);
}
}
@Test
public void sendAttachmentsMail() throws Exception {
mailSenderService.sendAttachmentsMail("jverson@126.com", "sendAttachmentsMail Test", "有附件的邮件", "favicon.ico");
}
注意附件是从classpath路径下加载的两个图片文件，目录如下：
正文中嵌入图片
public void sendInlineResourceMail(String to, String subject, String content, String rscPath, String rscId){
MimeMessage message = mailSender.createMimeMessage();
try {
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setFrom(senderEmailAddr);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);
FileSystemResource res = new FileSystemResource(new File(rscPath));
helper.addInline(rscId, res);
mailSender.send(message);
logger.info("sendInlineResourceMail done!");
} catch (MessagingException e) {
logger.error("sendInlineResourceMail exception！", e);
}
}
@Test
public void sendInlineResourceMail(){
String rscId = "tttt"; //contentId
String content="<html><body>这是有图片的邮件：<img src=\'cid:" + rscId + "\' ></body></html>";
String imgPath = "C:\\Users\\jiwenxing\\Pictures\\hello-world.gif"; //文件绝对路径
mailSenderService.sendInlineResourceMail("jverson@126.com", "InlineResourceMail Test", content, imgPath, rscId);
}
收到的邮件是这样：
需要特别注意的是公司网络环境可能会有限制导致连接不上smtp服务器从而测试失败。
总结
如果用到发送邮件的功能需求，则可以直接将本例中的MailSenderService类引入直接调用即可，其中这些方法都经过了测试，使用方法可参考单元测试。