使用 Microsoft Graph 处理邮件

Aspose.Email for Java 提供了一套丰富的 API，通过 Microsoft Graph 管理邮件。您可以列出、获取、创建、更新、移动、复制和删除邮件，并处理分页和附件。以下代码示例展示了最常见的操作。

列出邮件

您可以从特定文件夹（例如收件箱）检索邮件，并获取其完整内容：

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

按发送日期列出邮件

要按发送日期升序排序邮件，您可以使用 OrderBy 的功能 GraphQueryBuilder:

// create orderby messages query 'ASC'
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.getSentDate().orderBy(true);
MailQuery query = builder.getQuery();

GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(10), query);

获取邮件

拥有邮件引用后，您可以获取其完整内容：

GraphMessageInfo messageInfo = messageInfoColl.get(0);
MapiMessage fetchedMessage = client.fetchMessage(messageInfo.getItemId());

更新邮件

获取邮件后，您可以修改其内容并在服务器上更新：

fetchedMessage.setSubject("Update message");
MapiMessage updatedMessage = client.updateMessage(fetchedMessage);

邮件列表分页

在处理大型邮箱时，您可以使用分页将邮件分批检索。下面的示例演示了以每页两个项目的方式列出未读邮件：

// send ping test messages
for (int i = 0; i < 5; i++) {
    MailMessage eml = new MailMessage(user.EMail, user.EMail, "ping" + i, "test body");
    client.send(MapiMessage.fromMailMessage(eml));
}
// waiting for inbox
Thread.sleep(10000);

// paging option
int itemsPerPage = 2;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.isRead().equals(false);
MailQuery query = builder.getQuery();

// list messages
GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(itemsPerPage), query);
GraphMessageInfoCollection messages = pageInfo.getItems();
while (!pageInfo.getLastPage())
{
    pageInfo = client.listMessages(GraphKnownFolders.Inbox, pageInfo.getNextPage(), query);
    // add next page items to common collection
    messages.addRange(pageInfo.getItems());
}

// set messages state as read
for (GraphMessageInfo message : messages) {
    client.setRead(message.getItemId());
}

创建邮件

您可以创建带有主题、正文和属性的新邮件：

MapiMessage message = new MapiMessage();
message.setSubject("Subject");
message.setBody("Body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "[e-mail]");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "[e-mail]");

MapiMessage createdMessage = client.createMessage(GraphKnownFolders.Inbox, message);

发送邮件

您可以直接发送邮件：

client.send(message);

或者在草稿文件夹中创建后发送草稿邮件：

MapiMessage draftMessage = client.createMessage(GraphKnownFolders.Drafts, message);
client.send(draftMessage.getItemId());

复制和移动邮件

可以在文件夹之间复制或移动邮件：

MapiMessage copiedMessage = client.copyMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());
MapiMessage movedMessage = client.moveMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

管理附件

要列出并删除邮件的附件，请使用以下代码示例：

MapiAttachmentCollection attachments = client.listAttachments(fetchedMessage.getItemId());
for (MapiAttachment att : attachments) {
    client.deleteAttachment(att.getItemId());
}

删除邮件

最后，您可以永久删除邮件：

client.delete(message.getItemId());