Documentation – Робота з файлами сховища Outlook

Java: Створити новий PST, додати підпапки та повідомлення

Mon, 01 Jan 0001 00:00:00 +0000

Окрім аналізу існуючого PST файлу, Aspose.Email надає можливість створити PST файл з нуля. У цій статті показано, як створити Outlook PST файл і додати до нього підпапку.

Використайте PersonalStorage клас, щоб створити файл PST у певному розташуванні на локальному диску. Щоб створити файл PST з нуля:

Створіть PST за допомогою PersonalStorage.create() метод.
Додайте підпапку у корені файлу PST, отримавши доступ до кореневої папки, а потім викликавши addSubFolder() метод.

Наведений нижче приклад коду показує, як створити файл PST і додати підпапку під назвою Inbox.

// Create new PST
try (PersonalStorage pst = PersonalStorage.create(path, FileFormatVersion.Unicode)) {
    // Add new folder "Test"
    pst.getRootFolder().addSubFolder("Inbox");
}

Створити PST розміром більше 2 ГБ за допомогою OutputStream

Користувачі Aspose.Email можуть оптимізувати внутрішній кеш PST, використовуючи конструктор PersonalStorage:

blockSize - Оптимальний розмір блоку для розширення кеш‑буфера (в байтах).

PersonalStorage create(OutputStream stream, int blockSize, /*FileFormatVersion*/int version)

Зменшити розмір повідомлення та розмір створеного файлу PST

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

MapiMessageItemBase.setBodyContent(String content, /BodyContentType/int contentType, boolean compression) - Встановлює вміст тіла.
MapiMessageItemBase.setBodyRtf(String content, boolean compression) - Отримує або встановлює текст повідомлення у форматі RTF.

Нижчеприведений приклад коду демонструє, як використовувати стиснення RTF під час встановлення тіла повідомлення MAPI:

MapiMessage msg = new MapiMessage("from@doamin.com", "to@domain.com", "subject", "body");
// set the html body and keep it compressed
// this will reduce the message size
msg.setBodyContent(htmlBody, BodyContentType.Html, true);

Створити PersonalStorage на основі потоку SeekableByteChannel

Aspose.Email для Java робить можливим роботу з файлами Personal Storage (PST) за допомогою java.nio.channels. Це дозволяє створити екземпляр PersonalStorage, використовуючи потік SeekableByteChannel. Наведений нижче приклад коду демонструє, як створити екземпляр PersonalStorage на основі потоку FileChannel, додати підпапку з назвою "messageFolder" до кореневої папки та імпортувати повідомлення з файлів у каталозі "messageFolder":

try (RandomAccessFile raf = new RandomAccessFile("test.pst", "rw")) {
    FileChannel channel = raf.getChannel();
    try (PersonalStorage pst = PersonalStorage.create(channel, FileFormatVersion.Unicode)) {
        FolderInfo messageFolder = pst.getRootFolder().addSubFolder("messageFolder");

        for (File f : new File("messageFolder").listFiles()) {
            messageFolder.addMessage(MapiMessage.load(f.getAbsolutePath()));
        }
    }
}

Зміна класу контейнера папки

Іноді необхідно змінити клас папки. Поширений приклад — коли до однієї папки додаються повідомлення різних типів (події, листи тощо). У таких випадках клас папки потрібно змінити для всіх елементів, щоб вони правильно відображалися. Наведений нижче приклад коду показує, як змінити клас контейнера папки в PST для цієї мети.

try (PersonalStorage pst = PersonalStorage.fromFile("PersonalStorage1.pst")) {
    FolderInfo folder = pst.getRootFolder().getSubFolder("Inbox");

    folder.changeContainerClass("IPF.Note");
}

Додати повідомлення пакетно з підвищеною продуктивністю

Додавання окремих повідомлень у PST передбачає більше операцій вводу/виводу на диск і може сповільнити продуктивність. Для підвищення швидкості повідомлення можна додавати у PST пакетно, щоб мінімізувати операції вводу/виводу. addMessages(Iterable messages) метод дозволяє додавати повідомлення пакетно і може бути використаний у наступних сценаріях. Крім того, MessageAdded подія виникає, коли повідомлення додається до папки.

Додати повідомлення з іншого PST

Щоб додати повідомлення з іншого PST, використовуйте FolderInfo.enumerateMapiMessages() метод, який повертає Iterable<MapiMessage>:

try (PersonalStorage srcPst = PersonalStorage.fromFile("source.pst", false)) {
    try (PersonalStorage destPst = PersonalStorage.fromFile("destination.pst")) {

        // Get the folder by name
        FolderInfo srcFolder = srcPst.getRootFolder().getSubFolder("SomeFolder");
        FolderInfo destFolder = destPst.getRootFolder().getSubFolder("SomeFolder");

        destFolder.MessageAdded.add(new MessageAddedEventHandler() {
            // Handles the MessageAdded event.
            public void invoke(Object sender, MessageAddedEventArgs e) {
                System.out.println("Added: " + e.getEntryId());
            }
        });
        destFolder.addMessages(srcFolder.enumerateMapiMessages());
    }
}

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

Щоб додати повідомлення з каталогу, створіть getMessages(String pathToDir) метод, який повертає Iterable<MapiMessage>:

// Read messages from directory.
static Iterable<MapiMessage> getMessages (String pathToDir)
{
    return Arrays.stream(listDirectory(pathToDir, "*.msg"))
            .map(MapiMessage::load).collect(Collectors.toList());
}

try ( PersonalStorage pst = PersonalStorage.fromFile("storage.pst")) {
    FolderInfo folder = pst.getRootFolder().getSubFolder("SomeFolder");
    folder.MessageAdded.add(new MessageAddedEventHandler() {
        // Handles the MessageAdded event.
        public void invoke(Object sender, MessageAddedEventArgs e) {
            System.out.println("Added: " + e.getEntryId());
        }
    });
    folder.addMessages(getMessages("MessageDirectory"));
}

Java: Прочитати та конвертувати файл Outlook OST

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email надає API для читання файлів Microsoft Outlook OST. Ви можете завантажити файл OST з диска або потоку в екземпляр PersonalStorage клас і отримати інформацію про його вміст, наприклад, папки, підпапки та повідомлення. Microsoft Outlook створює файл PST для зберігання електронної пошти, коли для завантаження повідомлень використовуються сервери POP3 або IMAP. Він створює файл OST, коли сервером пошти є Microsoft Exchange. OST підтримує більші розміри файлів, ніж PST.

Читання файлів OST

Процес читання файлу OST за допомогою Aspose.Email точно такий же, як читання файлу PST. Той самий код може читати як PST, так і OST файли: просто вкажіть правильну назву файлу у PersonalStorage.fromFile() метод. Нижче наведений фрагмент коду показує, як читати файли OST.

Конвертація OST у PST

Спробуйте!

Конвертуйте електронні листи та архіви повідомлень онлайн безкоштовно Додаток конвертації Aspose.Email.

Aspose.Email дозволяє конвертувати файл OST у PST за допомогою одного рядка коду. Аналогічно, файл OST можна створити з файлу PST, використовуючи той самий рядок коду з FileFormat перелічувач. На даний момент API підтримує конвертацію форматів OST у PST, за винятком OST 2013/2016. Нижче наведений фрагмент коду показує, як конвертувати OST у PST.

Для виконання інших операцій з файлами OST, будь ласка, перегляньте наступні сторінки:

Конвертація PST у OST

Конвертація з PST у OST не підтримується Aspose.Email, оскільки OST завжди створюється Outlook під час додавання облікового запису та синхронізації з поштовим сервером. Різниця між файлами PST і OST полягає в тому, що PST доступний лише локально. Вміст OST також доступний на поштовому сервері. Тому немає потреби конвертувати PST у OST для локального використання. Проте ви можете імпортувати PST у існуючий обліковий запис за допомогою майстра імпорту/експорту в Outlook.

Java: Робота з повідомленнями у PST файлі

Mon, 01 Jan 0001 00:00:00 +0000

Додавання повідомлень до файлів PST

Створити новий файл PST та додати підпапки показано, як створити файл PST і додати до нього підпапку. За допомогою Aspose.Email ви можете додавати повідомлення до підпапок файлу PST, який ви створили або завантажили. У цій статті додаються два повідомлення з диска до підпапки Inbox у PST. Використовуйте PersonalStorage і FolderInfo класи для додавання повідомлень до файлів PST. Щоб додати повідомлення до папки Inbox у файлі PST:

Створіть екземпляр класу FolderInfo та завантажте його вмістом папки Inbox.
Додайте повідомлення з диска до папки Inbox, викликавши FolderInfo.addMessage() метод. FolderInfo клас надає addMessages метод, який дозволяє додати велику кількість повідомлень до папки, зменшуючи операції вводу/виводу на диск і підвищуючи продуктивність. Повний приклад можна знайти нижче, у Додавання пакетних повідомлень.

Нижче наведені фрагменти коду, які показують, як додати повідомлення до підпапки PST під назвою Inbox.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create new PST
PersonalStorage personalStorage = PersonalStorage.create(dataDir, FileFormatVersion.Unicode);

// Add new folder "Inbox"
personalStorage.getRootFolder().addSubFolder("Inbox");

// Select the "Inbox" folder
FolderInfo inboxFolder = personalStorage.getRootFolder().getSubFolder("Inbox");

// Add some messages to "Inbox" folder
inboxFolder.addMessage(MapiMessage.fromFile(dataDir + "MapiMsgWithPoll.msg"));

Додавання пакетних повідомлень

