Увод

Rad sa Outlook MSG fajlovima u C++ tradicionalno je zahtevao Windows‑specifičnu COM automatizaciju ili teške biblioteke trećih strana sa restriktivnim licencama. Aspose.Email FOSS za C++ menja to: to je čista C++17 biblioteka bez eksternih zavisnosti, bez COM‑a i bez koda specifičnog za platformu. Izgrađuje se identično na Linuxu, macOS‑u i Windowsu.

Biblioteka je objavljena pod MIT licencom i distribuira se kao izvorni kod putem GitHub-a. Vi je integrišete kloniranjem repozitorijuma i dodavanjem kao CMake poddirektorijum — nije potrebna registracija menadžera paketa, i nije potrebno unapred izgraditi binarne fajlove.

Ovaj post prolazi kroz osnovni radni tok: čitanje postojećeg MSG fajla, pregled njegovih svojstava, programatsko kreiranje nove poruke i konverziju napred‑nazad između MSG i EML formata.

Ključne karakteristike

Čitanje postojećih MSG fajlova

Koristite msg_reader da otvorite .msg datoteku i msg_document da pristupite njenom strukturiranom sadržaju. Obe klase se nalaze u prostoru imena 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 takođe ima from_stream preopterećenje za čitanje iz std::istream, što je korisno u kontekstima na strani servera ili u pipeline‑u gde fajlovi nisu prisutni na disku.

Kreiranje poruka programatski

mapi_message::create proizvodi novu poruku u memoriji sa temom i telom.
Možete zatim postaviti detalje pošiljaoca, dodati primaoce i priložiti binarne ili tekstualne podatke pre nego što je sačuvate.

#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"));

Konvertuj MSG u EML

mapi_message podržava direktnu konverziju MSG u EML putem save_to_eml metode.
EML izlaz je u skladu sa RFC 5322 (MIME), što ga čini kompatibilnim sa bilo kojim standardnim
mail klijentom ili procesnim pipeline‑om.

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();

Učitaj iz EML

Obrnuti smer je podjednako jednostavan: load_from_eml čita EML fajl i proizvodi mapi_message u memoriji, koji se zatim može sačuvati nazad u MSG.

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

from_eml.save(std::filesystem::path("restored.msg"));

Pristup CFB na niskom nivou

Za napredne slučajeve upotrebe — kao što je čitanje sirovih MAPI svojstava koja nisu izložena
visokorazinskom API — cfb_reader pruža direktan pristup Compound File Binary kontejneru
koji je osnova MSG formata.

#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();

Brzi početak

Korak 1 — Klonirajte i dodajte kao poddirektorijum

git clone https://github.com/aspose-email-foss/Aspose.Email-FOSS-for-Cpp.git

U vašem projektu 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)

Korak 2 — Uključivanje i korišćenje

#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";
}

Korak 3 — Izgradnja

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Подржани формати

FormatEkstenzijaČitanjePisanje
MSG (Outlook Message).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Отворени извор и лиценцирање

Aspose.Email FOSS za C++ je objavljen pod MIT licencom.
Puni izvor je dostupan na GitHub-u na aspose-email-foss/Aspose.Email-FOSS-for-Cpp.
Komercijalna upotreba je dozvoljena bez tantijema.
Biblioteka nema runtime zavisnosti osim C++17 kompajlera i CMake 3.26 ili novijeg.

Početak