Введение

Aspose.Email FOSS for C++ является новой библиотекой с открытым исходным кодом для чтения, создания и конвертации файлов Outlook MSG, сообщений RFC 5322 EML и контейнеров Compound File Binary (CFB), на которых построен формат MSG. Она написана на C++17, не имеет внешних runtime-зависимостей и собирается на Linux, macOS и Windows с помощью CMake — без зависимости от COM и без платформо-специфичных путей кода.

Файлы Outlook MSG постоянно встречаются в работе по интеграции предприятий — архивные конвейеры, инструменты миграции, экспорты для соответствия требованиям — но их чтение без самого Outlook обычно требовало автоматизации COM в Windows или коммерческой библиотеки. Aspose.Email FOSS for C++ предоставляет вам переносимую альтернативу: высокоуровневый класс mapi_message для повседневного чтения и создания сообщений, а также низкоуровневые классы msg_reader, msg_document и cfb_reader для прямого доступа к базовому формату контейнера, когда это необходимо.

Библиотека распространяется в виде исходного кода C++17 под лицензией MIT и добавляется в проект как подкаталог CMake, раскрывая цель AsposeEmailFoss — регистрация в менеджере пакетов и предварительно собранные бинарные файлы не требуются.

Ключевые возможности

Чтение файлов Outlook MSG

Откройте файл .msg с помощью msg_reader::from_file() или msg_reader::from_stream(). Чтобы получить прямой доступ к хранилищам и потокам сообщения, оберните считыватель в msg_document с msg_document::from_reader().

#include "aspose/email/foss/msg/msg_reader.hpp"
#include "aspose/email/foss/msg/msg_document.hpp"
#include <filesystem>

namespace aef = aspose::email::foss;

auto reader = aef::msg::msg_reader::from_file(
    std::filesystem::path("message.msg"), /*strict=*/false);
auto document = aef::msg::msg_document::from_reader(reader);

Создавать сообщения программно

mapi_message::create() создает новое сообщение в памяти из темы и тела. Установите отправителя, добавьте получателей и прикрепите двоичные или текстовые данные перед сохранением с помощью save().

#include "aspose/email/foss/msg/mapi_message.hpp"
#include <filesystem>

namespace aef = aspose::email::foss;

auto message = aef::msg::mapi_message::create(
    "Quarterly status update", "Hello team,\n\nRollout summary attached.");
message.set_sender_name("Build Agent");
message.set_sender_email_address("build.agent@example.com");
message.add_recipient("alice@example.com", "Alice Example");
message.add_recipient("carol@example.com", "Carol Example",
    aef::msg::mapi_message::recipient_type_cc);
message.add_attachment("report.txt", std::vector<std::uint8_t>{'o', 'k'}, "text/plain");
message.save(std::filesystem::path("output.msg"));

Преобразование между MSG и EML

mapi_message::save_to_eml() записывает текущее сообщение в виде файла EML по RFC 5322, а mapi_message::load_from_eml() считывает его обратно. Оба направления сохраняют тему, отправителя, получателей и вложения, поэтому сообщение может перемещаться между MSG и EML без Outlook.

auto message = aef::msg::mapi_message::from_file(
    std::filesystem::path("message.msg"), /*strict=*/false);
message.save_to_eml(std::filesystem::path("message.eml"));

auto restored = aef::msg::mapi_message::load_from_eml(std::filesystem::path("message.eml"));
restored.save(std::filesystem::path("restored.msg"));

Просмотр свойств сообщения и вложений

Загруженный mapi_message напрямую раскрывает свои стандартные поля заголовка — subject(), sender_name(), sender_email_address(), message_class() и internet_message_id() — а также recipients() и attachments() в виде векторов mapi_recipient и mapi_attachment. Для полей MAPI без отдельного аксессора get_property_value() считывает любое свойство по его common_message_property_id и property_type_code.

#include "aspose/email/foss/msg/mapi_message.hpp"
#include "aspose/email/foss/msg/common_message_property_id.hpp"
#include "aspose/email/foss/msg/property_type_code.hpp"
#include <iostream>

namespace aef = aspose::email::foss;

template <typename E>
constexpr auto to_underlying(E value) noexcept {
    return static_cast<std::underlying_type_t<E>>(value);
}

auto message = aef::msg::mapi_message::from_file(
    std::filesystem::path("message.msg"), /*strict=*/false);

std::cout << "Subject: " << message.subject() << '\n';
std::cout << "From: " << message.sender_name()
           << " <" << message.sender_email_address() << ">\n";
std::cout << "Recipients: " << message.recipients().size() << '\n';

for (const auto& attachment : message.attachments()) {
    std::cout << "- " << attachment.filename
               << " (" << attachment.mime_type << ", "
               << attachment.data.size() << " bytes)\n";
}

const auto display_cc = message.get_property_value(
    to_underlying(aef::msg::common_message_property_id::display_cc),
    to_underlying(aef::msg::property_type_code::ptyp_string));

Низкоуровневый доступ к контейнеру CFB

Файлы MSG хранятся внутри контейнера Compound File Binary (CFB) — формата структурированного хранилища, также используемого устаревшими двоичными форматами Office. cfb_reader открывает сырой контейнер и напрямую раскрывает его дерево каталогов: storage_ids() и stream_ids() перечисляют все записи, directory_entry_count() сообщает общее количество, а header() возвращает схему секторов контейнера. Это полезно, когда нужны данные MAPI, которые mapi_message API не выводит.

#include "aspose/email/foss/cfb/cfb_reader.hpp"
#include <iostream>

namespace aef = aspose::email::foss;

auto cfb = aef::cfb::cfb_reader::from_file(std::filesystem::path("message.msg"));
std::cout << "Directory entries: " << cfb.directory_entry_count() << '\n';
std::cout << "Storages: " << cfb.storage_ids().size() << '\n';
std::cout << "Streams: " << cfb.stream_ids().size() << '\n';

Быстрый старт

Добавьте библиотеку в ваш проект:

git clone https://github.com/aspose-email-foss/Aspose.Email-FOSS-for-Cpp.git
# CMakeLists.txt
add_subdirectory(Aspose.Email-FOSS-for-Cpp)
target_link_libraries(your_target PRIVATE AsposeEmailFoss::AsposeEmailFoss)

Затем создайте сообщение, сохраните его как MSG и выполните обратную конвертацию в EML:

#include "aspose/email/foss/msg/mapi_message.hpp"
#include <filesystem>
#include <vector>
#include <cstdint>

namespace aef = aspose::email::foss;

int main() {
    auto message = aef::msg::mapi_message::create("Hello from C++", "Body text here");
    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");
    message.save(std::filesystem::path("hello.msg"));

    auto loaded = aef::msg::mapi_message::from_file(
        std::filesystem::path("hello.msg"), /*strict=*/false);
    loaded.save_to_eml(std::filesystem::path("hello.eml"));

    return 0;
}

Поддерживаемые форматы

ФорматРасширениеЧтениеЗапись
Сообщение Outlook (MSG).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
Составной бинарный файл (CFB).cfb✓✓

Открытый исходный код и лицензирование

Aspose.Email FOSS for C++ выпущен под лицензией MIT. Полный исходный код доступен по адресу aspose-email-foss/Aspose.Email-FOSS-for-Cpp, и коммерческое использование разрешено без роялти. Библиотека не имеет runtime-зависимостей, кроме компилятора C++17 и CMake 3.26 или новее.

Начало работы

Связанные ресурсы