Додавання окремих повідомлень до PST передбачає більше операцій вводу/виводу на диск і тому може сповільнити продуктивність. Для підвищення продуктивності повідомлення можна додавати до PST у пакетному режимі, щоб мінімізувати операції вводу/виводу. The addMessages(Iterable messages) метод дозволяє визначити діапазон повідомлень, які будуть додані до PST для підвищення продуктивності, і може бути використаний у наступних сценаріях. Крім того, подія MessageAdded виникає, коли повідомлення додається до папки.

Завантаження повідомлень з диска

Наступний фрагмент коду показує, як завантажити повідомлення з диска.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
private static void addMessagesInBulkMode(String fileName, String msgFolderName) {
    try (PersonalStorage personalStorage = PersonalStorage.fromFile(fileName)) {
        FolderInfo folder = personalStorage.getRootFolder().getSubFolder("myInbox");
        folder.MessageAdded.add(new MessageAddedEventHandler() {
            public void invoke(Object sender, MessageAddedEventArgs e) {
                onMessageAdded(sender, e);
            }
        });
        folder.addMessages(new MapiMessageCollection(msgFolderName));
    }
}

static void onMessageAdded(Object sender, MessageAddedEventArgs e) {
    System.out.println(e.getEntryId());
    System.out.println(e.getMessage().getSubject());
}

Ітерабельна реалізація

Наступний фрагмент коду показує, як створити реалізацію Iterable.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public class MapiMessageCollection implements Iterable<MapiMessage> {

    private final File folder;

    public MapiMessageCollection(String folder) {
        this.folder = new File(folder);
    }

    public Iterator<MapiMessage> iterator() {
        return new MapiMessageIterator(folder.listFiles());
    }
}

public class MapiMessageIterator implements Iterator<MapiMessage> {

    private Queue<String> queue = new LinkedList<String>();

    public MapiMessageIterator(File[] listOfFiles) {
        for (File file : listOfFiles) {
            queue.offer(file.getAbsolutePath());
        }
    }

    public boolean hasNext() {
        return !queue.isEmpty();
    }

    public MapiMessage next() {
        return MapiMessage.fromFile(queue.poll());
    }
}

Додавання повідомлень з іншого PST

Для додавання повідомлень з іншого PST використайте FolderInfo.enumerateMapiMessages() метод, який повертає Iterable. Наступний фрагмент коду показує, як додати повідомлення з іншого PST.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
private static void bulkAddFromAnotherPst(String source) {
    // The path to the File directory.
    String dataDir = "data/";

    try (PersonalStorage pst = PersonalStorage.fromFile(source, false)) {
        try (PersonalStorage pstDest = PersonalStorage.fromFile(dataDir + "PersonalStorageFile1.pst")) {
            // Get the folder by name
            FolderInfo folderInfo = pst.getRootFolder().getSubFolder("Contacts");
            MessageInfoCollection ms = folderInfo.getContents();

            // Get the folder by name
            FolderInfo f = pstDest.getRootFolder().getSubFolder("myInbox");
            f.MessageAdded.add(new MessageAddedEventHandler() {
                public void invoke(Object sender, MessageAddedEventArgs e) {
                    onMessageAdded(sender, e);
                }
            });
            f.addMessages(folderInfo.enumerateMapiMessages());
            FolderInfo fi = pstDest.getRootFolder().getSubFolder("myInbox");
            MessageInfoCollection msgs = fi.getContents();
        }
    }
}

// Handles the MessageAdded event.
static void onMessageAdded(Object sender, MessageAddedEventArgs e) {
    System.out.println(e.getEntryId());
    System.out.println(e.getMessage().getSubject());
}

Отримання інформації про повідомлення з Outlook PST‑файла

У Читання файлу Outlook PST та отримання інформації про папки та підпапки, ми розглядали завантаження Outlook PST‑файлу та перегляд його папок для отримання імен папок та кількості повідомлень у них. У цій статті пояснюється, як прочитати всі папки та підпапки у PST‑файлі та відобразити інформацію про повідомлення, наприклад, тему, відправника та отримувачів. FolderInfo.getContents() метод використовується для відображення коротка інформація про повідомлення як тема, відправник, отримувачі. З точки зору продуктивності це найкращий варіант для отримання первинної інформації про повідомлення. Щоб витягнути повні дані повідомлення, PersonalStorage.extractMessage() надається метод. Outlook PST‑файл може містити вкладені папки. Щоб отримати інформацію про повідомлення з них, а також з папок верхнього рівня, використайте рекурсивний метод для читання всіх папок. Наступний фрагмент коду показує, як прочитати Outlook PST‑файл та рекурсивно відобразити вміст папок і повідомлень.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() {
    // The path to the File directory.
    String dataDir = "data/";

    // Load the Outlook file
    String path = dataDir + "PersonalStorage.pst";

    try {

        // Load the Outlook PST file
        PersonalStorage personalStorage = PersonalStorage.fromFile(path);

        // Get the Display Format of the PST file
        System.out.println("Display Format: " + personalStorage.getFormat());

        // Get the folders and messages information
        FolderInfo folderInfo = personalStorage.getRootFolder();

        // Call the recursive method to display the folder contents
        displayFolderContents(folderInfo, personalStorage);
    } catch (Exception ex) {
        System.out.println(ex.getMessage());
    }
}

// This is a recursive method to display contents of a folder
private static void displayFolderContents(FolderInfo folderInfo, PersonalStorage pst) {
    // Display the folder name
    System.out.println("Folder: " + folderInfo.getDisplayName());
    System.out.println("==================================");
    // Display information about messages inside this folder
    MessageInfoCollection messageInfoCollection = folderInfo.getContents();
    for (MessageInfo messageInfo : messageInfoCollection) {
        System.out.println("Subject: " + messageInfo.getSubject());
        System.out.println("Sender: " + messageInfo.getSenderRepresentativeName());
        System.out.println("Recipients: " + messageInfo.getDisplayTo());
        System.out.println("------------------------------");
    }

    // Call this method recursively for each subfolder
    if (folderInfo.hasSubFolders() == true) {
        for (FolderInfo subfolderInfo : folderInfo.getSubFolders()) {
            displayFolderContents(subfolderInfo, pst);
        }
    }
}

Витягування повідомлень з PST‑файлів

У цій статті показано, як читати файли Microsoft Outlook PST та витягнути повідомлення. Потім повідомлення зберігаються на диск у форматі MSG. У статті також показано, як витягнути певну кількість повідомлень з PST‑файлу. Використайте рекурсивний метод для перегляду всіх папок (включаючи вкладені) та викличте PersonalStorage.extractMessage() метод, щоб отримати Outlook‑повідомлення у екземпляр MapiMessage клас. Після цього викличте MapiMessage.save() метод для збереження повідомлення на диск або у потік у форматі MSG. Наступний фрагмент коду показує, як витягнути повідомлення з PST‑файлу.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() {
    // The path to the File directory.
    String dataDir = "data/";

    // Load the Outlook file
    String path = dataDir + "PersonalStorage.pst";

    try {
        // load the Outlook PST file
        PersonalStorage pst = PersonalStorage.fromFile(path);

        // get the Display Format of the PST file
        System.out.println("Display Format: " + pst.getFormat());

        // get the folders and messages information
        FolderInfo folderInfo = pst.getRootFolder();

        // Call the recursive method to extract msg files from each folder
        extractMsgFiles(folderInfo, pst);
    } catch (Exception ex) {
        System.out.println(ex.getMessage());
    }
}

// This is a recursive method to display contents of a folder
private static void extractMsgFiles(FolderInfo folderInfo, PersonalStorage pst) {
    // display the folder name
    System.out.println("Folder: " + folderInfo.getDisplayName());
    System.out.println("==================================");
    // loop through all the messages in this folder
    MessageInfoCollection messageInfoCollection = folderInfo.getContents();
    for (MessageInfo messageInfo : messageInfoCollection) {
        System.out.println("Saving message {0} ...." + messageInfo.getSubject());
        // get the message in MapiMessage instance
        MapiMessage message = pst.extractMessage(messageInfo);
        // save this message to disk in msg format
        message.save(message.getSubject().replace(":", " ") + ".msg");
        // save this message to stream in msg format
        ByteArrayOutputStream messageStream = new ByteArrayOutputStream();
        message.save(messageStream);
    }

    // Call this method recursively for each subfolder
    if (folderInfo.hasSubFolders() == true) {
        for (FolderInfo subfolderInfo : folderInfo.getSubFolders()) {
            extractMsgFiles(subfolderInfo, pst);
        }
    }
}

Збереження повідомлень безпосередньо з PST у потік

Щоб зберегти повідомлення з PST‑файлу безпосередньо у потік, не витягуючи MsgInfo для повідомлень, використайте saveMessageToStream() метод. Наступний фрагмент коду показує, як зберегти повідомлення безпосередньо з PST у потік.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/";

// Load the Outlook file
String path = dataDir + "PersonalStorage.pst";

// Save message to MemoryStream
try (PersonalStorage personalStorage = PersonalStorage.fromFile(path)) {
    FolderInfo inbox = personalStorage.getRootFolder().getSubFolder("Inbox");
    for (MessageInfo messageInfo : inbox.enumerateMessages()) {
        try (ByteArrayOutputStream memeorystream = new ByteArrayOutputStream()) {
            personalStorage.saveMessageToStream(messageInfo.getEntryIdString(), memeorystream);
        }
    }
}

// Save message to file
try (PersonalStorage pst = PersonalStorage.fromFile(path)) {
    FolderInfo inbox = pst.getRootFolder().getSubFolder("Inbox");
    for (MessageInfo messageInfo : inbox.enumerateMessages()) {
        try (FileOutputStream fs = new FileOutputStream(new File(dataDir + messageInfo.getSubject() + ".msg"))) {
            pst.saveMessageToStream(messageInfo.getEntryIdString(), fs);
        }
    }
}

