Java Mail发送邮件

时间:2022-09-24 09:13:25

  在日常开发过程中,很多人都会遇到java发送邮件的需求,整理了一下,提供两种发送邮件的方式:1.使用eml模版群发;2.自定义主题和内容单发;

  如果遇到连接失败等发送失败的问题,可以在代码中增加session.setDebug(true);  可以查看详细的错误日志,具体代码实现如下:  

import java.io.InputStream;
import java.util.Date;
import java.util.List;
import java.util.Properties;

import javax.mail.MessagingException;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

/**
 * @Description: 发送邮件
 * @author yehaixiao
 * @date 2017年7月25日
 */
public class SendEmailTest {

    private final static Log LOG = LogFactory.getLog(SendEmailTest.class);

    private static final String MAIL_SERVER_HOST = "发件人邮箱服务器的地址";

    private static final String USER = "发件人的邮箱账号";

    private static final String PASSWORD = "发件人的密码";

    /**
     * 按照指定模版群发邮件
     * 
     * @param toEmails
     * @param emlPath
     */
    public static void sendMassEml(List<String> toEmails, String emlPath) {
        if (toEmails == null || toEmails.size() == 0) {
            return;
        }
        Properties props = new Properties();
        // 使用的协议(JavaMail规范要求)
        props.setProperty("mail.transport.protocol", "smtp");
        // 发件人的邮箱的 SMTP
        props.setProperty("mail.smtp.host", MAIL_SERVER_HOST);
        // 需要请求认证
        props.setProperty("mail.smtp.auth", "true");
        Transport transport = null;
        try {
            // PS: 某些邮箱服务器要求 SMTP 连接需要使用 SSL 安全认证 (为了提高安全性, 邮箱支持SSL连接, 也可以自己开启),
            // 如果无法连接邮件服务器, 仔细查看控制台打印的 log, 如果有有类似 “连接失败, 要求 SSL 安全连接” 等错误,
            // 打开下面 注释代码, 开启 SSL 安全连接。

            // SMTP 服务器的端口 (非 SSL 连接的端口一般默认为 25, 可以不添加, 如果开启了 SSL 连接,
            // 需要改为对应邮箱的 SMTP 服务器的端口, 具体可查看对应邮箱服务的帮助, QQ邮箱的SMTP(SLL)端口为465或587,
            // 其他邮箱自行去查看)
            final String smtpPort = "465";
            props.setProperty("mail.smtp.port", smtpPort);
            props.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
            props.setProperty("mail.smtp.socketFactory.fallback", "false");
            props.setProperty("mail.smtp.socketFactory.port", smtpPort);
            // 根据配置创建会话对象, 用于和邮件服务器交互
            Session session = Session.getDefaultInstance(props);
            // 设置为debug模式, 可以查看详细的发送 log
            session.setDebug(false);
            // 根据 Session 获取邮件传输对象
            transport = session.getTransport();
            // 使用 邮箱账号 和 密码 连接邮件服务器, 这里认证的邮箱必须与 message 中的发件人邮箱一致, 否则报错
            //
            // PS_01: 成败的判断关键在此一句, 如果连接服务器失败, 都会在控制台输出相应失败原因的 log,
            // 仔细查看失败原因, 有些邮箱服务器会返回错误码或查看错误类型的链接, 根据给出的错误
            // 类型到对应邮件服务器的帮助网站上查看具体失败原因。
            //
            // PS_02: 连接失败的原因通常为以下几点, 仔细检查代码:
            // (1) 邮箱没有开启 SMTP 服务;
            // (2) 邮箱密码错误, 例如某些邮箱开启了独立密码;
            // (3) 邮箱服务器要求必须要使用 SSL 安全连接;
            // (4) 请求过于频繁或其他原因, 被邮件服务器拒绝服务;
            // (5) 如果以上几点都确定无误, 到邮件服务器网站查找帮助。
            //
            // PS_03: 仔细看log, 认真看log, 看懂log, 错误原因都在log已说明。
            transport.connect(USER, PASSWORD);
            for (String toEmail : toEmails) {
                // 创建一封邮件
                MimeMessage message = createMimeMessageByEml(session, toEmail, emlPath);
                // 发送邮件, 发到所有的收件地址, message.getAllRecipients()
                // 获取到的是在创建邮件对象时添加的所有收件人,
                // 抄送人, 密送人
                transport.sendMessage(message, message.getAllRecipients());
            }
            LOG.info("发送邮件成功,总数:" + toEmails.size());
        } catch (Exception e) {
            LOG.error("发送邮件失败", e);
        } finally {
            if (transport != null) {
                try {
                    // 关闭连接
                    transport.close();
                } catch (MessagingException e) {
                    LOG.error("关闭通道失败", e);
                }
            }
        }
    }

    /**
     * 创建指定eml模版邮件
     * 
     * @param session
     * @param sendMail
     * @param receiveMail
     * @param eml
     * @return
     * @throws Exception
     */
    private static MimeMessage createMimeMessageByEml(Session session, String toEmail, String eml) throws Exception {
        InputStream stream = Thread.currentThread().getContextClassLoader().getResourceAsStream(eml);
        // 创建一封本地邮件
        MimeMessage message = new MimeMessage(session, stream);
        // From: 发件人
        // InternetAddress 的三个参数分别为: 邮箱, 显示的昵称(只用于显示, 没有特别的要求), 昵称的字符集编码
        message.setFrom(new InternetAddress(USER, "网易见外"));
        // To: 收件人(可以增加多个收件人、抄送、密送)
        message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(toEmail));
        // Subject: 邮件主题
        // 设置发件时间
        message.setSentDate(new Date());
        // 保存设置
        message.saveChanges();
        stream.close();
        return message;
    }

    /**
     * 发送简单的邮件
     * 
     * @param toEmail
     * @param subject
     * @param content
     */
    public static void sendSimpleContent(String toEmail, String subject, String content) {
        Properties props = new Properties();
        props.setProperty("mail.transport.protocol", "smtp");
        props.setProperty("mail.smtp.host", MAIL_SERVER_HOST);
        props.setProperty("mail.smtp.auth", "true");
        try {
            final String smtpPort = "465";
            props.setProperty("mail.smtp.port", smtpPort);
            props.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
            props.setProperty("mail.smtp.socketFactory.fallback", "false");
            props.setProperty("mail.smtp.socketFactory.port", smtpPort);
            Session session = Session.getDefaultInstance(props);
            session.setDebug(false);
            MimeMessage message = createSimpleMessage(session, toEmail, subject, content);
            Transport transport = session.getTransport();
            transport.connect(USER, PASSWORD);
            transport.sendMessage(message, message.getAllRecipients());
            transport.close();
            LOG.info("发送邮件成功,收件人:" + toEmail);
        } catch (Exception e) {
            LOG.error("发送邮件失败", e);
        }
    }

    /**
     * 创建简单的文本邮件
     * 
     * @param session
     * @param toEmail
     * @param subject
     * @param content
     * @return
     * @throws Exception
     */
    private static MimeMessage createSimpleMessage(Session session, String toEmail, String subject, String content)
            throws Exception {
        MimeMessage message = new MimeMessage(session);
        message.setFrom(new InternetAddress(USER));
        message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(toEmail));
        message.setSubject(subject, "UTF-8");
        message.setContent(content, "text/html;charset=UTF-8");
        message.setSentDate(new Date());
        message.saveChanges();
        return message;
    }
}