Documentation – کار با فایل‌های ذخیره‌سازی Outlook

Java: ایجاد PST جدید، افزودن زیرپوشه‌ها و پیام‌ها

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

علاوه بر تجزیه یک فایل PST موجود، Aspose.Email امکان ایجاد یک فایل PST از ابتدا را فراهم می‌کند. این مقاله نشان می‌دهد چگونه یک فایل PST Outlook ایجاد و یک زیرپوشه به آن اضافه کنید.

از 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 با اندازه بیش از ۲ گیگابایت با استفاده از OutputStream

کاربران Aspose.Email می‌توانند کش داخلی PST را با استفاده از سازنده PersonalStorage بهینه‌سازی کنند:

blockSize - اندازه بهینه بلوک برای گسترش بافر کش (به بایت).

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

کاهش حجم پیام و اندازه فایل PST ایجاد شده

Aspose.Email قابلیت فشرده‌سازی محتویات بدنه را فراهم می‌کند که می‌تواند به کاهش حجم پیام کمک کند. این خصوصاً هنگام ارسال پیام‌های بزرگ یا مواجهه با محدودیت پهنای باند یا فضای ذخیره‌سازی مفید است. برای این منظور، کتابخانه پارامتر compression را در متدهای زیر ارائه می‌دهد:

MapiMessageItemBase.setBodyContent(String content, /BodyContentType/int contentType, boolean compression) - تنظیم محتویات بدنه.
MapiMessageItemBase.setBodyRtf(String content, boolean compression) - دریافت یا تنظیم متن پیام به فرمت RTF.

قطعه کد زیر نشان می‌دهد چگونه هنگام تنظیم بدنه پیام MAPI از فشرده‌سازی RTF استفاده کنیم:

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

ایجاد PersonalStorage بر پایه جریان SeekableByteChannel

Aspose.Email برای Java امکان کار با فایل‌های Personal Storage (PST) را با استفاده از java.nio.channels فراهم می‌کند. به شما اجازه می‌دهد یک نمونه PersonalStorage را با استفاده از یک جریان SeekableByteChannel ایجاد کنید. قطعه کد زیر نشان می‌دهد چگونه یک نمونه PersonalStorage بر پایه یک جریان FileChannel ایجاد کرده، یک زیرپوشه به نام "messageFolder" به پوشه ریشه اضافه کنید و پیام‌ها را از فایل‌های موجود در دایرکتوری "messageFolder" وارد کنید:

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

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

تغییر کلاس کانتینر پوشه

گاهی لازم است کلاس یک پوشه تغییر کند. یک مثال رایج این است که پیام‌های انواع مختلف (قرارها، پیام‌ها و غیره) به یک پوشه اضافه شوند. در این موارد، کلاس پوشه باید برای تمام عناصر در پوشه تغییر کند تا به درستی نمایش داده شوند. قطعه کد زیر نشان می‌دهد چگونه کلاس کانتینر یک پوشه در PST را برای این منظور تغییر دهیم.

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

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

افزودن پیام‌های دسته‌جمعی با عملکرد بهبود یافته

افزودن پیام‌های تک‌تک به یک PST به معنای عملیات I/O بیشتری به دیسک است و ممکن است عملکرد را کاهش دهد. برای بهبود عملکرد، می‌توان پیام‌ها را به صورت دسته‌جمعی به PST اضافه کرد تا عملیات I/O به حداقل برسد. این addMessages(Iterable messages) متد به شما امکان می‌دهد پیام‌ها را به صورت دسته‌جمعی اضافه کنید و می‌تواند در سناریوهای زیر استفاده شود. علاوه بر این، MessageAdded رویداد زمانی رخ می‌دهد که پیامی به پوشه اضافه شود.

افزودن پیام‌ها از PST دیگر

برای افزودن پیام‌ها از یک PST دیگر، از FolderInfo.enumerateMapiMessages() متد که برمی‌گرداند Iterable<MapiMessage>:

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

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

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

افزودن پیام‌ها از دایرکتوری

برای افزودن پیام‌ها از دایرکتوری، ایجاد کنید getMessages(String pathToDir) متد که برمی‌گرداند Iterable<MapiMessage>:

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

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

Java: خواندن و تبدیل فایل OST اوتلوک

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

Aspose.Email یک API برای خواندن فایل‌های OST مایکروسافت اوتلوک فراهم می‌کند. می‌توانید یک فایل OST را از دیسک یا استریم به یک نمونه از PersonalStorage کلاس و اطلاعات مربوط به محتویات آن را دریافت کنید، برای مثال پوشه‌ها، زیرپوشه‌ها و پیام‌ها. مایکروسافت اوتلوک یک فایل PST ایجاد می‌کند تا ایمیل‌ها را زمانی که سرورهای ایمیل POP3 یا IMAP برای دریافت پیام‌ها استفاده می‌شوند، ذخیره کند. زمانی که سرور ایمیل مایکروسافت اکسچنج باشد، یک فایل OST ایجاد می‌شود. OST از اندازه‌های بزرگتر فایل نسبت به فایل‌های PST پشتیبانی می‌کند.

خواندن فایل‌های OST

فرایند خواندن یک فایل OST با Aspose.Email دقیقاً همانند خواندن یک فایل PST است. همان کد می‌تواند هر دو فایل PST و OST را بخواند: فقط نام فایل صحیح را به PersonalStorage.fromFile() متد. قطعه‌کد زیر نشان می‌دهد چگونه فایل‌های OST را بخوانید.

تبدیل OST به PST

امتحان کنید!

