Documentation – Làm việc với các tệp lưu trữ Outlook

Java: Tạo PST mới, Thêm Thư mục Con và Tin nhắn

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

Cùng với việc phân tích một tệp PST hiện có, Aspose.Email cung cấp cách để tạo một tệp PST từ đầu. Bài viết này trình bày cách tạo tệp PST Outlook và thêm một thư mục con vào đó.

Sử dụng PersonalStorage lớp để tạo một tệp PST ở một vị trí nào đó trên đĩa cục bộ. Để tạo tệp PST từ đầu:

Tạo một PST bằng cách sử dụng PersonalStorage.create() phương thức.
Thêm một thư mục con ở gốc tệp PST bằng cách truy cập thư mục Root và sau đó gọi addSubFolder() phương thức.

Đoạn mã mẫu dưới đây cho bạn thấy cách tạo một tệp PST và thêm một thư mục con có tên Inbox.

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

Tạo PST với kích thước hơn 2GB bằng OutputStream

Người dùng Aspose.Email có thể tối ưu bộ nhớ cache nội bộ của PST bằng constructor PersonalStorage:

blockSize - Kích thước khối tối ưu để mở rộng bộ đệm cache (tính bằng byte).

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

Giảm kích thước tin nhắn và kích thước tệp PST được tạo

Aspose.Email cung cấp khả năng nén nội dung phần thân, giúp giảm kích thước tin nhắn. Điều này đặc biệt hữu ích khi gửi các tin nhắn lớn hoặc khi gặp hạn chế về băng thông hoặc dung lượng lưu trữ. Để thực hiện, thư viện cung cấp tham số nén bao gồm trong các phương thức sau:

MapiMessageItemBase.setBodyContent(String content, /BodyContentType/int contentType, boolean compression) - Đặt nội dung của phần thân.
MapiMessageItemBase.setBodyRtf(String content, boolean compression) - Lấy hoặc đặt văn bản tin nhắn định dạng RTF.

Đoạn mã dưới đây minh họa cách sử dụng nén RTF khi thiết lập phần thân tin nhắn 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);

Tạo PersonalStorage dựa trên Luồng SeekableByteChannel

Aspose.Email cho Java cho phép làm việc với các tệp Personal Storage (PST) bằng java.nio.channels. Nó cho phép bạn tạo một thể hiện PersonalStorage sử dụng luồng SeekableByteChannel. Đoạn mã mẫu dưới đây minh họa cách tạo một thể hiện PersonalStorage dựa trên luồng FileChannel, thêm một thư mục con tên "messageFolder" vào thư mục gốc, và nhập tin nhắn từ các tệp trong thư mục "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()));
        }
    }
}

Thay đổi Lớp Container của Thư mục

Đôi khi cần thay đổi lớp của một thư mục. Một ví dụ phổ biến là khi các tin nhắn loại khác nhau (cuộc hẹn, tin nhắn, v.v.) được thêm vào cùng một thư mục. Trong các trường hợp như vậy, lớp thư mục cần được thay đổi cho tất cả các phần tử trong thư mục để hiển thị đúng. Đoạn mã mẫu dưới đây cho bạn thấy cách thay đổi lớp container của một thư mục trong PST cho mục đích này.

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

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

Thêm Tin nhắn Hàng Loạt với Hiệu Suất Cải Thiện

Thêm các tin nhắn riêng lẻ vào PST đồng nghĩa với việc thực hiện nhiều thao tác I/O lên đĩa và có thể làm chậm hiệu suất. Để cải thiện hiệu suất, các tin nhắn có thể được thêm vào PST ở chế độ hàng loạt để giảm thiểu các thao tác I/O. addMessages(Iterable messages) phương thức cho phép bạn thêm tin nhắn hàng loạt và có thể được sử dụng trong các kịch bản sau. Ngoài ra, MessageAdded sự kiện xảy ra khi một tin nhắn được thêm vào thư mục.

Thêm Tin nhắn từ PST Khác

Để thêm tin nhắn từ một PST khác, sử dụng FolderInfo.enumerateMapiMessages() phương thức trả về 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());
    }
}

Thêm Tin nhắn từ Thư mục

Để thêm tin nhắn từ thư mục, tạo getMessages(String pathToDir) phương thức trả về 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: Đọc và Chuyển đổi Tệp Outlook OST

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

Aspose.Email cung cấp API để đọc các tệp OST của Microsoft Outlook. Bạn có thể tải tệp OST từ đĩa hoặc luồng vào một thể hiện của PersonalStorage lớp và lấy thông tin về nội dung của nó, chẳng hạn như thư mục, thư mục con và tin nhắn. Microsoft Outlook tạo tệp PST để lưu trữ email khi sử dụng máy chủ thư POP3 hoặc IMAP để tải tin nhắn. Nó tạo tệp OST khi máy chủ thư là Microsoft Exchange. OST hỗ trợ kích thước tệp lớn hơn so với tệp PST.

Đọc Tệp OST

Quá trình đọc tệp OST bằng Aspose.Email hoàn toàn giống với việc đọc tệp PST. Cùng một đoạn mã có thể đọc cả tệp PST và OST: chỉ cần cung cấp tên tệp đúng cho PersonalStorage.fromFile() phương thức. Đoạn mã sau đây cho bạn thấy cách đọc các tệp OST.

Chuyển đổi OST sang PST

Try it out!

Chuyển đổi email & lưu trữ tin nhắn trực tuyến với phiên bản miễn phí Ứng dụng Chuyển đổi Aspose.Email.

Aspose.Email cho phép chuyển đổi tệp OST sang PST chỉ bằng một dòng lệnh. Tương tự, tệp OST có thể được tạo từ tệp PST bằng cùng một dòng lệnh với FileFormat enumerator. Hiện tại, API hỗ trợ chuyển đổi định dạng OST sang PST ngoại trừ OST 2013/2016. Đoạn mã sau đây cho bạn thấy cách Chuyển đổi OST sang PST.

Để thực hiện các thao tác khác với tệp OST, vui lòng tham khảo các trang sau:

Chuyển đổi PST sang OST

Việc chuyển đổi từ PST sang OST không được Aspose.Email hỗ trợ vì OST luôn được Outlook tạo ra khi thêm tài khoản và đồng bộ với máy chủ thư. Sự khác nhau giữa tệp PST và OST là PST chỉ có sẵn cục bộ. Nội dung OST cũng có sẵn trên máy chủ email. Do đó không cần chuyển đổi PST sang OST cho việc sử dụng cục bộ. Tuy nhiên bạn có thể nhập PST vào tài khoản hiện có bằng trình hướng dẫn Nhập/Xuất trong Outlook.

Java: Làm việc với Tin nhắn trong tệp PST

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

Thêm Tin Nhắn vào Tệp PST

Tạo Tệp PST Mới và Thêm Thư Mục Con đã cho thấy cách tạo tệp PST và thêm một thư mục con vào đó. Với Aspose.Email bạn có thể thêm tin nhắn vào các thư mục con của tệp PST mà bạn đã tạo hoặc tải. Bài viết này thêm hai tin nhắn từ đĩa vào thư mục con Inbox của PST. Sử dụng PersonalStorage và FolderInfo các lớp để thêm tin nhắn vào tệp PST. Để thêm tin nhắn vào thư mục Inbox của tệp PST:

Tạo một thể hiện của lớp FolderInfo và tải nội dung của thư mục Inbox vào.
Thêm tin nhắn từ đĩa vào thư mục Inbox bằng cách gọi FolderInfo.addMessage() phương thức. Thuộc tính FolderInfo lớp này cung cấp addMessages phương thức cho phép thêm một số lượng lớn tin nhắn vào thư mục, giảm các thao tác I/O tới đĩa và cải thiện hiệu suất. Một ví dụ hoàn chỉnh có thể được tìm thấy bên dưới, trong Thêm Tin Nhắn Bulk.

Các đoạn mã dưới đây cho thấy cách thêm tin nhắn vào thư mục con PST có tên 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"));

Thêm Tin Nhắn Bulk

Thêm các tin nhắn riêng lẻ vào PST đồng nghĩa với nhiều thao tác I/O tới đĩa hơn và do đó có thể làm chậm hiệu suất. Để cải thiện hiệu suất, các tin nhắn có thể được thêm vào PST ở chế độ bulk để giảm thiểu các thao tác I/O. The addMessages(Iterable messages) phương thức cho phép bạn xác định một phạm vi tin nhắn để thêm vào PST nhằm cải thiện hiệu suất và có thể được sử dụng trong các kịch bản sau. Ngoài ra, sự kiện MessageAdded xảy ra khi một tin nhắn được thêm vào thư mục.

Tải Tin Nhắn Từ Đĩa

Đoạn mã dưới đây cho bạn thấy cách tải tin nhắn từ đĩa.

// 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 Implementation

Đoạn mã dưới đây cho bạn thấy cách tạo Iterable Implementation.

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

Thêm tin nhắn từ PST khác

Để thêm tin nhắn từ PST khác, sử dụng FolderInfo.enumerateMapiMessages() phương thức trả về Iterable. Đoạn mã dưới đây cho bạn thấy cách thêm tin nhắn từ PST khác.

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

Lấy thông tin tin nhắn từ tệp Outlook PST

Trong Đọc Tệp Outlook PST và Lấy Thông Tin Thư Mục và Thư Mục Con, chúng tôi đã thảo luận về việc tải tệp Outlook PST và duyệt các thư mục để lấy tên thư mục và số lượng tin nhắn trong chúng. Bài viết này giải thích cách đọc tất cả các thư mục và thư mục con trong tệp PST và hiển thị thông tin về các tin nhắn, ví dụ: tiêu đề, người gửi và người nhận. FolderInfo.getContents() phương thức được sử dụng để hiển thị thông tin tin nhắn ngắn gọn như tiêu đề, người gửi, người nhận. Về hiệu năng, đây là lựa chọn phù hợp nhất để lấy thông tin chính về các tin nhắn. Để trích xuất dữ liệu tin nhắn đầy đủ, PersonalStorage.extractMessage() phương thức được cung cấp. Tệp Outlook PST có thể chứa các thư mục lồng nhau. Để lấy thông tin tin nhắn từ chúng, cũng như các thư mục cấp cao nhất, hãy sử dụng phương pháp đệ quy để đọc tất cả các thư mục. Đoạn mã dưới đây cho bạn thấy cách đọc tệp Outlook PST và hiển thị nội dung thư mục và tin nhắn một cách đệ quy.

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

Trích xuất tin nhắn từ tệp PST

Bài viết này chỉ cách đọc các tệp Microsoft Outlook PST và trích xuất tin nhắn. Các tin nhắn sau đó được lưu vào đĩa ở định dạng MSG. Bài viết cũng chỉ cách trích xuất một số lượng tin nhắn cụ thể từ tệp PST. Sử dụng phương pháp đệ quy để duyệt tất cả các thư mục (gồm các thư mục lồng nhau) và gọi PersonalStorage.extractMessage() phương thức để lấy các tin nhắn Outlook vào một thể hiện của MapiMessage lớp. Sau đó, gọi MapiMessage.save() phương thức để lưu tin nhắn vào đĩa hoặc stream ở định dạng MSG. Đoạn mã dưới đây cho bạn thấy cách trích xuất tin nhắn từ tệp 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);
        }
    }
}

Lưu tin nhắn trực tiếp từ PST tới Stream

Để lưu tin nhắn từ tệp PST trực tiếp vào stream, mà không cần trích xuất MsgInfo cho các tin nhắn, hãy sử dụng saveMessageToStream() phương thức. Đoạn mã dưới đây cho bạn thấy cách lưu tin nhắn trực tiếp từ PST tới stream.

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

Trích xuất n số tin nhắn từ tệp PST

Đoạn mã dưới đây cho bạn thấy cách trích xuất một số lượng tin nhắn nhất định từ PST. Chỉ cần cung cấp chỉ mục cho tin nhắn đầu tiên và tổng số tin nhắn cần trích xuất.

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

Lấy tổng số mục từ tệp PST

Aspose.Email cung cấp GetTotalItemsCount() phương thức của PersonalStorage.Store thuộc tính. Nó trả về tổng số mục tin nhắn chứa trong PST.

Đoạn mã mẫu dưới đây cho thấy cách lấy tổng số lượng các mục (tin nhắn, cuộc hẹn, danh bạ, v.v.) được lưu trong tệp PST:

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

Xóa các mục khỏi tệp PST

Thêm tin nhắn vào tệp PST đã cho thấy cách thêm tin nhắn vào tệp PST. Tất nhiên, cũng có thể xóa các mục (nội dung) khỏi tệp PST và cũng có thể muốn xóa tin nhắn hàng loạt. Các mục từ tệp PST có thể được xóa bằng cách sử dụng FolderInfo.deleteChildItem() phương thức. API cũng cung cấp FolderInfo.deleteChildItems() phương thức để xóa các mục hàng loạt từ tệp PST.

Xóa tin nhắn khỏi tệp PST

Bài viết này cho biết cách sử dụng FolderInfo lớp để truy cập các thư mục cụ thể trong tệp PST. Để xóa tin nhắn từ thư mục Con Đã Gửi của tệp PST đã được tải trước hoặc đã tạo:

Tạo một đối tượng của FolderInfo lớp và tải nó với nội dung của thư mục con đã gửi.
Xóa tin nhắn từ thư mục Đã Gửi bằng cách gọi FolderInfo.deleteChildItem() phương thức và truyền MessageInfo.EntryId là một tham số. Đoạn mã dưới đây cho bạn thấy cách xóa tin nhắn từ thư mục Con Đã Gửi của tệp 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");
    }
}

