菜鸟笔记(二) - Java邮件发送实践

本文将介绍多种使用Java发送Email的应用实践。

前提摘要：在学习Java Web的构建中，无论是触发型的邮件-注册，重置密码邮件，还是批量式的营销广告，订阅邮件，邮件发送是系统离不开的应用场景。本文需要你知道Maven的基本使用。

一、实用Java Mail发送邮件

引入maven依赖

        <!-- mail -->
        <dependency>
            <groupId>javax.mail</groupId>
            <artifactId>mail</artifactId>
            <version>1.4.7</version>
        </dependency>
        <dependency>
            <groupId>javax.activation</groupId>
            <artifactId>activation</artifactId>
            <version>1.1.1</version>
        </dependency>
        <dependency>
       <groupId>org.codemonkey.simplejavamail</groupId>
            <artifactId>simple-java-mail</artifactId>
            <version>2.1</version>
        </dependency>

Demo Code

package cn.daimaniu.blog.mail;

import org.codemonkey.simplejavamail.Email;
import org.codemonkey.simplejavamail.Mailer;
import org.codemonkey.simplejavamail.TransportStrategy;

import javax.mail.Message;

/**
 * Author :keepcleargas
 * Date   :2016-09-04 13:52.
 * <p>
 * 通过Java Mail 发送邮件,@see{ org.codemonkey.simplejavamail 简单化的Mail发送}
 */
public class JavaMailSender implements IMailSender {
    private final String host = "smtp.126.com"; // smtp host
    private final int port = 465; //smtp 端口
    private final String user = "<请填写你的host相对应的邮件地址>"; //发送者邮件地址
    private final String password = "<邮件密码>"; //邮件密码
    private final String sender = "<发件人名称>"; //发送人名称

    public boolean send(String to, String toName, String body) {
        Email email = new Email();
        email.setFromAddress(sender, user);
        email.setReplyToAddress(sender, user);
        email.addRecipient(toName, to, Message.RecipientType.TO);
        email.setTextHTML(body);
        email.setSubject("你好" + toName + ",我是一封来自菜鸟笔记的邮件!!!");
        new Mailer(host, port, user, password, TransportStrategy.SMTP_SSL).sendMail(email);
        return true;
    }
}

Notice: 记得将代码里的<>的内容替换掉，如<请填写你的host相对应的邮件地址> 为 xxxx@126.com.

打开终端，执行Test

mvn test -Dtest=MailTest#TestJavaMailSender.

即可发送邮件了。

效果如下

cnbj-java-mail@2x.png

二、使用第三方邮件服务

Aliyun邮件服务示例

引入maven依赖

        <!--aliyun mail-->
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>3.0.0</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-dm</artifactId>
            <version>3.0.0-rc1</version>
        </dependency>

Demo Code

package cn.daimaniu.blog.mail;

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.dm.model.v20151123.SingleSendMailRequest;
import com.aliyuncs.dm.model.v20151123.SingleSendMailResponse;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

/**
 * Author :keepcleargas
 * Date   :2016-09-04 13:55.
 * <p>
 * 通过Aliyun Java SDK 发送邮件
 */
public class AliyunMailSender implements IMailSender {
    public boolean send(String to, String toName, String body) {
        IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", "<your accessKey>", "<your accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);
        SingleSendMailRequest request = new SingleSendMailRequest();
        try {
            request.setAccountName("<控制台创建的发信地址>");
            request.setFromAlias("菜鸟笔记"); //发送人的昵称
            request.setAddressType(1);
            request.setTagName("<控制台创建的标签>");
            request.setReplyToAddress(true);
            request.setToAddress(to);
            request.setSubject("你好" + toName + ",我是一封来自菜鸟笔记的邮件!!!");
            request.setHtmlBody(body);
            SingleSendMailResponse httpResponse = client.getAcsResponse(request);
            System.out.println("res:" + httpResponse.toString());
            return true;
        } catch (ServerException e) {
            e.printStackTrace();
            return false;
        } catch (ClientException e) {
            e.printStackTrace();
            return false;
        }
    }
}

