電子郵件早已成為工作生活中不可缺少的部分，每個(gè)工作的人都會(huì)有自己的私人郵箱或企業(yè)郵箱，用來協(xié)助我們處理生活事務(wù)以及實(shí)現(xiàn)工作中的交流。

今天主要通過簡(jiǎn)單的示例，了解在Java中如何使用API來完成郵件的接收與發(fā)送。

通過該篇文章我們可以有如下收獲：

1. 了解基于Java的電子郵件客戶端的實(shí)現(xiàn)方式
2. 了解常見的郵箱如何集成
3. 認(rèn)識(shí)郵箱中的IMAP與POP協(xié)議

適用場(chǎng)景

郵件和短信很像，將信息發(fā)送到目的用戶，不需要用戶在線，基于郵件服務(wù)器，完成消息的存儲(chǔ)與轉(zhuǎn)發(fā)。一般公司都會(huì)有自己的企業(yè)郵箱，主要也是為了保證數(shù)據(jù)的安全性。可能你平時(shí)在注冊(cè)網(wǎng)站時(shí)，需要通過郵件來接收驗(yàn)證消息完成認(rèn)證流程；或者每天打開郵箱收到的各種訂閱消息等等。

1. 基于電子郵件的通信與交流
2. 接收驗(yàn)證消息，實(shí)現(xiàn)用戶認(rèn)證
3. 發(fā)送郵件提供消息通知

說明

電子郵件在Internet上發(fā)送和接收的原理與我們通過郵局發(fā)信件非常相類似：首先要找到任何一個(gè)郵局，填寫郵件收件人姓名、地址等信息， 之后信件就會(huì)寄到收件人所在地的郵局，對(duì)方需要到相應(yīng)的郵局才能取出信件。同樣，在發(fā)送電子郵件時(shí)，郵件是由郵件發(fā)送服務(wù)器發(fā)出， 根據(jù)收信人的地址匹配目的郵件接收服務(wù)器，收信人收取郵件需要訪問這個(gè)服務(wù)器才能取件。

郵件的發(fā)送與接收都需要基于特定的通信協(xié)議，發(fā)郵件時(shí)基于SMTP協(xié)議，收郵件時(shí)基于POP3、IMAP協(xié)議。

• SMTP
  SMTP 的全稱是“Simple Mail Transfer Protocol”，即簡(jiǎn)單郵件傳輸協(xié)議，是用于發(fā)送電子郵件的協(xié)議。它是一組用于從源地址到目的地址傳輸郵件的規(guī)范，通過它來控制郵件的中轉(zhuǎn)方式。SMTP 協(xié)議屬于 TCP/IP 協(xié)議簇，它幫助每臺(tái)計(jì)算機(jī)在發(fā)送或中轉(zhuǎn)信件時(shí)找到下一個(gè)目的地。SMTP 服務(wù)器就是遵循 SMTP 協(xié)議的發(fā)送郵件服務(wù)器。
• IMAP
  IMAP（Internet Message Access Protocol）Internet郵件訪問協(xié)議，是用于接收電子郵件的協(xié)議。IMAP不用對(duì)服務(wù)器上面的郵件進(jìn)行全部下載（根據(jù)實(shí)際需要進(jìn)行下載），可以通過郵件客戶端對(duì)郵件進(jìn)行操作；IMAP提供了WebMail與郵件客戶端之間的雙向通信，以及客戶端上的操作（如閱讀、刪除、移動(dòng)郵件等）。
• POP3
  POP3（Post Office Protocol version 3）郵局協(xié)議的第3個(gè)版本，同樣用于接收電子郵件的協(xié)議。POP3可以讓你下載郵件服務(wù)器上的郵件（下載所有未讀郵件），在郵件從服務(wù)器發(fā)送到電腦的同時(shí)刪除郵件服務(wù)器上的郵件（目前很多郵件服務(wù)器都支持“下載郵件，不刪除郵件，或者發(fā)出提醒”）。

POP允許電子郵件客戶端下載服務(wù)器上的郵件，但是您在電子郵件客戶端的操作（如：移動(dòng)郵件、標(biāo)記已讀等），這是不會(huì)反饋到服務(wù)器上的， 比如：您通過電子郵件客戶端收取了QQ郵箱中的3封郵件并移動(dòng)到了其他文件夾，這些移動(dòng)動(dòng)作是不會(huì)反饋到服務(wù)器上的，也就是說，QQ郵箱服務(wù)器上的這些郵件是沒有同時(shí)被移動(dòng)的。但是IMAP就不同了，電子郵件客戶端的操作都會(huì)反饋到服務(wù)器上，您對(duì)郵件進(jìn)行的操作（如：移動(dòng)郵件、標(biāo)記已讀等），服務(wù)器上的郵件也會(huì)做相應(yīng)的動(dòng)作。也就是說，IMAP是“雙向”的。同時(shí)，IMAP可以只下載郵件的主題，只有當(dāng)您真正需要的時(shí)候，才會(huì)下載郵件的所有內(nèi)容。

