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 โดยเข้าถึงโฟลเดอร์ Root แล้วเรียก 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 for 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

ลองใช้ดู!

แปลงอีเมลและคลังข้อความออนไลน์ด้วยเวอร์ชันฟรี แอปแปลง Aspose.Email.

Aspose.Email ทำให้สามารถแปลงไฟล์ OST เป็น PST ด้วยบรรทัดโค้ดเดียวได้เช่นเดียวกัน, ไฟล์ OST สามารถสร้างจากไฟล์ PST โดยใช้บรรทัดโค้ดเดียวกันกับ รูปแบบไฟล์ enumerator. ปัจจุบัน API รองรับการแปลงรูปแบบ OST เป็น PST ยกเว้น OST 2013/2016 ตัวอย่างโค้ดต่อไปนี้แสดงให้คุณเห็นวิธีแปลง OST เป็น PST.

สำหรับการทำงานอื่นกับไฟล์ OST โปรดดูหน้านี้ต่อไปนี้:

การแปลง PST เป็น OST

การแปลงจาก PST เป็น OST ไม่ได้รับการสนับสนุนโดย Aspose.Email เนื่องจาก OST จะถูกสร้างโดย Outlook เสมอเมือเพิ่มบัญชีและซิงค์กับเซิร์ฟเวอร์เมล ความแตกต่างระหว่างไฟล์ PST และ OST คือ PST มีอยู่เฉพาะในเครื่องเท่านั้น ส่วนเนื้อหา OST มีอยู่บนเซิร์ฟเวอร์อีเมล ดังนั้นจึงไม่จำเป็นต้องแปลง PST เป็น OST เพื่อใช้งานในเครื่อง แต่คุณสามารถนำเข้า PST ไปยังบัญชีที่มีอยู่ได้โดยใช้วิซอร์ด Import/Export ใน 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 ในโหมด bulk เพื่อลดการทำ I/O. The addMessages(Iterable messages) เมธอดนี้อนุญาตให้คุณกำหนดช่วงของข้อความที่จะเพิ่มไปยัง PST เพื่อปรับปรุงประสิทธิภาพและสามารถใช้ในสถานการณ์ต่อไปนี้ นอกจากนี้เหตุการณ์ MessageAdded จะเกิดขึ้นเมื่อมีการเพิ่มข้อความไปยังโฟลเดอร์.

การโหลดข้อความจากดิสก์

โค้ดตัวอย่างต่อไปนี้แสดงวิธีโหลดข้อความจากดิสก์.

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

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

การทำงานของ Iterable

โค้ดตัวอย่างต่อไปนี้แสดงวิธีสร้างการทำงานของ 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());
    }
}

การเพิ่มข้อความจาก 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 และแสดงข้อมูลเกี่ยวกับข้อความ เช่น หัวเรื่อง, ผู้ส่ง, และผู้รับ. The FolderInfo.getContents() เมธอดใช้เพื่อแสดง ข้อมูลข้อความสรุป เช่น หัวเรื่อง, ผู้ส่ง, ผู้รับ. ด้านประสิทธิภาพ นี่เป็นตัวเลือกที่เหมาะสมที่สุดสำหรับการรับข้อมูลหลักของข้อความ. เพื่อ สกัด ข้อมูลข้อความทั้งหมด, the PersonalStorage.extractMessage() มีเมธอดให้ใช้ไฟล์ Outlook PST อาจมีโฟลเดอร์ซ้อน เพื่อดึงข้อมูลข้อความจากโฟลเดอร์เหล่านี้และโฟลเดอร์ระดับบนสุด ใช้วิธีการแบบ recursive เพื่ออ่านทุกโฟลเดอร์ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีอ่านไฟล์ 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. ใช้วิธีการแบบ recursive เพื่อท่องดูทุกโฟลเดอร์ (รวมถึงโฟลเดอร์ซ้อน) และเรียก 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 property. มันคืนค่าจำนวนรวมของรายการข้อความที่อยู่ใน PST.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการดึงจำนวนรวมของรายการ (ข้อความ, การนัดหมาย, รายชื่อผู้ติดต่อ ฯลฯ) ที่เก็บไว้ในไฟล์ PST:

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

ลบรายการจากไฟล์ PST

Add Messages to PST Files แสดงวิธีการเพิ่มข้อความไปยังไฟล์ PST แน่นอนว่าก็สามารถลบรายการ (เนื้อหา) จากไฟล์ PST ได้และอาจต้องการลบข้อความเป็นกลุ่ม รายการจากไฟล์ PST สามารถลบได้โดยใช้ FolderInfo.deleteChildItem() เมธอด. API ยังให้บริการ FolderInfo.deleteChildItems() เมธอดเพื่อลบรายการเป็นกลุ่มจากไฟล์ PST.

การลบข้อความจากไฟล์ PST

