Java 收發(fā)郵件 (Jakarta Mail)

Jakarta Mail API提供了一個(gè)獨(dú)立于平臺(tái)和協(xié)議的框架來構(gòu)建郵件，完成郵件接收與發(fā)送功能。它也包含在Java EE平臺(tái)中，也可以和Java SE平臺(tái)一起使用。

Jakarta Mail的前生是JavaMail。JavaMail最后一個(gè)版本是于2018年8月發(fā)布，已經(jīng)停止更新。新項(xiàng)目應(yīng)該使用Jakarta Mail。

現(xiàn)在很多郵箱默認(rèn)關(guān)閉smtp，pop3，imap服務(wù)，需要在設(shè)置中手動(dòng)開啟。

1257f786fa008bb14fea9aff63591654.png

如果郵箱是使用授權(quán)碼，則需要生成授權(quán)碼(代替下文中密碼)，這種方式更安全。

依賴

注意Jakarta Mail引用的包名與JavaMail不同，我寫demo時(shí)用的是2.0.0版。

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>jakarta.mail</artifactId>
    <version>{version}</version>
</dependency>

所有jar清單：

e24a18fce617ac7c3e83b7115d60248d.png

最新版本包含了對(duì)Android的支持，可參考Jakarta Mail for Android

發(fā)送郵件

使用smtp協(xié)議接收，本文以QQ郵件上為例。

  • 發(fā)送普通文本郵件
MailObject mailObj = new MailObject();
mailObj.setFrom("engr-z@qq.com");
mailObj.setTo(new String[]{"post@engr-z.com"});
mailObj.setSubject("JavaMail 2.0");
mailObj.setFormat(MailObject.EmailFormat.TEXT);
mailObj.setBody("Java 收發(fā)郵件 (Jakarta Mail)");

// smtp配置，可保存到properties文件，讀取
Properties props = new Properties();
props.put("mail.smtp.host", "smtp.qq.com");
props.put("mail.smtp.port", 465);
props.put("mail.smtp.ssl", true);
// 需要認(rèn)證
props.put("mail.smtp.auth", true);
props.put("mail.smtp.user", "engr-z@qq.com");
props.put("mail.smtp.pass", "******");
// 使用ssl
props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
//props.put("mail.smtp.socketFactory.fallback", false);
//props.put("mail.smtp.socketFactory.port", mailConfig.getPort());

// 創(chuàng)建會(huì)話
Session session = Session.getInstance(props, new Authenticator() {
    @Override
    protected PasswordAuthentication getPasswordAuthentication() {
        if (Boolean.valueOf(props.getProperty("mail.smtp.auth"))) {
            // 需要認(rèn)證
            PasswordAuthentication auth = new PasswordAuthentication(props.getProperty("mail.smtp.user"), props.getProperty("mail.smtp.pass"));
            return auth;
        }
        return super.getPasswordAuthentication();
    }
});

// 構(gòu)建郵件消息
MimeMessage msg = new MimeMessage(session);
msg.setFrom(new InternetAddress(mailObj.getFrom()));

InternetAddress[] address = new InternetAddress[mailObj.getTo().length];
for (int i = 0, j = mailObj.getTo().length; i < j; i++) {
    address[i] = new InternetAddress(mailObj.getTo()[i]);
}
// 可以用msg.setRecipients方法增加多個(gè)接收人，指定接收人類型
// Message.RecipientType.CC 抄送
// Message.RecipientType.BCC 密送
msg.setRecipients(Message.RecipientType.TO, address);

msg.setSubject(mailObj.getSubject());
if (MailObject.EmailFormat.HTML.equals(mailObj.getFormat())) {
    // html格式
    msg.setContent(mailObj.getBody(), "text/html;charset=utf-8");
} else {
    msg.setText(mailObj.getBody());
}
msg.setSentDate(new Date());

// 發(fā)送郵件
Transport.send(msg);
  • 發(fā)送帶附件的郵件
MailObject mailObj = new MailObject();
mailObj.setFrom("engr-z@qq.com");
mailObj.setTo(new String[]{"post@engr-z.com"});
mailObj.setSubject("JavaMail 2.0");
mailObj.setFormat(MailObject.EmailFormat.TEXT);
mailObj.setBody("Java 收發(fā)郵件 (Jakarta Mail)");

