使用 Microsoft Graph 管理邮箱

除了处理邮件、文件夹和附件外，Aspose.Email for Java 还允许您管理邮箱级别的功能，如分类、专注收件箱覆盖和规则。您也可以通过切换资源上下文来使用多个邮箱。这些操作通过 Graph API 集成提供。

如何使用 Outlook 分类

Outlook 中的分类允许您对邮件进行分组和标记，以便更好地组织。使用 Aspose.Email，您可以以编程方式创建、获取、更新、列出和删除分类。

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;

// create a new category
OutlookCategory category = client.createCategory(categoryName, preset);

// fetch a category
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

// list categories
List<OutlookCategory> categories = client.listCategories();

// update a category
fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

// delete a category
client.delete(category.getId());

如何使用覆盖

覆盖规则控制特定发件人的邮件在专注收件箱中的处理方式。例如，您可以强制来自特定发件人的邮件始终显示在专注视图中。

int focusedType = ClassificationType.Focused;

// create or update an override for a sender
ClassificationOverride override = client.createOrUpdateOverride(
    new MailAddress("testUser@host.com", "testUser"), focusedType
);

// list overrides
List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

// update override classification
ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");
ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

// reset classification
fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

// delete override
client.delete(updatedOverride.getId());

如何使用 Outlook 规则

邮箱规则允许您基于条件自动转发邮件或进行过滤。Graph API 支持创建、获取、更新、列出和删除收件箱规则。

// create a new rule
InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");

// define actions
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients()
    .addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

// list rules
List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

// fetch and update a rule
InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());
createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

// delete rule
client.delete(createdRule.getRuleId());

使用多个邮箱 - 切换邮箱上下文

默认情况下，操作针对当前用户的邮箱。您可以通过设置资源类型和资源 ID 将上下文切换到其他邮箱（例如列出共享邮箱的邮件）。

// switch to another mailbox
client.setResource(ResourceType.Users);
client.setResourceId("mailbox");
client.listMessages("mailfolder");

// switch back to the current user mailbox
client.setResource(ResourceType.Me);

使用 Microsoft Graph 的 OData 查询

Aspose.Email for Java 在使用 Microsoft Graph 时提供对 OData 查询的支持。它允许您在检索文件夹、邮件、联系人和日历项等资源时执行高级过滤、排序、选择、分页和展开。 ODataQueryBuilder 类允许您以结构化且可重用的方式构建 OData 查询参数，而不是手动构建查询字符串。以下方法可用于对大型数据集进行计数和搜索：

Select 仅检索所需的属性。
Filter 用于应用过滤器。
OrderBy 用于排序结果。
Top 和 Skip 用于分页。
Expand 在单个查询中展开相关实体。

多个 GraphClient 方法接受可选的 ODataQueryBuilder 用于应用 OData 查询的参数，包括：

listFolders
listMessages
listContacts
listCalendarItems
listAttachments
listCategories
listOverrides
listRules
listTaskLists
listTasks
listNotebooks

下面的代码示例展示了如何使用 ODataQueryBuilder 查询文件夹并使用高级过滤和分页检索邮件：

IGraphClient client = GraphClient.GetClient();

client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

// Example 1: List folders ordered by name
ODataQueryBuilder builder = new ODataQueryBuilder();
builder.setOrderBy("name asc");

GraphFolderInfoCollection folders = client.listFolders(builder);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

String folderId = folders.get(0).getItemId();

// Example 2: Retrieve filtered and paged messages
builder = new ODataQueryBuilder();
{
    builder.setFilter("startswith(name,'A')");
    builder.setOrderBy("name asc");
    builder.setTop(10);
    builder.setSkip(5);
    builder.setSelect(new String[]{"name", "age"});
    builder.setExpand(new String[]{"children", "parents"});
    builder.setCount(true);
    builder.setSearch("\"John Doe\"");
    builder.setFormat("json");
};

GraphMessageInfoCollection msgs = client.listMessages(folderId, builder);
for (GraphMessageInfo msg : msgs) {
    System.out.println(msg.getSubject());
}

在 Aspose.Email for Java 中使用 Microsoft Graph