try (PersonalStorage pst = PersonalStorage.fromFile(path)) {
    FolderInfo inbox = pst.getRootFolder().getSubFolder("Inbox");

    // To enumerate entryId of messages you may use FolderInfo.EnumerateMessagesEntryId() method:
    for (String entryId : inbox.enumerateMessagesEntryId()) {
        try (ByteArrayOutputStream ms = new ByteArrayOutputStream()) {
            pst.saveMessageToStream(entryId, ms);
        }
    }
}

Видобуток n повідомлень з PST‑файлу

Наступний фрагмент коду показує, як витягнути певну кількість повідомлень з PST. Просто вкажіть індекс першого повідомлення та загальну кількість повідомлень для витягнення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
FolderInfo inbox = personalStorage.getRootFolder().getSubFolder("Inbox");

// Extracts messages starting from 10th index top and extract total 100 messages
MessageInfoCollection messages = inbox.getContents(10, 100);

Отримання загальної кількості елементів з PST‑файлу

Aspose.Email надає GetTotalItemsCount() метод PersonalStorage.Store властивість. Вона повертає загальну кількість повідомлень, що містяться у PST.

Наступний зразок коду показує, як отримати загальну кількість елементів (повідомлень, зустрічей, контактів тощо), що зберігаються у PST‑файлі:

try (PersonalStorage pst = PersonalStorage.fromFile("my.pst", false)) {
    int count = pst.getStore().getTotalItemsCount();
}

Видалення елементів з PST‑файлів

Add Messages to PST Files показано, як додавати повідомлення у PST‑файли. Звісно, також можливо видаляти елементи (вміст) з PST‑файлу, і може бути потрібним масове видалення повідомлень. Елементи з PST‑файлу можна видаляти за допомогою FolderInfo.deleteChildItem() метод. API також надає FolderInfo.deleteChildItems() метод для масового видалення елементів з PST‑файлу.

Видалення повідомлень з PST‑файлів

Ця стаття показує, як використовувати FolderInfo клас для доступу до конкретних папок у PST‑файлі. Щоб видалити повідомлення з підпапки Sent раніше завантаженого або створеного PST‑файлу:

Створіть екземпляр FolderInfo клас і завантаживши його вмістом підпапки Sent.
Видаліть повідомлення з папки Sent, викликавши FolderInfo.deleteChildItem() метод і передаючи MessageInfo.EntryId як параметр. Наступний фрагмент коду показує, як видалити повідомлення з підпапки Sent у PST‑файлі.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/" + "Sub.pst";

// Load the Outlook PST file
PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir);

// Get the Sent items folder
FolderInfo folderInfo = personalStorage.getPredefinedFolder(StandardIpmFolder.SentItems);

MessageInfoCollection msgInfoColl = folderInfo.getContents();
for (MessageInfo msgInfo : msgInfoColl) {
    System.out.println(msgInfo.getSubject() + ": " + msgInfo.getEntryIdString());
    if (msgInfo.getSubject().equals("some delete condition")) {
        // Delete this item
        folderInfo.deleteChildItem(msgInfo.getEntryId());
        System.out.println("Deleted this message");
    }
}

Видалення папок з PST‑файлів

Ви можете видалити папку PST, перемістивши її до папки Видалені елементи.

try (PersonalStorage pst = PersonalStorage.fromFile("test.pst")) {
    FolderInfo deletedItemsFolder = pst.getPredefinedFolder(StandardIpmFolder.DeletedItems);
    FolderInfo emptyFolder = pst.getRootFolder().getSubFolder("Empty folder");
    FolderInfo someFolder = pst.getRootFolder().getSubFolder("Some folder");
    pst.moveItem(emptyFolder, deletedItemsFolder);
    pst.moveItem(someFolder, deletedItemsFolder);
}

Перевага цього методу полягає в тому, що видалена папка може бути легко відновлена.

FolderInfo someFolder = deletedItemsFolder.getSubFolder("Some folder");
pst.moveItem(someFolder, pst.getRootFolder());

За потреби ви також можете назавжди видалити папку з папки Видалені елементи.

deletedItemsFolder.deleteChildItem(emptyFolder.getEntryId());

The deleteChildItem() метод можна використати для будь‑яких папок, якщо ви бажаєте негайно та назавжди видалити підпапку, обходячи папку Видалені елементи.

FolderInfo someFolder = pst.getRootFolder().getSubFolder("Some folder");
pst.getRootFolder().deleteChildItem(someFolder.getEntryId());

Масове видалення елементів з PST‑файлу

API Aspose.Email можна використати для масового видалення елементів з PST‑файла. Це здійснюється за допомогою deleteChildItems() метод, який приймає список елементів Entry ID, що вказують на елементи для видалення. Наступний фрагмент коду показує, як масово видаляти елементи з PST‑файла.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/" + "Sub.pst";

try (PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir)) {
    // Get Inbox SubFolder from Outlook file
    FolderInfo inbox = personalStorage.getRootFolder().getSubFolder("Inbox");

    // Create instance of PersonalStorageQueryBuilder
    PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();

    queryBuilder.getFrom().contains("someuser@domain.com");
    MessageInfoCollection messages = inbox.getContents(queryBuilder.getQuery());
    List<String> deleteList = new ArrayList<String>();
    for (MessageInfo messageInfo : messages) {
        deleteList.add(messageInfo.getEntryIdString());
    }

    // delete messages having From = "someuser@domain.com"
    inbox.deleteChildItems(deleteList);
}

Перелічення та відновлення м’яко видалених повідомлень з PST

Можливо отримати назавжди видалені повідомлення за допомогою Aspose.Email для Java. Його API дозволяє перелічити м’яко видалені повідомлення у PST‑файлах. М’яко видалені елементи — це повідомлення, які були видалені двічі: спочатку переміщені до папки Видалені елементи, а потім звідти видалені. Ці повідомлення все ще можна відновити, і Aspose.Email надає зручний спосіб доступу до них. PersonalStorage.findAndEnumerateSoftDeletedItems() метод повертає колекцію RestoredItemEntry об’єкти. Кожен запис містить:

MapiMessage item — відновлене повідомлення.
String FolderId - ідентифікатор папки, в якій первісно знаходилося повідомлення.

Наступний зразок коду демонструє, як перелічити м’яко видалені (відновлювані) електронні елементи у PST‑файлах:

// Load the PST file
try (PersonalStorage pst = PersonalStorage.fromFile(fileName)) {
    // Enumerate soft-deleted items
    for (RestoredItemEntry entry : pst.findAndEnumerateSoftDeletedItems()) {
        MapiMessage message = entry.getItem();
        String folderId = entry.getFolderId();
        
        System.out.println("Subject: " + message.getSubject());
        System.out.println("Deleted from Folder ID: " + folderId);
        System.out.println("-----------------------------------");
    }
}

Пошук повідомлень і папок у PST за критерієм

Файли Personal Storage (PST) можуть містити величезну кількість даних, і пошук даних, що відповідають певному критерію у таких великих файлах, вимагає включення кількох контрольних точок у коді для фільтрації інформації. За допомогою PersonalStorageQueryBuilder клас, Aspose.Email дозволяє шукати конкретні записи в PST на основі заданого критерію пошуку. У PST можна шукати повідомлення за параметрами пошуку, такими як відправник, одержувач, тема, важливість повідомлення, наявність вкладень, розмір повідомлення та навіть ID повідомлення. PersonalStorageQueryBuilder також можна використати для пошуку підпапок.

Пошук повідомлень і папок у PST

Наступний фрагмент коду показує, як використовувати PersonalStorageQueryBuilder клас для пошуку вмісту в PST на основі різних критеріїв пошуку. Наприклад, показано пошук у PST за:

Важливість повідомлення.
Клас повідомлення.
Наявність вкладень.
Розмір повідомлення.
Дата повідомлення.
Непрочитані повідомлення.
Непрочитані повідомлення з вкладеннями, та
папки із конкретною назвою підпапки.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/";