ایمیل‌ها و آرشیو پیام‌ها را به‌صورت آنلاین با رایگان برنامه تبدیل Aspose.Email.

Aspose.Email امکان تبدیل یک فایل OST به PST را با یک خط کد فراهم می‌کند. به‌ طور مشابه، می‌توان فایل OST را از فایل PST با استفاده از همان خط کد و FileFormat enumerator. در حال حاضر، API از تبدیل فرمت‌های OST به PST به‌جز OST 2013/2016 پشتیبانی می‌کند. قطعه‌کد زیر نشان می‌دهد چگونه OST را به PST تبدیل کنید.

برای انجام عملیات دیگر با فایل‌های OST، لطفاً به صفحات زیر مراجعه کنید:

تبدیل PST به OST

تبدیل از PST به OST توسط Aspose.Email پشتیبانی نمی‌شود زیرا OST همیشه توسط اوتلوک هنگام افزودن حساب و همگام‌سازی با سرور ایمیل ایجاد می‌شود. تفاوت بین فایل‌های PST و OST این است که PST تنها به صورت محلی در دسترس است. محتوای OST نیز بر روی سرور ایمیل در دسترس است. بنابراین نیازی به تبدیل PST به OST برای استفاده محلی نیست. اما می‌توانید PST را با استفاده از ویزارد وارد/صادر کردن در اوتلوک به یک حساب موجود وارد کنید.

Java: کار با پیام‌ها در یک فایل PST

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

افزودن پیام‌ها به فایل‌های PST

ایجاد یک فایل PST جدید و افزودن زیرپوشه‌ها نشان داد چطور یک فایل PST ایجاد کرده و یک زیرپوشه به آن اضافه کنید. با Aspose.Email می‌توانید پیام‌ها را به زیرپوشه‌های یک فایل PST که ایجاد یا بارگذاری کرده‌اید اضافه کنید. این مقاله دو پیام را از دیسک به زیرپوشه Inbox یک PST اضافه می‌کند. از … استفاده کنید PersonalStorage و FolderInfo کلاس‌ها برای افزودن پیام‌ها به فایل‌های PST. برای افزودن پیام‌ها به پوشه Inbox یک فایل PST:

یک نمونه از کلاس FolderInfo ایجاد کنید و آن را با محتویات پوشه Inbox بارگذاری کنید.
پیام‌ها را از دیسک به پوشه Inbox اضافه کنید با فراخوانی FolderInfo.addMessage() متد. FolderInfo کلاس موارد زیر را در دسترس قرار می‌دهد addMessages روشی که امکان افزودن تعداد زیادی پیام به پوشه را فراهم می‌کند، عملیات I/O به دیسک را کاهش داده و عملکرد را بهبود می‌بخشد. یک مثال کامل در زیر می‌تواند یافت شود، در افزودن پیام‌های جمعی.

قطعه کدهای زیر نشان می‌دهند که چگونه پیام‌ها را به زیرپوشه‌ای به نام Inbox در PST اضافه کنید.

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

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

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

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

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

افزودن پیام‌های جمعی

اضافه کردن پیام‌های تک‌به‌تک به PST به معنای عملیات I/O بیشتر به دیسک است و بنابراین ممکن است عملکرد را کاهش دهد. برای بهبود عملکرد، می‌توان پیام‌ها را به صورت جمعی به PST اضافه کرد تا عملیات I/O به حداقل برسد. این addMessages(Iterable messages) این روش به شما اجازه می‌دهد تا یک بازه از پیام‌ها را برای افزودن به PST تعریف کنید تا عملکرد بهبود یابد و می‌تواند در سناریوهای زیر استفاده شود. علاوه بر این، رویداد MessageAdded زمانی رخ می‌دهد که پیامی به پوشه اضافه شود.

بارگذاری پیام‌ها از دیسک

قطعه کد زیر نشان می‌دهد که چگونه پیام‌ها را از دیسک بارگذاری کنید.

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

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

پیاده‌سازی Iterable

قطعه کد زیر نشان می‌دهد که چگونه یک پیاده‌سازی Iterable ایجاد کنید.

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

    private final File folder;

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

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

public class MapiMessageIterator implements Iterator<MapiMessage> {

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

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

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

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

اضافه کردن پیام‌ها از یک PST دیگر

برای اضافه کردن پیام‌ها از PST دیگر، از FolderInfo.enumerateMapiMessages() متدی که Iterable را برمی‌گرداند. قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را از PST دیگری اضافه کنید.

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

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

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

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

دریافت اطلاعات پیام‌ها از یک فایل PST Outlook

در خواندن فایل PST اوتلوک و دریافت اطلاعات پوشه‌ها و زیرپوشه‌ها، ما در مورد بارگذاری یک فایل PST Outlook و مرور پوشه‌های آن برای دریافت نام پوشه‌ها و تعداد پیام‌ها در آن‌ها بحث کردیم. این مقاله توضیح می‌دهد چگونه تمام پوشه‌ها و زیرپوشه‌های فایل PST را بخوانید و اطلاعات پیام‌ها مانند موضوع، فرستنده و گیرندگان را نمایش دهید. FolderInfo.getContents() متد برای نمایش اطلاعات مختصر پیام مانند موضوع، فرستنده، گیرندگان. از نظر عملکرد، این مناسب‌ترین گزینه برای دریافت اطلاعات اولیه درباره پیام‌ها است. برای استخراج داده کامل پیام، PersonalStorage.extractMessage() یک متد فراهم شده است. فایل PST Outlook ممکن است شامل پوشه‌های تو در تو باشد. برای دریافت اطلاعات پیام از این‌ها و همچنین پوشه‌های سطح بالا، از یک متد بازگشتی برای خواندن تمام پوشه‌ها استفاده کنید. قطعه کد زیر نشان می‌دهد چگونه یک فایل PST Outlook را بخوانید و محتویات پوشه‌ها و پیام‌ها را به‌صورت بازگشتی نمایش دهید.

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

این مقاله نشان می‌دهد چگونه فایل‌های PST مایکروسافت Outlook را بخوانیم و پیام‌ها را استخراج کنید. سپس پیام‌ها به‌صورت فایل MSG در دیسک ذخیره می‌شوند. مقاله همچنین نشان می‌دهد چگونه استخراج تعداد مشخصی از پیام‌ها از یک فایل PST. از یک متد بازگشتی برای مرور تمام پوشه‌ها (از جمله پوشه‌های تو در تو) استفاده کنید و متد را فراخوانی کنید PersonalStorage.extractMessage() متد برای دریافت پیام‌های Outlook به یک نمونه از MapiMessage کلاس. پس از آن، فراخوانی کنید MapiMessage.save() متد برای ذخیره پیام به‌صورت دیسک یا استریم در قالب MSG. قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را از فایل PST استخراج کنید.

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

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

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

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

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

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

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

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

ذخیره مستقیم پیام‌ها از PST به استریم

برای ذخیره پیام‌ها از یک فایل PST به‌صورت مستقیم به استریم، بدون استخراج MsgInfo برای پیام‌ها، از saveMessageToStream() متد. قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را مستقیم از PST به استریم ذخیره کنید.

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

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

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

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

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

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

استخراج n تعداد پیام از یک فایل PST

قطعه کد زیر نشان می‌دهد چگونه تعداد مشخصی از پیام‌ها را از PST استخراج کنید. به سادگی اندیس اولین پیام و تعداد کل پیام‌های مورد استخراج را بدهید.

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

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

دریافت تعداد کل آیتم‌ها از یک فایل PST

Aspose.Email ارائه می‌دهد GetTotalItemsCount() متد از PersonalStorage.Store خاصیت. تعداد کل پیام‌های موجود در PST را برمی‌گرداند.

نمونه کد زیر نشان می‌دهد چگونه تعداد کل آیتم‌ها (پیام‌ها، قرارها، مخاطبین و غیره) ذخیره‌شده در فایل PST را بازیابی کنید:

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

حذف آیتم‌ها از فایل‌های PST

اضافه کردن پیام‌ها به فایل‌های PST نشان داد چگونه پیام‌ها را به فایل‌های PST اضافه کنیم. البته می‌توان آیتم‌ها (محتواها) را از یک فایل PST حذف کرد و ممکن است حذف پیام‌ها به‌صورت گروهی نیز مطلوب باشد. آیتم‌های یک فایل PST می‌توانند با استفاده از FolderInfo.deleteChildItem() متد. API همچنین ارائه می‌دهد FolderInfo.deleteChildItems() متد برای حذف آیتم‌ها به‌صورت گروهی از فایل PST.

حذف پیام‌ها از فایل‌های PST

این مقاله نشان می‌دهد چگونه از FolderInfo کلاسی برای دسترسی به پوشه‌های خاص در یک فایل PST. برای حذف پیام‌ها از زیرپوشه Sent یک فایل PST که قبلاً بارگذاری یا ایجاد شده است:

یک نمونه از FolderInfo کلاس و بارگذاری آن با محتویات زیرپوشه Sent.
حذف پیام‌ها از پوشه Sent با فراخوانی FolderInfo.deleteChildItem() متد و عبور دادن MessageInfo.EntryId به‌عنوان پارامتر. قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را از زیرپوشه Sent یک فایل PST حذف کنید.

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

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

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

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

حذف پوشه‌ها از فایل‌های PST

می‌توانید یک پوشهٔ PST را با انتقال آن به پوشهٔ موارد حذف‌شده حذف کنید.

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

مزیت این متد این است که پوشهٔ حذف‌شده به‌راحتی قابل بازیابی است.

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

در صورت لزوم می‌توانید یک پوشه را به‌صورت دائمی از پوشهٔ موارد حذف‌شده حذف کنید.

deletedItemsFolder.deleteChildItem(emptyFolder.getEntryId());

این deleteChildItem() متد می‌تواند برای هر پوشه‌ای استفاده شود اگر بخواهید زیرپوشه را بلافاصله و به‌صورت دائمی حذف کنید و از پوشهٔ موارد حذف‌شده عبور کنید.

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

حذف آیتم‌ها به‌صورت گروهی از فایل PST

API Aspose.Email می‌تواند برای حذف آیتم‌ها به‌صورت گروهی از یک فایل PST استفاده شود. این کار با استفاده از deleteChildItems() متدی که لیستی از آیتم‌های Entry ID مربوط به آیتم‌های حذف‌شده را می‌پذیرد. قطعه کد زیر نشان می‌دهد چگونه آیتم‌ها را به‌صورت گروهی از فایل PST حذف کنید.

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

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

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

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

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

فهرست‌برداری و بازیابی پیام‌های حذف نرم از PST

با Aspose.Email برای Java می‌توان پیام‌های به‌صورت دائمی حذف‌شده را بازیابی کرد. API این کتابخانه امکان فهرست‌برداری از پیام‌های حذف نرم در فایل‌های PST را فراهم می‌کند. آیتم‌های حذف نرم پیام‌هایی هستند که دو بار حذف شده‌اند - ابتدا به پوشهٔ موارد حذف‌شده منتقل می‌شوند و سپس از آنجا حذف می‌شوند. این پیام‌ها هنوز قابل بازیابی هستند و Aspose.Email روشی راحت برای دسترسی به آن‌ها ارائه می‌دهد. PersonalStorage.findAndEnumerateSoftDeletedItems() متد مجموعه‌ای از را برمی‌گرداند RestoredItemEntry اشیاء. هر ورودی شامل:

MapiMessage آیتم — پیام بازیابی‌شده.
String FolderId - شناسهٔ پوشه‌ای که پیام در ابتدا متعلق به آن بود.

نمونه کد زیر نحوه فهرست‌برداری از آیتم‌های ایمیل حذف نرم (قابل بازیابی) در فایل‌های PST را نشان می‌دهد:

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

جستجوی پیام‌ها و پوشه‌ها در PST بر اساس معیار

فایل‌های ذخیره‌سازی شخصی (PST) می‌توانند حجم زیادی داده داشته باشند و جستجوی داده‌هایی که معیار خاصی را برآورده می‌شوند در چنین فایل‌های بزرگ نیاز به چندین نقطه بررسی در کد برای فیلتر کردن اطلاعات دارد. با استفاده از PersonalStorageQueryBuilder کلاس، Aspose.Email امکان جستجوی رکوردهای خاص در PST را بر اساس معیار جستجوی مشخص فراهم می‌کند. یک PST می‌تواند پیام‌ها را بر پایه پارامترهای جستجو مانند فرستنده، گیرنده، موضوع، اهمیت پیام، وجود پیوست، اندازه پیام و حتی شناسه پیام جستجو کند. PersonalStorageQueryBuilder همچنین می‌توان از آن برای جستجوی زیرپوشه‌ها استفاده کرد.

جستجوی پیام‌ها و پوشه‌ها در PST

قطعه کد زیر نشان می‌دهد چگونه از PersonalStorageQueryBuilder کلاسی برای جستجوی محتویات در PST بر اساس معیارهای جستجوی مختلف. به عنوان مثال، جستجو در PST بر پایه:

اهمیت پیام.
کلاس پیام.
وجود پیوست‌ها.
اندازه پیام.
تاریخ پیام.
پیام‌های خوانده‌نشده.
پیام‌های خوانده‌نشده با پیوست، و
پوشه‌ها با نام زیرپوشه خاص.

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

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

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

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

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

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

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

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

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

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

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

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

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

جستجوی رشته در PST با پارامتر نادیده‌گیری حروف

قطعه کد زیر نحوه جستجوی یک رشته در PST با پارامتر نادیده‌گیری حروف بزرگ/کوچک را نشان می‌دهد.

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

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

جستجوی موضوع پیام‌ها با کلیدواژه‌های متعدد در فایل PST

می‌توانید استفاده کنید MailQueryBuilder.or متد برای یافتن پیام‌هایی که موضوع آن‌ها شامل حداقل یکی از کلمات مشخص شده باشد، همان‌طور که در زیر نشان داده شده است:

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

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

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

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

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

دریافت صفحه‌بندی‌شده محتویات پوشه PST

عملکرد برنامه خود را بهبود دهید و هنگام مرور پوشه‌های بزرگ کنترل بهتری داشته باشید. محتویات پوشه را به شکل صفحه‌بندی‌شده با استفاده از نسخه اضافه‌شده Aspose.Email از متد دریافت کنید. getContents متد. این متد - FolderInfo.getContents(MailQuery query, int startIndex, int count) - زیرمجموعه‌ای از پیام‌ها را که با پرس‌وجوی مشخص سازگار هستند، از یک شاخص داده شده بازیابی می‌کند و تعداد آن محدود می‌شود. نمونه کد زیر بازیابی صفحه‌بندی‌شده و پردازش پیام‌های فیلترشده از یک پوشه PST را نشان می‌دهد:

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

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

    // Define the page size
    int pageSize = 5;

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

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

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

انتقال آیتم‌ها به سایر پوشه‌های فایل PST

Aspose.Email امکان انتقال آیتم‌ها از یک پوشه منبع به پوشه دیگری در همان فایل ذخیره‌سازی شخصی (PST) را فراهم می‌کند. این شامل موارد زیر است:

انتقال یک پوشه مشخص به یک پوشه والد جدید.
انتقال یک پیام مشخص به یک پوشه جدید.
انتقال محتواها به یک پوشه جدید.
انتقال زیرپوشه‌ها به یک پوشه والد جدید.

قطعه کد زیر نحوه انتقال آیتم‌ها مانند پیام‌ها و پوشه‌ها از یک پوشه منبع به پوشه دیگری در همان فایل PST را نشان می‌دهد.

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

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

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

به‌روزرسانی ویژگی‌های پیام در فایل PST

گاهی لازم است برخی ویژگی‌های پیام‌ها مانند تغییر موضوع، علامت‌گذاری اهمیت پیام و موارد مشابه به‌روزرسانی شوند. به‌روزرسانی یک پیام در فایل PST با این تغییرات در ویژگی‌های پیام می‌تواند با استفاده از FolderInfo.changeMessages متد. این مقاله نشان می‌دهد چگونه پیام‌ها را به صورت گروهی در یک فایل PST برای تغییر ویژگی‌ها به‌روزرسانی کنیم. قطعه کد زیر نشان می‌دهد چگونه ویژگی‌های پیام‌ها را به صورت دسته‌ای برای چندین پیام در یک فایل PST به‌روزرسانی کنید.

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

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

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

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

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

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

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

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

به‌روزرسانی ویژگی‌های سفارشی در یک فایل PST

گاهی لازم است آیتم‌های پردازش‌شده در داخل فایل PST علامت‌گذاری شوند. 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

این مقاله نشان می‌دهد چگونه به اطلاعات مخاطب از یک فایل PST مایکروسافت اوتلوک دسترسی پیدا کرده و مخاطبین را در دیسک به فرمت MSG ذخیره کنید. برای این کار، از PersonalStorage و MapiContact کلاس‌ها برای دریافت و نمایش اطلاعات مخاطب.

برای دریافت اطلاعات یک مخاطب:

بارگذاری فایل PST در PersonalStorage کلاس.
مرور پوشه Contacts.
دریافت محتویات پوشه Contacts برای به دست آوردن مجموعه پیام‌ها.
حلقه‌زدن در مجموعه پیام‌ها.
فراخوانی کنید PersonalStorage.extractMessage() و سپس toMapiMessageItem() متد برای دریافت اطلاعات مخاطب در MapiContact کلاس.
استفاده کنید MapiContact ویژگی‌ها برای دسترسی به اطلاعات مخاطب.
متد را فراخوانی کنید PersonalStorage.extractMessage() متد برای دریافت اطلاعات مخاطب در MapiMessage کلاس.
متد را فراخوانی کنید MapiMessage.save() متد برای ذخیره مخاطب در دیسک با فرمت MSG.

در زیر یک کد نمونه آورده شده است که تمام اطلاعات مخاطبین را از فایل PST استخراج کرده و در دیسک به فرمت MSG ذخیره می‌کند.

ذخیره اطلاعات تماس‌ها از Outlook PST به دیسک در فرمت vCard

این مقاله نشان می‌دهد چگونه می‌توان اطلاعات تماس را از یک فایل PST مایکروسافت اوتلوک دسترسی پیدا کرد و تماس را به فرمت vCard (VCF) بر روی دیسک ذخیره کرد. از PersonalStorage و MapiContact کلاس‌ها برای دریافت اطلاعات تماس.

در زیر مراحل دریافت اطلاعات مخاطبین آمده است:

بارگذاری فایل PST در PersonalStorage کلاس.
مرور پوشه Contacts.
دریافت محتویات پوشه Contacts برای به دست آوردن مجموعه پیام‌ها.
حلقه‌زدن در مجموعه پیام‌ها.
متد را فراخوانی کنید PersonalStorage.extractMessage() متد برای دریافت اطلاعات مخاطب در MapiContact کلاس.
از ویژگی‌های MapiContact کلاس برای دسترسی به اطلاعات مخاطب.

برنامه زیر یک فایل PST را از دیسک بارگذاری می‌کند و تمام مخاطبین را در قالب vCard (VCF) ذخیره می‌سازد. فایل‌های VCF سپس می‌توانند در هر برنامهٔ دیگری که می‌تواند فایل تماس استاندارد vCard را بارگذاری کند، استفاده شوند. اگر هر فایل VCF را در مایکروسافت اوتلوک باز کنید، شبیه به تصویری که در پایین نشان داده شده است خواهد بود.

|| | :- | |شکل: یک 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

این مقاله نشان می‌دهد چگونه آیتم‌های تقویم را از یک فایل PST Outlook دسترسی یافته و تقویم را در دیسک با فرمت ICS ذخیره کنید. از PersonalStorage و MapiCalendar کلاس‌ها برای دریافت اطلاعات تقویم.

مراحل زیر برای ذخیره آیتم‌های تقویم:

بارگذاری فایل PST در PersonalStorage کلاس.
مرور پوشه Calendar.
محتویات پوشه Calendar را دریافت کنید تا مجموعه پیام‌ها را به دست آورید.
حلقه‌زدن در مجموعه پیام‌ها.
متد را فراخوانی کنید PersonalStorage.extractMessage() متد برای دریافت اطلاعات مخاطب در MapiCalendar کلاس.
متد را فراخوانی کنید MapiCalendar.save() متدی برای ذخیره آیتم تقویم در دیسک با فرمت ICS.

برنامه زیر یک فایل PST را از دیسک بارگذاری می‌کند و تمام آیتم‌های تقویم را در قالب ICS ذخیره می‌نماید. پس از آن می‌توان فایل‌های ICS را در هر برنامه دیگری که قادر به بارگذاری فایل تقویم استاندارد ICS باشد، استفاده کرد. اگر هر فایل ICS را در Microsoft Outlook باز کنید، مشابه تصویر زیر خواهد بود.

|| | :- | |شکل: آیتم تقویم ذخیره‌شده با Aspose.Email|

استخراج آیتم‌های تقویم از یک فایل PST

کلاس MapiCalendar نمایانگر یک آیتم تقویم در فرمت MAPI مایکروسافت Outlook است. یک پیام را از یک فایل 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

API Aspose.Email قابلیت تقسیم یک فایل PST واحد به چندین فایل PST با اندازه دلخواه را فراهم می‌کند. همچنین می‌تواند چندین فایل PST را در یک فایل PST واحد ادغام کند. هر دو عملیات تقسیم و ادغام PST با افزودن رویدادها به این عملیات‌ها قابل پیگیری هستند.

تقسیم و ادغام فایل‌های PST

نمونه‌های کد زیر نشان می‌دهند چگونه یک فایل PST بزرگ را به چندین بخش کوچک تقسیم کنیم.

ادغام چندین PST در یک PST واحد

نمونه کد زیر نشان می‌دهد چگونه چندین PST می‌توانند در یک فایل PST بزرگ ترکیب شوند.

امتحان کنید!

ادغام و ترکیب چندین فایل ایمیل در یک فایل واحد با نسخه رایگان اپلیکیشن ادغام Aspose.Email.

ادغام پوشه‌ها از یک PST دیگر

API Aspose.Email امکان ادغام کل پوشه‌ها از یک PST دیگر به PST مقصد را می‌دهد، که منجر به یک PST بزرگ می‌شود.

تقسیم PST بر اساس معیار تعریف‌شده

متدهای کمکی

Java: کار با ویژگی‌های حفاظت با گذرواژه PST

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

مایکروسافت اوتلوک به کاربران اجازه می‌دهد فایل‌های PST را با گذرواژه محافظت کنند تا دسترسی به آن‌ها محدود شود. Aspose.Email می‌تواند حفاظت با گذرواژه روی یک فایل PST را تشخیص دهد. این مقاله نشان می‌دهد چگونه یک PST را برای وجود گذرواژه بررسی کنید و همچنین چگونه صحت گذرواژه اعمال شده را بررسی کنید.

بررسی حفاظت با گذرواژه

این MapiPropertyTag.PR_PST_PASSWORD مقدار از MapiPropertyTag کلاس برای بررسی اینکه آیا یک فایل با گذرواژه محافظت شده است استفاده می‌شود.

هش CRC-32 رشته گذرواژه در ویژگی PidTagPstPassword (برچسب = 0x67ff0003) در MessageStore. اگر این ویژگی وجود داشته باشد و صفر نباشد، آنگاه PST با گذرواژه محافظت شده است.

قطعه‌کد زیر نشان می‌دهد چگونه بررسی شود آیا یک فایل PST با گذرواژه محافظت شده است و آیا رشته داده‌شده یک گذرواژه معتبر برای آن PST است یا خیر.

قطعه‌کد زیر دو تابع را نشان می‌دهد؛ اولین تابع بررسی می‌کند آیا PST با گذرواژه محافظت شده است یا نه، و دومین تابع نشان می‌دهد چگونه بررسی شود آیا گذرواژه ارائه شده صحیح است یا نه.

حذف/تنظیم مجدد ویژگی PR_PST_PASSWORD

حذف PR_PST_PASSWORD ویژگی نمی‌تواند به‌دست‌آید زیرا سایر ویژگی‌ها از یک MessageStore حذف می‌شوند. در عوض، باید مقدار آن را صفر (0) تنظیم کنیم تا حذف شود. ویژگی "Store" کلاس PST دسترسی به ویژگی‌های ذخیره‌سازی PST را به‌جای MessageStoreProperties PST فراهم می‌کند در این حالت.

تنظیم/تغییر گذرواژه PST

قطعه‌کد زیر نشان می‌دهد چگونه یک گذرواژه بر روی فایل‌های PST تنظیم کنید.

تأیید گذرواژه برای فایل‌های PST محافظت‌شده با گذرواژه

Aspose.Email به توسعه‌دهندگان امکان می‌دهد بررسی کنند آیا فایل PST با گذرواژه محافظت شده است و آیا گذرواژهٔ داده‌شده صحیح است یا نه. برای این منظور، API ویژگی PersonalStorage.Store.IsPasswordProtected ویژگی و PersonalStorage.Store.IsPasswordValid() متد. PersonalStorage.Store.IsPasswordProtected ویژگی true برمی‌گرداند اگر فایل PST با گذرواژه محافظت شده باشد و false اگر نه. PersonalStorage.Store.IsPasswordValid() متد که رشتهٔ گذرواژه را به عنوان پارامتر می‌گیرد و در صورت صحیح بودن گذرواژه true و در غیر این صورت false برمی‌گرداند.

قطعه‌کد زیر نحوه استفاده از PersonalStorage.Store.IsPasswordProtected ویژگی و PersonalStorage.Store.IsPasswordValid() متد.

کد نمونه

خروجی کنسول

ذخیره‌سازی با گذرواژه محافظت شده - True گذرواژه معتبر - True

Java: خواندن فایل PST اوتلوک و دریافت اطلاعات پوشه‌ها و زیرپوشه‌ها

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

Aspose.Email برای Java به شما امکان می‌دهد فایل‌های PST مایکروسافت اوتلوک را بخوانید. می‌توانید یک فایل PST را از دیسک یا جریان به یک نمونه از PersonalStorage کلاس و دریافت اطلاعات درباره محتویات آن، به عنوان مثال، پوشه‌ها، زیرپوشه‌ها و پیام‌ها.

بارگذاری یک فایل PST

یک فایل 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 باشد، متد یک مقدار enum از نوع StandardIpmFolder برای پوشه والد سطح‌بالا برمی‌گرداند. این تعیین می‌کند آیا پوشه فعلی زیرپوشه یک پوشه پیش‌تعریف‌شده است یا خیر. اگر پارامتر ‘getForTopLevelParent’ برابر false باشد، یک مقدار enum از نوع StandardIpmFolder برای پوشه جاری برمی‌گرداند.

String fileName = "my.pst";

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

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

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

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

        System.out.println();

        checkFolders(folder.getSubFolders());
    }
}

دریافت یا افزودن یک پوشه استاندارد RSS Feeds در یک فایل PST

Aspose.Email امکان دریافت مرجعی به پوشه پیش‌تعریف‌شده‌ای که RSS feeds را نگه می‌دارد را فراهم می‌کند. این می‌تواند مفید باشد اگر بخواهید به‌صورت برنامه‌ای به RSS feeds ذخیره شده در فایل 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 از فایل‌های خراب

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، رشته base64 باید با استفاده از Apache Commons Codec.

بارگذاری MapidistributionList از فایل

کد زیر یک لیست توزیع MAPI را از یک فایل بارگذاری می‌کند.

ایجاد یک MapiDistributionList جدید و افزودن آن به زیرپوشه Contacts

مراحل زیر برای افزودن یک MapiDistributionList به یک PST:

یک PST جدید ایجاد کنید.
پوشه Contacts را به PST اضافه کنید.
ایجاد تماس‌های نمونه.
یک لیست توزیع بر پایه تماس‌های ایجاد شده بسازید.
لیست توزیع را به PST اضافه کنید.

قطعه‌کد زیر نشان می‌دهد چگونه یک MapiDistributionList و سپس آن را به پوشه Contacts یک فایل PST تازه ایجاد شده اضافه کنید.

ایجاد یک لیست توزیع تک‌بار استفاده

برای این لیست توزیع، نیازی به تماس‌های جداگانه نیست.

Java: خواندن فایل OLM Outlook برای Mac و دریافت اطلاعات پوشه‌ها و زیرپوشه‌ها

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

Aspose.Email برای جاوا به شما امکان می‌دهد فایل‌های OLM Outlook برای Mac را بخوانید. می‌توانید یک فایل OLM را از دیسک به یک نمونه از OlmStorage کلاس و دریافت اطلاعات درباره محتویات آن، به عنوان مثال، پوشه‌ها، زیرپوشه‌ها و پیام‌ها.

باز کردن فایل‌های فرمت OLM

فایل‌های فرمت OLM می‌توانند به دو روش باز شوند:

استفاده از سازنده
استفاده از متد استاتیک FromFile

رفتار این روش‌ها متفاوت است. بخش زیر را ببینید.

باز کردن فایل‌ها با سازنده

برای باز کردن یک فایل، سازندهٔ OlmStorage کلاس و نام کامل فایل یا جریان را به عنوان آرگومان به آن پاس دهید:

OlmStorage olm = new OlmStorage("fileName");

باز کردن فایل‌ها با متد استاتیک FromFile

برای باز کردن یک فایل، از متد استاتیک استفاده کنید fromFile و نام کامل فایل را به عنوان آرگومان به آن پاس دهید:

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

باز کردن فایل‌ها با متد استاتیک FromStream

برای باز کردن یک فایل با استفاده از متد استاتیک fromStream، یک نام جریان را به عنوان آرگومان به آن پاس دهید:

خواندن فایل OLM

قطعه کد زیر نشان می‌دهد که چگونه فایل OLM را بارگذاری کرده و محتویات آن را دریافت کنید.

دریافت پوشه‌ها

برای دریافت پوشه‌ها از یک فایل OLM (Outlook برای Mac)، آن را با OlmStorage ابتدا کلاس، سپس یکی از روش‌های زیر را بسته به نیازهای خود استفاده کنید:

getFolder(String name, boolean ignoreCase) - دریافت پوشه بر اساس نام.
getFolders() - دریافت سلسله‌مراتب/مجموعه‌ای از پوشه‌ها.
getFolderHierarchy() - دریافت سلسله‌مراتب پوشه.

نمونه کد زیر نشان می‌دهد چطور یک پوشه را از یک فایل OLM دریافت کنید:

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

try {

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

} finally {

    olm.dispose();

}

هنگام استفاده از fromFile متد برای باز کردن یک فایل OLM، getFolderHierarchy() null برمی‌گرداند. در این صورت، فراخوانی کنید getFolders() متدی که به طور صریح فهرست دایرکتوری‌ها در فایل OLM را بازیابی می‌کند.

دریافت مسیر پوشه

شما همچنین می‌توانید مسیر پوشه‌های داخل فایل OML را دریافت کنید. Aspose.Email ارائه می‌دهد OlmFolder.Path خصوصیتی که مسیر پوشه را برمی‌گرداند. قطعه کد زیر استفاده از آن را نشان می‌دهد OlmFolder.Path خصوصیتی برای دریافت مسیرهای پوشه‌ها در فایل OML.

شمارش تعداد آیتم‌ها در پوشه

شما همچنین می‌توانید تعداد آیتم‌ها در پوشه را بشمارید. Aspose.Email ارائه می‌دهد OlmFolder.MessageCount خصوصیتی که تعداد آیتم‌ها در پوشه را برمی‌گرداند. قطعه کد زیر استفاده از آن را نشان می‌دهد OlmFolder.MessageCount خصوصیتی برای دریافت تعداد آیتم‌ها در پوشه‌های فایل OML.

شمارش پیام‌ها از یک پوشهٔ مشخص

Aspose.Email API ای را برای کار با ذخیره‌سازی‌های OLM و استخراج پیام‌ها از یک پوشهٔ مشخص فراهم می‌کند. OlmFolder و OlmMessageInfo کلاس‌ها به ترتیب اطلاعات مختصری درباره یک پوشه و یک پیام در ذخیره‌سازی ارائه می‌دهند. OlmFolder کلاس متدهای زیر را فراهم می‌کند:

OlmFolder.getSubFolder(String subfolderName, boolean ignoreCase) - زیرپوشه را بر حسب نام دریافت می‌کند.
OlmFolder.enumerateMapiMessages() - یک شمارنده را افشا می‌کند که امکان تکرار MapiMessageها در پوشهٔ فعلی را فراهم می‌آورد.
OlmFolder.enumerateMessages() - یک شمارنده را افشا می‌کند که امکان تکرار OlmMessageInfoها در پوشهٔ فعلی را فراهم می‌آورد.
OlmFolder.enumerateMessages(int startIndex, int count) - یک شمارنده را افشا می‌کند که امکان تکرار OlmMessageInfoها در یک بازهٔ مشخص را فراهم می‌آورد.
OlmFolder.enumerateMessages(MailQuery query) - یک شمارنده را افشا می‌کند که امکان تکرار OlmMessageInfoها را بر اساس معیارهای جستجو فراهم می‌آورد.

نمونه‌های کد زیر استفاده از این روش‌ها را نشان می‌دهند:

 // Enumerates all messages in a given folder

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

try {

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

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

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

   }

} finally {

    olm.dispose();

}

// Enumerates a range of messages in a given folder

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

try {

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

   int startIndex = 10;

   int count = 100;

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

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

   }

} finally {

    olm.dispose();

}

// Enumerates messages by search criteria

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

try {

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

    MailQueryBuilder mailQueryBuilder = new MailQueryBuilder();

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

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

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

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

   }

} finally {

    olm.dispose();

}

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

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

try {

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

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

       if (messageInfo.hasAttachments()) {

            MapiMessage msg = olm.extractMapiMessage(messageInfo);

       }

   }

} finally {

    olm.dispose();

}

استخراج پیام‌ها از OLM بر اساس شناسه‌ها

گاهی لازم است پیام‌های انتخابی را بر حسب شناسه استخراج کنید. به عنوان مثال، برنامهٔ شما شناسه‌ها را در پایگاه داده ذخیره می‌کند و پیام را بر حسب نیاز استخراج می‌کند. این روش کارآمدی برای جلوگیری از پیمایش کل ذخیره‌سازی هر بار برای یافتن پیام خاص است. برای پیاده‌سازی این ویژگی برای فایل‌های OLM، Aspose.Email روش‌ها و کلاس‌های زیر را ارائه می‌دهد:

EntryId ویژگی OlmMessageInfo کلاس - دریافت شناسه ورودی پیام.
بارگذاری‌شده extractMapiMessage(String id) متد از OlmStorage کلاس - دریافت پیام از OLM.

نمونه کد زیر نشان می‌دهد چگونه پیام‌ها را از OLM با استفاده از شناسه‌ها استخراج کنید:

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

توجه: شناسه پیام در فایل ذخیره‌سازی منحصر به فرد است. شناسه‌ها توسط Aspose.Email ایجاد می‌شوند و نمی‌توانند در کتابخانه‌ها یا برنامه‌های دیگر پردازش OLM استفاده شوند.

استخراج آیتم‌های OLM از فایل‌های خراب

Aspose.Email یک API پیمایش ارائه می‌دهد که امکان استخراج تمام آیتم‌های OLM تا حد امکان را فراهم می‌کند، بدون پرتاب استثناها، حتی اگر برخی داده‌های فایل اصلی خراب باشد.

از OlmStorage(TraversalExceptionsCallback callback) سازنده و load(String fileName) متد به جای fromFile متد.

سازنده امکان تعریف یک متد 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 خصوصیتی که به شما امکان می‌دهد تاریخ اصلاح پیام را دریافت کنید.

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

Java: کار با فایل‌های PST بزرگ

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

پردازش فایل‌های بزرگ جدول ذخیره‌سازی شخصی (PST) می‌تواند عملکرد را کاهش داده و مصرف حافظه را افزایش دهد. Aspose.Email برای Java چندین تکنیک و API ارائه می‌دهد که به توسعه‌دهندگان امکان دسترسی، پردازش و مدیریت داده‌های صندوق پستی را به‌صورت کارآمد فراهم می‌کند بدون اینکه منابع سیستم بارگذاری بیش از حد شوند.

از روش‌های قابل تکرار برای پیمایش پوشه‌ها و پیام‌ها استفاده کنید

هنگام مرور پوشه‌ها و پیام‌ها، روش‌هایی که مقدار برمی‌گردانند را ترجیح دهید Iterable. این باعث کاهش بار حافظه و بهبود عملکرد می‌شود.

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

از MessageInfo برای ویژگی‌های پایه پیام استفاده کنید

اگر فقط به جزئیات پایه پیام نیاز دارید، از MessageInfo به‌جای بارگیری کل پیام. این کار سریع‌تر است و حافظه کمتری مصرف می‌کند.

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

از استخراج کامل پیام‌ها مگر در صورت ضرورت خودداری کنید

استفاده نکنید ExtractMessage یا EnumerateMapiMessages روش‌ها برای همه پیام‌ها مگر اینکه به همه ویژگی‌ها نیاز داشته باشید.

در عوض، در نظر بگیرید:

ا) بازیابی شناسه‌های پیام

استفاده کنید enumerateMessagesEntryId برای دریافت تمام شناسه‌های پیام در یک پوشه. سپس می‌توانید به‌صورت انتخابی ویژگی‌ها، پیام‌ها یا پیوست‌ها را استخراج کنید.

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

ب) استخراج یک ویژگی منفرد

استفاده کنید 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();
}

ج) استخراج فقط پیوست‌ها

اگر فقط پیوست‌ها مورد نیاز است، از 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);
    }
}

در صورت امکان از روش‌های انبوه استفاده کنید

هر زمان که نیاز داشته باشید به افزودن یا حذف آیتم‌های متعدد، به‌جای عملیات‌های تک‌تک از روش‌های انبوه استفاده کنید. این کار بار پردازشی را کاهش داده و عملکرد را بهبود می‌بخشد.