如果感興趣可以深入了解這幾個(gè)協(xié)議的具體實(shí)現(xiàn)與規(guī)范，這里我們只用知道，與郵箱服務(wù)器對(duì)接時(shí)，是基于這幾個(gè)協(xié)議來實(shí)現(xiàn)通信，什么時(shí)候用什么協(xié)議即可。后面示例中會(huì)有用到。

郵箱與協(xié)議

如果要完成郵件的發(fā)送，我們需要知道用戶通過服務(wù)器將郵件發(fā)送給 誰 ，這里的用戶指的是發(fā)件方，需要明確我們的發(fā)件地址， 誰即對(duì)方的郵箱地址，郵箱地址主要郵3個(gè)部分組成， 用戶名 @ 郵件服務(wù)器域名 ，比如[email protected]，[email protected]等等， 上面說到的服務(wù)器與域名對(duì)應(yīng)。

在編寫示例前，需要先了解我們用到郵箱的一些信息，比如實(shí)現(xiàn)基于qq郵箱的郵件發(fā)送以及收取時(shí)，我們必須知道其郵箱服務(wù)器對(duì)應(yīng)的協(xié)議服務(wù)地址以及端口， 下面是幾個(gè)常見的協(xié)議信息：

• 126郵箱

• 163郵箱

• QQ郵箱

• Gmail郵箱

實(shí)例

在Java中我們可以基于JavaMail API實(shí)現(xiàn)郵件的發(fā)送與讀取，由于我使用的是JDK17，所以選用的是jakarta.mail.jar完成今天的示例。

在Spring中同樣提供了郵件的支持，我們可以在項(xiàng)目中通過引入spring-boot-starter-mail來集成，下面分別來看下如何實(shí)現(xiàn)郵件的收發(fā)功能。示例以QQ郵件為例，比如我的郵箱地址為[email protected]，下面來看看具體實(shí)現(xiàn)過程

• 發(fā)送郵件

1. 引入依賴

< dependency >
      < groupId >org.springframework.boot< /groupId >
      < artifactId >spring-boot-starter-mail< /artifactId >
      < version >${spring-boot.version}< /version >
  < /dependency >

2. 添加application配置

spring:
  mail:
    host: smtp.qq.com
    port: 25
    protocol: smtp
    username: [email protected]
    password: '******'

這里主要配置了郵箱地址，和上面說到的協(xié)議類型、服務(wù)地址以及端口，最后還有一個(gè)密碼，注意這里不是郵箱登錄密碼，我們需要單獨(dú)申請(qǐng)，這個(gè)在各個(gè)郵箱中都有申請(qǐng)入口，比如qq郵箱中：

點(diǎn)擊“管理服務(wù)”在新的頁面中通過“生成授權(quán)碼”按流程申請(qǐng)即可，注意不要泄露！??！

1. 編寫郵件發(fā)送服務(wù)

@Service
public class EmailQQService {

    @Resource
    private JavaMailSender javaMailSender;

    @Resource
    private MailProperties mailProperties;

    public void sendEmail(Email email){
      SimpleMailMessage simpleMailMessage = new SimpleMailMessage();
      simpleMailMessage.setFrom(mailProperties.getUsername()); //設(shè)置發(fā)送郵件賬號(hào)
      simpleMailMessage.setTo(email.getTo()); //設(shè)置接收郵件的人，可以多個(gè)
      simpleMailMessage.setSubject(email.getSubject()); //設(shè)置發(fā)送郵件的主題
      simpleMailMessage.setText(email.getText()); //設(shè)置發(fā)送郵件的內(nèi)容
      javaMailSender.send(simpleMailMessage);
    }
}

主要指定發(fā)送目標(biāo)對(duì)象的郵箱地址，郵件主題以及郵件內(nèi)容等即可?？梢钥吹?，基于spring提供的工具，郵件的發(fā)送變得非常簡(jiǎn)單。

• 郵件的接收

在Spring中沒有提供這樣的工具類，需要我們自己寫：

@Service
public class QqEmailService {
    
    public List< Email > receiveEmail() throws MessagingException, IOException {
        Properties properties = configProperties();
        Store store = createStore( properties );
        List< Email > emails = receive(store);
        store.close();
        return emails;
    }

}

1. 添加接收服務(wù)相關(guān)的配置，包括協(xié)議、服務(wù)地址、端口

private Properties configProperties(){
        // 配置郵件服務(wù)器
        Properties properties = new Properties();
        properties.setProperty("mail.store.protocol", receiveMailProperties.getProtocol());
        properties.setProperty("mail.imap.host", receiveMailProperties.getHost());
        properties.setProperty("mail.imap.port", receiveMailProperties.getPort());
        return properties;
    }

