Uvod

Rad s Outlook MSG datotekama u C++ tradicionalno je zahtijevao Windows‑specifičnu COM automatizaciju
ili teške biblioteke trećih strana s restriktivnim licencama. Aspose.Email FOSS za C++
mijenja to: to je čista C++17 biblioteka bez vanjskih ovisnosti, bez COM‑a i bez
kôda specifičnog za platformu. Izgrađuje se identično na Linuxu, macOS‑u i Windowsu.

Biblioteka je objavljena pod MIT licencom i distribuirana kao izvor putem GitHub-a. Integrirate je kloniranjem repozitorija i dodavanjem kao CMake poddirektorij — nije potrebna registracija u upravitelju paketa, niti je potrebno unaprijed izgraditi binarne datoteke.

Ovaj post prolazi kroz osnovni tijek rada: čitanje postojeće MSG datoteke, pregledavanje njezinih svojstava, programatsko stvaranje nove poruke i povratno pretvaranje između MSG i EML formata.

Ključne značajke

Čitanje postojećih MSG datoteka

Koristite msg_reader za otvaranje .msg datoteke i msg_document za pristup njenom strukturiranom sadržaju.
Obje klase nalaze se 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đer ima from_stream preopterećenje za čitanje iz std::istream, što je korisno u kontekstima na strani poslužitelja ili cjevovoda gdje datoteke nisu prisutne na disku.

Kreirajte poruke programatski

mapi_message::create stvara novu poruku u memoriji s predmetom i tijelom.
Možete zatim postaviti podatke pošiljatelja, dodati primatelje i priložiti binarne ili tekstualne podatke prije spremanja.

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

Pretvori MSG u EML

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

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 smjer je podjednako jednostavan: load_from_eml čita EML datoteku i proizvodi mapi_message u memoriji, koja se zatim može spremiti natrag 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"));

Niskorazinski pristup CFB

Za napredne slučajeve upotrebe — poput čitanja sirovih MAPI svojstava koja nisu izložena visokorazinskom API‑ju — cfb_reader daje izravan pristup Compound File Binary kontejneru koji je temelj formata 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();

Brzi početak

Korak 1 — Kloniraj i dodaj kao poddirektorij

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štenje

#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

Podržani formati

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

Open Source i licenciranje

Aspose.Email FOSS za C++ objavljen je pod MIT licencom. Cijeli izvor je dostupan na GitHubu na aspose-email-foss/Aspose.Email-FOSS-for-Cpp. Komercijalna upotreba je dopuštena bez tantijema. Biblioteka nema runtime ovisnosti osim C++17 kompajlera i CMake 3.26 ili novijeg.

Početak