Notice: Aliyun 邮件服务需要在阿里云控制台申请开通，并设置自己的域名相关的发件人如 vip@daimaniu.cn,将验证成功的发件人，accessId和SecretKey替换<>。

打开终端，执行Test

mvn test -Dtest=MailTest#TestAliyunMailSender

效果如下

cnbj-mail.png

三、构建你的发送Html内容

使用模板语言，构建Html.

Velocity[^1]初识

Velocity 是一个基于Java 的模板引擎，它允许任何人仅仅简单的使用模板语言来引用由Java 代码定义的对象，从而实现界面和Java 代码的分离，使得界面设计人员可以和Java 程序开发人员同步开发一个遵循MVC 架构的web 站点。

推荐阅读 [^2]使用 Velocity 模板引擎快速生成代码

构建邮件正文

引入maven依赖

        <!--template-->
        <dependency>
            <groupId>org.apache.velocity</groupId>
            <artifactId>velocity</artifactId>
            <version>1.7</version>
        </dependency>
        <dependency>
            <groupId>org.apache.velocity</groupId>
            <artifactId>velocity-tools</artifactId>
            <version>2.0</version>
        </dependency>

在/src/main/resources/下新建文件夹template，添加reg.vm模板（发送注册验证邮件模板）.

reg.vm 标准的html格式

<html>
<head>
    <meta http-equiv="content-type" content="text/html;charset=utf8">
</head>
<body>
<p>${toName},你好</p>

<p>欢迎来到菜鸟笔记，您的登录帐号是:${to}</p>
<a href="http://blog.daimaniu.com/confirm?code=${code}">请点此完成邮箱验证</a>

<p>(如果以上链接无法点击，请将地址手工复制到浏览器地址栏中访问)
    <a href="http://blog.daimaniu.cn/confirm?code=${code}">http://blog.daimaniu.cn/confirm?code=${code}</a>
</p>

<p>----------------------------------------------</p>

<p>此信是由菜鸟笔记发出，请勿直接回复。</p>

</body>
</html>

VelocityUtil.java

public class VelocityUtil {
    /**
     * 生成 注册邮件
     *
     * @param to     接收人的邮件地址
     * @param toName 接收人的昵称
     * @param code   邮件验证码
     * @return
     */
    public static String genRegMail(String to, String toName, String code) {
        VelocityEngine ve = new VelocityEngine();
        ve.setProperty(RuntimeConstants.RESOURCE_LOADER, "classpath");
        ve.setProperty("classpath.resource.loader.class", ClasspathResourceLoader.class.getName());

        ve.init();

        Template t = ve.getTemplate("template/reg.vm", "utf-8");
        VelocityContext ctx = new VelocityContext();
        ctx.put("to", to);
        ctx.put("toName", toName);
        //code random
        ctx.put("code", code);

        StringWriter sw = new StringWriter();
        t.merge(ctx, sw);
        return sw.toString();
    }
}

Notice: ctx map里填写的字段都是reg.vm 里 ${}对应的数据字段。

打开终端，执行Test

mvn test -Dtest=MailTest#VelocityHtmlTest

cnbj-velocity-mail.png

四、场景案例分析

Trigger Sample:

Teambition的协作邀请.
知乎的注册邮箱验证
阿里云的服务器操作邮件
Google/Outlook的异地登录安全提醒
.......

Subscribe Sample:
1.daocloud的每周精选
2.垃圾邮件---[手动滑稽]

参考列表

本文源代码地址:https://github.com/daimaniu/cainiaobiji ,欢迎star 和 fork。
原文地址:http://blog.daimaniu.cn/cai-niao-bi-ji-er-javayou-jian-fa-song-shi-jian/

下期预告

下期预告(9月8号):Java Excel报表导入导出 - 企业管理后台必备技能。

欢迎大家关注我的微博，或者在 Follow 我。菜鸟笔记周四不见不散

菜鸟笔记(二) - Java邮件发送实践

一、实用Java Mail发送邮件

二、使用第三方邮件服务

Aliyun邮件服务示例

三、构建你的发送Html内容

Velocity[^1]初识

构建邮件正文

四、场景案例分析

参考列表

下期预告

推荐阅读更多精彩内容