Робота з папками на IMAP-сервері

Отримання інформації про папки

Отримати інформацію про папки з IMAP-сервера дуже легко за допомогою Aspose.Email. Викличте listFolders() метод ImapClient клас. Повертає об’єкт ImapFolderInfoCollection тип. Ітеруйте цю колекцію та отримуйте інформацію про окремі папки у циклі. Метод має перегрузки. Ви можете передати назву папки як параметр, щоб отримати список підпапок. Наведений нижче фрагмент коду показує, як отримати інформацію про папку з IMAP-сервера, використовуючи описаний метод Aspose.Email.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get all folders in the currently subscribed folder
ImapFolderInfoCollection folderInfoColl = client.listFolders();

// Iterate through the collection to get folder info one by one
for (ImapFolderInfo folderInfo : (Iterable<ImapFolderInfo>) folderInfoColl) {
    // Folder name and get New messages in the folder
    System.out.println("Folder name is " + folderInfo.getName());
    ImapFolderInfo folderExtInfo = client.getFolderInfo(folderInfo.getName());
    System.out.println("New message count: " + folderExtInfo.getNewMessageCount());
    System.out.println("Is it readonly? " + folderExtInfo.getReadOnly());
    System.out.println("Total number of messages " + folderExtInfo.getTotalMessageCount());
}

Видалення та перейменування папок

Папку на IMAP-сервері можна видалити або перейменувати одним рядком за допомогою Aspose.Email:

The deleteFolder() метод приймає назву папки як параметр.
Для renameFolder() метод, вам потрібно передати поточну назву папки та нову назву папки. Нижчий фрагмент коду показує, як видалити папку з IMAP-сервера та як перейменувати папку. Кожна операція виконується одним рядком коду.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Delete a folder and Rename a folder
client.deleteFolder("foldername");
client.renameFolder("foldername", "newfoldername");

Додавання нового повідомлення у папку

Ви можете додати нове повідомлення у папку за допомогою MailMessage і ImapClient класи. Спочатку створіть MailMessage об’єкт, вказавши значення теми, одержувачів та відправника. Потім підпишіться на папку та додайте повідомлення туди. Нижчий фрагмент коду показує, як додати нове повідомлення у папку.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create a message
MailMessage msg = new MailMessage("user@domain1.com", "user@domain2.com", "subject", "message");

// Subscribe to the Inbox folder and Append the newly created message
client.selectFolder(ImapFolderInfo.IN_BOX);
client.subscribeFolder(client.getCurrentFolder().getName());
client.appendMessage(client.getCurrentFolder().getName(), msg);

Додати декілька повідомлень з підтримкою MultiConnection

Ви можете додати кілька повідомлень, використовуючи appendMessages метод, наданий ImapClient клас. The appendMessages метод приймає список MailMessage і додає його до поточної папки, якщо папка не передана як параметр. ImapClient також підтримує режим MultiConnection для інтенсивних операцій. Нижчий код демонструє, як додати декілька повідомлень за допомогою режиму MultiConnection.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

List<MailMessage> messages = new ArrayList<MailMessage>();
for (int i = 0; i < 20; i++) {
    MailMessage message = new MailMessage("<EMAIL ADDRESS>", "<EMAIL ADDRESS>", "Test Message - " + UUID.randomUUID().toString(), "IMAP Group Append with MultiConnection");
    messages.add(message);
}

imapClient.setConnectionsQuantity(5);
imapClient.setUseMultiConnection(MultiConnectionMode.Enable);
imapClient.appendMessages(messages);

Зауважте, що використання режиму мультипідключення не гарантує підвищення продуктивності.

Перемістити повідомлення в іншу папку поштової скриньки

Aspose.Email for Java дозволяє перемістити повідомлення з однієї папки поштової скриньки в іншу, використовуючи ImapClient API. Цей moveMessage метод використовує унікальний ідентифікатор повідомлення та назву папки призначення для переміщення повідомлення у папку призначення. Наступний фрагмент коду показує, як перемістити повідомлення в іншу папку поштової скриньки.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// This example shows how to move a message from one folder of a mailbox to another one using the ImapClient API of Aspose.Email for Java
// Available from Aspose.Email for Java onwards
// -------------- Available API Overload Members --------------
// void ImapClient.moveMessage(IConnection iConnection, int sequenceNumber, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(IConnection iConnection, String uniqueId, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(int sequenceNumber, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(String uniqueId, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(IConnection iConnection, int sequenceNumber, String folderName)
// void ImapClient.moveMessage(IConnection iConnection, String uniqueId, String folderName)
// void ImapClient.moveMessage(int sequenceNumber, String folderName)
// void ImapClient.moveMessage(String uniqueId, String folderName)