Xóa thư mục khỏi tệp PST

Bạn có thể xóa thư mục PST bằng cách chuyển nó tới thư mục Đã Xóa.

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

Ưu điểm của phương pháp này là thư mục đã xóa có thể được khôi phục dễ dàng.

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

Bạn cũng có thể xóa vĩnh viễn một thư mục khỏi thư mục Đã Xóa, nếu cần.

deletedItemsFolder.deleteChildItem(emptyFolder.getEntryId());

Cái deleteChildItem() phương thức có thể được sử dụng cho bất kỳ thư mục nào nếu bạn muốn xóa ngay lập tức và vĩnh viễn thư mục con, bỏ qua thư mục Đã Xóa.

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

Xóa các mục hàng loạt từ tệp PST

API Aspose.Email có thể được sử dụng để xóa các mục hàng loạt từ tệp PST. Điều này được thực hiện bằng cách sử dụng deleteChildItems() phương thức nhận một danh sách các mục Entry ID đề cập đến các mục cần xóa. Đoạn mã dưới đây cho bạn thấy cách xóa các mục hàng loạt từ tệp 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);
}

Liệt kê và khôi phục các tin nhắn đã xóa mềm từ PST

Có thể truy xuất các tin nhắn đã xóa vĩnh viễn bằng Aspose.Email cho Java. API của nó cho phép liệt kê các tin nhắn đã xóa mềm trong tệp PST. Các mục đã xóa mềm là những tin nhắn bị xóa hai lần - đầu tiên được chuyển tới thư mục Đã Xóa và sau đó được xóa khỏi đó. Những tin nhắn này vẫn có thể khôi phục, và Aspose.Email cung cấp cách tiện lợi để truy cập chúng. PersonalStorage.findAndEnumerateSoftDeletedItems() phương thức trả về một tập hợp các RestoredItemEntry đối tượng. Mỗi mục nhập chứa:

MapiMessage mục — tin nhắn đã khôi phục.
String FolderId - định danh của thư mục mà tin nhắn ban đầu thuộc về.

Đoạn mã mẫu dưới đây minh họa cách liệt kê các mục email đã xóa mềm (có thể khôi phục) trong tệp 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("-----------------------------------");
    }
}

Tìm kiếm tin nhắn và thư mục trong PST theo tiêu chí

Các tệp Personal Storage (PST) có thể chứa một lượng dữ liệu khổng lồ và việc tìm kiếm dữ liệu đáp ứng một tiêu chí cụ thể trong các tệp lớn như vậy cần bao gồm nhiều điểm kiểm tra trong mã để lọc thông tin. Với PersonalStorageQueryBuilder lớp, Aspose.Email cho phép tìm kiếm các bản ghi cụ thể trong PST dựa trên tiêu chí tìm kiếm được chỉ định. Một PST có thể được tìm kiếm các tin nhắn dựa trên các tham số như người gửi, người nhận, tiêu đề, mức độ quan trọng, có tệp đính kèm, kích thước tin nhắn và thậm chí ID tin nhắn. PersonalStorageQueryBuilder cũng có thể được sử dụng để tìm các thư mục con.

Tìm kiếm tin nhắn và thư mục trong PST

Đoạn mã sau cho bạn thấy cách sử dụng PersonalStorageQueryBuilder lớp để tìm nội dung trong PST dựa trên các tiêu chí tìm kiếm khác nhau. Ví dụ, nó minh họa việc tìm kiếm PST dựa trên:

Mức độ quan trọng của tin nhắn.
Lớp tin nhắn.
Có tệp đính kèm.
Kích thước tin nhắn.
Ngày tin nhắn.
Tin chưa đọc.
Tin chưa đọc có tệp đính kèm, và
các thư mục có tên thư mục con cụ thể.

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

Tìm kiếm một chuỗi trong PST với tham số bỏ qua chữ hoa chữ thường

Đoạn mã dưới đây cho bạn thấy cách tìm kiếm một chuỗi trong PST với tham số bỏ qua chữ hoa chữ thường.

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

Tìm kiếm tiêu đề tin nhắn bằng nhiều từ khóa trong tệp PST

Bạn có thể sử dụng MailQueryBuilder.or phương thức để tìm các tin nhắn có tiêu đề chứa ít nhất một trong các từ được chỉ định như dưới đây:

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

Truy xuất có phân trang nội dung thư mục PST

Cải thiện hiệu năng ứng dụng và kiểm soát khi duyệt các thư mục lớn. Truy xuất nội dung thư mục theo cách phân trang bằng cách sử dụng overload của Aspose.Email cho getContents phương thức. Phương thức này - FolderInfo.getContents(MailQuery query, int startIndex, int count) - truy xuất một tập hợp con các tin nhắn khớp với truy vấn được chỉ định, bắt đầu từ chỉ mục cho trước và giới hạn bởi số lượng. Đoạn mã mẫu dưới đây minh họa việc truy xuất có phân trang và xử lý các tin nhắn đã lọc từ một thư mục 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());
        }
    }
}

Di chuyển các mục tới các thư mục khác của tệp PST

Aspose.Email cho phép di chuyển các mục từ thư mục nguồn sang một thư mục khác trong cùng tệp Personal Storage (PST). Điều này bao gồm:

Di chuyển một thư mục được chỉ định đến một thư mục cha mới.
Di chuyển một tin nhắn được chỉ định đến một thư mục mới.
Di chuyển nội dung đến một thư mục mới.
Di chuyển các thư mục con đến một thư mục cha mới.

Đoạn mã dưới đây cho bạn thấy cách di chuyển các mục như tin nhắn và thư mục từ thư mục nguồn sang một thư mục khác trong cùng tệp 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);
}

Cập nhật thuộc tính tin nhắn trong tệp PST

Đôi khi cần cập nhật một số thuộc tính của tin nhắn như thay đổi tiêu đề, đánh dấu tầm quan trọng tin nhắn và các thứ tương tự. Việc cập nhật tin nhắn trong tệp PST, với các thay đổi như vậy trong thuộc tính tin nhắn, có thể thực hiện bằng cách sử dụng FolderInfo.changeMessages phương thức. Bài viết này cho thấy cách cập nhật hàng loạt tin nhắn trong tệp PST cho các thay đổi thuộc tính. Đoạn mã mẫu dưới đây cho bạn thấy cách cập nhật thuộc tính của tin nhắn trong chế độ hàng loạt cho nhiều tin nhắn trong tệp 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);

Cập nhật Thuộc tính Tùy chỉnh trong tệp PST

