1. Продукты
  2.   Aspose.Email
  3.   Aspose.Email FOSS for C++

Aspose.Email FOSS для C++

Чтение, создание и обработка файлов Outlook MSG и контейнеров CFB из C++ — бесплатно и с открытым исходным кодом, без зависимости от Microsoft Outlook.

Aspose.Email FOSS for C++ Aspose.Email FOSS
for C++

Документация GitHub

Открытая C++ библиотека для файлов MSG и CFB

Aspose.Email FOSS для C++ — это библиотека с лицензией MIT, open-source, предназначенная для работы с файлами .msg Microsoft Outlook и контейнерами Compound File Binary (CFB). Подключите заголовки через CMake и сразу начните читать, создавать и обрабатывать электронные сообщения без установки Microsoft Outlook или какого‑либо проприетарного runtime.

Библиотека предоставляет два уровня доступа. На низком уровне cfb_reader и cfb_writer дают полный контроль над бинарными контейнерами CFB — обход записей каталога, чтение и запись узлов хранилища и данных потоков, а также просмотр сырой раскладки секторов. msg_reader и msg_writer обрабатывают формат MSG поверх CFB, предоставляя потоки свойств MAPI, таблицы получателей и подхранилища вложений. На высоком уровне mapi_message позволяет создавать новые сообщения с нуля, читать темы, тела, получателей и вложения, а также конвертировать между форматами MSG и EML. Библиотека работает на любой платформе с компилятором C++17 и не имеет внешних зависимостей, что делает её подходящей для Windows, Linux, macOS, Docker‑контейнеров и встроенных систем. Корпоративная версия с дополнительными функциями предлагается как Aspose.Email for C++.

Чтение и запись контейнеров CFB

  • Open CFB files: Загрузите существующие CFB‑контейнеры из пути к файлу, потока или массива байтов с помощью cfb_reader::from_file(), cfb_reader::from_stream() или cfb_reader::from_bytes().
  • Обойти дерево каталогов: Перечислять хранилища и потоки с помощью storage_ids(), stream_ids() и child_ids(), а также перемещаться по вложенным иерархиям с помощью resolve_path().
  • Проверка узлов: Проверьте тип узла с помощью cfb_node::is_storage() и cfb_node::is_stream(), прочитайте метки времени через creation_time() и modified_time().
  • Создание CFB контейнеров: Создавайте CFB‑документы программно с помощью cfb_document и сериализуйте их в массив байтов или файл с помощью cfb_writer::to_bytes() или cfb_writer::write_file().

Где используется доступ к CFB

  • MSG file inspection: CFB — это формат контейнера для файлов Outlook .msg — прямой доступ к CFB позволяет проводить судебно‑экспертную проверку и ремонт.
  • Custom binary formats: Любое устаревшее приложение, использующее CFB для хранения данных, может быть прочитано или записано без зависимости от COM.
  • Восстановление данных: Обойдите полное дерево каталогов и извлеките необработанные байты потоков из повреждённых или нестандартных файлов CFB.

Чтение и запись файлов MSG

  • Read MSG files: Откройте файлы Outlook MSG с помощью msg_reader::from_file() или msg_reader::from_stream() и получите доступ к базовым потокам свойств MAPI и вложенным подхранилищам.
  • Создавайте MSG‑файлы: Получайте MSG‑файлы из msg_document с помощью msg_writer::to_bytes() или msg_writer::write_file().
  • Проверка документа MSG: Доступ к метаданным версии через msg_document::major_version(), msg_document::minor_version(), и проверка строгого режима с помощью msg_document::strict().
  • Преобразовать в CFB: Извлеките базовый документ CFB из файла MSG с помощью msg_document::to_cfb_document().

Где используется обработка MSG

  • Email archival pipelines: Массово считывайте файлы .msg из каталогов архива и извлекайте метаданные или вложения.
  • Инструменты миграции: Преобразуйте коллекции MSG в стандартные форматы для импорта в системы, не являющиеся Outlook.
  • Юридическое раскрытие: Разобрать необработанные потоки свойств MAPI, чтобы извлечь все поля сообщения, включая нестандартные свойства.

Высокоуровневый API сообщений MAPI

  • Создать сообщения: Создайте полное электронное письмо с mapi_message::create(), затем задайте тему, тело и HTML тело через set_subject(), set_body() и set_html_body().
  • Установить детали отправителя: Настройте set_sender_name(), set_sender_email_address() и set_sender_address_type() для исходящего сообщения.
  • Управление вложениями: Загружайте вложения из байтов или потоков с помощью mapi_attachment::from_bytes() и mapi_attachment::from_stream(), а также проверяйте наличие вложенных сообщений через is_embedded_message().
  • Сохранить и перезагрузить: Сериализуйте с помощью mapi_message::save() и перезагрузите с помощью mapi_message::from_file() или mapi_message::from_stream().

Где используется высокоуровневый API

  • Автоматическое создание электронных писем: Создавайте тысячи персонализированных MSG файлов из записей данных в пакетных заданиях.
  • Создание тестовой фикстуры: Создавайте корректные MSG‑файлы с предсказуемым содержимым для наборов интеграционных тестов.
  • Извлечение вложений: Загрузите файл MSG, пройдитесь по вложениям и сохраните каждое на диск.

Преобразование EML и MIME

  • Load EML into mapi_message: Разберите стандартный файл .eml (RFC 5322 / MIME) в полноценный объект mapi_message через mapi_message::load_from_eml().
  • Сохранить mapi_message как EML: Сериализуйте mapi_message обратно в формат MIME с помощью save_to_eml().
  • Точность при обратных преобразованиях: Тема, тело, отправитель, получатели и вложения сохраняются при переходе от EML к MSG и обратно к EML.

Где используется конвертация EML

  • Format bridging: Получайте электронные письма в формате EML с почтовых серверов и конвертируйте их в MSG для хранения, совместимого с Outlook.
  • Соответствие стандартам: Конвертировать проприетарные файлы MSG в стандартный MIME для доставки в любой почтовый транспорт.
  • Нормализация архивов: Привести смешанный архив файлов .eml и .msg к единому формату.

Чтение темы из файла MSG

Откройте файл Outlook MSG из потока и выведите тему — не требуется Microsoft Outlook.

#include <fstream>
#include <iostream>

#include "aspose/email/foss/msg/mapi_message.hpp"

int main()
{
    std::ifstream input("sample.msg", std::ios::binary);
    auto message = aspose::email::foss::msg::mapi_message::from_stream(input);
    std::cout << message.subject() << '\n';
}

Создание и сохранение сообщения MSG

Создайте полное электронное письмо с отправителем, получателем и вложением, затем запишите его в форматы MSG и EML.

#include <fstream>

#include "aspose/email/foss/msg/mapi_message.hpp"

int main()
{
    auto message = aspose::email::foss::msg::mapi_message::create("Hello", "Body");
    message.set_sender_name("Alice");
    message.set_sender_email_address("alice@example.com");
    message.add_recipient("bob@example.com", "Bob");
    message.add_attachment("note.txt", std::vector<std::uint8_t>{'a', 'b', 'c'}, "text/plain");

    std::ofstream msg_output("hello.msg", std::ios::binary);
    message.save(msg_output);

    std::ofstream eml_output("hello.eml", std::ios::binary);
    message.save_to_eml(eml_output);
}
  

Ресурсы поддержки и обучения

 Русский