基于JavaMail开发邮件发送器工具类

在开发当中肯定会碰到利用Java调用邮件服务器的服务发送邮件的情况，比如账号激活、找回密码等功能。本人之前也碰到多次这样需求，为此特意将功能封装成一个简单易用工具类，需要用邮件发送功能时，只需要调用相关的接口即可。本人也将该工具提交到了GitHub上（https://github.com/lzj09/mail-helper），供大家参考。接下来，简单介绍一下该工具类及使用方法。

1、工程依赖

本工程主要依赖如下Jar:

<dependency>
    <groupId>javax.mail</groupId>
    <artifactId>javax.mail-api</artifactId>
    <version>1.6.2</version>
</dependency>

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.23</version>
</dependency>

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

由于邮件发送是基于JavaMail的所以需要依赖JavaMail相关的Jar;

发送邮件的模板不仅支持简单的文本内容，也支持html，同时邮件模板中的语法支持freemarker语法，所以需要freemarker相关Jar;

记录日志信息，目前使用log4j。

2、核心类MailHelper

核心类MailHelper中最重要的send方法，即邮件发送方法，该方法的签名为：

public static void send(SenderConfig sender, String receiver, String subject, String template, Map<String, Object> data) throws Exception

该方法有5个参数，分别是：

SenderConfig sender：邮件发送账号的配置信息，配置信息有：

// 用户名
private String username;
// 密码
private String password;
// 昵称
private String nickname;
// smtp服务主机名
private String smtpHost;
// smtp服务端口
private String smtpPort;
// 是否开启ssl
private boolean isSsl;

其实最主要就是smtp的配置信息

String receiver：邮件接收者邮箱地址
String subject：邮件的主题，也即在邮件列表上显示的名称
String template：邮件模板内容，支持freemarker语法
Map<String, Object> data：邮件模板中需要替换的数据内容

该方法的实现为：

// 将SenderConfig配置信息转换成Properties
Properties prop = wrapProperties(sender);

// 获取权限配置
AuthConfig auth = getAuthConfig(sender);

// 构建邮件会话
Session mailSession = Session.getDefaultInstance(prop, auth);  
mailSession.setDebug(false); 

// 构建邮件消息
Message mailMessage = new MimeMessage(mailSession);

// 设置昵称
String nick = MimeUtility.encodeText(getNickname(sender));
Address from = new InternetAddress(nick + " <" + sender.getUsername() + ">"); 
mailMessage.setFrom(from);

// 设置邮件接收者
Address to = new InternetAddress(receiver);
mailMessage.setRecipient(Message.RecipientType.TO, to);  

// 设置邮件主题
mailMessage.setSubject(subject);

// 设置发送时间
mailMessage.setSentDate(new Date());

// 设置邮件内容
Multipart mainPart = new MimeMultipart();
// 内容是可以包含html
BodyPart html = new MimeBodyPart();
html.setContent(getContent(template, data), "text/html; charset=utf-8");
mainPart.addBodyPart(html);
mailMessage.setContent(mainPart);

// 发送邮件  
Transport.send(mailMessage);

3、测试

利用邮件发送的工具类测试将邮件发送出去：

首先准备需要发送的邮件模板：test.html

<!doctype html>
<html>
    <head>
        <title>测试邮件</title>
        <meta charset="utf-8">
    </head>
    
    <body>
        <h2>${name}</h2>
        <div>${description}</div>
    </body>
</html>

其中模板中放置了2个占位符，分别是${name}和${description}

构建测试例子：

// 配置邮件发送信息
SenderConfig sender = new SenderConfig();
sender.setNickname("架构与我");
// 改成自己的邮件帐号
sender.setUsername("xxx@163.com");
// 改成自己的邮件密码
sender.setPassword("xxx");
sender.setSmtpHost("smtp.163.com");
sender.setSmtpPort("25");
sender.setSsl(false);

// 获取邮件模板
File tpl = new File("src/test/resources/test.html");
StringBuilder builder = new StringBuilder();
try (BufferedReader reader = new BufferedReader(new InputStreamReader(new FileInputStream(tpl), "utf-8"));) {
    String line = null;
    while ((line = reader.readLine()) != null) {
        builder.append(line);
    }
}

// 测试数据
Map<String, Object> data = new HashMap<String, Object>();
data.put("name", "架构与我");
data.put("description", "专注大数据、微服务架构、高并发高吞吐量大型网站、移动开发。");

// 测试发送邮件
// 改成自己的接收邮件地址
MailHelper.send(sender, "xxx@qq.com", "来自架构与我的邮件", builder.toString(), data);

发送成功后，可以看到接收邮箱的内容如下：