40.接受邮件

发送Email的过程我们在上一节已经讲过了，客户端总是通过SMTP协议把邮件发送给MTA。接收Email则相反，因为邮件最终到达收件人的MDA服务器，所以，接收邮件是收件人用自己的客户端把邮件从MDA服务器上抓取到本地的过程。

‍

接受邮件的协议

接收邮件使用最广泛的协议是POP3：Post Office Protocol version 3，它也是一个建立在TCP连接之上的协议。POP3服务器的标准端口是110，如果整个会话需要加密，那么使用加密端口995。

另一种接收邮件的协议是IMAP：Internet Mail Access Protocol，它使用标准端口143和加密端口993。IMAP和POP3的主要区别是，IMAP协议在本地的所有操作都会自动同步到服务器上，并且，IMAP可以允许用户在邮件服务器的收件箱中创建文件夹。

JavaMail也提供了IMAP协议的支持。因为POP3和IMAP的使用方式非常类似，我们简单介绍下IMAP。

收取Email时，我们无需关心POP3/IMAP的协议底层，因为JavaMail提供了高层接口。

我们创建一个mail2.properties：密码已脱敏

mail.imap.host=imap.qq.com
mail.imap.port=993
mail.imap.socketFactory.class=javax.net.ssl.SSLSocketFactory
mail.imap.socketFactory.port=993
mail.imap.username=peterjxl@qq.com
mail.imap.password=***

‍

创建Store对象，并连接：

Properties properties = new Properties();
properties.load(new FileInputStream("src/chapter20/mail2.properties"));
String host = properties.getProperty("mail.imap.host");
String username = properties.getProperty("mail.imap.username");
String password = properties.getProperty("mail.imap.password");

URLName url = new URLName("imap", host, 993, "", username, password);
Session session = Session.getInstance(properties, null);
session.setDebug(true);
Store store = new IMAPStore(session, url);
store.connect();     // 连接服务器，不连接则会报错 jakarta.mail.MessagingException: Not connected

一个Store​对象表示整个邮箱的存储，要收取邮件，我们需要通过Store​访问指定的Folder​（文件夹），通常是INBOX​表示收件箱：

// 获取收件箱:
Folder folder = store.getFolder("INBOX");
// 以读写方式打开:
folder.open(Folder.READ_WRITE);
// 打印邮件总数/新邮件数量/未读数量/已删除数量:
System.out.println("Total messages: " + folder.getMessageCount());
System.out.println("New messages: " + folder.getNewMessageCount());
System.out.println("Unread messages: " + folder.getUnreadMessageCount());
System.out.println("Deleted messages: " + folder.getDeletedMessageCount());
// 获取每一封邮件:
Message[] messages = folder.getMessages();
for (Message message : messages) {
    // 打印每一封邮件:
    printMessage((MimeMessage) message);
}

当我们获取到一个Message​对象时，可以强制转型为MimeMessage，然后打印出邮件主题、发件人、收件人等信息：

void printMessage(MimeMessage msg) throws IOException, MessagingException {
    // 邮件主题:
    System.out.println("Subject: " + MimeUtility.decodeText(msg.getSubject()));
    // 发件人:
    Address[] froms = msg.getFrom();
    InternetAddress address = (InternetAddress) froms[0];
    String personal = address.getPersonal();
    String from = personal == null ? address.getAddress() : (MimeUtility.decodeText(personal) + " <" + address.getAddress() + ">");
    System.out.println("From: " + from);
    // 继续打印其他信息，例如收件人，正文.........
}

‍

‍

比较麻烦的是获取邮件的正文。一个MimeMessage​对象也是一个Part​对象，它可能只包含一个文本，也可能是一个Multipart​对象，即由几个Part​构成，因此，需要递归地解析出完整的正文：

String getBody(Part part) throws MessagingException, IOException {
    if (part.isMimeType("text/*")) {
        // Part是文本:
        return part.getContent().toString();
    }
    if (part.isMimeType("multipart/*")) {
        // Part是一个Multipart对象:
        Multipart multipart = (Multipart) part.getContent();
        // 循环解析每个子Part:
        for (int i = 0; i < multipart.getCount(); i++) {
            BodyPart bodyPart = multipart.getBodyPart(i);
            String body = getBody(bodyPart);
            if (!body.isEmpty()) {
                return body;
            }
        }
    }
    return "";
}

最后记得关闭Folder​和Store​：

folder.close(true); // 传入true表示删除操作会同步到服务器上（即删除服务器收件箱的邮件）
store.close();

小结

使用Java接收Email时，可以用POP3协议或IMAP协议。

设置debug模式可以查看通信详细内容，便于排查错误。

‍