javax.mail发送邮件

赵英范
2023-12-01

在网络上查了很多资料,因为一些原因,生生花费了近4天时间,才完成一个小小的发送邮件功能。为方便后来者开发,节省时间,现在总结一下。希望后来者,可以30分钟内搞定。
1.确定发件人的邮箱是哪种(QQ邮箱,网易邮箱,或者是内网的邮箱系统)
2.确定邮箱系统使用的发送功能使用的协议:(SMTP,SMTPS)
3.确定邮箱SMTP服务器地址以及端口(或者SMTPS的服务器地址以及端口)。

  • 发邮件前是否验证发件人的用户名,密码。
  • 发件人或者收件人信息是否来自数据库。
  • 发件人邮箱必须开启SMTP等相关协议,QQ邮箱,网易邮箱的操作码(不是登陆密码,在开启协议时,会提示出来)。

这里只给出一些链接,方便大家使用。

1. 直接的发送。

import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Date;
import java.util.Properties;

public class Main {

    // 发件人的 邮箱 和 密码(替换为自己的邮箱和密码)
    // PS: 某些邮箱服务器为了增加邮箱本身密码的安全性,给 SMTP 客户端设置了独立密码(有的邮箱称为“授权码”), 
    //     对于开启了独立密码的邮箱, 这里的邮箱密码必需使用这个独立密码(授权码)。
    public static String myEmailAccount = "xxxxxxxxx@163.com";
    public static String myEmailPassword = "xxxxxxxxx";

    // 发件人邮箱的 SMTP 服务器地址, 必须准确, 不同邮件服务器地址不同, 一般(只是一般, 绝非绝对)格式为: smtp.xxx.com
    // 网易163邮箱的 SMTP 服务器地址为: smtp.163.com
    public static String myEmailSMTPHost = "smtp.163.com";

    // 收件人邮箱(替换为自己知道的有效邮箱)
    public static String receiveMailAccount = "xiejava@qq.com";

    public static void main(String[] args) throws Exception {
        // 1. 创建参数配置, 用于连接邮件服务器的参数配置
        Properties props = new Properties();                    // 参数配置
        props.setProperty("mail.transport.protocol", "smtp");   // 使用的协议(JavaMail规范要求)
        props.setProperty("mail.smtp.host", myEmailSMTPHost);   // 发件人的邮箱的 SMTP 服务器地址
        props.setProperty("mail.smtp.auth", "true");            // 需要请求认证

        // 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);
        */

        // 2. 根据配置创建会话对象, 用于和邮件服务器交互
        Session session = Session.getDefaultInstance(props);
        session.setDebug(true);                                 // 设置为debug模式, 可以查看详细的发送 log

        // 3. 创建一封邮件
        MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount);

        // 4. 根据 Session 获取邮件传输对象
        Transport transport = session.getTransport();

        // 5. 使用 邮箱账号 和 密码 连接邮件服务器, 这里认证的邮箱必须与 message 中的发件人邮箱一致, 否则报错
        // 
        //    PS_01: 成败的判断关键在此一句, 如果连接服务器失败, 都会在控制台输出相应失败原因的 log,
        //           仔细查看失败原因, 有些邮箱服务器会返回错误码或查看错误类型的链接, 根据给出的错误
        //           类型到对应邮件服务器的帮助网站上查看具体失败原因。
        //
        //    PS_02: 连接失败的原因通常为以下几点, 仔细检查代码:
        //           (1) 邮箱没有开启 SMTP 服务;
        //           (2) 邮箱密码错误, 例如某些邮箱开启了独立密码;
        //           (3) 邮箱服务器要求必须要使用 SSL 安全连接;
        //           (4) 请求过于频繁或其他原因, 被邮件服务器拒绝服务;
        //           (5) 如果以上几点都确定无误, 到邮件服务器网站查找帮助。
        //
        //    PS_03: 仔细看log, 认真看log, 看懂log, 错误原因都在log已说明。
        transport.connect(myEmailAccount, myEmailPassword);

        // 6. 发送邮件, 发到所有的收件地址, message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
        transport.sendMessage(message, message.getAllRecipients());

        // 7. 关闭连接
        transport.close();
    }

    /**
     * 创建一封只包含文本的简单邮件
     *
     * @param session 和服务器交互的会话
     * @param sendMail 发件人邮箱
     * @param receiveMail 收件人邮箱
     * @return
     * @throws Exception
     */
    public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail) throws Exception {
        // 1. 创建一封邮件
        MimeMessage message = new MimeMessage(session);

        // 2. From: 发件人
        message.setFrom(new InternetAddress(sendMail, "某宝网", "UTF-8"));

        // 3. To: 收件人(可以增加多个收件人、抄送、密送)
        message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail, "XX用户", "UTF-8"));

        // 4. Subject: 邮件主题
        message.setSubject("打折钜惠", "UTF-8");

        // 5. Content: 邮件正文(可以使用html标签)
        message.setContent("XX用户你好, 今天全场5折, 快来抢购, 错过今天再等一年。。。", "text/html;charset=UTF-8");

        // 6. 设置发件时间
        message.setSentDate(new Date());

        // 7. 保存设置
        message.saveChanges();

        return message;
    }

}