try (PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir + "Outlook.pst")) {
    FolderInfo folder = personalStorage.getRootFolder().getSubFolder("Inbox");
    PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();

    // High importance messages
    builder.getImportance().equals((int) MapiImportance.High);
    MessageInfoCollection messages = folder.getContents(builder.getQuery());
    System.out.println("Messages with High Imp:" + messages.size());

    builder = new PersonalStorageQueryBuilder();
    builder.getMessageClass().equals("IPM.Note");
    messages = folder.getContents(builder.getQuery());
    System.out.println("Messages with IPM.Note:" + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Messages with attachments AND high importance
    builder.getImportance().equals((int) MapiImportance.High);
    builder.hasFlags(MapiMessageFlags.MSGFLAG_HASATTACH);
    messages = folder.getContents(builder.getQuery());
    System.out.println("Messages with atts: " + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Messages with size > 15 KB
    builder.getMessageSize().greater(15000);
    messages = folder.getContents(builder.getQuery());
    System.out.println("messags size > 15Kb:" + messages.size());

    java.util.Calendar c = java.util.Calendar.getInstance();

    builder = new PersonalStorageQueryBuilder();
    // Messages by Current Date
    // (Note that queries by date are not supported for Calendar Items in the Appointments folder)
    builder.getSentDate().on(c.getTime(), DateComparisonType.ByDate);
    messages = folder.getContents(builder.getQuery());
    System.out.println("Messages by Current Date: " + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Messages between Dates
    // (Note that queries by date are not supported for Calendar Items in the Appointments folder)
    c.set(2020,  0, 1, 0, 0, 0);
    builder.getSentDate().since(c.getTime());
    c.set(2021,  0, 1, 0, 0, 0);
    builder.getSentDate().before(c.getTime());
    messages = folder.getContents(builder.getQuery());
    System.out.println("Messages between Dates: " + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Unread messages
    builder.hasNoFlags(MapiMessageFlags.MSGFLAG_READ);
    messages = folder.getContents(builder.getQuery());
    System.out.println("Unread:" + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Unread messages with attachments
    builder.hasNoFlags(MapiMessageFlags.MSGFLAG_READ);
    builder.hasFlags(MapiMessageFlags.MSGFLAG_HASATTACH);
    messages = folder.getContents(builder.getQuery());
    System.out.println("Unread msgs with atts: " + messages.size());

    // Folder with name of 'SubInbox'
    builder = new PersonalStorageQueryBuilder();
    builder.getFolderName().equals("SubInbox");
    FolderInfoCollection folders = folder.getSubFolders(builder.getQuery());
    System.out.println("Folder having subfolder: " + folders.size());

    builder = new PersonalStorageQueryBuilder();
    // Folders with subfolders
    builder.hasSubfolders();
    folders = folder.getSubFolders(builder.getQuery());
    System.out.println(folders.size());
}

Пошук рядка в PST з параметром ігнорування регістру

Наступний фрагмент коду показує, як шукати рядок у PST з параметром ігнорування регістру.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/";

try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "CaseSensitivity.pst", FileFormatVersion.Unicode)) {
    FolderInfo folderinfo = personalStorage.createPredefinedFolder("Inbox", StandardIpmFolder.Inbox);
    folderinfo.addMessage(MapiMessage.fromMailMessage(MailMessage.load("Sample.eml")));
    PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();
    // IgnoreCase is True
    builder.getFrom().contains("automated", true);
    MailQuery query = builder.getQuery();
    MessageInfoCollection coll = folderinfo.getContents(query);
    System.out.println(coll.size());
}

Пошук тем повідомлень за кількома ключовими словами у PST‑файлі

Ви можете використати MailQueryBuilder.or метод для пошуку повідомлень із темою, що містить принаймні одне з вказаних слів, як показано нижче:

PersonalStorageQueryBuilder builder1 = new PersonalStorageQueryBuilder();
builder1.getSubject().contains("Review"); // 'Review' is key word for the search

PersonalStorageQueryBuilder builder2 = new PersonalStorageQueryBuilder();
builder2.getSubject().contains("Error"); // 'Error' is also key word for the search

PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();
queryBuilder.or(builder1.getQuery(), builder2.getQuery()); // message subjects must contain 'Review' or 'Error' words

try (PersonalStorage storage = PersonalStorage.fromFile("example.pst"))
{
    FolderInfo folderInfo = storage.getRootFolder().getSubFolder("Inbox");
    MessageInfoCollection messageInfos = folderInfo.getContents(queryBuilder.getQuery());

    for (MessageInfo messageInfo : messageInfos)
    {
        System.out.println(messageInfo.getSubject());
    }
}

Постраничне отримання вмісту PST‑папки

Покращуйте продуктивність вашого застосунку та контроль під час навігації великими папками. Отримуйте вміст папки посторінковим способом, використовуючи перевантаження Aspose.Email для getContents метод. Цей метод - FolderInfo.getContents(MailQuery query, int startIndex, int count) - отримує підмножину повідомлень, що відповідають вказаному запиту, починаючи з заданого індексу та обмежену кількістю. Наступний приклад коду демонструє постраничне отримання та обробку відфільтрованих повідомлень з PST‑папки:

// Load the PST file
try (PersonalStorage pst = PersonalStorage.fromFile(fileName)) {
    // Access a specific subfolder
    FolderInfo folder = pst.getRootFolder().getSubFolder("Inbox");

    // Build a query to filter messages by sender address
    PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();
    queryBuilder.getFrom().contains("report-service", true);

    // Define the page size
    int pageSize = 5;

    // Retrieve and process messages in pages
    for (int pageIndex = 0; pageIndex < 6; pageIndex++) {
        int startIndex = pageIndex * pageSize;

        // Get a page of messages
        MessageInfoCollection messages = folder.getContents(queryBuilder.getQuery(), startIndex, pageSize);

        for (MessageInfo messageInfo : messages) {
            // Output basic info about each message
            System.out.println("Subject: " + messageInfo.getSubject() + ", Sender: " + messageInfo.getSenderRepresentativeName());
        }
    }
}

Переміщення елементів у інші папки PST‑файлу

Aspose.Email дозволяє переміщати елементи з вихідної папки в іншу папку в тому ж файлі Personal Storage (PST). Це включає:

Переміщення вказаної папки у нову батьківську папку.
Переміщення вказаного повідомлення у нову папку.
Переміщення вмісту у нову папку.
Переміщення підпапок у нову батьківську папку.

Наступний фрагмент коду показує, як перемістити елементи, такі як повідомлення та папки, з вихідної папки в іншу папку в тому ж PST‑файлі.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
try (PersonalStorage personalStorage = PersonalStorage.fromFile("test.pst")) {
    FolderInfo inbox = personalStorage.getPredefinedFolder(StandardIpmFolder.Inbox);
    FolderInfo deleted = personalStorage.getPredefinedFolder(StandardIpmFolder.DeletedItems);
    FolderInfo subfolder = inbox.getSubFolder("Subfolder");

    // Move folder and message to the Deleted Items
    personalStorage.moveItem(subfolder, deleted);
    MessageInfoCollection contents = subfolder.getContents();
    personalStorage.moveItem(contents.get(0), deleted);

    // Move all inbox subfolders and subfolder contents to the Deleted Items
    inbox.moveSubfolders(deleted);
    subfolder.moveContents(deleted);
}

Оновлення властивостей повідомлень у PST‑файлі

Іноді потрібно оновити певні властивості повідомлень, наприклад, змінити тему, позначити важливість повідомлення тощо. Оновлення повідомлення у PST файлі з такими змінами у властивостях повідомлення можна здійснити за допомогою FolderInfo.changeMessages метод. У цій статті показано, як масово оновлювати повідомлення у PST файлі щодо змін у властивостях. Нижче наведений фрагмент коду демонструє, як оновити властивості повідомлень у масовому режимі для декількох повідомлень у PST файлі.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/" + "Sub.pst";

// Load the Outlook PST file
PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir);

// Get Requierd Subfolder
FolderInfo inbox = personalStorage.getRootFolder().getSubFolder("Inbox");

// find messages having From = "someuser@domain.com"
PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();
queryBuilder.getFrom().contains("someuser@domain.com");

// Get Contents from Query
MessageInfoCollection messages = inbox.getContents(queryBuilder.getQuery());

// Save (MessageInfo,EntryIdString) in List
List<String> changeList = new ArrayList<String>();
for (MessageInfo messageInfo : messages) {
    changeList.add(messageInfo.getEntryIdString());
}

// Compose the new properties
MapiPropertyCollection updatedProperties = new MapiPropertyCollection();
updatedProperties.add(MapiPropertyTag.PR_SUBJECT_W, new MapiProperty(MapiPropertyTag.PR_SUBJECT_W, "New Subject".getBytes(Charset.forName("utf-16le"))));
updatedProperties.add(MapiPropertyTag.PR_IMPORTANCE, new MapiProperty(MapiPropertyTag.PR_IMPORTANCE, BitConverter.getBytesInt64(2)));

// update messages having From = "someuser@domain.com" with new properties
inbox.changeMessages(changeList, updatedProperties);

Оновлення користувацьких властивостей у PST файлі

Іноді необхідно позначати елементи, які були оброблені у PST файлі. API Aspose.Email дозволяє це зробити за допомогою MapiProperty та MapiNamedProperty. Наступні методи корисні для цього.

constructor MapiNamedProperty(long propertyTag, String nameIdentifier, UUID propertyGuid, byte[] propertyValue)
constructor MapiNamedProperty(long propertyTag, long nameIdentifier, UUID propertyGuid, byte[] propertyValue)
FolderInfo.changeMessages(MapiPropertyCollection updatedProperties) - changes all messages in folder
PersonalStorage.changeMessage(String entryId, MapiPropertyCollection updatedProperties) - change message properties

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() {
    // The path to the File directory.
    String dataDir = "data/" + "Sub.pst";

    try (PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir)) {
        FolderInfo testFolder = personalStorage.getRootFolder().getSubFolder("Inbox");

        // Create the collection of message properties for adding or updating
        MapiPropertyCollection newProperties = new MapiPropertyCollection();

        // Normal, Custom and PidLidLogFlags named property
        MapiProperty property = new MapiProperty(MapiPropertyTag.PR_ORG_EMAIL_ADDR_W, "test_address@org.com".getBytes(Charset.forName("utf-16le")));
        MapiProperty namedProperty1 = new MapiNamedProperty(generateNamedPropertyTag(0L, MapiPropertyType.PT_LONG), "ITEM_ID", UUID.randomUUID(),
                BitConverter.getBytesInt64(123));
        MapiProperty namedProperty2 = new MapiNamedProperty(generateNamedPropertyTag(1L, MapiPropertyType.PT_LONG), 0x0000870C,
                UUID.fromString("0006200A-0000-0000-C000-000000000046"), BitConverter.getBytesInt64(0));
        newProperties.add(namedProperty1.getTag(), namedProperty1);
        newProperties.add(namedProperty2.getTag(), namedProperty2);
        newProperties.add(property.getTag(), property);
        testFolder.changeMessages(testFolder.enumerateMessagesEntryId(), newProperties);
    }
}

private static long generateNamedPropertyTag(long index, int dataType) {
    return (((0x8000 | index) << 16) | (long) dataType) & 0x00000000FFFFFFFFL;
}

Витягнути вкладення без повного витягнення повідомлення

API Aspose.Email можна використати для витягування вкладень з PST повідомлень без попереднього повного витягування повідомлення. Цей ExtractAttachments метод PersonalStorage можна використати для цього. Нижче наведений фрагмент коду показує, як витягнути вкладення без повного витягування повідомлення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/";

try (PersonalStorage personalstorage = PersonalStorage.fromFile(dataDir + "Outlook.pst")) {
    FolderInfo folder = personalstorage.getRootFolder().getSubFolder("Inbox");

    for (String messageInfo : folder.enumerateMessagesEntryId()) {
        MapiAttachmentCollection attachments = personalstorage.extractAttachments(messageInfo);

        if (attachments.size() != 0) {
            for (MapiAttachment attachment : attachments) {
                if (attachment.getLongFileName() != null && !attachment.getLongFileName().isEmpty()) {
                    if (attachment.getLongFileName().contains(".msg")) {
                        continue;
                    } else {
                        attachment.save(dataDir + "Attachments/" + attachment.getLongFileName());
                    }
                }
            }
        }
    }
}

Додавання файлів до PST

Основна функціональність Microsoft Outlook – управління електронною поштою, календарями, завданнями, контактами та записами журналу. Крім того, файли також можна додавати до папки PST, і створений PST зберігає записи доданих документів. Aspose.Email забезпечує можливість додавати файли у папку так само, як і повідомлення, контакти, завдання та записи журналу до PST. Нижче наведений фрагмент коду показує, як додати документи до папки PST за допомогою Aspose.Email.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/";

try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "Ps1_out.pst", FileFormatVersion.Unicode)) {
    FolderInfo folder = personalStorage.getRootFolder().addSubFolder("Files");

    // Add Document.doc file with the "IPM.Document" message class by default.
    folder.addFile(dataDir + "attachment_1.doc", null);
}

