Εισαγωγή

Η εργασία με αρχεία Outlook MSG σε C++ απαιτούσε ιστορικά Windows-only COM αυτοματοποίηση
ή βαριές βιβλιοθήκες τρίτων με περιοριστικές άδειες. Το Aspose.Email FOSS για C++
αλλάζει αυτό: είναι μια καθαρή βιβλιοθήκη C++17 χωρίς εξωτερικές εξαρτήσεις, χωρίς COM, και χωρίς
κώδικα ειδικό για πλατφόρμα. Κατασκευάζεται ταυτόσημα σε Linux, macOS και Windows.

Η βιβλιοθήκη κυκλοφορεί υπό την άδεια MIT και διανέμεται ως πηγαίος κώδικας μέσω του GitHub. Την ενσωματώνετε κλωνοποιώντας το αποθετήριο και προσθέτοντάς το ως υποκατάλογο CMake — δεν απαιτείται καταχώριση σε διαχειριστή πακέτων και δεν χρειάζεται να προ-χτιστούν τα δυαδικά αρχεία.

Αυτή η ανάρτηση περιγράφει τη βασική ροή εργασίας: ανάγνωση ενός υπάρχοντος αρχείου MSG, επιθεώρηση των ιδιοτήτων του, δημιουργία νέου μηνύματος προγραμματιστικά και round‑tripping μεταξύ των μορφών MSG και EML.

Βασικά χαρακτηριστικά

Διαβάστε υπάρχοντα αρχεία MSG

Χρησιμοποιήστε msg_reader για να ανοίξετε ένα αρχείο .msg και msg_document για να έχετε πρόσβαση στο δομημένο περιεχόμενό του.
Και οι δύο κλάσεις βρίσκονται στον χώρο ονομάτων 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 επίσης έχει μια from_stream υπερφόρτωση για ανάγνωση από ένα std::istream, η οποία είναι χρήσιμη σε server-side ή pipeline περιβάλλοντα όπου τα αρχεία δεν υπάρχουν στον δίσκο.

Δημιουργία μηνυμάτων προγραμματιστικά

mapi_message::create δημιουργεί ένα νέο μήνυμα στη μνήμη με θέμα και σώμα. Μπορείτε
να ορίσετε τα στοιχεία αποστολέα, να προσθέσετε παραλήπτες και να επισυνάψετε δυαδικά ή κειμενικά δεδομένα πριν
αποθήκευσης.

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

Μετατροπή MSG σε EML

mapi_message υποστηρίζει άμεση μετατροπή MSG σε EML μέσω της save_to_eml μεθόδου.
Η έξοδος EML συμμορφώνεται με το RFC 5322 (MIME), καθιστώντας την συμβατή με οποιονδήποτε τυπικό πελάτη αλληλογραφίας
ή pipeline επεξεργασίας.

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

Φόρτωση από EML

Η αντίστροφη κατεύθυνση είναι εξίσου απλή: load_from_eml διαβάζει ένα αρχείο EML και παράγει ένα mapi_message στη μνήμη, το οποίο μπορεί στη συνέχεια να αποθηκευτεί ξανά σε MSG.

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

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

Πρόσβαση χαμηλού επιπέδου CFB

Για προχωρημένες περιπτώσεις χρήσης — όπως η ανάγνωση ακατέργαστων ιδιοτήτων MAPI που δεν εκτίθενται από το υψηλού επιπέδου API — cfb_reader παρέχει άμεση πρόσβαση στο Compound File Binary container που υποστηρίζει τη μορφή 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();

Γρήγορη εκκίνηση

Βήμα 1 — Κλωνοποίηση και προσθήκη ως υποκατάλογος

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

Στο έργο σας 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)

Βήμα 2 — Συμπερίληψη και χρήση

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

Βήμα 3 — Κατασκευή

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

Υποστηριζόμενες μορφές

ΜορφήΕπέκτασηΑνάγνωσηΕγγραφή
MSG (Outlook Message).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Ανοιχτός Κώδικας & Αδειοδότηση

Το Aspose.Email FOSS για C++ κυκλοφορεί υπό την άδεια MIT. Ο πλήρης κώδικας είναι διαθέσιμος στο GitHub στη διεύθυνση aspose-email-foss/Aspose.Email-FOSS-for-Cpp. Η εμπορική χρήση επιτρέπεται χωρίς δικαιώματα royalty. Η βιβλιοθήκη δεν έχει εξαρτήσεις χρόνου εκτέλεσης πέραν ενός μεταγλωττιστή C++17 και του CMake 3.26 ή νεότερου.

Ξεκινώντας