Wprowadzenie
Praca z plikami Outlook MSG w C++ historycznie wymagała wyłącznie automatyzacji COM dostępnej tylko w systemie Windows lub ciężkich bibliotek firm trzecich o restrykcyjnych licencjach. Aspose.Email FOSS dla C++ zmienia to: jest to czysta biblioteka C++17 bez zewnętrznych zależności, bez COM i bez kodu specyficznego dla platformy. Buduje się identycznie na Linuxie, macOS i Windows.
Biblioteka jest udostępniona na licencji MIT i dystrybuowana jako kod źródłowy przez GitHub. Integrujesz ją, klonując repozytorium i dodając je jako podkatalog CMake — nie jest wymagana rejestracja w menedżerze pakietów, ani nie trzeba wstępnie budować binarek.
Ten wpis przeprowadza przez podstawowy przebieg pracy: odczyt istniejącego pliku MSG, przeglądanie jego właściwości, programowe tworzenie nowej wiadomości oraz konwersję w obie strony między formatami MSG i EML.
Kluczowe funkcje
Odczyt istniejących plików MSG
Użyj msg_reader, aby otworzyć plik .msg i msg_document, aby uzyskać dostęp do jego strukturalnej zawartości. Obie klasy znajdują się w przestrzeni nazw aspose::email::foss::msg.
#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"));
auto document = aef::msg::msg_document::from_reader(reader);
msg_reader ma również przeciążenie from_stream do odczytu z std::istream, co jest przydatne w kontekstach po stronie serwera lub w pipeline, gdzie pliki nie są obecne na dysku.
Tworzenie wiadomości programowo
mapi_message::create tworzy nową wiadomość w pamięci z tematem i treścią. Następnie możesz ustawić dane nadawcy, dodać odbiorców oraz dołączyć binarne lub tekstowe ładunki przed zapisaniem.
#include "aspose/email/foss/msg/mapi_message.hpp"
namespace aef = aspose::email::foss;
auto msg = aef::msg::mapi_message::create(
"Quarterly status update",
"Hello team,\n\nPlease find the rollout summary attached.\n\nRegards");
msg.set_sender_name("Build Agent");
msg.set_sender_email_address("build.agent@example.com");
msg.add_recipient("alice@example.com", "Alice Example");
msg.save(std::filesystem::path("output.msg"));
Konwertuj MSG na EML
mapi_message obsługuje bezpośrednią konwersję MSG-to-EML za pomocą metody save_to_eml. Wyjście EML jest zgodne z RFC 5322 (MIME), co czyni je kompatybilnym z dowolnym standardowym klientem poczty lub pipeline przetwarzania.
auto loaded = aef::msg::mapi_message::from_file(
std::filesystem::path("message.msg"), /*strict=*/false);
// Save as EML to a file
loaded.save_to_eml(std::filesystem::path("message.eml"));
// Or capture as bytes
std::vector<std::uint8_t> eml_bytes = loaded.save_to_eml();
Ładuj z EML
Odwrotny kierunek jest równie prosty: load_from_eml odczytuje plik EML i tworzy mapi_message w pamięci, które następnie można zapisać z powrotem jako MSG.
auto from_eml = aef::msg::mapi_message::load_from_eml(
std::filesystem::path("message.eml"));
from_eml.save(std::filesystem::path("restored.msg"));
Niskopoziomowy dostęp do CFB
Dla zaawansowanych przypadków użycia — takich jak odczytywanie surowych właściwości MAPI nieudostępnianych przez wysokopoziomowy API — cfb_reader zapewnia bezpośredni dostęp do kontenera Compound File Binary, który leży u podstaw formatu MSG.
#include "aspose/email/foss/cfb/cfb_reader.hpp"
namespace aef = aspose::email::foss;
auto cfb = aef::cfb::cfb_reader::from_file(std::filesystem::path("message.msg"));
auto storage_ids = cfb.storage_ids();
auto stream_ids = cfb.stream_ids();
Szybki start
Krok 1 — Sklonuj i dodaj jako podkatalog
git clone https://github.com/aspose-email-foss/Aspose.Email-FOSS-for-Cpp.git
W swoim projekcie CMakeLists.txt:
cmake_minimum_required(VERSION 3.26)
project(my_project)
add_subdirectory(Aspose.Email-FOSS-for-Cpp)
add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE AsposeEmailFoss::AsposeEmailFoss)
Krok 2 — Dołącz i użyj
#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"
namespace aef = aspose::email::foss;
int main()
{
// Create a message
auto msg = aef::msg::mapi_message::create("Hello from C++", "Body text here");
msg.save(std::filesystem::path("hello.msg"));
// Round-trip to EML
auto loaded = aef::msg::mapi_message::from_file(
std::filesystem::path("hello.msg"), false);
loaded.save_to_eml(std::filesystem::path("hello.eml"));
std::cout << "Done\n";
}
Krok 3 — Zbuduj
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
Obsługiwane formaty
| Format | Rozszerzenie | Odczyt | Zapis |
|---|---|---|---|
| MSG (wiadomość Outlook) | .msg | ✓ | ✓ |
| EML (RFC 5322 / MIME) | .eml | ✓ | ✓ |
| CFB (Compound File Binary) | .msg, .cfb | ✓ | ✓ |
Open Source i licencjonowanie
Aspose.Email FOSS dla C++ jest udostępniony na licencji MIT. Pełne źródło jest dostępne na GitHub pod adresem aspose-email-foss/Aspose.Email-FOSS-for-Cpp. Komercyjne użycie jest dozwolone bez tantiem. Biblioteka nie ma zależności w czasie wykonywania poza kompilatorem C++17 i CMake 3.26 lub nowszym.