บทความนี้แสดงวิธีการใช้ FolderInfo คลาสเพื่อเข้าถึงโฟลเดอร์เฉพาะในไฟล์ PST. เพื่อลบข้อความจากโฟลเดอร์ย่อย Sent ของไฟล์ PST ที่โหลดหรือสร้างไว้ก่อนหน้า:

สร้างอินสแตนซ์ของ FolderInfo คลาสและโหลดด้วยเนื้อหาของโฟลเดอร์ย่อย sent.
ลบข้อความจากโฟลเดอร์ Sent โดยเรียก FolderInfo.deleteChildItem() เมธอดและส่งผ่าน MessageInfo.EntryId เป็นพารามิเตอร์ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีลบข้อความจากโฟลเดอร์ย่อย Sent ของไฟล์ PST.

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

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

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

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

การลบโฟลเดอร์จากไฟล์ PST

คุณสามารถลบโฟลเดอร์ PST ได้โดยย้ายไปยังโฟลเดอร์ Deleted Items.

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

คุณสามารถลบโฟลเดอร์ออกจากโฟลเดอร์ Deleted Items อย่างถาวร หากจำเป็น.

deletedItemsFolder.deleteChildItem(emptyFolder.getEntryId());

นี้ deleteChildItem() เมธอดนี้สามารถใช้กับโฟลเดอร์ใดก็ได้หากคุณต้องการลบโฟลเดอร์ย่อยโดยทันทีและถาวรโดยข้ามโฟลเดอร์ Deleted Items.

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

Enumerate และกู้คืนข้อความที่ถูกลบแบบ Soft-Deleted จาก PST

สามารถดึงข้อความที่ถูกลบอย่างถาวรด้วย Aspose.Email for Java ได้ API ของมันอนุญาตให้คุณ enumerate ข้อความที่ถูกลบแบบ soft-deleted ในไฟล์ PST. รายการที่ถูกลบแบบ soft-deleted คือข้อความที่ถูกลบสองครั้ง - ก่อนหน้านี้ย้ายไปยังโฟลเดอร์ Deleted Items แล้วจึงลบออกจากนั้น ข้อความเหล่านี้ยังสามารถกู้คืนได้ และ Aspose.Email มีวิธีที่สะดวกในการเข้าถึงพวกมัน. The PersonalStorage.findAndEnumerateSoftDeletedItems() เมธอดคืนคอลเลกชันของ RestoredItemEntry วัตถุ. แต่ละรายการประกอบด้วย:

MapiMessage item — ข้อความที่เรียกคืน.
String FolderId - ตัวระบุของโฟลเดอร์ที่ข้อความเดิมอยู่.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการ enumerate รายการอีเมลที่ถูกลบแบบ soft-deleted (เรียกคืนได้) ในไฟล์ PST:

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

ค้นหาข้อความและโฟลเดอร์ใน PST ตามเกณฑ์

ไฟล์ Personal Storage (PST) อาจมีข้อมูลจำนวนมหาศาลและการค้นหาข้อมูลที่ตรงกับเกณฑ์เฉพาะในไฟล์ใหญ่เช่นนี้ต้องมีจุดตรวจสอบหลายขั้นตอนในโค้ดเพื่อกรองข้อมูล. ด้วย PersonalStorageQueryBuilder คลาส, Aspose.Email ทำให้สามารถค้นหาบันทึกเฉพาะใน PST ตามเกณฑ์การค้นหาที่กำหนดได้ สามารถค้นหาข้อความใน PST ตามพารามิเตอร์การค้นหาเช่นผู้ส่ง, ผู้รับ, หัวเรื่อง, ความสำคัญของข้อความ, การมีไฟล์แนบ, ขนาดข้อความ, และแม้กระทั่ง ID ของข้อความ. The 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 ด้วยพารามิเตอร์ Ignore Case

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการค้นหาข้อความใน PST ด้วยพารามิเตอร์ ignore case.

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

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

การค้นหาหัวเรื่องข้อความด้วยคำสำคัญหลายคำในไฟล์ PST

คุณสามารถใช้ MailQueryBuilder.or เมธอดเพื่อค้นหาข้อความที่หัวเรื่องมีคำอย่างน้อยหนึ่งคำที่กำหนดตามตัวอย่างด้านล่าง:

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

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

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

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

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

การดึงข้อมูลโฟลเดอร์ PST แบบแบ่งหน้า

ปรับปรุงประสิทธิภาพและการควบคุมของแอปพลิเคชันเมื่อนำทางในโฟลเดอร์ขนาดใหญ่ ดึงเนื้อหาโฟลเดอร์ในรูปแบบแบ่งหน้าโดยใช้โอเวอร์โหลดของ Aspose.Email ของ getContents เมธอดนี้ - FolderInfo.getContents(MailQuery query, int startIndex, int count) - ดึงชุดย่อยของข้อความที่ตรงกับคิวรีที่กำหนด เริ่มจากดัชนีที่ระบุและจำกัดด้วยจำนวน ตัวอย่างโค้ดต่อไปนี้แสดงการดึงข้อมูลแบบแบ่งหน้าและการประมวลผลข้อความที่กรองจากโฟลเดอร์ PST:

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

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

    // Define the page size
    int pageSize = 5;

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

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

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

