Uvod u članak

Rad s Outlook MSG datotekama u C++ je povijesno zahtijevao Windows-only COM automatizaciju ili teške biblioteke trećih strana sa ograničavajućim licencama. Aspose.Email FOSS za C ++ mijenja to: to je čista knjižnica C + 17 bez vanjskih ovisnosti, bez COM i bez specifičnog koda platforme. Izgradi se identično na Linuxu, macOS-u i Windowsu.

Biblioteka je objavljena pod licencom MIT-a i distribuirana kao izvor putem GitHuba. Integrirate ga kloniranjem repozitorija i dodavanjem u CMake podsporodice ne zahtijeva se registracija menadžera paketa, a ni binarne datoteke nisu potrebne za unaprijed izgradnju.

Ovaj post vodi kroz osnovni tok rada: čitanje postojeće MSG datoteke, pregledanje njenih svojstava, programsko stvaranje nove poruke i kretanje između MS G-a i EML formata.

Glavne karakteristike

Čitanje postojećih MSG datoteka

Upotreba: msg_reader Otvoriti .msg datoteke i msg_document pristupiti strukturiranom sadržaju. Oba razreda žive u aspose::email::foss::msg prostor imena.

#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 i from_stream Preopterećenje za čitanje iz std::istream, koji je koristan u serverskim ili pipeline kontekstu gdje datoteke nisu prisutne na disku.

Programirano kreiranje poruka

mapi_message::create Proizvodi novu poruku u memoriji s predmetom i telom. zatim može postaviti podatke pošiljatelja, dodati primatelje i priložiti binarne ili tekst korisne opterećenja prije nego što je -Spašavanje.

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

Preobraziti MSG u EML

mapi_message U tom smislu, Komisija je zaključila da se u skladu s člankom 20. stavkom 1. točkom (a) Uredbe (EU) br. 1306/2013 ne može primjenjivati: save_to_eml metoda. EML izlaz je u skladu s RFC 5322 (MIME), što ga čini kompatibilnim sa bilo kojim standardnim poštom. U slučaju da je to moguće, mora se provesti proces.

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

Uređaj za prevoz i prijevoz u skladu s člankom 7. stavkom 1.

Obrnuto je isto tako jednostavno: load_from_eml čita EML datoteku i proizvodi mapi_message u memoriju, koja se zatim može spasiti natrag na 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-u niske razine

Za napredne slučajeve upotrebe kao što je čitanje sirovih svojstava MAPI-a koje nisu izložene u Srednja razina: cfb_reader daje direktan pristup konteineru Compound File Binary koji podupire MSG format.

#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 Kloniranje i dodavanje 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čiti i koristiti

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

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

Podržani formati

Format:ProstranjenjeČitaj.Pišite.
MSG (poruka iz perspektive).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (kompound file binary).msg, .cfb✓✓

Otvoreni izvor i licenciranje

Aspose.Email FOSS for C++ is released under the MIT license. The full source is available na GitHub-u u: Sljedeći članakSlužbenici i službenicima. Komercijalna upotreba je dozvoljena bez autorskih naknada. Biblioteka nema ovisnosti o vremenu pokretanja Ako je to moguće, podnosite zahtjev za primjenu ili odlaganje.

Početak