Đôi khi cần đánh dấu các mục đã được xử lý trong tệp PST. API Aspose.Email cho phép thực hiện điều này bằng cách sử dụng MapiProperty và MapiNamedProperty. Các phương thức sau hữu ích cho việc này.

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

Trích xuất Tệp đính kèm mà không Trích xuất Toàn bộ Tin nhắn

API Aspose.Email có thể được sử dụng để trích xuất tệp đính kèm từ tin nhắn PST mà không cần trích xuất toàn bộ tin nhắn trước. Các ExtractAttachments phương thức của PersonalStorage có thể được sử dụng để thực hiện điều này. Đoạn mã mẫu dưới đây cho bạn thấy cách trích xuất tệp đính kèm mà không cần trích xuất toàn bộ tin nhắn.

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

Thêm Tệp vào PST

Chức năng chính của Microsoft Outlook là quản lý email, lịch, công việc, liên hệ và mục nhật ký. Ngoài ra, các tệp cũng có thể được thêm vào thư mục PST và PST kết quả sẽ ghi lại các tài liệu đã thêm. Aspose.Email cung cấp khả năng thêm tệp vào thư mục theo cách tương tự như việc thêm tin nhắn, liên hệ, công việc và mục nhật ký vào PST. Đoạn mã mẫu dưới đây cho bạn thấy cách thêm tài liệu vào thư mục PST bằng 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: Làm việc với Liên hệ trong Tệp PST

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

Đọc Nhiều Liên hệ ở Định dạng VCard

Đoạn mẫu mã dưới đây minh họa cách đọc tệp VCF, kiểm tra xem nó có chứa nhiều liên hệ không, và nếu có, tải các liên hệ từ tệp vào danh sách các đối tượng VCardContact. Mã sử dụng các phương thức sau:

isMultiContacts(InputStream stream) - Kiểm tra xem luồng nguồn có chứa đa liên hệ không.
loadAsMultiple(String filePath, Charset encoding) - Tải danh sách liên hệ từ tệp đa liên hệ.
loadAsMultiple(InputStream stream, Charset encoding) - Tải danh sách liên hệ từ luồng đa liên hệ.

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

Thêm Liên hệ vào PST

Tạo PST mới, Thêm Thư mục Con và Tin nhắn đã chỉ cách tạo tệp PST và thêm thư mục con vào nó. Với Aspose.Email bạn có thể thêm một MapiContact vào thư mục con Contacts của tệp PST mà bạn đã tạo hoặc tải. Dưới đây là các bước để thêm MapiContact vào một PST:

Tạo một MapiContact đối tượng.
Đặt MapiContact các thuộc tính bằng các constructor và phương thức khác nhau.
Tạo một PST bằng cách sử dụng PersonalStorage.create() phương thức.
Tạo một thư mục đã định trước (Contacts) tại gốc của tệp PST bằng cách truy cập thư mục gốc và sau đó gọi addMapiMessageItem() phương thức.

Đoạn mã dưới đây cho thấy cách tạo một MapiContact và sau đó thêm nó vào thư mục Contacts của tệp PST mới tạo.

Lưu thông tin liên hệ từ tệp PST ở Định dạng MSG

Bài viết này chỉ cách truy cập thông tin liên hệ từ tệp Microsoft Outlook PST và lưu các liên hệ vào đĩa ở định dạng MSG. Để làm điều này, sử dụng PersonalStorage và MapiContact các lớp để lấy và hiển thị thông tin liên hệ.

Để lấy thông tin của một liên hệ:

Tải tệp PST trong PersonalStorage lớp.
Duyệt thư mục Contacts.
Lấy nội dung của thư mục Contacts để có bộ sưu tập tin nhắn.
Lặp qua bộ sưu tập tin nhắn.
Gọi PersonalStorage.extractMessage() và sau đó toMapiMessageItem() phương thức để lấy thông tin liên hệ trong MapiContact lớp.
Sử dụng MapiContact các thuộc tính để truy cập thông tin liên hệ.
Gọi PersonalStorage.extractMessage() phương thức để lấy thông tin liên hệ trong MapiMessage lớp.
Gọi MapiMessage.save() phương thức để lưu liên hệ vào đĩa ở định dạng MSG.

Dưới đây là mã mẫu lấy tất cả thông tin liên hệ từ tệp PST và lưu chúng vào đĩa ở định dạng MSG.

Lưu Thông Tin Liên Hệ từ Outlook PST ra Đĩa ở định dạng vCard

Bài viết này cho thấy cách truy cập thông tin liên hệ từ tệp PST Microsoft Outlook và lưu liên hệ vào đĩa ở định dạng vCard (VCF). Nó sử dụng PersonalStorage và MapiContact các lớp để lấy thông tin liên hệ.

Dưới đây là các bước để lấy thông tin liên hệ:

Tải tệp PST trong PersonalStorage lớp.
Duyệt thư mục Contacts.
Lấy nội dung của thư mục Contacts để có bộ sưu tập tin nhắn.
Lặp qua bộ sưu tập tin nhắn.
Gọi PersonalStorage.extractMessage() phương thức để lấy thông tin liên hệ trong MapiContact lớp.
Sử dụng các thuộc tính của MapiContact lớp để truy cập thông tin liên hệ.

Chương trình dưới đây tải tệp PST từ đĩa và lưu tất cả các liên hệ ở định dạng vCard (VCF). Các tệp VCF sau đó có thể được sử dụng trong bất kỳ chương trình nào khác có thể tải tệp liên hệ vCard tiêu chuẩn. Nếu bạn mở bất kỳ tệp VCF nào trong Microsoft Outlook, nó sẽ giống như ảnh chụp màn hình dưới đây.

|| | :- | |Figure: A vCard saved with Aspose.Email|

Java: Làm việc với mục Lịch trong tệp PST

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

Thêm MapiCalendar vào PST

Tạo PST mới, Thêm Thư mục Con và Tin nhắn đã chỉ cách tạo tệp PST và thêm một thư mục con vào nó. Với Aspose.Email bạn có thể thêm MapiCalendar vào thư mục con Calendar của tệp PST mà bạn đã tạo hoặc tải.

Dưới đây là các bước để thêm MapiCalendar vào một PST:

Tạo một MapiCalendar đối tượng.
Đặt MapiCalendar các thuộc tính bằng một constructor và các phương thức.
Tạo một PST bằng cách sử dụng PersonalStorage.create() phương thức.
Tạo một thư mục được định nghĩa trước (Calendar) ở gốc tệp PST bằng cách truy cập thư mục gốc và sau đó gọi addMapiMessageItem() phương thức.

Đoạn mã dưới đây cho thấy cách tạo một MapiCalendar và sau đó thêm nó vào thư mục Calendar của tệp PST mới tạo.

Lưu các mục lịch từ Outlook PST vào Đĩa ở định dạng ICS