ย้ายรายการไปยังโฟลเดอร์อื่นของไฟล์ PST

Aspose.Email ทำให้สามารถย้ายรายการจากโฟลเดอร์ต้นทางไปยังโฟลเดอร์อื่นในไฟล์ Personal Storage (PST) เดียวกันได้ สิ่งนี้รวมถึง:

การย้ายโฟลเดอร์ที่กำหนดไปยังโฟลเดอร์แม่ใหม่.
การย้ายข้อความที่กำหนดไปยังโฟลเดอร์ใหม่.
การย้ายเนื้อหาไปยังโฟลเดอร์ใหม่.
การย้ายโฟลเดอร์ย่อยไปยังโฟลเดอร์แม่ใหม่.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการย้ายรายการเช่นข้อความและโฟลเดอร์จากโฟลเดอร์ต้นทางไปยังโฟลเดอร์อื่นในไฟล์ PST เดียวกัน.

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

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

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

การอัปเดตคุณสมบัติของข้อความในไฟล์ PST

บางครั้งจำเป็นต้องอัปเดตคุณสมบัติบางอย่างของข้อความ เช่น การเปลี่ยนหัวเรื่อง การทำเครื่องหมายความสำคัญของข้อความ เป็นต้น การอัปเดตข้อความในไฟล์ PST ด้วยการเปลี่ยนแปลงคุณสมบัติเช่นนั้น สามารถทำได้โดยใช้ FolderInfo.changeMessages เมธอดนี้ บทความนี้แสดงวิธีอัปเดตข้อความเป็นกลุ่มในไฟล์ PST สำหรับการเปลี่ยนแปลงคุณสมบัติ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีอัปเดตคุณสมบัติของข้อความในโหมดกลุ่มสำหรับหลายข้อความในไฟล์ PST

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

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

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

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

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

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

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

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

อัปเดตคุณสมบัติแบบกำหนดเองในไฟล์ PST

บางครั้งจำเป็นต้องทำเครื่องหมายรายการที่ประมวลผลแล้วในไฟล์ PST API ของ Aspose.Email สามารถทำได้โดยใช้ MapiProperty และ MapiNamedProperty เมธอดต่อไปนี้จะเป็นประโยชน์ในการทำเช่นนั้น

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

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

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

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

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

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

สกัดไฟล์แนบโดยไม่ต้องสกัดข้อความทั้งหมด

API ของ Aspose.Email สามารถใช้สกัดไฟล์แนบจากข้อความ PST โดยไม่ต้องสกัดข้อความทั้งหมดก่อน. ส่วน ExtractAttachments เมธอดของ PersonalStorage สามารถใช้ทำเช่นนี้ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสกัดไฟล์แนบโดยไม่ต้องสกัดข้อความทั้งหมด

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

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

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

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

การเพิ่มไฟล์ไปยัง PST

ฟังก์ชันหลักของ Microsoft Outlook คือการจัดการอีเมล, ปฏิทิน, งาน, ผู้ติดต่อและบันทึกบันทึกเหตุการณ์ นอกจากนี้ ยังสามารถเพิ่มไฟล์ลงในโฟลเดอร์ PST ได้และ PST ที่ได้จะบันทึกข้อมูลเอกสารที่เพิ่มแล้ว Aspose.Email ให้ความสามารถในการเพิ่มไฟล์ไปยังโฟลเดอร์ในลักษณะเดียวกัน พร้อมกับเพิ่มข้อความ, ผู้ติดต่อ, งานและบันทึกเหตุการณ์ไปยัง PST ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มเอกสารไปยังโฟลเดอร์ PST ด้วย Aspose.Email

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

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

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

Java: ทำงานกับผู้ติดต่อในไฟล์ PST

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

การอ่านผู้ติดต่อหลายรายการในรูปแบบ VCard

ตัวอย่างโค้ดด้านล่างแสดงวิธีอ่านไฟล์ VCF, ตรวจสอบว่ามีหลายผู้ติดต่อหรือไม่ และถ้ามีให้โหลดผู้ติดต่อจากไฟล์เข้าสู่รายการของอ็อบเจ็กต์ VCardContact โค้ดนี้ใช้เมธอดต่อไปนี้:

isMultiContacts(InputStream stream) - ตรวจสอบว่าสตรีมต้นทางมีหลายผู้ติดต่อหรือไม่.
loadAsMultiple(String filePath, Charset encoding) - โหลดรายการผู้ติดต่อจากไฟล์หลายผู้ติดต่อ.
loadAsMultiple(InputStream stream, Charset encoding) - โหลดรายการผู้ติดต่อจากสตรีมหลายผู้ติดต่อ.

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

