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 с размер над 2Gb, използвайки 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 изисква повече I/O операции към диска и може да забави производителността. За подобрена производителност, съобщенията могат да се добавят в PST в масов режим, за да се минимизират I/O операциите. 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

Try it out!

Конвертирайте имейли и архиви от съобщения онлайн с безплатното Приложение за конвертиране на 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() метод. The FolderInfo класът излага addMessages метод, който позволява да се добави голям брой съобщения към папката, намалявайки I/O операциите към диска и подобрявайки производителността. Пълен пример може да бъде намерен по-долу, в Масово добавяне на съобщения.

Кодовият фрагмент по-долу показва как да добавите съобщения към подпапка в 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 води до повече I/O операции към диска и следователно може да забави производителността. За подобрена производителност съобщенията могат да се добавят към PST в режим на масово добавяне, за да се минимизират I/O операциите. 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

Следният кодов фрагмент показва как да създадете имплементация на 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 файл. За изтриване на съобщения от подпапката „Изпратени“ на предварително зареден или създаден PST файл:

Създайте инстанция на FolderInfo клас и го заредете със съдържанието на подпапката „Изпратени“.
Изтрийте съобщения от папка „Изпратени“ като извикате FolderInfo.deleteChildItem() метод и предаване на MessageInfo.EntryId като параметър. Следният кодов откъс показва как да изтриете съобщения от подпапка „Изпратени“ на 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());

Този 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 по критерий

Файловете за лично съхранение (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 позволява преместване на елементи от изходна папка към друга папка в същия файл за лично съхранение (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 файла. Aspose.Email API позволява това чрез 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) - променя всички съобщения в папката
PersonalStorage.changeMessage(String entryId, MapiPropertyCollection updatedProperties) - променя свойства на съобщението

// 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;
}

Извличане на прикрепени файлове без извличане на цялото съобщение

Aspose.Email API може да се използва за извличане на прикрепени файлове от 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 файлове.

Обединяване на множество PST файлове в един PST

Следният примерен код показва как множество PST файлове могат да се обединят в един голям PST файл.

Try it out!

Обединете и комбинирайте множество имейл файлове в един единствен с безплатния 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 файл е защитен с парола и също как да проверите дали поставената парола е правилна.

Проверка за паролна защита

Този 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() метод. The PersonalStorage.Store.IsPasswordProtected свойството връща true, ако PST файлът е защитен с парола и false, ако не е. The 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) файл, можете да проверите дали всяка папка е от предварително дефиниран тип или е подпапка на такъв тип, и да получите информация за всяка папка.

Този FolderInfo.getPredefinedType(boolean getForTopLevelParent) метод се използва за проверка дали папката е от StandardIpmFolder.

Ако параметърът ‘getForTopLevelParent’ е true, методът връща стойност от тип StandardIpmFolder enum за родителската папка от най-горно ниво. Това определя дали текущата папка е подпапка на предварително дефинирана папка. Ако параметърът ‘getForTopLevelParent’ е false, той връща стойност от тип StandardIpmFolder enum за текущата папка.

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 enum.

Следният примерен код показва как да се получи папка за 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.
    }
})) {
    //
}

Изключения при зареждане и обхождане ще бъдат достъпни чрез метода за обратен извикване.

Този зареждане методът връща ’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 дистрибуционен списък от файл.

Създаване на нов MapiDistributionList и добавянето му към подпапката Contacts

По-долу са стъпките за добавяне на MapiDistributionList към PST:

Създайте нов PST.
Добавете папката Contacts към PST.
Създайте примерни контакти.
Създайте дистрибуционен списък на базата на създадените контакти.
Добавете дистрибуционния списък към PST.

Следният кодов отрязък показва как да създадете MapiDistributionList и след това го добавете в папката Contacts на ново създадения PST файл.

Създаване на еднократен дистрибуционен списък

За този дистрибуционен списък не са необходими отделни контакти.

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 за 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());
        }
    }
}

Получете датата на модификация на съобщението

Този OlmMessageInfo.getModifiedDate свойство, което ви позволява да получите датата на модификация на съобщението.

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

Java: Работа с големи PST файлове

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

Обработката на големи файлове Personal Storage Table (PST) може да намали производителността и да увеличи използването на памет. Aspose.Email за 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) Извличане на ID‑та на съобщения

Използвайте enumerateMessagesEntryId за да получите всички ID‑та на съобщения в папка. Тогава можете избирателно да извлечете свойства, съобщения или прикачени файлове.

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

Използвайте масови методи, когато е възможно

Всеки път, когато трябва да добави или изтриване множество елементи, предпочитайте масови методи вместо индивидуални операции. Това намалява натоварването и подобрява производителността.