Java: Робота з контактами у файлі PST

Mon, 01 Jan 0001 00:00:00 +0000

Читання декількох контактів у форматі VCard

Нижче наведений приклад коду демонструє, як читати файл VCF, перевірити, чи містить він кілька контактів, і, якщо так, завантажити контакти з файлу у список об’єктів VCardContact. Код використовує наступні методи:

isMultiContacts(InputStream stream) - Перевіряє, чи містить вихідний потік декілька контактів.
loadAsMultiple(String filePath, Charset encoding) - Завантажує список контактів з файлу, що містить декілька контактів.
loadAsMultiple(InputStream stream, Charset encoding) - Завантажує список контактів з потоку багатьох контактів.

try (InputStream stream = new FileInputStream("test.vcf")) {
    if (VCardContact.isMultiContacts(stream)) {
        List<VCardContact> contacts = VCardContact.loadAsMultiple(stream, Charset.forName("utf-8"));
    }
}

Додавання контакту до PST

Створити новий PST, додати підпапки та повідомлення показано, як створити файл PST і додати до нього підпапку. За допомогою Aspose.Email ви можете додати MapiContact у підпапку Contacts файлу PST, який ви створили або завантажили. Нижче наведені кроки для додавання MapiContact у PST:

Створіть MapiContact об’єкт.
Встановіть MapiContact властивостей, використовуючи різні конструктори та методи.
Створіть PST за допомогою PersonalStorage.create() метод.
Створіть заздалегідь визначену папку (Contacts) у корені файлу PST, отримавши доступ до кореневої папки і викликавши addMapiMessageItem() метод.

Нижче наведений фрагмент коду показує, як створити MapiContact а потім додати його до папки Contacts новоствореного файлу PST.

Збереження інформації про контакти з файлу PST у форматі MSG

У цій статті показано, як отримати контактну інформацію з файлу Microsoft Outlook PST та зберегти контакти на диск у форматі MSG. Для цього використовуйте PersonalStorage і MapiContact класи для отримання та відображення інформації про контакт.

Щоб отримати інформацію про контакт:

Завантажте файл PST у PersonalStorage клас.
Перегляньте папку Contacts.
Отримайте вміст папки Contacts, щоб отримати колекцію повідомлень.
Переберіть колекцію повідомлень.
Викличте PersonalStorage.extractMessage() а потім toMapiMessageItem() метод для отримання інформації про контакт у MapiContact клас.
Використати MapiContact властивості для доступу до інформації про контакт.
Викличте PersonalStorage.extractMessage() метод для отримання інформації про контакт у MapiMessage клас.
Викличте MapiMessage.save() метод для збереження контакту на диск у форматі MSG.

Нижче наведений зразок коду, який отримує всю інформацію про контакти з файлу PST і зберігає її на диск у форматі MSG.

Збереження контактної інформації з Outlook PST на диск у форматі vCard

У цій статті показано, як отримати контактну інформацію з файлу Microsoft Outlook PST і зберегти контакт на диск у форматі vCard (VCF). Він використовує PersonalStorage і MapiContact класи для отримання контактної інформації.

Нижче наведено кроки для отримання інформації про контакти:

Завантажте файл PST у PersonalStorage клас.
Перегляньте папку Contacts.
Отримайте вміст папки Contacts, щоб отримати колекцію повідомлень.
Переберіть колекцію повідомлень.
Викличте PersonalStorage.extractMessage() метод для отримання інформації про контакт у MapiContact клас.
Використовуйте властивості MapiContact клас для доступу до інформації про контакт.

Нижче програма завантажує файл PST з диска та зберігає всі контакти у форматі vCard (VCF). Файли VCF потім можна використовувати в будь-якій іншій програмі, яка підтримує стандартний файл контакту vCard. Якщо відкрити будь-який файл VCF у Microsoft Outlook, він виглядатиме як на скріншоті нижче.

|| | :- | |Рисунок: vCard, збережений за допомогою Aspose.Email|

Java: Робота з елементами календаря у PST файлі

Mon, 01 Jan 0001 00:00:00 +0000

Додавання MapiCalendar до PST

Створити новий PST, додати підпапки та повідомлення показано, як створити PST файл і додати до нього підпапку. За допомогою Aspose.Email ви можете додати MapiCalendar у підпапку Calendar PST файлу, який ви створили або завантажили.

Нижче наведено кроки для додавання MapiCalendar у PST:

Створіть MapiCalendar об’єкт.
Встановіть MapiCalendar властивості за допомогою конструктора та методів.
Створіть PST за допомогою PersonalStorage.create() метод.
Створіть заздалегідь визначену папку (Calendar) у корені PST файлу, отримавши доступ до кореневої папки і потім викликавши addMapiMessageItem() метод.

Нижче наведений фрагмент коду показує, як створити MapiCalendar а потім додати його до папки Calendar новоствореного PST файлу.

Зберегти елементи календаря з Outlook PST на диск у форматі ICS

У цій статті показано, як отримати доступ до елементів календаря з Outlook PST файлу і зберегти календар на диск у форматі ICS. Використовується PersonalStorage і MapiCalendar класи для отримання інформації про календар.

Нижче наведено кроки збереження елементів календаря:

Завантажте файл PST у PersonalStorage клас.
Перегляньте папку Calendar.
Отримайте вміст папки Calendar, щоб отримати колекцію повідомлень.
Переберіть колекцію повідомлень.
Викличте PersonalStorage.extractMessage() метод для отримання інформації про контакт у MapiCalendar клас.
Викличте MapiCalendar.save() метод для збереження елемента календаря на диск у форматі ICS.

Нижче наведена програма, яка завантажує PST файл з диска і зберігає всі елементи календаря у форматі ICS. Файли ICS потім можна використати в будь‑якій іншій програмі, що може завантажити стандартний файл календаря ICS. Якщо ви відкриєте будь‑який файл ICS у Microsoft Outlook, він виглядатиме як на скріншоті нижче.

|| | :- | |Рисунок: елемент календаря, збережений за допомогою Aspose.Email|

Витягнути елементи календаря з PST файлу

Клас MapiCalendar представляє елемент календаря у форматі Microsoft Outlook MAPI. Витягніть повідомлення з PST файлу і перетворіть його у елемент MAPI повідомлення. Наступний приклад коду витягує елемент календаря з PST файлу і перетворює його в об’єкт MapiCalendar для подальшого маніпулювання чи обробки:

MapiCalendar cal = (MapiCalendar) pst.extractMessage(messageInfo).toMapiMessageItem();

Зберегти елементи календаря у форматі ICS з оригінальною міткою часу

Використайте наведений вище приклад коду, щоб витягнути елемент календаря з PST файлу, а потім вкажіть додаткові параметри для збереження його у форматі ICS з оригінальною міткою часу, використовуючи setKeepOriginalDateTimeStamp метод MapiCalendarIcsSaveOptions клас:

MapiCalendar cal = (MapiCalendar) pst.extractMessage(messageInfo).toMapiMessageItem();

if (cal != null) {
    MapiCalendarIcsSaveOptions so = new MapiCalendarIcsSaveOptions();
    so.setKeepOriginalDateTimeStamp(true);
    cal.save("cal.ics", so);
}

Модифікувати/Видаляти повторення з рекурентних подій

Java: Робота з MapiTask у PST

Mon, 01 Jan 0001 00:00:00 +0000

Додавання MapiTask до PST

Створити новий PST, додати підпапки та повідомлення показано, як створити PST файл і додати до нього підпапку. За допомогою Aspose.Email ви можете додати MapiTask до підпапки Tasks PST файлу, який ви створили або завантажили.

