Úvodní článek

Práce s soubory Outlook MSG v C++ historicky vyžadovala automatizaci COM pouze pro Windows nebo těžkopádné knihovny třetích stran se omezujícími licencemi. Aspose.Email FOSS pro C ++ mění to: je to čistá kněžka C + 17 bez externích závislostí, žádných COM a žádný kód specifický pro platformu. Staví se identicky na Linuxu, macOSu a Windowsu.

Knihovna je vydána pod licencí MIT a distribuována jako zdroj přes GitHub. Integrace se provádí klonováním úložiště a přidáváním jej do podspolečnosti CMake není zapotřebí registrace správce balíčků, ani nejsou nutná předem vytvořená binární soubory.

Tento příspěvek prochází hlavním pracovním postupem: čtením existujícího souboru MSG, kontrolou jeho vlastností, programově vytvářením nové zprávy a přepínáním mezi formáty MS G a EML.

Klíčové prvky

Číst existující soubory MSG

Použití: msg_reader otevřít .msg soubor a msg_document přístup k jeho strukturovanému obsahu. Obě třídy žijí v aspose::email::foss::msg namespace (prostor jmen).

#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 má také from_stream přetížení pro čtení z std::istream, což je užitečné v kontextech na straně serveru nebo pipeline, kde soubory nejsou přítomny na disku.

Programované vytváření zpráv

mapi_message::create Vytvoří nové vzpomínkové zprávy s předmětem a tělem. může nastavit odesílače podrobnosti, přidat příjemce a připojit binární nebo textové užitečné zatížení před - Ušetřovat.

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

Konverze MSG na EML

mapi_message podporuje přímé převodování MSG na EML prostřednictvím save_to_eml metody. EML výstup odpovídá RFC 5322 (MIME), což je kompatibilní s jakýmkoli standardním poštovním odesláním. klientem nebo zpracovatelem.

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

Zátěž z EML

Obrácený směr je stejně jednoduchý: load_from_eml čte soubor EML a produkuje mapi_message v paměti, která se pak může uložit zpět do MSG.

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

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

Přístup k CFB nízké úrovně

Pro pokročilé případy použití jako je čtení surových vlastností MAPI, které nejsou odhaleny pomocí API na vysoké úrovni cfb_reader poskytuje přímý přístup k kontejneru Kompound File Binary které jsou základem formátu 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();

Rychlý start

Krok 1 Klonování a přidávání jako podrozkaz

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

Ve 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)

Krok 2 Zahrnout a použít

#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 Vybudovat

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

Podporované formáty

FormátRozšířeníČtěte.Píšeš.
MSG (poselství s výhledem).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (kompound file binary).msg, .cfb✓✓

Open Source & Licence

Aspose.Email FOSS for C++ is released under the MIT license. The full source is available na GitHub: Aspose-email-foss/Aspose.Email-FOSS-for-Cpp (Přístupní číslo). Komerční použití je povoleno bez poplatků. Knihovna nemá žádné závislosti na běžném čase nad rámec kompilátoru C++17 a CMake 3.26 nebo novější.

Jak začít?