2. 創(chuàng)建Session與Store

private Store createStore(Properties properties) throws MessagingException {
        // 創(chuàng)建Session實(shí)例對(duì)象
        Session session = Session.getInstance( properties );
        // 創(chuàng)建IMAP協(xié)議的Store對(duì)象
        Store store = session.getStore("imap");
        // 連接郵件服務(wù)器
        store.connect(mailProperties.getUsername(), mailProperties.getPassword());
        return store;
    }

3. 從服務(wù)器讀取郵件

private List< Email > receive(Store store) throws MessagingException, IOException {
        // 獲得收件箱
        Folder folder = store.getFolder("INBOX");
        // 以讀寫模式打開收件箱
        folder.open(Folder.READ_WRITE);
        // 各狀態(tài)郵件數(shù)量
        System.out.println(String.format("收件箱郵件總數(shù)：%s，其中，新郵件數(shù)：%s，未讀郵件數(shù)：%s，",folder.getMessageCount(), folder.getUnreadMessageCount(), folder.getNewMessageCount()));
        // 獲得收件箱的郵件列表
        Message[] messages = folder.getMessages(folder.getMessageCount()-5, folder.getMessageCount());
        System.out.println("------------------------開始解析郵件----------------------------------");
        List< Email > emailList = new ArrayList<  >();
        for (Message message : messages) {
            Email email = new Email()
                    .setFrom(Arrays.stream(message.getFrom()).map(address - > ((InternetAddress)address).getAddress()).collect(Collectors.joining()))
                    .setSubject(message.getSubject())
                    .setContentType(message.getContentType())
                    .setSendDate(message.getSentDate())
                    .setReceiveDate(message.getReceivedDate());


            System.out.println(String.format(" >> >> > 郵件來自：%s，主題：%s，接收時(shí)間：%s", email.getFrom(),
                    email.getSubject(),
                    DateFormatUtils.format(email.getReceiveDate(), DateFormatUtils.ISO_8601_EXTENDED_DATETIME_FORMAT.getPattern()))
            );
            email.setEmailContents(resolveMessage(message.getContentType(), message));
            System.out.println(String.format("郵件內(nèi)容：%s" , email.getEmailContents()));
            emailList.add(email);
        }
        // 關(guān)閉資源
        folder.close(false);
        return emailList;
    }

4. 解析郵件內(nèi)容，郵件除了文字，還有圖片，需要根據(jù)消息內(nèi)容類型進(jìn)行解析，當(dāng)然發(fā)送消息的時(shí)候，同樣支持各種類型的消息，具體可以JavaMailSender的實(shí)現(xiàn)類

private List< EmailContent > resolveMessage(String contentType, Message message) throws MessagingException, IOException {
        List< EmailContent > emailContents = new ArrayList<  >();
        resolveMessageContent( message.getContent(), message, emailContent- >{
            emailContents.add(emailContent);
        } );
//        return content.toString();
        return emailContents;
    }

    private void resolveMessageContent(Object content, Object parent, Consumer< EmailContent > emailContentConsumer) throws MessagingException, IOException {
        if( content instanceof String ){
            emailContentConsumer.accept( new EmailContent(EmailContent.Type.TEXT, (String) content) );
        }else if( content instanceof MimeMultipart){
            MimeMultipart multipart = (MimeMultipart) content;
            int count = multipart.getCount(), index = -1;
            while ( count > ++index ){//  0：純文本；1：html內(nèi)容
                BodyPart bodyPart = multipart.getBodyPart(index);
                Object partContent = bodyPart.getContent();
                resolveMessageContent( partContent, bodyPart, emailContentConsumer);
            }
        }else if( content instanceof BASE64DecoderStream){
            File file = new File(((IMAPBodyPart) parent).getFileName());
            ((BASE64DecoderStream) content).transferTo( new FileOutputStream( file ) );
            emailContentConsumer.accept( new EmailContent(EmailContent.Type.FILE, file.getAbsolutePath()) );
        }else {
            System.out.println(" >> >> >> >> >> >> >> >> 郵件內(nèi)容類型： "+ content.getClass() );
            emailContentConsumer.accept( new EmailContent(EmailContent.Type.TEXT, content.toString()) );
        }
    }

5. 關(guān)閉store

store.close();

代碼有點(diǎn)多，但是流程不復(fù)雜且比較清晰。到這里一個(gè)簡(jiǎn)單的針對(duì)qq郵箱的郵件發(fā)送與接收示例就完成了。不管是收郵件還是發(fā)郵件其關(guān)鍵點(diǎn)是：

1. 郵件收發(fā)對(duì)應(yīng)的協(xié)議類型、服務(wù)地址、服務(wù)端口
2. 發(fā)送郵件用戶的郵箱地址與授權(quán)碼
3. 目標(biāo)郵箱地址

剩下的都是些簡(jiǎn)單API調(diào)用的過程