Bài viết này cho thấy cách truy cập các mục lịch từ tệp Outlook PST và lưu lịch vào đĩa ở định dạng ICS. Nó sử dụng PersonalStorage và MapiCalendar các lớp để lấy thông tin lịch.

Dưới đây là các bước để lưu các mục lịch:

Tải tệp PST trong PersonalStorage lớp.
Duyệt thư mục Calendar.
Lấy nội dung của thư mục Calendar để có bộ sưu tập tin nhắn.
Lặp qua bộ sưu tập tin nhắn.
Gọi PersonalStorage.extractMessage() phương thức để lấy thông tin liên hệ trong MapiCalendar lớp.
Gọi MapiCalendar.save() phương thức để lưu mục lịch vào đĩa ở định dạng ICS.

Chương trình dưới đây tải một tệp PST từ đĩa và lưu tất cả các mục lịch ở định dạng ICS. Các tệp ICS sau đó có thể được sử dụng trong bất kỳ chương trình nào khác có thể tải tệp lịch chuẩn ICS. Nếu bạn mở bất kỳ tệp ICS nào trong Microsoft Outlook, nó sẽ trông giống như ảnh chụp màn hình bên dưới.

|| | :- | |Figure: Calendar item saved with Aspose.Email|

Trích xuất các mục lịch từ tệp PST

Lớp MapiCalendar đại diện cho một mục lịch trong định dạng MAPI của Microsoft Outlook. Trích xuất một tin nhắn từ tệp PST và chuyển đổi nó thành một mục tin nhắn MAPI. Đoạn mã mẫu sau trích xuất một mục lịch từ tệp PST và chuyển đổi nó thành đối tượng MapiCalendar để thao tác hoặc xử lý tiếp theo:

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

Lưu các mục lịch ở định dạng ICS với Dấu thời gian Gốc

Sử dụng đoạn mã mẫu ở trên để trích xuất một mục lịch từ tệp PST và sau đó chỉ định các tùy chọn bổ sung để lưu nó dưới dạng ICS với dấu thời gian gốc bằng cách sử dụng setKeepOriginalDateTimeStamp phương thức của MapiCalendarIcsSaveOptions lớp:

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

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

Chỉnh sửa/Xóa các lần xuất hiện từ các chuỗi lặp

Java: Làm việc với MapiTask trong PST

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

Thêm MapiTask vào PST

Tạo PST mới, Thêm Thư mục Con và Tin nhắn đã chỉ cách tạo tệp PST và thêm một thư mục con vào nó. Với Aspose.Email bạn có thể thêm MapiTask vào thư mục con Tasks của tệp PST mà bạn đã tạo hoặc tải.

Dưới đây là các bước để thêm MapiTask vào PST:

Tạo một MapiTask đối tượng.
Đặt MapiTask các thuộc tính bằng hàm khởi tạo và các phương thức khác nhau.
Tạo một PST bằng cách sử dụng PersonalStorage.create() phương thức.
Tạo một thư mục được định nghĩa trước (Tasks) ở gốc tệp PST bằng cách truy cập thư mục Root và sau đó gọi addMapiMessageItem() phương thức.

Đoạn mã dưới đây cho thấy cách tạo một MapiTask và sau đó thêm nó vào thư mục Tasks của tệp PST mới tạo.

Java: Làm việc với MapiJournal trong PST

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

Thêm MapiJournal vào PST

Tạo PST mới, Thêm Thư mục Con và Tin nhắn đã cho thấy cách tạo tệp PST và thêm một thư mục con vào đó. Với Aspose.Email, bạn có thể thêm MapiJournal vào thư mục con Journal của tệp PST mà bạn đã tạo hoặc tải. Dưới đây là các bước để thêm MapiJournal vào PST:

Tạo một MapiJournal đối tượng.
Đặt MapiJournal các thuộc tính bằng một constructor và các phương thức.
Tạo một PST bằng cách sử dụng PersonalStorage.create() phương thức.
Tạo một thư mục được định trước (Journals) ở gốc của tệp PST bằng cách truy cập thư mục gốc và sau đó gọi addMapiMessageItem() phương thức.

Đoạn mã dưới đây cho thấy cách tạo một MapiJournal và sau đó thêm nó vào thư mục Journal của tệp PST mới tạo.

Thêm Tệp Đính Kèm vào MapiJournal

Cũng có thể thêm tệp đính kèm vào các mục nhật ký MAPI. Đoạn mã dưới đây cho thấy cách thực hiện.

Java: Làm việc với MapiNote trong PST

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

Thêm MapiNote vào PST

Tạo PST mới, Thêm Thư mục Con và Tin nhắn đã chỉ cách tạo tệp PST và thêm một thư mục con vào nó. Với Aspose.Email bạn có thể thêm một MapiNote vào thư mục con Notes của tệp PST mà bạn đã tạo hoặc tải.

Dưới đây là các bước để thêm MapiNote vào PST:

Tạo một mẫu MapiNote bằng Microsoft Outlook và lưu nó dưới dạng tệp MSG.
Tải ghi chú MSG đã lưu vào MapiMessage đối tượng.
Tạo một MapiNote đối tượng và tải mẫu ghi chú MSG.
Đặt MapiNote các thuộc tính bằng các phương thức khác nhau.
Tạo một PST bằng cách sử dụng PersonalStorage.create() phương thức.
Tạo một thư mục được định nghĩa trước (Notes) ở gốc tệp PST bằng cách truy cập thư mục gốc và sau đó gọi addMapiMessageItem() phương thức.

Đoạn mã dưới đây cho thấy cách tạo một MapiNote và sau đó thêm nó vào thư mục Notes của tệp PST mới tạo.

Java: Chia và Gộp Các Tệp PST

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

API Aspose.Email cung cấp khả năng chia một tệp PST duy nhất thành nhiều tệp PST với kích thước mong muốn. Nó cũng có thể gộp nhiều tệp PST thành một tệp PST duy nhất. Cả các thao tác chia và gộp PST đều có thể được theo dõi bằng cách thêm các sự kiện vào các thao tác này.

Chia và Gộp Các Tệp PST

Các mẫu mã dưới đây minh họa cách chia một tệp PST lớn thành nhiều phần nhỏ của các tệp PST.

Gộp Nhiều PST thành Một PST

Mẫu mã dưới đây cho thấy cách nhiều PST có thể được gộp thành một tệp PST lớn duy nhất.

Try it out!

Gộp và kết hợp nhiều tệp email thành một tệp duy nhất với phiên bản miễn phí Aspose.Email Merger App.

Gộp Thư mục từ PST khác

API Aspose.Email cho phép gộp toàn bộ thư mục từ một PST khác vào PST đích, do đó tạo ra một PST có kích thước lớn.

Chia PST dựa trên Tiêu chí Được Định nghĩa

Các Phương thức Hỗ trợ

Java: Làm việc với Thuộc tính Bảo vệ Mật khẩu PST

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

