Aspose 使用教程：通过 Java 中最流行的 5 种方法提取电子邮件

通过 POP3 检索电子邮件
通过 IMAP 检索电子邮件
从 MS Exchange 服务器检索邮件
从服务器提取邮件的 Microsoft 图形
从离线邮箱存储中提取邮件

在开发电子邮件处理应用程序时，建立从收件箱提取邮件的有效机制对于可靠、及时地交付和访问邮件至关重要。这一点尤其受到处理日益增长的收件量的组织和企业的青睐。在本文中，我们将探讨如何利用 Java 库的强大功能，以 pst 文件为例，通过 POP3、IMAP、EWS、Graph API 以及各种格式的离线邮箱存储检索电子邮件。这些方法为电子邮件检索提供了全面的解决方案，增强了 Java 应用程序的功能。

提取邮件的 Java API

要使用 Java 从服务器或邮箱存储中提取邮件，我们将使用 Aspose.Email for Java。Aspose.Email 是一个强大的库，能让 Java 开发人员毫不费力地处理电子邮件、文件夹和邮件服务器。它支持多种电子邮件格式，包括 MSG、EML、PST 和 OST，使其成为电子邮件相关任务的多功能选择。只要下载或使用以下 Maven 配置进行安装，就能在项目中轻松实现 API。

存储库：

<repository>
    <id>AsposeJavaAPI</id>
    <name>Aspose Java API</name>
    <url>http://repository.aspose.com/repo/</url>
</repository>

依赖性：

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-email</artifactId>
    <version>23.11</version>
    <classifier>jdk16</classifier>
</dependency>

通过 POP3 检索电子邮件

POP3（邮局协议 3）是一种广泛使用的电子邮件检索协议。它允许您将邮件从邮件服务器下载到本地设备。通过 Aspose.Email，您可以使用以下代码片段和步骤通过 POP3 轻松检索电子邮件：

使用 Pop3Client 类创建一个传递必要属性的对象，以便与 POP3 服务器建立连接。
通过将安全选项设置为 SecurityOptions.Auto，启用自动选择适当的安全协议。
调用 Pop3Client 对象的 listMessages 方法，读取邮箱中的邮件集合。
遍历 messageInfoCol 集合。
对于每个 Pop3MessageInfo 对象，调用 Pop3Client 对象上的 fetchMessage 方法，并传递从 messageInfo.getSequenceNumber() 中获取的序列号。
在循环中，您可以处理 eml 变量中获取的信息，例如读取其内容或将其保存到文件中。

