Pendahuluan

Aspose.Email FOSS untuk C++ adalah perpustakaan open-source baru untuk membaca, membuat, dan mengonversi file Outlook MSG, pesan RFC 5322 EML, serta kontainer Compound File Binary (CFB) yang menjadi dasar format MSG. Perpustakaan ini ditulis dalam C++17, tidak memiliki dependensi runtime eksternal, dan dapat dibangun di Linux, macOS, dan Windows melalui CMake — tidak ada dependensi COM dan tidak ada jalur kode spesifik platform.

File Outlook MSG muncul terus-menerus dalam pekerjaan integrasi perusahaan — pipeline arsip, alat migrasi, ekspor kepatuhan — tetapi membaca mereka tanpa Outlook biasanya memerlukan otomasi COM di Windows atau perpustakaan komersial. Aspose.Email FOSS untuk C++ memberi Anda alternatif portabel: kelas mapi_message tingkat tinggi untuk pembacaan dan pembuatan pesan sehari-hari, plus kelas msg_reader, msg_document, dan cfb_reader tingkat lebih rendah untuk akses langsung ke format kontainer yang mendasarinya bila Anda membutuhkannya.

Perpustakaan ini didistribusikan sebagai sumber C++17 di bawah lisensi MIT dan ditambahkan ke proyek sebagai subdirektori CMake, mengekspos target AsposeEmailFoss — tidak diperlukan pendaftaran manajer paket dan tidak ada binari pra-bangun.

Fitur Utama

Baca File Outlook MSG

Buka file .msg dengan msg_reader::from_file() atau msg_reader::from_stream(). Untuk mengakses penyimpanan dan aliran pesan secara langsung, balut pembaca dalam msg_document dengan msg_document::from_reader().

#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"), /*strict=*/false);
auto document = aef::msg::msg_document::from_reader(reader);

Buat Pesan Secara Programatis

mapi_message::create() membuat pesan baru di memori dari subjek dan isi. Atur pengirim, tambahkan penerima, dan lampirkan payload biner atau teks sebelum menyimpan dengan save().

#include "aspose/email/foss/msg/mapi_message.hpp"
#include <filesystem>

namespace aef = aspose::email::foss;

auto message = aef::msg::mapi_message::create(
    "Quarterly status update", "Hello team,\n\nRollout summary attached.");
message.set_sender_name("Build Agent");
message.set_sender_email_address("build.agent@example.com");
message.add_recipient("alice@example.com", "Alice Example");
message.add_recipient("carol@example.com", "Carol Example",
    aef::msg::mapi_message::recipient_type_cc);
message.add_attachment("report.txt", std::vector<std::uint8_t>{'o', 'k'}, "text/plain");
message.save(std::filesystem::path("output.msg"));

Konversi Antara MSG dan EML

mapi_message::save_to_eml() menulis pesan saat ini sebagai file EML RFC 5322, dan mapi_message::load_from_eml() membacanya kembali. Kedua arah mempertahankan subjek, pengirim, penerima, dan lampiran, sehingga pesan dapat berpindah antara MSG dan EML tanpa Outlook.

auto message = aef::msg::mapi_message::from_file(
    std::filesystem::path("message.msg"), /*strict=*/false);
message.save_to_eml(std::filesystem::path("message.eml"));

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

Periksa Properti Pesan dan Lampiran

Sebuah mapi_message yang dimuat mengekspos bidang header standar secara langsung — subject(), sender_name(), sender_email_address(), message_class(), dan internet_message_id() — serta recipients() dan attachments() sebagai vektor mapi_recipient dan mapi_attachment. Untuk bidang MAPI yang tidak memiliki accessor khusus, get_property_value() membaca properti apa pun berdasarkan common_message_property_id dan property_type_code.

#include "aspose/email/foss/msg/mapi_message.hpp"
#include "aspose/email/foss/msg/common_message_property_id.hpp"
#include "aspose/email/foss/msg/property_type_code.hpp"
#include <iostream>