Нижче наведено кроки додавання MapiTask до PST:

Створіть MapiTask об’єкт.
Встановіть MapiTask властивості, використовуючи конструктор та різні методи.
Створіть PST за допомогою PersonalStorage.create() метод.
Створіть заздалегідь визначену папку (Tasks) у корені PST файлу, отримавши доступ до кореневої папки і потім викликавши addMapiMessageItem() метод.

Нижче наведений фрагмент коду показує, як створити MapiTask а потім додати його до папки Tasks новоствореного PST файлу.

Java: Робота з MapiJournal у PST

Mon, 01 Jan 0001 00:00:00 +0000

Додавання MapiJournal до PST

Створити новий PST, додати підпапки та повідомлення показано, як створити файл PST і додати до нього підпапку. За допомогою Aspose.Email ви можете додати MapiJournal до підпапки Journal файлу PST, який ви створили або завантажили. Нижче наведено кроки для додавання MapiJournal до PST:

Створіть MapiJournal об’єкт.
Встановіть MapiJournal властивості за допомогою конструктора та методів.
Створіть PST за допомогою PersonalStorage.create() метод.
Створіть заздалегідь визначену папку (Journals) у корені файлу PST, отримавши доступ до кореневої папки, а потім викликавши addMapiMessageItem() метод.

Нижче наведений фрагмент коду показує, як створити MapiJournal а потім додайте його до папки Journal новоствореного файлу PST.

Додавання вкладень до MapiJournal

Також можна додавати вкладення до елементів журналу MAPI. Нижчеприведений код показує, як це зробити.

Java: Робота з MapiNote у PST

Mon, 01 Jan 0001 00:00:00 +0000

Додавання MapiNote до PST

Створити новий PST, додати підпапки та повідомлення показано, як створити PST файл і додати до нього підпапку. За допомогою Aspose.Email ви можете додати MapiNote до підпапки Notes PST файлу, який ви створили або завантажили.

Нижче наведено кроки додавання MapiNote до PST:

Створіть шаблон MapiNote за допомогою Microsoft Outlook і збережіть його як файл MSG.
Завантажте збережену нотатку MSG у MapiMessage об’єкт.
Створіть MapiNote об’єкт і завантажте шаблон нотатки MSG.
Встановіть MapiNote властивості різними методами.
Створіть PST за допомогою PersonalStorage.create() метод.
Створіть заздалегідь визначену папку (Notes) у корені PST файлу, отримавши доступ до кореневої папки і потім викликавши addMapiMessageItem() метод.

Нижче наведений фрагмент коду показує, як створити MapiNote а потім додати його до папки Notes новоствореного PST файлу.

Java: Розділення та об’єднання файлів PST

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email API забезпечує можливість розділити один файл PST на кілька файлів PST бажаного розміру. Він також може об’єднувати кілька файлів PST в один файл PST. Обидві операції – розділення та об’єднання PST – можна відстежувати, додаючи події до цих операцій.

Розділення та об’єднання файлів PST

Наступні приклади коду ілюструють, як розділити великий файл PST на кілька малих фрагментів файлiв PST.

Об’єднання кількох PST у один PST

Наступний приклад коду показує, як кілька файлів PST можна об’єднати в один великий файл PST.

Спробуйте!

Об’єднуйте та комбінуйте кілька файлових листів в один за допомогою безкоштовного Додаток Aspose.Email Merger.

Об’єднання папок з іншого PST

Aspose.Email API дозволяє об’єднувати цілі папки з іншого PST у цільовий PST, що призводить до великого розміру PST.

Розділення PST за визначеним критерієм

Допоміжні методи

Java: Робота з властивостями захисту паролем PST

Mon, 01 Jan 0001 00:00:00 +0000

Microsoft Outlook дозволяє користувачам захищати паролем файли PST, обмежуючи доступ до них. Aspose.Email може виявити захист паролем у файлі PST. У цій статті показано, як перевірити наявність пароля в PST і як перевірити, чи правильний застосований пароль.

Перевірка захисту паролем

The MapiPropertyTag.PR_PST_PASSWORD значення з MapiPropertyTag клас використовується для перевірки, чи файл захищено паролем.

Хеш CRC-32 рядка пароля зберігається у властивості PidTagPstPassword (tag = 0x67ff0003) у MessageStore. Якщо ця властивість існує і не дорівнює нулю, то PST захищено паролем.

Нижче наведений фрагмент коду показує, як перевірити, чи захищено PST файл паролем, і чи є наданий рядок дійсним паролем для цього PST.

Нижче наведений фрагмент коду показує дві функції: перша перевіряє, чи захищено PST паролем, а друга демонструє, як перевірити, чи наданий пароль правильний.

Видалити/Скинути властивість PR_PST_PASSWORD

Видалення PR_PST_PASSWORD властивість не може бути досягнута, оскільки інші властивості видалено зі сховища повідомлень. Натомість потрібно встановити її значення в нуль (0), щоб її видалити. Властивість "Store" класу PST дозволяє доступ до властивостей сховища PST замість MessageStoreProperties PST у цьому випадку.

Встановити/Змінити пароль PST

Нижче наведений фрагмент коду показує, як встановити пароль для файлів PST.

Перевірка пароля для захищених паролем файлів PST

Aspose.Email дозволяє розробникам перевіряти, чи захищено PST файл паролем, і чи правильний даний пароль. Для цього API надає PersonalStorage.Store.IsPasswordProtected властивість і PersonalStorage.Store.IsPasswordValid() метод. PersonalStorage.Store.IsPasswordProtected властивість повертає true, якщо файл PST захищено паролем, і false, якщо ні. PersonalStorage.Store.IsPasswordValid() метод, який приймає рядок пароля як параметр і повертає true, якщо пароль правильний, і false, якщо він неправильний.

Нижче наведений фрагмент коду демонструє використання PersonalStorage.Store.IsPasswordProtected властивість і PersonalStorage.Store.IsPasswordValid() метод.

Приклад коду

Вивід консолі

Сховище захищено паролем - True Пароль дійсний - True

Java: Читання файлу Outlook PST та отримання інформації про папки та підпапки

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email для Java дозволяє читати файли Microsoft Outlook PST. Ви можете завантажити файл PST з диска або потоку в екземпляр PersonalStorage клас і отримати інформацію про його вміст, наприклад, папки, підпапки та повідомлення.

Завантажити файл PST

Файл Outlook PST можна завантажити в екземпляр PersonalStorage класу. Нижче наведено приклад коду для завантаження файлу PST:

Відображення інформації про папки

Після завантаження файлу PST у PersonalStorage класу, ви можете отримати інформацію про відображуване ім’я файлу, кореневу папку, підпапки та кількість повідомлень. Наведений нижче приклад коду показує назву файлу PST, папки та кількість повідомлень у папках:

Отримати лише користувачем визначені папки

Файли PST/OST можуть містити папки, створені користувачем. Aspose.Email надає можливість отримати доступ лише до користувачем визначених папок, використовуючи PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser властивості. Ви можете встановити PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser встановіть властивість у true, щоб отримати лише користувачем визначені папки. Нижче наведено приклад коду, який демонструє використання PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser для отримання користувачем визначених папок.

Перевірка, чи знаходиться папка у заздалегідь визначеній папці

При відкритті та перевірці папок у файлі PST (Personal Storage Table) ви можете перевірити, чи є кожна папка заздалегідь визначеною, чи підпапкою заздалегідь визначеної папки, та отримати інформацію про кожну папку.

The FolderInfo.getPredefinedType(boolean getForTopLevelParent) метод використовується для перевірки, чи папка є StandardIpmFolder.

Якщо параметр ‘getForTopLevelParent’ має значення true, метод повертає значення enum StandardIpmFolder для батьківської папки верхнього рівня. Це визначає, чи є поточна папка підпапкою заздалегідь визначеної папки. Якщо параметр ‘getForTopLevelParent’ має значення false, повертається значення enum StandardIpmFolder для поточної папки.

String fileName = "my.pst";

try (PersonalStorage pst = PersonalStorage.fromFile(fileName)) {
    checkFolders(pst.getRootFolder().getSubFolders());
}

private void checkFolders(FolderInfoCollection folders) {
    for (FolderInfo folder : folders) {
        System.out.println("Display Name: " + folder.getDisplayName());

        // Determines whether the current folder is a predefined folder
        int folderType = folder.getPredefinedType(false);
        String answer = folderType == StandardIpmFolder.Unspecified ? "No" : "Yes, " + folderType;
        System.out.println("Is StandardIpmFolder?: " + answer);

        // Determines whether the current folder is a subfolder of a predefined folder
        if (folderType == StandardIpmFolder.Unspecified) {
            folderType = folder.getPredefinedType(true);
            answer = folderType == StandardIpmFolder.Unspecified ? "No" : "Yes, " + folderType;
            System.out.println("Is subfolder from StandardIpmFolder parent?: " + answer);
        }

        System.out.println();

        checkFolders(folder.getSubFolders());
    }
}

Отримати або додати стандартну папку RSS-стрічок у файлі PST

Aspose.Email дозволяє отримати посилання на заздалегідь визначену папку, яка містить RSS-стрічки. Це може бути корисно, якщо ви хочете програмно отримати доступ і маніпулювати RSS-стрічками, збереженими у файлі Outlook PST. Присвойте значення RssFeeds до StandardIpmFolder перелічення.

Наступний приклад коду показує, як отримати папку RSS-стрічок:

try (PersonalStorage pst = PersonalStorage.fromFile("my.pst", false)) {
    FolderInfo rssFolder = pst.getPredefinedFolder(StandardIpmFolder.RssFeeds);
}

