共计 2936 个字符，预计需要花费 8 分钟才能阅读完成。
发送 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 的使用方式非常类似，这里我们只介绍 POP3 的用法。
使用 POP3 收取 Email 时，我们无需关心 POP3 协议底层，因为 JavaMail 提供了高层接口。首先需要连接到 Store 对象：
// 准备登录信息:
String host = "pop3.example.com";
int port = 995;
String username = "[email protected]";
String password = "password";
Properties props = new Properties();
props.setProperty("mail.store.protocol", "pop3"); // 协议名称
props.setProperty("mail.pop3.host", host);// POP3 主机名
props.setProperty("mail.pop3.port", String.valueOf(port)); // 端口号
// 启动 SSL:
props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
props.put("mail.smtp.socketFactory.port", String.valueOf(port));
// 连接到 Store:
URLName url = new URLName("pop3", host, post, "", username, password);
Session session = Session.getInstance(props, null);
session.setDebug(true); // 显示调试信息
Store store = new POP3SSLStore(session, url);
store.connect();
一个 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();
练习
使用 POP3 接收邮件。
下载练习
小结
使用 Java 接收 Email 时，可以用 POP3 协议或 IMAP 协议。
使用 POP3 协议时，需要用 Maven 引入 JavaMail 依赖，并确定 POP3 服务器的域名/端口/是否使用 SSL 等，然后，调用相关 API 接收 Email。
设置 debug 模式可以查看通信详细内容，便于排查错误。