namespace aef = aspose::email::foss;

template <typename E>
constexpr auto to_underlying(E value) noexcept {
    return static_cast<std::underlying_type_t<E>>(value);
}

auto message = aef::msg::mapi_message::from_file(
    std::filesystem::path("message.msg"), /*strict=*/false);

std::cout << "Subject: " << message.subject() << '\n';
std::cout << "From: " << message.sender_name()
           << " <" << message.sender_email_address() << ">\n";
std::cout << "Recipients: " << message.recipients().size() << '\n';

for (const auto& attachment : message.attachments()) {
    std::cout << "- " << attachment.filename
               << " (" << attachment.mime_type << ", "
               << attachment.data.size() << " bytes)\n";
}

const auto display_cc = message.get_property_value(
    to_underlying(aef::msg::common_message_property_id::display_cc),
    to_underlying(aef::msg::property_type_code::ptyp_string));

Akses Kontainer CFB Tingkat Rendah

File MSG disimpan di dalam kontainer Compound File Binary (CFB) — format structured-storage yang juga digunakan oleh format biner Office lama. cfb_reader membuka kontainer mentah dan mengekspos pohon direktori secara langsung: storage_ids() dan stream_ids() mencantumkan setiap entri, directory_entry_count() melaporkan totalnya, dan header() mengembalikan tata letak sektor kontainer. Ini berguna ketika Anda membutuhkan data MAPI yang tidak ditampilkan oleh mapi_message API.

#include "aspose/email/foss/cfb/cfb_reader.hpp"
#include <iostream>

namespace aef = aspose::email::foss;

auto cfb = aef::cfb::cfb_reader::from_file(std::filesystem::path("message.msg"));
std::cout << "Directory entries: " << cfb.directory_entry_count() << '\n';
std::cout << "Storages: " << cfb.storage_ids().size() << '\n';
std::cout << "Streams: " << cfb.stream_ids().size() << '\n';

Panduan Cepat

Tambahkan pustaka ke proyek Anda:

git clone https://github.com/aspose-email-foss/Aspose.Email-FOSS-for-Cpp.git
# CMakeLists.txt
add_subdirectory(Aspose.Email-FOSS-for-Cpp)
target_link_libraries(your_target PRIVATE AsposeEmailFoss::AsposeEmailFoss)

Kemudian buat pesan, simpan sebagai MSG, dan lakukan round-trip ke EML:

#include "aspose/email/foss/msg/mapi_message.hpp"
#include <filesystem>
#include <vector>
#include <cstdint>

namespace aef = aspose::email::foss;

int main() {
    auto message = aef::msg::mapi_message::create("Hello from C++", "Body text here");
    message.set_sender_name("Alice");
    message.set_sender_email_address("alice@example.com");
    message.add_recipient("bob@example.com", "Bob");
    message.add_attachment("note.txt", std::vector<std::uint8_t>{'a', 'b', 'c'}, "text/plain");
    message.save(std::filesystem::path("hello.msg"));

    auto loaded = aef::msg::mapi_message::from_file(
        std::filesystem::path("hello.msg"), /*strict=*/false);
    loaded.save_to_eml(std::filesystem::path("hello.eml"));

    return 0;
}

Format yang Didukung

FormatEkstensiBacaTulis
Pesan Outlook (MSG).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
Compound File Binary (CFB).cfb✓✓

Sumber Terbuka & Lisensi

Aspose.Email FOSS untuk C++ dirilis di bawah lisensi MIT. Kode sumber lengkap tersedia di aspose-email-foss/Aspose.Email-FOSS-for-Cpp, dan penggunaan komersial diizinkan tanpa royalti. Pustaka ini tidak memiliki ketergantungan runtime selain kompiler C++17 dan CMake 3.26 atau yang lebih baru.

Memulai

Sumber Daya Terkait