เพิ่มผู้ติดต่อไปยัง PST

สร้าง PSTใหม่, เพิ่มโฟลเดอร์ย่อยและข้อความ แสดงวิธีสร้างไฟล์ PST และเพิ่มโฟลเดอร์ย่อยลงไป ด้วย Aspose.Email คุณสามารถเพิ่ม MapiContact ไปยังโฟลเดอร์ย่อย Contacts ของไฟล์ PST ที่คุณสร้างหรือโหลดไว้ ด้านล่างเป็นขั้นตอนเพื่อเพิ่ม MapiContact ไปยัง PST:

สร้าง MapiContact อ็อบเจ็กต์.
ตั้งค่า MapiContact คุณสมบัติโดยใช้คอนสตรักเตอร์และเมธอดที่แตกต่างกัน.
สร้าง PST ด้วย PersonalStorage.create() เมธอด.
สร้างโฟลเดอร์ที่กำหนดล่วงหน้า (Contacts) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์รากและจากนั้นเรียก addMapiMessageItem() เมธอด.

ตัวอย่างโค้ดด้านล่างแสดงวิธีสร้าง MapiContact และจากนั้นเพิ่มไปยังโฟลเดอร์ Contacts ของไฟล์ PST ที่สร้างใหม่.

บันทึกข้อมูลผู้ติดต่อจากไฟล์ PST ในรูปแบบ MSG

บทความนี้แสดงวิธีเข้าถึงข้อมูลผู้ติดต่อจากไฟล์ Microsoft Outlook PST และบันทึกผู้ติดต่อลงดิสก์ในรูปแบบ MSG เพื่อทำเช่นนั้นให้ใช้ PersonalStorage และ MapiContact คลาสสำหรับรับและแสดงข้อมูลผู้ติดต่อ.

เพื่อรับข้อมูลผู้ติดต่อ:

โหลดไฟล์ PST ใน PersonalStorage คลาส.
เรียกดูโฟลเดอร์ Contacts.
รับเนื้อหาของโฟลเดอร์ Contacts เพื่อรับชุดข้อความ.
วนลูปผ่านชุดข้อความ.
เรียก PersonalStorage.extractMessage() และจากนั้น toMapiMessageItem() เมธอดเพื่อรับข้อมูลผู้ติดต่อใน MapiContact คลาส.
ใช้ MapiContact คุณสมบัติเพื่อเข้าถึงข้อมูลผู้ติดต่อ.
เรียกใช้ PersonalStorage.extractMessage() เมธอดเพื่อรับข้อมูลผู้ติดต่อใน MapiMessage คลาส.
เรียกใช้ MapiMessage.save() เมธอดเพื่อบันทึกผู้ติดต่อลงดิสก์ในรูปแบบ MSG.

ด้านล่างเป็นโค้ดตัวอย่างที่ดึงข้อมูลผู้ติดต่อทั้งหมดจากไฟล์ PST และบันทึกลงดิสก์ในรูปแบบ MSG.

บันทึกข้อมูลผู้ติดต่อจาก Outlook PST ลงดิสก์ในรูปแบบ vCard

บทความนี้แสดงวิธีเข้าถึงข้อมูลการติดต่อจากไฟล์ Microsoft Outlook PST และบันทึกข้อมูลการติดต่อลงดิสก์ในรูปแบบ vCard (VCF) โดยใช้ PersonalStorage และ MapiContact คลาสเพื่อรับข้อมูลการติดต่อ.

ด้านล่างเป็นขั้นตอนเพื่อรับข้อมูลผู้ติดต่อ:

โหลดไฟล์ PST ใน PersonalStorage คลาส.
เรียกดูโฟลเดอร์ Contacts.
รับเนื้อหาของโฟลเดอร์ Contacts เพื่อรับชุดข้อความ.
วนลูปผ่านชุดข้อความ.
เรียกใช้ PersonalStorage.extractMessage() เมธอดเพื่อรับข้อมูลผู้ติดต่อใน MapiContact คลาส.
ใช้คุณสมบัติของ MapiContact คลาสเพื่อเข้าถึงข้อมูลผู้ติดต่อ.

โปรแกรมด้านล่างโหลดไฟล์ PST จากดิสก์และบันทึกผู้ติดต่อทั้งหมดในรูปแบบ vCard (VCF) ไฟล์ VCF สามารถใช้ในโปรแกรมอื่นใด ๆ ที่สามารถโหลดไฟล์ผู้ติดต่อ vCard มาตรฐานได้ หากคุณเปิดไฟล์ VCF ใด ๆ ใน Microsoft Outlook จะปรากฏเช่นรูปหน้าจอด้านล่าง