// smtp配置，可保存到properties文件，讀取
Properties props = new Properties();
props.put("mail.smtp.host", "smtp.qq.com");
props.put("mail.smtp.port", 465);
props.put("mail.smtp.ssl", true);
// 需要認(rèn)證
props.put("mail.smtp.auth", true);
props.put("mail.smtp.user", "engr-z@qq.com");
props.put("mail.smtp.pass", "******");
// 使用ssl
props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
//props.put("mail.smtp.socketFactory.fallback", false);
//props.put("mail.smtp.socketFactory.port", mailConfig.getPort());

// 創(chuàng)建會(huì)話
Session session = Session.getInstance(props, new Authenticator() {
    @Override
    protected PasswordAuthentication getPasswordAuthentication() {
        if (Boolean.valueOf(props.getProperty("mail.smtp.auth"))) {
            // 需要認(rèn)證
            PasswordAuthentication auth = new PasswordAuthentication(props.getProperty("mail.smtp.user"), props.getProperty("mail.smtp.pass"));
            return auth;
        }
        return super.getPasswordAuthentication();
    }
});

// 構(gòu)建郵件消息
MimeMessage msg = new MimeMessage(session);
msg.setFrom(new InternetAddress(mailObj.getFrom()));

InternetAddress[] address = new InternetAddress[mailObj.getTo().length];
for (int i = 0, j = mailObj.getTo().length; i < j; i++) {
    address[i] = new InternetAddress(mailObj.getTo()[i]);
}
// 可以用msg.setRecipients方法增加多個(gè)接收人，指定接收人類型
// Message.RecipientType.CC 抄送
// Message.RecipientType.BCC 密送
msg.setRecipients(Message.RecipientType.TO, address);

msg.setSubject(mailObj.getSubject());

Multipart mp = new MimeMultipart();

// 郵件內(nèi)容
MimeBodyPart body = new MimeBodyPart();
if (MailObject.EmailFormat.HTML.equals(mailObj.getFormat())) {
    // html格式
    body.setContent(mailObj.getBody(), "text/html;charset=utf-8");
} else {
    body.setText(mailObj.getBody());
}
mp.addBodyPart(body);

// 附件
for (File file : mailObj.getFiles()) {
    MimeBodyPart attachment = new MimeBodyPart();
    attachment.attachFile(file);
    mp.addBodyPart(attachment);
}

msg.setContent(mp);
msg.setSentDate(new Date());

// 發(fā)送郵件
Transport.send(msg);

代碼中MailObj是我創(chuàng)建的MailObject對(duì)象，MailObject封裝了郵件相關(guān)的信息：

/**
 * @author Engr-Z
 * @since 2021/3/3
 */
@Data
public class MailObject {

    enum EmailFormat {
        TEXT, HTML
    }

    /**
     * 發(fā)件人
     */
    private String from;

    /**
     * 收件人
     */
    private String[] to;

    /**
     * 抄送人
     */
    private String[] cc;

    /**
     * 密送人
     */
    private String[] bcc;

    /**
     * 郵件標(biāo)題
     */
    private String subject;

    /**
     * 郵件內(nèi)容
     */
    private String body;

    /**
     * 郵件格式
     */
    private EmailFormat format;

    /**
     * 附件
     */
    private File[] files;

}

接收郵件

接收郵件常用的協(xié)議有pop3，imap和exchange。exchange是微軟的郵箱協(xié)議，Jakarta Mail暫不支持。

  • 使用pop3協(xié)議
