Чтение повреждённых файлов PST/OST

Чтение повреждённых 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);
    }
}