|| | :- | |รูปภาพ: vCard ที่บันทึกด้วย Aspose.Email|

Java: การทำงานกับรายการปฏิทินในไฟล์ PST

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

การเพิ่ม MapiCalendar ไปยัง PST

สร้าง PSTใหม่, เพิ่มโฟลเดอร์ย่อยและข้อความ ได้แสดงวิธีสร้างไฟล์ PST และเพิ่มโฟลเดอร์ย่อยเข้าไป ด้วย Aspose.Email คุณสามารถเพิ่ม MapiCalendar ไปยังโฟลเดอร์ย่อย Calendar ของไฟล์ PST ที่คุณสร้างหรือโหลด

ต่อไปนี้คือขั้นตอนการเพิ่ม MapiCalendar ไปยัง PST:

สร้าง MapiCalendar อ็อบเจ็กต์.
ตั้งค่า MapiCalendar คุณสมบัติโดยใช้คอนสตรัคเตอร์และเมธอด.
สร้าง PST ด้วย PersonalStorage.create() เมธอด.
สร้างโฟลเดอร์ที่กำหนดล่วงหน้า (Calendar) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์รากแล้วเรียก addMapiMessageItem() เมธอด.

ตัวอย่างโค้ดด้านล่างแสดงวิธีสร้าง MapiCalendar จากนั้นเพิ่มลงในโฟลเดอร์ Calendar ของไฟล์ PST ที่สร้างใหม่

บันทึกรายการปฏิทินจาก Outlook PST ลงดิสก์ในรูปแบบ ICS

บทความนี้แสดงวิธีเข้าถึงรายการปฏิทินจากไฟล์ Outlook PST และบันทึกปฏิทินลงดิสก์ในรูปแบบ ICS โดยใช้ PersonalStorage และ MapiCalendar คลาสสำหรับดึงข้อมูลปฏิทิน

ต่อไปนี้คือขั้นตอนการบันทึกรายการปฏิทิน:

โหลดไฟล์ PST ใน PersonalStorage คลาส.
เรียกดูโฟลเดอร์ Calendar.
รับเนื้อหาของโฟลเดอร์ Calendar เพื่อรับชุดข้อความ
วนลูปผ่านชุดข้อความ.
เรียกใช้ PersonalStorage.extractMessage() เมธอดเพื่อรับข้อมูลผู้ติดต่อใน MapiCalendar คลาส.
เรียกใช้ MapiCalendar.save() เมธอดเพื่อบันทึกรายการปฏิทินลงดิสก์ในรูปแบบ ICS.

โปรแกรมด้านล่างโหลดไฟล์ PST จากดิสก์และบันทึกรายการปฏิทินทั้งหมดในรูปแบบ ICS ไฟล์ ICS นี้สามารถใช้ในโปรแกรมอื่น ๆ ที่สามารถโหลดไฟล์ปฏิทินมาตรฐาน ICS ได้ หากคุณเปิดไฟล์ ICS ใด ๆ ใน Microsoft Outlook จะมีลักษณะเหมือนภาพหน้าจอด้านล่าง

|| | :- | |รูปภาพ: รายการปฏิทินที่บันทึกด้วย Aspose.Email|

สกัดรายการปฏิทินจากไฟล์ PST

คลาส MapiCalendar แทนรายการปฏิทินในรูปแบบ Microsoft Outlook MAPI สกัดข้อความจากไฟล์ PST แล้วแปลงเป็นรายการข้อความ MAPI ตัวอย่างโค้ดต่อไปนี้สกัดรายการปฏิทินจากไฟล์ PST และแปลงเป็นอ็อบเจกต์ MapiCalendar เพื่อการจัดการหรือประมวลผลต่อไป

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

บันทึกรายการปฏิทินในรูปแบบ ICS พร้อมเวลาต้นฉบับ

ใช้ตัวอย่างโค้ดด้านบนเพื่อสกัดรายการปฏิทินจากไฟล์ PST แล้วระบุตัวเลือกเพิ่มเติมเพื่อบันทึกเป็น ICS พร้อมเวลาเดิมโดยใช้ setKeepOriginalDateTimeStamp เมธอดของ MapiCalendarIcsSaveOptions คลาส:

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

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

แก้ไข/ลบเหตุการณ์จากการทำซ้ำ

Java: การทำงานกับ MapiTask ใน PST

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

การเพิ่ม MapiTask ไปยัง PST

สร้าง PSTใหม่, เพิ่มโฟลเดอร์ย่อยและข้อความ ได้แสดงวิธีสร้างไฟล์ PST และเพิ่มโฟลเดอร์ย่อยเข้าไป ด้วย Aspose.Email คุณสามารถเพิ่ม MapiTask ไปยังโฟลเดอร์ย่อย Tasks ของไฟล์ PST ที่คุณสร้างหรือโหลด

ต่อไปนี้คือขั้นตอนการเพิ่ม MapiTask ลงใน PST:

สร้าง MapiTask อ็อบเจ็กต์.
ตั้งค่า MapiTask คุณสมบัติโดยใช้คอนสตรัคเตอร์และวิธีต่าง ๆ
สร้าง PST ด้วย PersonalStorage.create() เมธอด.
สร้างโฟลเดอร์ที่กำหนดล่วงหน้า (Tasks) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์ Root แล้วเรียก 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 เข้าด้วยกันเป็นไฟล์ PST ขนาดใหญ่หนึ่งไฟล์.

ลองใช้ดู!

รวมและผสานไฟล์อีเมลหลายไฟล์ให้เป็นไฟล์เดียวด้วยฟรี แอปพลิเคชัน Aspose.Email Merger.

รวมโฟลเดอร์จาก PST อื่น

Aspose.Email API อนุญาตให้รวมโฟลเดอร์ทั้งหมดจาก PST อื่นเข้าสู่ PST ปลายทาง ทำให้ได้ PST ขนาดใหญ่.

แยก PST ตามเกณฑ์ที่กำหนด

เมธอดช่วยเหลือ

Java: ทำงานกับคุณสมบัติป้องกันรหัสผ่านของ PST

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

Microsoft Outlook ให้ผู้ใช้ตั้งรหัสผ่านป้องกันไฟล์ PST เพื่อจำกัดการเข้าถึง Aspose.Email สามารถตรวจจับการป้องกันด้วยรหัสผ่านบนไฟล์ PST บทความนี้แสดงวิธีตรวจสอบว่า PST มีรหัสผ่านหรือไม่และวิธีตรวจสอบว่ารหัสผ่านที่ตั้งไว้เป็นจริงหรือไม่

ตรวจสอบการป้องกันด้วยรหัสผ่าน

นี้ MapiPropertyTag.PR_PST_PASSWORD ค่าจาก แท็กคุณสมบัติ Mapi คลาสนี้ใช้เพื่อตรวจสอบว่าไฟล์ถูกป้องกันด้วยรหัสผ่านหรือไม่.

แฮช CRC-32 ของสตริงรหัสผ่านจะถูกเก็บไว้ในคุณสมบัติ PidTagPstPassword (tag = 0x67ff0003) ใน คลังข้อความ. หากคุณสมบัตินี้มีอยู่และไม่เป็นศูนย์, จะหมายความว่า 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() เมธอด.

ตัวอย่างโค้ด

ผลลัพธ์คอนโซล

ที่เก็บข้อมูลถูกป้องกันด้วยรหัสผ่าน - จริง รหัสผ่านถูกต้อง - จริง

Java: อ่านไฟล์ Outlook PST และรับข้อมูลโฟลเดอร์และโฟลเดอร์ย่อย

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

Aspose.Email for 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 Feeds มาตรฐานในไฟล์ PST

Aspose.Email ทำให้สามารถดึงอ้างอิงไปยังโฟลเดอร์ที่กำหนดล่วงหน้าที่เก็บ RSS feeds ได้ ซึ่งอาจมีประโยชน์หากคุณต้องการเข้าถึงและจัดการ RSS feeds ที่จัดเก็บในไฟล์ Outlook PST อย่างอัตโนมัติ ให้ค่าของ RssFeeds แก่ StandardIpmFolder enum.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรับโฟลเดอร์ RSS Feeds:

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

และตัวอย่างโค้ดด้านล่างแสดงวิธีเพิ่มโฟลเดอร์ RSS Feeds:

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

วิเคราะห์โฟลเดอร์ที่ค้นหาได้

ไฟล์ PST/OST อาจมีโฟลเดอร์ที่สามารถค้นหาได้เพิ่มเติมจากประเภทโฟลเดอร์ปกติ Aspose.Email ให้ FolderKind enumerator สำหรับระบุข้อความจากโฟลเดอร์การค้นหาเหล่านี้ด้วย EnumerateFolders และ GetSubFolders เมธอด.

ดึงข้อมูลโฟลเดอร์แม่จาก MessageInfo

โค้ดสแนปชอตต่อไปนี้แสดงวิธีดึงข้อมูลโฟลเดอร์แม่จาก MessageInfo.

API การเดินสำรวจไฟล์ PST

API การเดินสำรวจช่วยให้ดึงรายการ PST ทั้งหมดให้ได้มากที่สุดโดยไม่ทำให้เกิดข้อยกเว้น แม้ข้อมูลบางส่วนของไฟล์ต้นฉบับจะเสียหาย ขั้นตอนต่อไปนี้แสดงวิธีใช้ API นี้.

ใช้ PersonalStorage คอนสตรัคเตอร์และ โหลด เมธอดแทนจากเมธอด fromFile.

คอนสตรัคเตอร์อนุญาตให้กำหนดเมธอด callback.

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

ข้อยกเว้นที่เกิดจากการโหลดและการเดินสำรวจจะพร้อมใช้งานผ่านเมธอด callback.

นี้ โหลด เมธอดคืนค่า ’true’ หากไฟล์โหลดสำเร็จและสามารถเดินสำรวจต่อได้ หากไฟล์เสียหายและไม่สามารถเดินสำรวจได้ จะคืนค่า ‘false’.

if (currentPst.load(inputStream))

สิ่งนี้ทำให้สามารถเปิดและเดินสำรวจไฟล์ PST ที่เสียหายได้โดยไม่ทำให้เกิดข้อยกเว้น ทั้งข้อยกเว้นและรายการที่เสียหายจะถูกจัดการโดยเมธอด 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: อ่านไฟล์ 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 จากไฟล์ที่เสียหาย

Traversal API ช่วยให้สามารถสกัดข้อมูลทั้งหมดจากไฟล์ PST ได้อย่างเต็มที่ โดยไม่ทำให้เกิดข้อยกเว้น แม้ข้อมูลบางส่วนของไฟล์ต้นฉบับจะเสียหาย

ใช้ PersonalStorage(TraversalExceptionsCallback callback) คอนสตรัคเตอร์และ load(String fileName) เมธอดแทนที่ fromFile เมธอด.

คอนสตรัคเตอร์อนุญาตให้กำหนดเมธอด callback.

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

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

ข้อยกเว้นที่เกิดจากการโหลดและการเดินสำรวจจะพร้อมใช้งานผ่านเมธอด callback.

เมธอด 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: การทำงานกับไฟล์ PST ขนาดใหญ่

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

การประมวลผลไฟล์ Personal Storage Table (PST) ขนาดใหญ่สามารถลดประสิทธิภาพและเพิ่มการใช้หน่วยความจำได้ Aspose.Email สำหรับ Java มีเทคนิคและ API หลายอย่างที่ช่วยให้นักพัฒนาสามารถเข้าถึง, ประมวลผล, และจัดการข้อมูลเมลบ็อกซ์อย่างมีประสิทธิภาพโดยไม่ทำให้ระบบทำงานหนักเกินไป

ใช้เมธอด Iterable สำหรับการสำรวจโฟลเดอร์และข้อความ

เมื่อทำการวนซ้ำผ่านโฟลเดอร์และข้อความ, ควรเลือกใช้วิธีการที่คืนค่า 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);
    }
}

ใช้วิธีการแบบจำนวนมากเมื่อเป็นไปได้

เมื่อใดก็ตามที่คุณต้องการ เพิ่ม หรือ ลบ หลายรายการ แนะนำให้ใช้วิธีการแบบจำนวนมากแทนการดำเนินการแต่ละรายการ ซึ่งลดภาระและปรับปรุงประสิทธิภาพ

Java: อ่านไฟล์ OLM ของ Outlook for Mac และรับข้อมูลโฟลเดอร์และโฟลเดอร์ย่อย

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

Aspose.Email for Java ช่วยให้คุณอ่านไฟล์ OLM ของ Outlook for Mac คุณสามารถโหลดไฟล์ OLM จากดิสก์เข้าไปยังอินสแตนซ์ของ OlmStorage คลาสและรับข้อมูลเกี่ยวกับเนื้อหาของมัน เช่น โฟลเดอร์, โฟลเดอร์ย่อย, และข้อความ.

เปิดไฟล์รูปแบบ OLM

ไฟล์รูปแบบ OLM สามารถเปิดได้สองวิธี:

โดยใช้คอนสตรัคเตอร์
โดยใช้เมธอดสเตติก FromFile

มีความแตกต่างในพฤติกรรมระหว่างเมธอดเหล่านี้ ดูส่วนต่อไปนี้

เปิดไฟล์โดยคอนสตรัคเตอร์

เพื่อเปิดไฟล์ เรียกคอนสตรัคเตอร์ของ OlmStorage คลาสและส่งชื่อไฟล์เต็มหรือสตรีมเป็นอาร์กิวเมนต์ให้กับมัน:

OlmStorage olm = new OlmStorage("fileName");

เปิดไฟล์โดยใช้เมธอดสเตติก FromFile

เพื่อเปิดไฟล์ ใช้เมธอดสเตติก fromFile และส่งชื่อไฟล์เต็มเป็นอาร์กิวเมนต์ให้กับมัน:

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

เปิดไฟล์โดยใช้เมธอดสเตติก FromStream

เพื่อเปิดไฟล์โดยใช้เมธอดสเตติก fromStream, ส่งชื่อสตรีมเป็นอาร์กิวเมนต์ให้กับมัน:

อ่านไฟล์ OLM

โค้ดตัวอย่างต่อไปนี้แสดงวิธีโหลดไฟล์ OLM และดึงเนื้อหาของมัน