А наведений нижче приклад коду демонструє, як додати папку RSS-стрічок:

try (PersonalStorage pst = PersonalStorage.create("my.pst", FileFormatVersion.Unicode)) {
    FolderInfo rssFolder = pst.createPredefinedFolder("RSS Feeds", StandardIpmFolder.RssFeeds);
}

Аналіз пошукових папок

Файл PST/OST може містити пошукові папки, окрім звичайних типів папок. Aspose.Email надає FolderKind перелічувач для зазначення повідомлень із таких пошукових папок з EnumerateFolders і GetSubFolders методи.

Отримання інформації про батьківську папку з MessageInfo

Наведений нижче приклад коду показує, як отримати інформацію про батьківську папку з MessageInfo.

API обходу файлів PST

API обходу дозволяє витягнути всі елементи PST настільки далеко, наскільки це можливо, без виникнення виключень, навіть якщо частина даних оригінального файлу пошкоджена. Нижче наведено кроки щодо використання цього API.

Використати PersonalStorage конструктор і завантажити метод замість методу fromFile.

Конструктор дозволяє визначити метод зворотного виклику.

try (PersonalStorage currentPst = new PersonalStorage(new TraversalExceptionsCallback() {
    public void invoke(TraversalAsposeException exception, String itemId) {
        // Exception handling code.
    }
})) {
    //
}

Винятки під час завантаження та обходу будуть доступні через метод зворотного виклику.

The завантажити метод повертає ’true’, якщо файл успішно завантажено і подальший обход можна виконати. Якщо файл пошкоджений і обхід неможливий, повертається ‘false’.

if (currentPst.load(inputStream))

Це дозволяє відкривати та обходити навіть пошкоджені файли PST без виникнення виключень. Як виключення, так і пошкоджені елементи будуть оброблятися методом зворотного виклику.

try (PersonalStorage pst = new PersonalStorage(new TraversalExceptionsCallback() {
    public void invoke(TraversalAsposeException exception, String itemId) {
        // Exception handling code.
    }
})) {
    if (pst.load("test.pst")) {
        getAllMessages(pst, pst.getRootFolder());
    }
}

private static void getAllMessages(PersonalStorage pst, FolderInfo folder) {
    for (String messageEntryId : folder.enumerateMessagesEntryId()) {
        MapiMessage message = pst.extractMessage(messageEntryId);
    }
    for (FolderInfo subFolder : folder.getSubFolders()) {
        getAllMessages(pst, subFolder);
    }
}

Java: Читання пошкоджених PST/OST файлів

Mon, 01 Jan 0001 00:00:00 +0000

Читання пошкоджених PST/OST файлів

Іноді може бути неможливо прочитати PST/OST через деякі проблеми. Наприклад, деякі блоки даних можуть бути пошкоджені. У таких випадках під час виклику часто виникають виключення. EnumerateFolders, EnumerateMessages, GetContents, GetSubfolders, тощо. методи. Але окремі повідомлення або папки можуть залишатися недоторканими у сховищі.

Користувачі Aspose.Email можуть знаходити ідентифікатори елементів ієрархічно. Далі можна витягувати елементи за ідентифікаторами. Для цього бібліотека пропонує наступні методи:

PersonalStorage.findMessages(String parentEntryId) - знаходить ідентифікатори повідомлень для папки.
PersonalStorage.findSubfolders(String parentEntryId) - знаходить ідентифікатори підпапок для папки.

Примітка, що незважаючи на переваги, існують пошкоджені сховища, які не можна прочитати навіть за допомогою цих методів.

Наступний фрагмент коду демонструє використання цих методів для читання пошкоджених PST/OST файлів:

try (PersonalStorage pst = PersonalStorage.fromFile(fileName)) {
    exploreCorruptedPst(pst, pst.getRootFolder().getEntryIdString());
}

public static void exploreCorruptedPst(PersonalStorage pst, String rootFolderId) {
    Iterable<String> messageIdList = pst.findMessages(rootFolderId);

    for (String messageId : messageIdList) {
        try {
            MapiMessage msg = pst.extractMessage(messageId);
            System.out.println("- " + msg.getSubject());
        } catch (Exception e) {
            System.out.println("Message reading error. Entry id: " + messageId);
        }
    }

    Iterable<String> folderIdList = pst.findSubfolders(rootFolderId);

    for (String subFolderId : folderIdList) {
        if (subFolderId != rootFolderId) {
            try {
                FolderInfo subfolder = pst.getFolderById(subFolderId);
                System.out.println(subfolder.getDisplayName());
            } catch (Exception e) {
                System.out.println("Message reading error. Entry id: " + subFolderId);
            }

            exploreCorruptedPst(pst, subFolderId);
        }
    }
}

Витягнути елементи PST з пошкоджених файлів

API обходу дозволяє витягувати всі елементи PST наскільки це можливо, не викидаючи виключень, навіть якщо деякі дані вихідного файлу пошкоджені.

Використайте PersonalStorage(TraversalExceptionsCallback callback) конструктор та load(String fileName) метод замість fromFile метод.

Конструктор дозволяє визначити метод зворотного виклику.

TraversalExceptionsCallback exceptionsCallback = new TraversalExceptionsCallback() {
    @Override
    public void invoke(TraversalAsposeException exception, String itemId) {
        /* Exception handling  code. */
    }
};

try (PersonalStorage pst = new PersonalStorage(exceptionsCallback)) { }

Винятки під час завантаження та обходу будуть доступні через метод зворотного виклику.

Метод load повертає ’true’, якщо файл успішно завантажено і подальший обхід можливий. Якщо файл пошкоджений і обхід неможливий, повертається ‘false’.

if (currentPst.load(inputStream))

Наступний приклад коду показує, як впровадити API обходу PST файлу в проєкт:

public static void main(String[] args) {
    TraversalExceptionsCallback exceptionsCallback = new TraversalExceptionsCallback() {
        @Override
        public void invoke(TraversalAsposeException exception, String itemId) {
            /* Exception handling  code. */
        }
    };

    try (PersonalStorage pst = new PersonalStorage(exceptionsCallback)) {
        if (pst.load("test.pst")) {
            getAllMessages(pst, pst.getRootFolder());
        }
    }
}

private static void getAllMessages(PersonalStorage pst, FolderInfo folder) {
    for (String messageEntryId : folder.enumerateMessagesEntryId()) {
        MapiMessage message = pst.extractMessage(messageEntryId);
    }
    for (FolderInfo subFolder : folder.getSubFolders()) {
        getAllMessages(pst, subFolder);
    }
}

Java: Додавання MapiDistributionList до PST

Mon, 01 Jan 0001 00:00:00 +0000

Створити новий PST, додати підпапки та повідомлення показано, як створити файл PST і додати до нього підпапку. За допомогою Aspose.Email ви можете додати MapiDistributionList у підпапку Contacts PST файлу, який ви створили або завантажили.

Щоб встановити EntryId для MapiDistributionListMember, base64String потрібно конвертувати за допомогою Apache Commons Codec.

Завантажити MapidistributionList з файлу

Нижченаведений код завантажує MAPI distribution list з файлу.

Створити новий MapiDistributionList і додати його до підпапки Contacts

Нижче наведено кроки для додавання MapiDistributionList у PST:

Створіть новий PST.
Додайте папку Contacts до PST.
Створити зразкові контакти.
Створити список розсилки на основі створених контактів.
Додайте список розсилки до PST.

Нижче наведений фрагмент коду показує, як створити MapiDistributionList а потім додати його до папки Contacts новоствореного файлу PST.

Створити одноразовий список розсилки

Для цього списку розсилки окремі контакти не потрібні.

Java: Робота з великими PST‑файлами

Mon, 01 Jan 0001 00:00:00 +0000

Обробка великих файлів Personal Storage Table (PST) може знизити продуктивність і збільшити використання пам’яті. Aspose.Email for Java надає кілька технік і API, які дозволяють розробникам ефективно отримувати доступ, обробляти та керувати даними поштових скриньок без перевантаження системних ресурсів.

Використовуйте ітеровані методи для обходу папок та повідомлень

Під час ітерації по папках та повідомленнях, надавайте перевагу методам, які повертають Iterable. Це зменшує використання пам’яті та підвищує продуктивність.

try (PersonalStorage pst = PersonalStorage.fromFile("storage.pst")) {
    for (FolderInfo folder : pst.getRootFolder().enumerateFolders()) {
        for (MessageInfo messageInfo : folder.enumerateMessages()) {
            // Process message
        }
    }
}

Використовуйте MessageInfo для базових властивостей повідомлень

Якщо вам потрібні лише базові деталі повідомлення, використовуйте MessageInfo замість завантаження повного листа. Це швидше і споживає менше пам’яті.

for (MessageInfo messageInfo : folder.enumerateMessages()) {
    System.out.println("Subject: " + messageInfo.getSubject());
    System.out.println("To: " + messageInfo.getDisplayTo());
    System.out.println("Importance: " + messageInfo.getImportance());
    System.out.println("Message Class: " + messageInfo.getMessageClass());
}

Уникайте вилучення повних листів, якщо це не потрібно

Не використовуйте ExtractMessage або EnumerateMapiMessages методи для всіх листів, якщо вам не потрібні всі властивості.

Замість цього розгляньте:

a) Отримання ідентифікаторів листів

Використати enumerateMessagesEntryId щоб отримати всі ідентифікатори листів у папці. Потім можна вибірково вилучати властивості, листи або вкладення.

