Вступ
Aspose.Email FOSS для C++ — нова бібліотека з відкритим вихідним кодом для читання, створення та конвертації файлів Outlook MSG, повідомлень RFC 5322 EML та контейнерів Compound File Binary (CFB), на яких базується формат MSG. Вона написана на C++17, не має зовнішніх залежностей під час виконання і збирається на Linux, macOS та Windows за допомогою CMake — без залежності від COM і без платформо-специфічних шляхів коду.
Файли Outlook MSG постійно з’являються у роботі з корпоративною інтеграцією — архівні конвеєри, інструменти міграції, експорти для відповідності — але їх читання без самого Outlook зазвичай вимагало автоматизації COM у Windows або комерційної бібліотеки. Aspose.Email FOSS для 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 без спеціального accessor’а, 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 | ✓ | ✓ |
| Compound File Binary (CFB) | .cfb | ✓ | ✓ |
Відкритий код & ліцензування
Aspose.Email FOSS для C++ випущено під ліцензією MIT. Повний вихідний код доступний за адресою aspose-email-foss/Aspose.Email-FOSS-for-Cpp, і комерційне використання дозволено без роялті. Бібліотека не має залежностей під час виконання, окрім компілятора C++17 та CMake 3.26 або новішого.