ดึงโฟลเดอร์

เพื่อดึงโฟลเดอร์จากไฟล์ OLM (Outlook for Mac) ให้โหลดไฟล์ด้วย OlmStorage เริ่มจากคลาส แล้วใช้หนึ่งในเมธอดต่อไปนี้ตามความต้องการของคุณ:

getFolder(String name, boolean ignoreCase) - ดึงโฟลเดอร์ตามชื่อ.
getFolders() - ดึงโครงสร้างโฟลเดอร์/คอลเลกชันของโฟลเดอร์.
getFolderHierarchy() - ดึงโครงสร้างโฟลเดอร์.

ตัวอย่างโค้ดด้านล่างจะแสดงวิธีดึงโฟลเดอร์จากไฟล์ OLM:

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

try {

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

} finally {

    olm.dispose();

}

เมื่อใช้ fromFile เมธอดเพื่อเปิดไฟล์ OLM, the getFolderHierarchy() จะคืนค่า null ในกรณีนี้ ให้เรียก getFolders() เมธอดเพื่อดึงรายการไดเรกทอรีในไฟล์ OLM อย่างชัดเจน

ดึงที่อยู่โฟลเดอร์

คุณยังสามารถดึงที่อยู่ของโฟลเดอร์ในไฟล์ OML ได้ Aspose.Email มีให้ OlmFolder.Path property ที่คืนค่าที่อยู่ของโฟลเดอร์ โค้ดตัวอย่างต่อไปนี้แสดงการใช้ OlmFolder.Path property เพื่อดึงเส้นทางโฟลเดอร์ในไฟล์ OML.

นับจำนวนรายการในโฟลเดอร์

คุณยังสามารถนับจำนวนรายการในโฟลเดอร์ได้ Aspose.Email มีให้ OlmFolder.MessageCount property ที่คืนค่าจำนวนรายการในโฟลเดอร์ โค้ดตัวอย่างต่อไปนี้แสดงการใช้ OlmFolder.MessageCount property เพื่อดึงจำนวนรายการในโฟลเดอร์ของไฟล์ OML.

วนซ้ำข้อความจากโฟลเดอร์ที่กำหนด

Aspose.Email มี API สำหรับทำงานกับ OLM storage และดึงข้อความจากโฟลเดอร์ที่กำหนด. The OlmFolder และ OlmMessageInfo คลาสเหล่านี้แสดงข้อมูลสรุปเกี่ยวกับโฟลเดอร์และข้อความในที่เก็บข้อมูลตามลำดับ. The OlmFolder คลาสนี้ให้เมธอดต่อไปนี้:

OlmFolder.getSubFolder(String subfolderName, boolean ignoreCase) - ดึงโฟลเดอร์ย่อยตามชื่อ.
OlmFolder.enumerateMapiMessages() - ให้เข้าถึง enumerator ที่สนับสนุนการวนซ้ำ MapiMessages ในโฟลเดอร์ปัจจุบัน.
OlmFolder.enumerateMessages() - ให้เข้าถึง enumerator ที่สนับสนุนการวนซ้ำ OlmMessageInfo ในโฟลเดอร์ปัจจุบัน.
OlmFolder.enumerateMessages(int startIndex, int count) - ให้เข้าถึง enumerator ที่สนับสนุนการวนซ้ำ OlmMessageInfo ภายในช่วงที่กำหนด.
OlmFolder.enumerateMessages(MailQuery query) - ให้เข้าถึง enumerator ที่สนับสนุนการวนซ้ำ 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());
}

หมายเหตุ: ID ของข้อความเป็นค่าเอกลักษณ์ภายในไฟล์เก็บข้อมูล ID สร้างโดย Aspose.Email และไม่สามารถใช้ในไลบรารีหรือแอปพลิเคชัน OLM ของบุคคลที่สามอื่นได้.

ดึงข้อมูล OLM จากไฟล์ที่เสียหาย

Aspose.Email มี API การเดินทางที่ช่วยดึงข้อมูล OLM ทั้งหมดเท่าที่ทำได้โดยไม่โยนข้อยกเว้น แม้ข้อมูลบางส่วนของไฟล์ต้นฉบับจะเสียหาย

ใช้ OlmStorage(TraversalExceptionsCallback callback) คอนสตรัคเตอร์และ load(String fileName) เมธอดแทนที่ fromFile เมธอด.

คอนสตรัคเตอร์อนุญาตให้กำหนดเมธอด callback.

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

ข้อยกเว้นที่เกิดจากการโหลดและการเดินสำรวจจะพร้อมใช้งานผ่านเมธอด 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());
        }
    }
}

ดึงวันที่แก้ไขของข้อความ

นี้ OlmMessageInfo.getModifiedDate property ที่ให้คุณดึงวันที่แก้ไขของข้อความ

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