for (String id : folder.enumerateMessagesEntryId()) {
    // Retrieve a property using ID (extractProperty),
    // Extract a MapiMessage (extractMessage),
    // Extract message attachments (extractAttachments),
    // Save message to a stream (saveMessageToStream).
}

b) Вилучення окремої властивості

Використати ExtractProperty якщо вам потрібна лише певна властивість, відсутня в MessageInfo.

for (String msgId : folder.enumerateMessagesEntryId()) {
    String transportMessageHeaders =
        pst.extractProperty(
            org.apache.commons.codec.binary.Base64.decodeBase64(msgId),
            KnownPropertyList.TRANSPORT_MESSAGE_HEADERS.getTag()
        ).getString();
}

c) Вилучення лише вкладень

Якщо потрібні лише вкладення, використовуйте ExtractAttachments.

for (String msgId : folder.enumerateMessagesEntryId()) {
    MapiAttachmentCollection attachments = pst.extractAttachments(msgId);
}

Використовуйте критерії пошуку для фільтрації листів

Фільтрація листів за допомогою критерії пошуку зменшує кількість завантажених листів і підвищує продуктивність.

try (PersonalStorage pst = PersonalStorage.fromFile("storage.pst")) {

    PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();
    // Unread messages
    builder.hasNoFlags(MapiMessageFlags.MSGFLAG_READ);

    for (FolderInfo folder : pst.getRootFolder().enumerateFolders()) {
        MessageInfoCollection unread = folder.getContents(builder.getQuery());
    }
}

Зберегти листи у потік

Замість того, щоб вилучати та зберігати листи по одному, використовуйте SaveMessageToStream для кращої продуктивності.

for (String id : folder.enumerateMessagesEntryId()) {
    try (OutputStream fos  = new FileOutputStream("message.msg")) {
        pst.saveMessageToStream(id, fos);
    }
}

Використовуйте масові методи, коли це можливо

Коли вам потрібно додати або видалити кілька елементів, віддавайте перевагу масовим методам замість окремих операцій. Це зменшує навантаження і підвищує продуктивність.

Java: Читання файлу OLM Outlook для Mac та отримання інформації про папки і підпапки

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java дозволяє читати файли OLM Outlook для Mac. Ви можете завантажити файл OLM з диска в екземпляр OlmStorage клас і отримати інформацію про його вміст, наприклад, папки, підпапки та повідомлення.

Відкрити файли формату OLM

Файли формату OLM можна відкрити двома способами:

використовуючи конструктор
використовуючи статичний метод FromFile

Існують відмінності у поведінці між цими методами. Дивіться розділ нижче.

Відкрити файли за допомогою конструктора

Щоб відкрити файл, викличте конструктор OlmStorage клас і передайте повну назву файлу або потік як аргумент:

OlmStorage olm = new OlmStorage("fileName");

Відкрити файли за допомогою статичного методу FromFile

Щоб відкрити файл, використайте статичний метод fromFile і передайте повну назву файлу як аргумент:

OlmStorage olm = OlmStorage.fromFile("fileName");

Відкрити файли за допомогою статичного методу FromStream

Щоб відкрити файл за допомогою статичного методу fromStream, передайте ім’я потоку як аргумент:

Читання файлу OLM

Наступний фрагмент коду показує, як завантажити файл OLM та отримати його вміст.

Отримати папки

Щоб отримати папки з файлу OLM (Outlook for Mac), завантажте його за допомогою OlmStorage спочатку ініціалізуйте клас, а потім використайте один із наступних методів залежно від ваших потреб:

getFolder(String name, boolean ignoreCase) - Отримує папку за назвою.
getFolders() - Отримує ієрархію папок/колекцію папок.
getFolderHierarchy() - Отримує ієрархію папок.

Нижче наведений зразок коду покаже, як отримати папку з файлу OLM:

// Get the folder by name
OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

} finally {

    olm.dispose();

}

При використанні fromFile метод для відкриття файлу OLM, getFolderHierarchy() поверне null. У цьому випадку викликайте getFolders() метод явно для отримання списку каталогів у файлі OLM.

Отримати шлях до папки

Ви також можете отримати шлях до папок у файлі OML. Aspose.Email надає OlmFolder.Path властивість, що повертає шлях до папки. Наступний фрагмент коду демонструє використання OlmFolder.Path властивість для отримання шляхів до папок у файлі OML.

Підрахувати кількість елементів у папці

Ви також можете підрахувати кількість елементів у папці. Aspose.Email надає OlmFolder.MessageCount властивість, що повертає кількість елементів у папці. Наступний фрагмент коду демонструє використання OlmFolder.MessageCount властивість для отримання кількості елементів у папках файлу OML.

Перерахувати повідомлення з заданої папки

Aspose.Email надає API для роботи зі сховищами OLM та витягання повідомлень з заданої папки. OlmFolder і OlmMessageInfo класи представляють коротку інформацію про папку та повідомлення у сховищі відповідно. OlmFolder клас надає наступні методи:

OlmFolder.getSubFolder(String subfolderName, boolean ignoreCase) - Отримує підпапку за назвою.
OlmFolder.enumerateMapiMessages() - Надає енумератор, який підтримує ітерацію MapiMessages у поточній папці.
OlmFolder.enumerateMessages() - Надає енумератор, який підтримує ітерацію OlmMessageInfo у поточній папці.
OlmFolder.enumerateMessages(int startIndex, int count) - Надає енумератор, який підтримує ітерацію OlmMessageInfo у заданому діапазоні.
OlmFolder.enumerateMessages(MailQuery query) - Надає енумератор, який підтримує ітерацію OlmMessageInfo за критеріями пошуку.

Наведені нижче приклади коду продемонструють використання цих методів:

 // Enumerates all messages in a given folder

OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

   for (OlmMessageInfo messageInfo : inbox.enumerateMessages()) {

        System.out.println(messageInfo.getSubject());

   }

} finally {

    olm.dispose();

}

// Enumerates a range of messages in a given folder

OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

   int startIndex = 10;

   int count = 100;

   for (OlmMessageInfo messageInfo : inbox.enumerateMessages(startIndex, count)) {

        System.out.println(messageInfo.getSubject());

   }

} finally {

    olm.dispose();

}

// Enumerates messages by search criteria

OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

    MailQueryBuilder mailQueryBuilder = new MailQueryBuilder();

    mailQueryBuilder.getSubject().contains("invitation");

    mailQueryBuilder.getFrom().contains("Mark");

   for (OlmMessageInfo messageInfo : inbox.enumerateMessages(mailQueryBuilder.getQuery())) {

        System.out.println(messageInfo.getSubject());

   }

} finally {

    olm.dispose();

}

// Enumerates all messages and the extraction of some of them

OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

   for (OlmMessageInfo messageInfo : inbox.enumerateMessages()) {

       if (messageInfo.hasAttachments()) {

            MapiMessage msg = olm.extractMapiMessage(messageInfo);

       }

   }

} finally {

    olm.dispose();

}

Витягти повідомлення з OLM за ідентифікаторами

Іноді потрібно витягти вибрані повідомлення за ідентифікаторами. Наприклад, ваш застосунок зберігає ідентифікатори у базі даних і витягує повідомлення за запитом. Це ефективний спосіб уникнути перебору всього сховища щоразу, щоб знайти конкретне повідомлення для витягування. Для реалізації цієї функції в OLM-файлах Aspose.Email надає такі методи та класи:

EntryId властивість OlmMessageInfo клас - Отримує ідентифікатор запису повідомлення.
перевантажений extractMapiMessage(String id) метод OlmStorage клас - Отримує повідомлення з OLM.

Нижче наведений приклад коду демонструє, як витягти повідомлення з OLM за ідентифікатором:

for (OlmMessageInfo msgInfo : olmFolder.enumerateMessages()) {
    MapiMessage msg = storage.extractMapiMessage(msgInfo.getEntryId());
}

Примітка: Ідентифікатор повідомлення унікальний у межах файлу сховища. Ідентифікатори створюються Aspose.Email і не можуть бути використані в інших сторонніх бібліотеках чи додатках для обробки OLM.

Витягнути елементи OLM з пошкоджених файлів

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

Використайте OlmStorage(TraversalExceptionsCallback callback) конструктор та load(String fileName) метод замість fromFile метод.

Конструктор дозволяє визначити метод зворотного виклику.

OlmStorage olm = new OlmStorage(new TraversalExceptionsCallback() {
    public void invoke(TraversalAsposeException exception, String itemId) {
        /* Exception handling  code. */
    }
});

Винятки під час завантаження та обходу будуть доступні через метод зворотного виклику.

TraversalExceptionsCallback exceptionsCallback = new TraversalExceptionsCallback() {
    public void invoke(TraversalAsposeException exception, String itemId) {
        /* Exception handling  code. */
    }
};
try (OlmStorage olm = new OlmStorage(exceptionsCallback)) {
    if (olm.load(fileName)) {
        List<OlmFolder> folderHierarchy = olm.getFolders();
        extractItems(olm, folderHierarchy);
    }
}

private static void extractItems(OlmStorage olm, List<OlmFolder> folders) {
    for (OlmFolder folder : folders) {
        if (folder.hasMessages()) {
            System.out.println(folder);

            for (MapiMessage msg : olm.enumerateMessages(folder)) {
                System.out.println(msg.getSubject());
            }
        }

        if (folder.getSubFolders().size() > 0) {
            extractItems(olm, folder.getSubFolders());
        }
    }
}

Отримати дату модифікації повідомлення

The OlmMessageInfo.getModifiedDate властивість дозволяє отримати дату зміни повідомлення.

for (OlmMessageInfo messageInfo : inboxFolder.enumerateMessages()) {
    Date modifiedDate = messageInfo.getModifiedDate();
}