使用 Microsoft Graph 操作文件夹

Aspose.Email for Java 允许您在 Microsoft Graph 中执行多种文件夹操作,如列出、创建、更新、复制、移动和删除文件夹。以下是常见场景的示例。

列出文件夹

以下示例检索所有文件夹并打印其显示名称及属性:

GraphFolderInfoCollection folders = client.listFolders();
for (GraphFolderInfo folderInfo : folders) {
    System.out.println(folderInfo.getDisplayName());
    for (KeyValuePair<Long, MapiProperty> prop : folderInfo.getProperties()) {
        System.out.println(prop.getValue().getDescriptor().toString() + " " + prop.getValue().getString());
    }
}

列出收件箱文件夹的子文件夹

您还可以列出特定文件夹下的子文件夹,例如收件箱:

GraphFolderInfoCollection inboxFolders = client.listFolders(GraphKnownFolders.Inbox);

创建文件夹

您可以创建根级文件夹和子文件夹。

创建根文件夹

GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");

创建子文件夹

以下代码示例展示了如何在收件箱文件夹下创建子文件夹:

GraphFolderInfo inboxTestSubFolder1 = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");

获取文件夹

以下代码示例演示了如何检索特定文件夹,例如已发送邮件:

GraphFolderInfo sentItemsFolder = client.getFolder(GraphKnownFolders.SentItems);

更新文件夹

您可以更新文件夹属性,例如其显示名称:

GraphFolderInfo originalFolder = client.createFolder("TEST_FOLDER");
originalFolder.setDisplayName("NEW_TEST_FOLDER");
GraphFolderInfo updatedFolder = client.updateFolder(originalFolder);

复制文件夹及其内容

以下示例展示了如何复制文件夹及其子文件夹和邮件:

GraphFolderInfo parentFolder = client.createFolder("PARENT_FOLDER");
GraphFolderInfo testFolder = client.createFolder("TEST_FOLDER");
GraphFolderInfo testSubFolder = client.createFolder(testFolder.getItemId(), "TEST_SUBFOLDER");

MapiMessage message = new MapiMessage();
message.setSubject("Test subject");
message.setBody("Test body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");
MapiMessage createdMessage = client.createMessage(testSubFolder.getItemId(), message);

GraphFolderInfo folderCopy = client.copyFolder(parentFolder.getItemId(), testFolder.getItemId());

GraphFolderInfoCollection folderColl = client.listFolders(parentFolder.getItemId());
// TEST_FOLDER
System.out.println(folderColl.get(0).getDisplayName());

folderColl = client.listFolders(folderColl.get(0).getItemId());
// TEST_SUBFOLDER
System.out.println(folderColl.get(0).getDisplayName());

GraphMessageInfoCollection listMessages = client.listMessages(folderColl.get(0).getItemId());
// Test subject
System.out.println(listMessages.get(0).getSubject());

移动文件夹及其内容

您还可以将文件夹及其所有内容移动到其他位置:

GraphFolderInfo folder = client.moveFolder(parentFolder.getItemId(), testFolder.getItemId());

删除文件夹

使用以下代码示例永久删除文件夹:

client.delete(testFolder.getItemId());