Pop3Client client = new Pop3Client("pop3.server.com", "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);
try {
    Pop3MessageInfoCollection messageInfoCol = pop3Client.listMessages();
for (Pop3MessageInfo messageInfo : messageInfoCol) {
    MailMessage eml = client.fetchMessage(messageInfo.getSequenceNumber());
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

通过 IMAP 检索电子邮件

IMAP （互联网消息访问协议）是一种标准的电子邮件检索协议，允许电子邮件客户端访问和管理存储在远程电子邮件服务器上的邮件。与通常将邮件下载到本地设备的 POP3 不同，IMAP 将邮件保存在服务器上，是多设备同步和远程访问的理想选择。Aspose.Email 允许将该协议无缝集成到您的应用程序中。请参阅以下代码示例，了解检索邮件的步骤：

创建一个 ImapClient 对象，传递 IMAP 服务器的主机名、用户名和密码。
将客户端的安全选项设置为 SecurityOptions.Auto，以便自动选择适当的安全协议。
调用 ImapClient 对象上的 listMessages 方法，检索代表邮箱中邮件的 ImapMessageInfo 对象集合。
遍历 messageInfoCol 集合。
对于每个 ImapMessageInfo 对象，调用 ImapClient 对象上的 fetchMessage 方法，并传递从 messageInfo.getUniqueId() 中获取的唯一 ID。
然后，您可以在循环中处理 eml 变量中获取的信息，例如读取其内容或将其保存到文件中。

ImapClient client = new ImapClient("localhost", "user", "password");
client.setSecurityOptions(SecurityOptions.Auto);
try {
    ImapMessageInfoCollection messageInfoCol = client.listMessages();
for (ImapMessageInfo messageInfo : messageInfoCol) {
    MailMessage eml = client.fetchMessage(messageInfo.getUniqueId());
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

从 MS Exchange Server 检索邮件

Exchange Web Services（EWS）协议是微软开发的一种功能强大、用途广泛的通信协议，用于访问和管理 Microsoft Exchange Server 和 Office 365 中的数据。Aspose.Email提供了一系列与Exchange邮箱和邮件打交道的功能，使开发人员能够构建与Microsoft Exchange Server和Office 365无缝集成并管理其中数据的应用程序和服务，使其成为现代业务通信和协作的重要工具。以下是我们的 API 与 EWS 协议有效集成的简单代码片段和步骤：

创建 IEWSClient 对象，调用 EWSClient 类上的 getEWSClient 方法，并传递 Exchange 服务器 EWS 端点的 URL 以及用于身份验证的用户名和密码。
调用客户端对象上的 getMailboxInfo() 和 getInboxUri() 方法，获取收件箱文件夹的 URI。
调用客户端对象上的 listMessages() 方法，并传递收件箱的 URI，以检索代表收件箱中邮件的 ExchangeMessageInfo 对象集合。
遍历 messageInfoCol 集合。
对于每个 ExchangeMessageInfo 对象，调用 getUniqueUri() 方法获取邮件的唯一 URI。
调用客户端对象上的 fetchMessage 方法，传递 strMessageURI，以获取特定的消息。
然后，您可以在循环中处理 eml 变量中获取的消息，例如读取其内容或将其保存到文件中。

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "UserName", "Password");
ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) messageInfoCol) {
    String strMessageURI = msgInfo.getUniqueUri();
    MailMessage eml = client.fetchMessage(strMessageURI);
}

从服务器提取消息的 Microsoft Graph

Microsoft Graph API 是微软提供的 REST API，用于访问各种微软服务，包括 Outlook 和 Office 365。Aspose.Email for Java 提供的 IGraphClient 类实例可处理构建请求、向 Microsoft Graph API 发送请求和处理响应。这种集成为高效处理电子邮件提供了一系列功能。下面的代码示例演示了由以下步骤支持的信息检索功能：

创建一个 IGraphClient 对象，调用 GraphClient 类上的 getClient 方法并传递一个 tokenProvider 对象以验证 Microsoft Graph API。
调用 IGraphClient 对象上的 listMessages 方法，传递 GraphKnownFolders.Inbox 以检索代表收件箱中消息的 GraphMessageInfo 对象集合。
遍历 messageInfoColl 集合。
对于每个 GraphMessageInfo 对象，调用 IGraphClient 对象上的 fetchMessage 方法，将 getItemId 方法作为参数传递，以获取特定消息。
在循环内，您可以在 message 变量中处理获取的消息，例如读取其内容或使用 MapiMessage 类将其保存到文件中。

IGraphClient client = GraphClient.getClient(tokenProvider);
GraphMessageInfoCollection messageInfoColl = client.listMessages(GraphKnownFolders.Inbox);
for (GraphMessageInfo messageInfo : messageInfoColl) {
    MapiMessage message = client.fetchMessage(messageInfo.getItemId());
}

从离线邮箱存储中提取邮件

离线邮箱存储是指在本地设备或计算机上存储电子邮件信息和相关数据，使用户可以在没有互联网连接的情况下访问电子邮件。通过我们的渐进式程序库，您可以开发电子邮件客户端和应用程序，让用户即使在未连接到电子邮件服务器或互联网的情况下也能处理电子邮件。以下代码片段和步骤将向您展示如何利用该库的强大功能打开 Outlook 个人存储 (PST) 文件、访问 "收件箱 "文件夹并从中提取每封邮件。

创建 PersonalStorage 对象，调用 PersonalStorage 类上的 fromFile 方法并传递 PST 文件的文件路径（"storage.pst"）。
通过 PersonalStorage 对象上的 getRootFolder 方法访问 PST 文件的根文件夹。
使用 getSubFolder 方法从根文件夹中获取 "收件箱 "文件夹，并传递 "收件箱 "作为文件夹名称。
遍历收件箱文件夹中的邮件。
对于 folder.enumerateMessages() 集合中的每个 MessageInfo 对象，调用 PersonalStorage 对象上的 extractMessage 方法，传递 messageInfo 参数以提取特定消息。
在循环中，您可以处理 msg 变量中提取的消息，例如读取其内容或使用 MapiMessage 类处理其元数据。

PersonalStorage pst = PersonalStorage.fromFile("storage.pst");
FolderInfo folder = pst.getRootFolder().getSubFolder("Inbox");
for (MessageInfo messageInfo : folder.enumerateMessages()) {
        MapiMessage msg = pst.extractMessage(messageInfo);
    }

结论

在本文中，我们学习了如何利用 Aspose.Email for Java 的强大功能来检索电子邮件。该库支持 POP3、IMAP、EWS、Graph API 和离线邮箱存储，使您能够定制应用程序的功能以满足特定需求。无论您是开发客户端应用程序、集成工具还是定制解决方案，我们的 Java API 都能为您提供各种工具，帮助您创建无缝、高效的邮件处理体验。您可以使用文档探索 Aspose.Email 的其他功能。

相关产品

最新文章

相关文章