final ImapClient client = new ImapClient("host.domain.com", 993, "username", "password");
try {
    String folderName = "EMAILNET-35151";
    if (!client.existFolder(folderName))
        client.createFolder(folderName);
    try {
        MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35151 - " + UUID.randomUUID(),
                "EMAILNET-35151 ImapClient: Provide option to Move Message");
        client.selectFolder(ImapFolderInfo.IN_BOX);
        // Append the new message to Inbox folder
        String uniqueId = client.appendMessage(ImapFolderInfo.IN_BOX, message);
        ImapMessageInfoCollection messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
        // Now move the message to the folder EMAILNET-35151
        client.moveMessage(uniqueId, folderName);
        client.commitDeletes();
        // Verify that the message was moved to the new folder
        client.selectFolder(folderName);
        messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
        // Verify that the message was moved from the Inbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
    } finally {
        try {
            client.deleteFolder(folderName);
        } catch (java.lang.RuntimeException e) {
        }
    }
} finally {
    if (client != null)
        client.dispose();
}

Копіювати повідомлення в іншу папку поштової скриньки

API Aspose.Email забезпечує можливість копіювати повідомлення з однієї папки скриньки в іншу. Це дозволяє копіювати як одне, так і кілька повідомлень, використовуючи copyMessage і copyMessages методи. copyMessages метод забезпечує можливість копіювати кілька повідомлень з вихідної папки скриньки до папки призначення. Наведений нижче фрагмент коду показує, як копіювати повідомлення в іншу папку скриньки.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("exchange.aspose.com", "username", "password");
try {
    // Create the destination folder
    String folderName = "EMAILNET-35242";
    if (!client.existFolder(folderName))
        client.createFolder(folderName);
    try {
        // Append a couple of messages to the server
        MailMessage message1 = new MailMessage("asposeemail.test3@aspose.com", "asposeemail.test3@aspose.com", "EMAILNET-35242 - " + UUID.randomUUID(),
                "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        String uniqueId1 = client.appendMessage(message1);

        MailMessage message2 = new MailMessage("asposeemail.test3@aspose.com", "asposeemail.test3@aspose.com", "EMAILNET-35242 - " + UUID.randomUUID(),
                "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        String uniqueId2 = client.appendMessage(message2);

        // Verify that the messages have been added to the mailbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection msgsColl = client.listMessages();
        for (ImapMessageInfo msgInfo : msgsColl)
            System.out.println(msgInfo.getSubject());

        // Copy multiple messages using the CopyMessages command and Verify that messages are copied to the destination folder
        client.copyMessagesByUids(Arrays.asList(uniqueId1, uniqueId2), folderName);

        client.selectFolder(folderName);
        msgsColl = client.listMessages();
        for (ImapMessageInfo msgInfo : msgsColl)
            System.out.println(msgInfo.getSubject());
    } finally {
        try {
            client.deleteFolder(folderName);
        } catch (java.lang.RuntimeException e) {
        }
    }
} finally {
    if (client != null)
        client.dispose();
}

Робота зі спеціальними папками поштових скриньок

Деякі сховища повідомлень IMAP містять спеціальні поштові скриньки, наприклад для чернеток чи надісланих листів. Багато поштових клієнтів дозволяють користувачам вказати, куди зберігати чернетки чи надіслані листи, але їх налаштування вимагає знання, які скриньки сервер виділив для цих цілей. Aspose.Email може ідентифікувати такі спеціальні скриньки, використовуючи ImapMailboxInfo клас, який спрощує роботу з ними. Наведений приклад коду демонструє, як отримати доступ до цих спеціальних поштових скриньок, використовуючи ImapMailboxInfo клас.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();
System.out.println(mailboxInfo.getInbox());
System.out.println(mailboxInfo.getDraftMessages());
System.out.println(mailboxInfo.getJunkMessages());
System.out.println(mailboxInfo.getSentMessages());
System.out.println(mailboxInfo.getTrash());

Видалення повідомлень з сервера Робота з ImapClient асинхронно