// pop3配置，可保存到properties文件，讀取
Properties props = new Properties();
props.put("mail.pop3.host", "pop.qq.com");
props.put("mail.pop3.port", 995);
props.put("mail.pop3.ssl", true);
// 需要認(rèn)證
props.put("mail.pop3.auth", true);
props.put("mail.pop3.user", "post@engr-z.com");
props.put("mail.pop3.pass", "******");
// 使用ssl
props.put("mail.pop3.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
//props.put("mail.pop3.socketFactory.fallback", false);
//props.put("mail.pop3.socketFactory.port", mailConfig.getPort());

Session session = Session.getDefaultInstance(props);
Store store = session.getStore(mailConfig.getProtocol().value);
if (Boolean.valueOf(props.getProperty("mail.pop3.auth"))) {
    // 需要認(rèn)證
    store.connect(mailConfig.getHost(), mailConfig.getPort(), props.getProperty("mail.pop3.user"), props.getProperty("mail.pop3.pass"));
} else {
    store.connect();
}

// 獲取收件箱 store.getDefaultForlder
Folder mbox = store.getFolder("INBOX");
// INBOX
mbox.open(Folder.READ_ONLY);
System.out.println(mbox.getName());
int msgCount = mbox.getMessageCount();
System.out.println("郵件總數(shù)：" + msgCount);
// 取最新的郵件
Message msg = mbox.getMessage(msgCount);
System.out.println("郵件主題：" + msg.getSubject());
System.out.println("發(fā)件人：" + msg.getFrom());
// 返回?cái)?shù)組
System.out.println("收件人：" + msg.getRecipients(Message.RecipientType.TO));
// 沒有為null
System.out.println("抄送人：" + msg.getRecipients(Message.RecipientType.CC));
// 沒有為null
System.out.println("密送人：" + msg.getRecipients(Message.RecipientType.BCC));
// MimeMultipart 對(duì)像
System.out.println("郵件內(nèi)容：" + msg.getContent());
  • 使用imap協(xié)議

只需把上面props配置key改為imap即可，QQ郵件imap端口是 993：

// imap配置，可保存到properties文件，讀取
Properties props = new Properties();
props.put("mail.imap.host", "imap.qq.com");
props.put("mail.imap.port", 993);
props.put("mail.imap.ssl", true);
// 需要認(rèn)證
props.put("mail.imap.auth", true);
props.put("mail.imap.user", "post@engr-z.com");
props.put("mail.imap.pass", "******");
// 使用ssl
props.put("mail.imap.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
//props.put("mail.imap.socketFactory.fallback", false);
//props.put("mail.imap.socketFactory.port", mailConfig.getPort());

Session session = Session.getDefaultInstance(props);
Store store = session.getStore(mailConfig.getProtocol().value);
if (Boolean.valueOf(props.getProperty("mail.imap.auth"))) {
    // 需要認(rèn)證
    store.connect(mailConfig.getHost(), mailConfig.getPort(), props.getProperty("mail.imap.user"), props.getProperty("mail.imap.pass"));
} else {
    store.connect();
}

// 以下操作與pop3相同......

完

開發(fā)中我們還可以使用Apache Commons Email收發(fā)郵件，它的API使用起來更簡單。Spring Boot也有郵件模塊。有興趣可以到官網(wǎng)了解。

Jakrata項(xiàng)目地址：eclipse-ee4j.github.io/mail/

除非注明，否則均為"攻城獅·正"原創(chuàng)文章，轉(zhuǎn)載請(qǐng)注明出處。
本文鏈接：https://engr-z.com/298.html

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 概述 郵件相關(guān)的標(biāo)準(zhǔn) 廠商所提供的 JavaMail 服務(wù)程序可以有選擇地實(shí)現(xiàn)某些郵件協(xié)議，常見的郵件協(xié)議包括： ...
    靜默虛空閱讀 2,222評(píng)論 -1贊 4
  • 一、簡介 ??發(fā)送郵件應(yīng)該是網(wǎng)站的必備拓展功能之一，注冊(cè)驗(yàn)證，忘記密碼或者是給用戶發(fā)送營銷信息。正常我們會(huì)用Jav...
    無劍_君閱讀 605評(píng)論 0贊 5
  • 當(dāng)你用到郵箱這方面的功能，可以參考該篇文章。已經(jīng)在實(shí)際應(yīng)用使用中。 適應(yīng)qq郵箱（國內(nèi)大部分郵箱跟qq相似，如16...
    zhongjh閱讀 1,008評(píng)論 0贊 0
  • Java Mail 簡介 常見的郵件協(xié)議包括：SMTP（Simple Mail Transfer Protocol...
    Josaber閱讀 3,413評(píng)論 1贊 9
  • 基本了解： 電子郵件需要在郵件客戶端和郵件服務(wù)器之間，以及兩個(gè)郵件服務(wù)器之間進(jìn)行傳遞，就必須遵循一定的規(guī)則，這些規(guī)...
    哲也_閱讀 643評(píng)論 0贊 0

友情鏈接更多精彩內(nèi)容