邮件工具-MailUtil

    Hutool对所有第三方都是可选依赖，因此在使用MailUtil时需要自行引入第三方依赖。

    在classpath（在标准Maven项目中为）的config目录下新建mail.setting文件，最小配置内容如下，在此配置下，smtp服务器和用户名都将通过from参数识别：

    1. # 发件人（必须正确，否则发送失败）
    2. from = hutool@yeah.net
    3. # 密码（注意，某些邮箱需要为SMTP服务单独设置密码，详情查看相关帮助）
    4. pass = q1w2e3

    有时候一些非标准邮箱服务器（例如企业邮箱服务器）的smtp地址等信息并不与发件人后缀一致，端口也可能不同，此时Hutool可以提供完整的配置文件：

    1. # 邮件服务器的SMTP地址，可选，默认为smtp.<发件人邮箱后缀>
    2. host = smtp.yeah.net
    3. # 邮件服务器的SMTP端口，可选，默认25
    4. port = 25
    5. # 发件人（必须正确，否则发送失败）
    6. from = hutool@yeah.net
    7. # 用户名，默认为发件人邮箱前缀
    8. user = hutool
    9. # 密码（注意，某些邮箱需要为SMTP服务单独设置密码，详情查看相关帮助）
    10. pass = q1w2e3
    • 发送普通文本邮件，最后一个参数可选是否添加多个附件：
    • 发送HTML格式的邮件并附带附件，最后一个参数可选是否添加多个附件：
    1. MailUtil.send("hutool@foxmail.com", "测试", "<h1>邮件来自Hutool测试</h1>", true, FileUtil.file("d:/aaa.xml"));
    • 群发邮件，可选HTML或普通文本，可选多个附件：
    1.     "person1@bbb.com", 
    2.     "person2@bbb.com", 
    3.     "person3@bbb.com", 
    6. MailUtil.send(tos, "测试", "邮件来自Hutool群发测试", false);

    发送邮件非常简单，只需一个方法即可搞定其中按照参数顺序说明如下：

    • tos: 对方的邮箱地址，可以是单个，也可以是多个（Collection表示）
    • subject：标题
    • content：邮件正文，可以是文本，也可以是HTML内容
    • isHtml： 是否为HTML，如果是，那参数3识别为HTML内容
    • files： 可选：附件，可以为多个或没有，将File对象加在最后一个可变参数中即可
    • 自定义邮件服务器除了使用配置文件定义全局账号以外，MailUtil.send方法同时提供重载方法可以传入一个MailAccount对象，这个对象为一个普通Bean，记录了邮件服务器信息。
    • 使用SSL加密方式发送邮件在使用QQ或Gmail邮箱时，需要强制开启SSL支持，此时我们只需修改配置文件即可：
    1. # 发件人（必须正确，否则发送失败），“小磊”可以任意变更，<>内的地址必须唯一，以下方式也对
    2. # from = hutool@yeah.net
    3. from = 小磊<hutool@yeah.net>
    4. # 密码（注意，某些邮箱需要为SMTP服务单独设置密码，详情查看相关帮助）
    5. pass = q1w2e3
    6. # 使用SSL安全连接
    7. sslEnable = true

    在原先极简配置下只需加入sslEnable即可完成SSL连接，当然，这是最简单的配置，很多参数根据已有参数已设置为默认。

    1. # 邮件服务器的SMTP地址
    2. host = smtp.yeah.net
    3. # 邮件服务器的SMTP端口
    4. port = 465
    5. from = hutool@yeah.net
    6. # 用户名（注意：如果使用foxmail邮箱，此处user为qq号）
    7. user = hutool
    8. # 密码（注意，某些邮箱需要为SMTP服务单独设置密码，详情查看相关帮助）
    10. #使用 STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。
    11. startttlsEnable = true
    13. # 使用SSL安全连接
    14. sslEnable = true
    15. # 指定实现javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
    16. socketFactoryClass = javax.net.ssl.SSLSocketFactory
    17. # 如果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, 默认值为true
    18. socketFactoryFallback = true
    19. # 指定的端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口456
    20. socketFactoryPort = 465
    22. # SMTP超时时长，单位毫秒，缺省值不超时
    23. timeout = 0
    24. # Socket连接超时值，单位毫秒，缺省值不超时
    25. connectionTimeout = 0

    3、针对QQ邮箱和Foxmail邮箱的说明

    (1) QQ邮箱中SMTP密码是单独生成的授权码，而非你的QQ密码，至于怎么生成，见腾讯的帮助说明：http://service.mail.qq.com/cgi-bin/help?subtype=1&&id=28&&no=1001256

    使用帮助引导生成授权码后，配置如下即可：

    1. host = smtp.qq.com
    2. from = XXXX@foxmail.com