Microsoft Graph を使用したメッセージ操作

Aspose.Email for Java は、Microsoft Graph を介したメッセージ管理のための豊富な API を提供します。メッセージの一覧取得、取得、作成、更新、移動、コピー、削除に加え、ページングや添付ファイルの処理も行えます。以下のコードサンプルは、最も一般的な操作例です。

メッセージ一覧

受信トレイなどの特定のフォルダーからメッセージを取得し、完全な内容を取得できます:

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);

メッセージ一覧のページング

大規模なメールボックスを扱う場合、ページングを使用してメッセージを分割して取得できます。以下の例は、未読メッセージを2件ずつのページに分けて一覧表示する方法を示しています:

// 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());