Microsoft Outlook cho phép người dùng bảo vệ mật khẩu cho tệp PST để hạn chế truy cập. Aspose.Email có thể phát hiện bảo vệ mật khẩu trên tệp PST. Bài viết này hướng dẫn cách kiểm tra tệp PST có mật khẩu không và cách kiểm tra mật khẩu đã áp dụng là đúng hay không.

Kiểm tra bảo vệ bằng mật khẩu

Cái MapiPropertyTag.PR_PST_PASSWORD giá trị từ MapiPropertyTag lớp được sử dụng để kiểm tra xem tệp có được bảo vệ bằng mật khẩu hay không.

Hàm băm CRC-32 của chuỗi mật khẩu được lưu trong thuộc tính PidTagPstPassword (tag = 0x67ff0003) trong MessageStore. Nếu thuộc tính này tồn tại và không bằng 0, thì PST được bảo vệ bằng mật khẩu.

Đoạn mã sau đây cho thấy cách kiểm tra tệp PST có được bảo vệ bằng mật khẩu không và chuỗi đã cho có phải là mật khẩu hợp lệ cho PST đó không.

Đoạn mã dưới đây hiển thị hai hàm, hàm đầu tiên kiểm tra xem PST có được bảo vệ bằng mật khẩu không, và hàm thứ hai cho biết cách kiểm tra mật khẩu cung cấp có đúng hay không.

Xóa/Đặt lại Thuộc tính PR_PST_PASSWORD

Xóa bỏ của PR_PST_PASSWORD thuộc tính không thể đạt được vì các thuộc tính khác đã bị gỡ bỏ khỏi kho tin nhắn. Thay vào đó, chúng ta cần đặt giá trị của nó thành zero (0) để xóa bỏ. Thuộc tính "Store" của lớp PST cho phép truy cập các thuộc tính lưu trữ của PST thay vì MessageStoreProperties của PST trong trường hợp này.

Đặt/Thay đổi Mật khẩu PST

Đoạn mã sau đây cho bạn thấy cách đặt mật khẩu cho các tệp PST.

Xác minh Mật khẩu cho Các Tệp PST Bảo vệ Bằng Mật khẩu

Aspose.Email cho phép các nhà phát triển kiểm tra xem tệp PST có được bảo vệ bằng mật khẩu hay không và kiểm tra mật khẩu đã cho có đúng hay không. Đối với việc này, API cung cấp PersonalStorage.Store.IsPasswordProtected thuộc tính và PersonalStorage.Store.IsPasswordValid() phương thức. Thuộc tính PersonalStorage.Store.IsPasswordProtected thuộc tính trả về true nếu tệp PST được bảo vệ bằng mật khẩu và false nếu không. Thuộc tính PersonalStorage.Store.IsPasswordValid() phương thức nhận chuỗi mật khẩu làm tham số và trả về true nếu mật khẩu đúng và false nếu không đúng.

Đoạn mã sau đây minh họa việc sử dụng PersonalStorage.Store.IsPasswordProtected thuộc tính và PersonalStorage.Store.IsPasswordValid() phương thức.

Mã mẫu

Đầu ra Console

Lưu trữ được bảo vệ bằng mật khẩu - True Mật khẩu hợp lệ - True

Java: Đọc Tệp Outlook PST và Lấy Thông Tin Thư Mục và Thư Mục Con

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

Aspose.Email cho Java cho phép bạn đọc các tệp PST của Microsoft Outlook. Bạn có thể tải tệp PST từ đĩa hoặc stream vào một thể hiện của PersonalStorage lớp và lấy thông tin về nội dung của nó, ví dụ: các thư mục, thư mục con và tin nhắn.

Tải tệp PST

Một tệp Outlook PST có thể được tải vào một thể hiện của PersonalStorage lớp. Một đoạn mã mẫu để tải tệp PST được đưa ra dưới đây:

Hiển thị Thông tin Thư mục

Sau khi tải tệp PST vào PersonalStorage lớp, bạn có thể lấy thông tin về tên hiển thị của tệp, thư mục gốc, thư mục con và số lượng tin nhắn. Đoạn mã mẫu sau hiển thị tên của tệp PST, các thư mục và số lượng tin nhắn trong các thư mục:

Chỉ lấy các thư mục do người dùng định nghĩa

Các tệp PST/OST có thể chứa các thư mục được người dùng tạo. Aspose.Email cung cấp khả năng truy cập chỉ các thư mục do người dùng định nghĩa bằng cách sử dụng PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser thuộc tính. Bạn có thể đặt PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser thuộc tính thành true để chỉ lấy các thư mục do người dùng tạo. Đoạn mã mẫu dưới đây minh họa việc sử dụng PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser để lấy các thư mục do người dùng định nghĩa.

Kiểm tra xem thư mục có nằm trong một thư mục được định trước không

Khi mở và kiểm tra các thư mục trong tệp PST (Personal Storage Table), bạn có thể kiểm tra xem mỗi thư mục có phải là loại thư mục được định trước hay là thư mục con của loại thư mục được định trước, và lấy thông tin về mỗi thư mục.

Cái FolderInfo.getPredefinedType(boolean getForTopLevelParent) phương thức được sử dụng để kiểm tra xem thư mục có phải từ StandardIpmFolder.

Nếu tham số ‘getForTopLevelParent’ là true, phương thức trả về một giá trị enum StandardIpmFolder cho thư mục cấp cao nhất. Điều này xác định liệu thư mục hiện tại có phải là thư mục con của một thư mục được định trước hay không. Nếu tham số ‘getForTopLevelParent’ là false, nó trả về một giá trị enum StandardIpmFolder cho thư mục hiện tại.

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

Lấy hoặc Thêm thư mục RSS Feeds chuẩn trong tệp PST

Aspose.Email cho phép truy xuất tham chiếu tới thư mục được định trước chứa RSS feeds. Điều này có thể hữu ích nếu bạn muốn truy cập và thao tác các RSS feeds được lưu trong tệp Outlook PST một cách lập trình. Gán giá trị của RssFeeds cho StandardIpmFolder enum.

Ví dụ mã dưới đây cho thấy cách lấy một thư mục RSS Feeds:

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

Và đoạn mã mẫu dưới đây minh họa cách thêm một thư mục RSS Feeds:

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

Phân tích Thư mục có thể Tìm kiếm

Một PST/OST có thể chứa các thư mục có thể tìm kiếm ngoài các loại thư mục thông thường. Aspose.Email cung cấp FolderKind bộ liệt kê để chỉ định các tin nhắn từ các thư mục tìm kiếm như vậy với EnumerateFolders và GetSubFolders các phương thức.

Truy xuất Thông tin Thư mục Cha từ MessageInfo

Đoạn mã mẫu sau cho bạn thấy cách truy xuất thông tin thư mục cha từ MessageInfo.

API duyệt tệp PST

API duyệt cho phép trích xuất tất cả các mục PST càng nhiều càng tốt, mà không ném ra ngoại lệ, ngay cả khi một số dữ liệu của tệp gốc bị hỏng. Các bước sau cho thấy cách sử dụng API này.

Sử dụng PersonalStorage constructor và load phương thức thay vì phương thức fromFile.

Constructor cho phép định nghĩa một phương thức callback.

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

Các ngoại lệ khi tải và duyệt sẽ được cung cấp thông qua phương thức callback.

Cái load phương thức trả về ’true’ nếu tệp đã được tải thành công và có thể tiếp tục duyệt. Nếu tệp bị hỏng và không thể duyệt, sẽ trả về ‘false’.

if (currentPst.load(inputStream))

Điều này cho phép mở và duyệt ngay cả các tệp PST bị hỏng mà không ném ra ngoại lệ. Cả ngoại lệ và các mục bị hỏng sẽ được xử lý bởi phương thức callback.

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: Đọc tệp PST/OST bị hỏng

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

Đọc tệp PST/OST bị hỏng

Đôi khi việc đọc PST/OST có thể không khả thi do một số vấn đề. Ví dụ, một số khối dữ liệu có thể bị hỏng. Trong những trường hợp như vậy, ngoại lệ thường xảy ra khi gọi EnumerateFolders, EnumerateMessages, GetContents, GetSubfolders, v.v. các phương thức. Tuy nhiên, các tin nhắn hoặc thư mục riêng lẻ có thể vẫn không bị hỏng trong kho lưu trữ.

Người dùng Aspose.Email có thể tìm các định danh mục theo chiều phân cấp. Tiếp theo, bạn có thể trích xuất các mục bằng định danh. Để đạt mục đích này, thư viện cung cấp các phương thức sau:

PersonalStorage.findMessages(String parentEntryId) - tìm các định danh của tin nhắn cho thư mục.
PersonalStorage.findSubfolders(String parentEntryId) - tìm các định danh của thư mục con cho thư mục.

Lưu ý, rằng dù có những ưu điểm, vẫn có các kho lưu trữ bị hỏng không thể đọc được ngay cả khi sử dụng các phương thức này.

Đoạn mã dưới đây minh họa cách sử dụng các phương thức này để đọc các tệp PST/OST bị hỏng:

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

Trích xuất mục PST từ các tệp bị hỏng

API duyệt cho phép trích xuất càng nhiều mục PST càng tốt, mà không ném ra ngoại lệ, ngay cả khi một số dữ liệu của tệp gốc bị hỏng.

Sử dụng PersonalStorage(TraversalExceptionsCallback callback) hàm khởi tạo và load(String fileName) phương thức thay vì fromFile phương thức.

Constructor cho phép định nghĩa một phương thức callback.

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

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

Các ngoại lệ khi tải và duyệt sẽ được cung cấp thông qua phương thức callback.

Phương thức load trả về ’true’ nếu tệp đã được tải thành công và có thể tiếp tục duyệt. Nếu tệp bị hỏng và không thể duyệt, sẽ trả về ‘false’.

if (currentPst.load(inputStream))

Đoạn mã mẫu sau cho thấy cách triển khai API duyệt tệp PST vào một dự án:

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: Thêm MapiDistributionList vào PST

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

Tạo PST mới, Thêm Thư mục Con và Tin nhắn đã chỉ cách tạo tệp PST và thêm thư mục con vào nó. Với Aspose.Email bạn có thể thêm một MapiDistributionList vào thư mục con Contacts của tệp PST mà bạn đã tạo hoặc tải.

Để thiết lập EntryId cho một MapiDistributionListMember, chuỗi base64 cần được chuyển đổi bằng cách sử dụng Apache Commons Codec.

Tải MapiDistributionList từ tệp

Mã dưới đây tải một danh sách phân phối MAPI từ tệp.

Tạo MapiDistributionList mới và thêm nó vào thư mục con Contacts

Dưới đây là các bước để thêm một MapiDistributionList vào một PST:

Tạo một PST mới.
Thêm thư mục Contacts vào PST.
Tạo các liên hệ mẫu.
Tạo danh sách phân phối dựa trên các liên hệ đã tạo.
Thêm danh sách phân phối vào PST.

Đoạn mã dưới đây cho thấy cách tạo một MapiDistributionList và sau đó thêm nó vào thư mục Contacts của tệp PST mới tạo.

Tạo danh sách phân phối một lần

Đối với danh sách phân phối này, không cần các liên hệ riêng biệt.

Java: Đọc Tệp OLM của Outlook cho Mac và Lấy Thông Tin Thư Mục và Thư Mục Con

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

Aspose.Email cho Java cho phép bạn đọc các tệp OLM của Outlook cho Mac. Bạn có thể tải tệp OLM từ đĩa vào một thể hiện của OlmStorage lớp và lấy thông tin về nội dung của nó, ví dụ: các thư mục, thư mục con và tin nhắn.

Mở tệp định dạng OLM

Các tệp định dạng OLM có thể được mở theo hai cách:

sử dụng hàm khởi tạo
sử dụng phương thức tĩnh FromFile

Có sự khác nhau về hành vi giữa các phương thức này. Xem phần bên dưới.

Mở tệp bằng hàm khởi tạo

Để mở tệp, gọi hàm khởi tạo của OlmStorage lớp và truyền tên tệp đầy đủ hoặc stream làm đối số cho nó:

OlmStorage olm = new OlmStorage("fileName");

Mở tệp bằng phương thức tĩnh FromFile

Để mở tệp, sử dụng phương thức tĩnh fromFile và truyền tên tệp đầy đủ làm đối số cho nó:

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

Mở tệp bằng phương thức tĩnh FromStream

Để mở tệp bằng phương thức tĩnh fromStream, truyền tên stream làm đối số cho nó:

Đọc tệp OLM

Đoạn mã dưới đây cho bạn thấy cách tải tệp OLM và lấy nội dung của nó.

Lấy thư mục

Để lấy các thư mục từ tệp OLM (Outlook for Mac), tải nó bằng OlmStorage đầu tiên lớp, sau đó sử dụng một trong các phương thức sau tùy theo nhu cầu của bạn:

getFolder(String name, boolean ignoreCase) - Lấy thư mục theo tên.
getFolders() - Lấy cấu trúc thư mục/collection các thư mục.
getFolderHierarchy() - Lấy cấu trúc thư mục.

Đoạn mã mẫu dưới đây sẽ cho bạn thấy cách lấy thư mục từ tệp OLM:

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

try {

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

} finally {

    olm.dispose();

}

Khi sử dụng fromFile phương thức để mở tệp OLM, getFolderHierarchy() sẽ trả về null. Trong trường hợp này, gọi getFolders() phương thức một cách rõ ràng để truy xuất danh sách các thư mục trong tệp OLM.

Lấy Đường Dẫn Thư Mục

Bạn cũng có thể lấy đường dẫn thư mục của các thư mục trong tệp OML. Aspose.Email cung cấp OlmFolder.Path thuộc tính trả về đường dẫn thư mục. Đoạn mã dưới đây minh họa việc sử dụng OlmFolder.Path thuộc tính để lấy đường dẫn thư mục trong tệp OML.

Đếm số lượng mục trong thư mục

Bạn cũng có thể đếm số lượng mục trong thư mục. Aspose.Email cung cấp OlmFolder.MessageCount thuộc tính trả về số lượng mục trong thư mục. Đoạn mã dưới đây minh họa việc sử dụng OlmFolder.MessageCount thuộc tính để lấy số lượng mục trong các thư mục của tệp OML.

Liệt kê tin nhắn từ một thư mục cho trước

Aspose.Email cung cấp API để làm việc với lưu trữ OLM và trích xuất tin nhắn từ một thư mục cho trước. The OlmFolder và OlmMessageInfo các lớp đại diện cho thông tin ngắn gọn về một thư mục và một tin nhắn trong lưu trữ tương ứng. The OlmFolder lớp cung cấp các phương thức sau:

OlmFolder.getSubFolder(String subfolderName, boolean ignoreCase) - Lấy thư mục con theo tên.
OlmFolder.enumerateMapiMessages() - Tiết lộ bộ liệt kê, hỗ trợ duyệt MapiMessages trong thư mục hiện tại.
OlmFolder.enumerateMessages() - Tiết lộ bộ liệt kê, hỗ trợ duyệt OlmMessageInfo trong thư mục hiện tại.
OlmFolder.enumerateMessages(int startIndex, int count) - Tiết lộ bộ liệt kê, hỗ trợ duyệt OlmMessageInfo trong một khoảng cho trước.
OlmFolder.enumerateMessages(MailQuery query) - Tiết lộ bộ liệt kê, hỗ trợ duyệt OlmMessageInfo theo tiêu chí tìm kiếm.

Các đoạn mã dưới đây sẽ minh họa việc sử dụng các phương thức này:

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

}

Trích xuất tin nhắn từ OLM bằng định danh

Đôi khi cần trích xuất các tin nhắn đã chọn bằng định danh. Ví dụ, ứng dụng của bạn lưu các định danh trong cơ sở dữ liệu và trích xuất tin nhắn khi cần. Đây là cách hiệu quả để tránh duyệt toàn bộ lưu trữ mỗi lần để tìm một tin nhắn cụ thể cần trích xuất. Để thực hiện tính năng này cho tệp OLM, Aspose.Email cung cấp các phương thức và lớp sau:

EntryId thuộc tính của OlmMessageInfo lớp - Lấy định danh mục nhập tin nhắn.
overloaded extractMapiMessage(String id) phương thức của OlmStorage lớp - Lấy tin nhắn từ OLM.

Đoạn mã mẫu dưới đây minh họa cách trích xuất tin nhắn từ OLM bằng định danh:

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

Lưu ý: ID tin nhắn là duy nhất trong tệp lưu trữ. ID được tạo bởi Aspose.Email và không thể sử dụng trong các thư viện hoặc ứng dụng xử lý OLM của bên thứ ba.

Trích xuất mục OLM từ tệp bị hỏng

Aspose.Email cung cấp một API duyệt mà cho phép trích xuất tất cả các mục OLM càng nhiều càng tốt, mà không ném ngoại lệ, ngay cả khi một số dữ liệu của tệp gốc bị hỏng.

Sử dụng OlmStorage(TraversalExceptionsCallback callback) hàm khởi tạo và load(String fileName) phương thức thay vì fromFile phương thức.

Constructor cho phép định nghĩa một phương thức callback.

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

Các ngoại lệ khi tải và duyệt sẽ được cung cấp thông qua phương thức callback.

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

Lấy Ngày Chỉnh Sửa Tin Nhắn

Cái OlmMessageInfo.getModifiedDate thuộc tính cho phép bạn lấy ngày chỉnh sửa tin nhắn.

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

Java: Làm việc với các tệp PST lớn

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

Xử lý các tệp Personal Storage Table (PST) lớn có thể làm giảm hiệu suất và tăng mức sử dụng bộ nhớ. Aspose.Email cho Java cung cấp nhiều kỹ thuật và API cho phép các nhà phát triển truy cập, xử lý và quản lý dữ liệu hộp thư một cách hiệu quả mà không gây tải quá mức cho tài nguyên hệ thống.

Sử dụng Các Phương pháp Iterable để Duyệt Thư mục và Tin nhắn

Khi lặp qua các thư mục và tin nhắn, nên ưu tiên các phương pháp trả về Iterable. Điều này giảm tải bộ nhớ và cải thiện hiệu suất.

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

Sử dụng MessageInfo cho các Thuộc tính Tin nhắn Cơ bản

Nếu bạn chỉ cần chi tiết tin nhắn cơ bản, hãy sử dụng MessageInfo thay vì tải toàn bộ tin nhắn. Cách này nhanh hơn và tiêu tốn ít bộ nhớ hơn.

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

Tránh Trích xuất Toàn bộ Tin nhắn trừ khi cần thiết

Không sử dụng ExtractMessage hoặc EnumerateMapiMessages phương pháp cho tất cả tin nhắn trừ khi bạn cần mọi thuộc tính.

Thay vào đó, hãy xem xét:

a) Lấy ID Tin nhắn

Sử dụng enumerateMessagesEntryId để lấy tất cả ID tin nhắn trong một thư mục. Sau đó bạn có thể trích xuất chọn lọc các thuộc tính, tin nhắn hoặc đính kèm.

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) Trích xuất một Thuộc tính Đơn

Sử dụng ExtractProperty nếu bạn chỉ cần một thuộc tính cụ thể còn thiếu trong 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) Chỉ Trích xuất Đính kèm

Nếu chỉ cần tệp đính kèm, hãy sử dụng ExtractAttachments.

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

Sử dụng Tiêu chí Tìm kiếm để Lọc Tin nhắn

Lọc tin nhắn bằng cách sử dụng tiêu chí tìm kiếm giảm số lượng tin nhắn được tải và cải thiện hiệu suất.

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

Lưu Tin nhắn vào Stream

Thay vì trích xuất và lưu từng tin nhắn một, hãy sử dụng SaveMessageToStream để hiệu suất tốt hơn.

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

Sử dụng phương pháp Bulk khi có thể

Khi nào bạn cần thêm hoặc xóa nhiều mục, ưu tiên các phương pháp bulk hơn các thao tác riêng lẻ. Điều này giảm tải và cải thiện hiệu suất.