详细内容请参照直接发送邮件,但是内容都是在一个类里,且发送前没有进行用户名密码校验

内部邮箱系统可能邮件的消息头的日期不符合中文规范,这是系统解析邮件问题,这里不讨论。

2. 发送前验证用户名和密码

  • 1、构建一个继承自javax.mail.Authenticator的具体类,并重写里面的getPasswordAuthentication()方法。此类是用作登录校验的,以确保你对该邮箱有发送邮件的权利。

  • 2、构建一个properties文件,该文件中存放SMTP服务器地址等参数。

  • 3、通过构建的properties文件和javax.mail.Authenticator具体类来创建一个javax.mail.Session。Session的创建,就相当于登录邮箱一样。剩下的自然就是新建邮件。

  • 4、构建邮件内容,一般是javax.mail.internet.MimeMessage对象,并指定发送人,收信人,主题,内容等等。

  • 5、使用javax.mail.Transport工具类发送邮件。

这部分的参考资料,估计是以为大神写的,中间缺少一些类和方法。参考资料的链接JAVA邮件发送的简单实现

下面这部分代码是,自己结合资料写的

public class SimpleMail(){
      // 创建Properties 类用于记录邮箱的一些属性
        Properties props = new Properties();
        // 表示SMTP发送邮件,必须进行身份验证
        props.put("mail.smtp.auth", "true");
        //此处填写SMTP服务器
        props.put("mail.smtp.host", "smtp.qq.com");
        //端口号,QQ邮箱给出了两个端口,但是另一个我一直使用不了,所以就给出这一个587
        props.put("mail.smtp.port", "587");
        // 此处填写你的账号
        props.put("mail.user", "xxxxxxx@qq.com");
        // 此处的密码就是前面说的16位STMP口令
        props.put("mail.password", "xxxxxxxxxxxxxxxxxxx");

        // 构建授权信息,用于进行SMTP进行身份验证
        Authenticator authenticator = new Authenticator() {

            protected PasswordAuthentication getPasswordAuthentication() {
                // 用户名、密码
                String userName = props.getProperty("mail.user");
                String password = props.getProperty("mail.password");
                return new PasswordAuthentication(userName, password);
            }
        };
        // 使用环境属性和授权信息,创建邮件会话
        Session mailSession = Session.getInstance(props, authenticator);
        // 创建邮件消息
        MimeMessage message = new MimeMessage(mailSession);
        // 设置发件人
        InternetAddress form = new InternetAddress(
                props.getProperty("mail.user"));
        message.setFrom(form);

        // 设置收件人的邮箱
        InternetAddress to = new InternetAddress("xxxxxxxx@qq.com");
        message.setRecipient(RecipientType.TO, to);

        // 设置邮件标题
        message.setSubject("测试邮件");

        // 设置邮件的内容体
        message.setContent("这是一封测试邮件", "text/html;charset=UTF-8");

        // 最后当然就是发送邮件啦
        Transport.send(message);
}

3.使用SMTPS协议发送邮件

import java.util.Date;
import java.util.Properties;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
public class SendEmailService {
    private Logger logger = Logger.getLogger(SendEmailService.class.getName());
    public void sendEmail() {
    final String GMAIL_HOST = "smtp.gmail.com";
    final String ZOHO_HOST = "smtp.zoho.com";
    final String SSL_PORT = "465";
    final String SENDER_EMAIL = "username@zoho.com";//发件用户名
    final String SENDER_USERNAME = "username@zoho.com";//邮件的FROMUSER属性值;
    final String SENDER_PASSWORD = "zoho-password";//发件用户密码
    // protocol properties
    Properties props = System.getProperties();
    props.setProperty("mail.smtps.host", ZOHO_HOST); //设置发件邮箱smtps服务器地址                          
    props.setProperty("mail.smtp.port", SSL_PORT);
    props.setProperty("mail.smtp.startssl.enable", "true");
    props.setProperty("mail.smtps.auth", "true");//与smtp不同
    props.put("mail.smtps.quitwait", "false");  //一取消发件就关闭连接。
    Session session = Session.getInstance(props, null);
    try {
        // 新建邮件
        final MimeMessage msg = new MimeMessage(session);
        // 设置收件人(可以多个,对应不同方法)和邮件内容
        msg.setFrom(new InternetAddress(SENDER_EMAIL));
        msg.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@gmail.com", false));
        msg.setSubject("Demo");//设置邮件主题
        msg.setText("Message Sent via JavaMail", "utf-8", "html");//设置邮件内容
        msg.setSentDate(new Date());//设置发送时间
        Transport transport = session.getTransport("smtps");//注意:这里是有参数的“smtps”
        //smtp的是没有参数的
        //Transport transport = session.getTransport();
        // 发送邮件
        transport.connect(ZOHO_HOST, SENDER_USERNAME, SENDER_PASSWORD);
        transport.sendMessage(msg, msg.getAllRecipients());
        transport.close();
    } catch (MessagingException e) {
        logger.log(Level.SEVERE, "Failed to send message", e);
    }
    }
} 

参考资料,JavaMail使用SMTPS协议发送邮件

4.内部系统发送邮件
参照1 但是服务器地址和端口都是邮箱系统管理员提供,并且发送邮件的网络是内网。

 类似资料: