Программирование с Thunderbird
Чтение сообщений
Mozilla Thunderbird — это открытый кроссплатформенный почтовый клиент, разработанный Mozilla Foundation. Он хранит электронные письма в собственной файловой структуре, управляя индексами сообщений и подпапками через проприетарные форматы файлов. Aspose.Email может работать со структурами хранилища почты Thunderbird. Класс MboxrdStorageReader позволяет разработчикам читать сообщения из файла хранилища почты Mozilla Thunderbird. В этой статье показано, как читать сообщения из хранилища почты Thunderbird:
- Откройте файл хранилища Thunderbird
- Создайте экземпляр класса MboxrdStorageReader и передайте вышеуказанный поток в конструктор.
- Вызовите read_next_message() для получения первого сообщения.
- Используйте тот же read_next_message() в цикле while, чтобы прочитать все сообщения.
- Закрыть все потоки.
Следующий фрагмент кода показывает, как прочитать все сообщения из хранилища почты Thunderbird.
Получение свойств сообщения
Чтобы читать и извлекать информацию из файла Mbox, Aspose.Email предоставляет MboxStorageReader класс для создания объекта чтения файла Mbox и MboxLoadOptions класс для загрузки файла. Следующие свойства MboxMessageInfo класс может использоваться для доступа и отображения конкретных деталей сообщения:
- ‘date’ - Получает дату сообщения.
- ‘from_address’ - Получает адрес отправителя.
- ‘subject’ — получает тему сообщения.
- ’to’ — получает коллекцию адресов, содержащую получателей сообщения.
- ‘cc’ — получает коллекцию адресов, содержащую получателей CC.
- ‘bcc’ — получает коллекцию адресов, содержащую получателей BCC сообщения.
Следующий пример кода демонстрирует использование этих свойств для чтения и извлечения информации о сообщениях из файла Mbox:
import aspose.email as ae
reader = ae.storage.mbox.MboxStorageReader.create_reader(file_name, ae.storage.mbox.MboxLoadOptions())
for mbox_message_info in reader.enumerate_message_info():
print(f"Subject: {mbox_message_info.subject}")
print(f"Date: {mbox_message_info.date}")
print(f"From: {mbox_message_info.from_address}")
print(f"To: {mbox_message_info.to}")
print(f"CC: {mbox_message_info.cc}")
print(f"Bcc: {mbox_message_info.bcc}")
Извлечение сообщений из MBOX по идентификаторам
Для чтения сообщений из файла MBOX Aspose.Email предоставляет метод ‘create_reader()’ класса MboxStorageReader класс для создания объекта чтения файла. Принимает имя файла и MboxLoadOptions в качестве аргументов, позволяя пользователю загружать файл MBOX с определёнными параметрами при необходимости.
Для извлечения сообщений используются следующие методы и свойства:
- метод ’enumerate_message_info()’ класса MboxStorageReader класс — перебирает каждое сообщение в файле MBOX.
- метод ’extract_message()’ класса MboxStorageReader класс — извлекает каждое сообщение по его Entry ID.
- свойство ’entry_id’ класса MboxMessageInfo класс — получает идентификатор записи.
Наконец, сообщение конвертируется в формат EML с помощью EmlLoadOptions.
Ниже приведён пример кода, показывающий использование этих возможностей для чтения и извлечения сообщений из файла MBOX:
import aspose.email as ae
reader = ae.storage.mbox.MboxStorageReader.create_reader("my.mbox", ae.storage.mbox.MboxLoadOptions())
for mbox_message_info in reader.enumerate_message_info():
eml = reader.extract_message(mbox_message_info.entry_id, ae.EmlLoadOptions())
Настройка параметров загрузки при чтении сообщений из MBOX
С Aspose.Email EmlLoadOptions класс, вы можете указать дополнительные параметры при загрузке MailMessage из формата Eml. Например, можно установить опцию сохранения вложений TNEF при загрузке EML‑файла с помощью свойства ‘preserve_tnef_attachments’ класса EmlLoadOptions класс.
Вы можете прочитать следующее письмо из файла mbox, используя указанные параметры загрузки, с помощью метода ‘read_next_message’ класса MboxStorageReader класс и конвертировать файл в формат PST с помощью метода ‘mbox_to_pst’ класса MailStorageConverter класс .
Приведённый ниже пример кода демонстрирует использование этих методов и свойств для работы с файлами хранилища почты, включая чтение сообщений из формата mbox, сохранение вложений TNEF и конвертацию сообщений из mbox в формат pst:
import aspose.email as ae
reader = ae.storage.mbox.MboxrdStorageReader(fileName, ae.storage.mbox.MboxLoadOptions())
# Read messages preserving tnef attachments.
load_options = ae.EmlLoadOptions()
load_options.preserve_tnef_attachments = True
eml = reader.read_next_message(load_options)
ae.storage.MailStorageConverter.MboxMessageOptions(load_options)
# Convert messages from mbox to pst preserving tnef attachments.
pst = ae.storage.MailStorageConverter.mbox_to_pst("Input.mbox", "Output.pst")
Установка предпочтительной кодировки текста при загрузке файлов Mbox для чтения
Вы можете указать кодировку текста, используемую при загрузке файла MBOX. Свойство ‘preferred_text_encoding’ доступно для MboxLoadOptions класс задаёт дополнительную опцию и гарантирует корректное чтение и обработку сообщения с закодированным содержимым.
Следующий фрагмент кода показывает, как использовать эту функцию в проекте:
import aspose.email as ae
load_options = ae.storage.mbox.MboxLoadOptions()
load_options.preferred_text_encoding = 'utf-8'
reader = ae.storage.mbox.MboxrdStorageReader("sample.mbox", load_options)
message = reader.read_next_message()
Конвертация MBOX в PST с сохранением или удалением подписи
Чтобы удалить подпись из файла во время процесса конвертации, установите свойство MboxToPstConversionOptions.remove_signature в значение true.
Следующий пример кода демонстрирует, как использовать это свойство:
import aspose.email as ae
personalStorage = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)
conversion_options = ae.storage.MboxToPstConversionOptions()
conversion_options.remove_signature = True
ae.storage.MailStorageConverter.mbox_to_pst( ae.storage.mbox.MboxrdStorageReader("source.mbox", ae.storage.mbox.MboxLoadOptions()), personalStorage, "Inbox", conversion_options)
Запись сообщений
Класс MboxrdStorageWriter предоставляет возможность записывать новые сообщения в файл хранилища почты Thunderbird. Чтобы записать сообщения:
- Откройте файл хранилища Thunderbird в FileStream.
- Создайте экземпляр класса MboxrdStorageWriter и передайте вышеуказанный поток в конструктор.
- Подготовьте новое сообщение с помощью класса MailMessage.
- Вызовите метод write_message() и передайте вышеуказанный экземпляр MailMessage, чтобы добавить сообщение в хранилище Thunderbird.
- Закрыть все потоки.
Следующий фрагмент кода показывает, как записывать сообщения в хранилище почты Thunderbird.
Получение общего количества сообщений из файла MBox
Класс MboxrdStorageReader предоставляет возможность считывать количество доступных элементов в файле MBox. Это можно использовать для разработки приложений, показывающих прогресс выполнения при обработке такого файла.