Робота з повідомленнями за допомогою 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, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");

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

Утилітні функції Microsoft Graph