Jak pracovat s přílohami v C++

Aspose.Email FOSS for C++ provides the mapi_attachment Třída pro vytváření příloh z surových bajtů nebo proudů a mapi_message Seznam příloh pro čtení z existujících souborů MSG. Můžete přidat přílohy při sestavování zpráv a kontrolovat je při načítání souborů, včetně zjištění, zda je příloha sama o sobě vloženou Zprávu ohledně místa.

Krok 1 – Vytvoření projektu

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

add_subdirectory(Aspose.Email-FOSS-for-Cpp)
target_link_libraries(your_target PRIVATE AsposeEmailFoss::AsposeEmailFoss)

Krok 2 – Přidání přílohy souboru z bajtů

Použijte mapi_message::add_attachment() Připojení binárních dat při sestavování zprávy. Zadejte souborové jméno, surové bajty jako a std::vector<std::uint8_t>,a také na místo, Typ obsahu :

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

int main()
{
    auto message = aspose::email::foss::msg::mapi_message::create(
        "Report", "Please review the attached report.");
    message.set_sender_name("Alice");
    message.set_sender_email_address("alice@example.com");
    message.add_recipient("bob@example.com", "Bob");

    // Attach a text file
    std::vector<std::uint8_t> text_data{'H', 'e', 'l', 'l', 'o'};
    message.add_attachment("notes.txt", text_data, "text/plain");

    // Attach a binary blob
    std::vector<std::uint8_t> bin_data{0x00, 0x01, 0x02, 0x03};
    message.add_attachment("data.bin", bin_data, "application/octet-stream");

    message.save(std::filesystem::path("report.msg"));
}

Krok 3 - Přidání přílohy z souboru na disku

Přečtěte si soubor do bajtového vektoru a potom jej přepněte na add_attachment():

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

int main()
{
    // Read a file into bytes
    std::ifstream file("document.pdf", std::ios::binary);
    std::vector<std::uint8_t> pdf_bytes(
        std::istreambuf_iterator<char>(file),
        std::istreambuf_iterator<char>{});

    auto message = aspose::email::foss::msg::mapi_message::create(
        "Document", "See attached PDF.");
    message.set_sender_name("Alice");
    message.set_sender_email_address("alice@example.com");
    message.add_recipient("bob@example.com", "Bob");
    message.add_attachment("document.pdf", pdf_bytes, "application/pdf");

    message.save(std::filesystem::path("with_pdf.msg"));
}

Krok 4 – Čtení příloh z existujícího souboru MSG

message.attachments() Vrátí se A const odkaz na vektor připojených objektů. Každá expozice filename, mime_type, data (zpětně z Bílého domu) a content_id:

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

int main()
{
    std::ifstream input("sample.msg", std::ios::binary);
    const auto message = aspose::email::foss::msg::mapi_message::from_stream(input);

    std::cout << "Attachments: " << message.attachments().size() << '\n';
    for (std::size_t i = 0; i < message.attachments().size(); ++i)
    {
        const auto& a = message.attachments()[i];
        std::cout << "[" << (i + 1) << "]"
                  << "  name="         << a.filename
                  << "  mime="         << a.mime_type
                  << "  bytes="        << a.data.size()
                  << "  content_id="   << a.content_id
                  << '\n';
    }
}

Krok 5 – Detekce a přístup k vestavěným zprávám

Některé soubory obsahují jiné soubory jako přílohy (předávané nebo pozvánky na schůzku). Použijte is_embedded_message() zjistit a přístup k vloženému sdělení prostřednictvím embedded_message:

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

int main()
{
    std::ifstream input("sample.msg", std::ios::binary);
    const auto message = aspose::email::foss::msg::mapi_message::from_stream(input);

    for (const auto& attachment : message.attachments())
    {
        if (attachment.is_embedded_message() && attachment.embedded_message != nullptr)
        {
            const auto& inner = *attachment.embedded_message;
            std::cout << "Embedded subject: " << inner.subject() << '\n';
            std::cout << "Embedded from:    " << inner.sender_email_address() << '\n';

            // Save the embedded message as a standalone MSG
            inner.save(std::filesystem::path("embedded.msg"));
        }
        else
        {
            std::cout << "Regular attachment: " << attachment.filename
                      << " (" << attachment.data.size() << " bytes)\n";
        }
    }
}

Krok 6 – Uložení dat na disk

Extrahujte přílohy a napište je do souboru pomocí standardních C++ datových proudů:

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

int main()
{
    const auto message = aspose::email::foss::msg::mapi_message::from_file(
        std::filesystem::path("sample.msg"));

    const std::filesystem::path out_dir("attachments");
    std::filesystem::create_directories(out_dir);

    for (const auto& a : message.attachments())
    {
        if (!a.is_embedded_message())
        {
            const auto out_path = out_dir / a.filename;
            std::ofstream out(out_path, std::ios::binary);
            out.write(reinterpret_cast<const char*>(a.data.data()),
                      static_cast<std::streamsize>(a.data.size()));
            std::cout << "Saved: " << out_path << '\n';
        }
    }
}

Časté problémy a opravy

attachment.data Je prázdný pro velkou známou připoutanost. Zkontrolujte zdroj souboru MSG skutečně obsahuje přílohy (nikoli odkaz OLE). MSG soubory exportované z některých Poštovní klienty mohou ukládat přílohy jako externí odkazy, které knihovna nemůže sledovat.

is_embedded_message() Návraty true ale embedded_message Je to nullptr. O příloha označuje vložený MSG, ale údaje nebyly čitelné. zdroj je platný a není zkrácen.

Uložení extrahovaného přílohy selže s chybou cesty. Některé přílohy souborů obsahují znaky, které jsou na cílovém souborovém systému neplatné (např.., :, ? Je Vzdělávání - Sanitize attachment.filename Předtím, než se vybuduje výstupní cesta.

Velké soubory způsobují vysokou spotřebu paměti. semapi_message::from_file() Loading vše Přiložení dat do paměti. Pro velké soubory otevřete podkladový kontejner CFB s cfb_reader přístup k jednotlivým proudům bez úplného zhmotnění všech příloh.

add_attachment() Nenašel se v čase sestavy. Ujistěte se, že používáte správné Zahrnuje to: "aspose/email/foss/msg/mapi_message.hpp".Metoda je členem aspose::email::foss::msg::mapi_message.

Často kladené otázky

Jaké typy MIME bych měl použít pro přílohy?

Pro formát souboru použijte standardní typ IANA MIME: "text/plain" pro .txt, "application/pdf" pro .pdf, "application/octet-stream" Jako generický zpětný odkaz pro binární soubory. typ MIME je uložen jako attach_mime_tag Majetek je majetek.

Mohu připojit stejný soubor několikrát?

Ano, každý hovor na add_attachment() Přidá se samostatný záznam. duplikát Jména souborů jsou povolena; rozlišují se podle polohy v seznamu příloh.

Jak nastavit Content-ID pro inline obrázky?

Přejděte na řetězce ID obsahu jako čtvrtý argument do mapi_attachment::from_stream():

auto att = aspose::email::foss::msg::mapi_attachment::from_bytes(
    "logo.png", png_bytes, "image/png", "<logo-cid@example.com>");

content_id Je vystavena jako attachment.content_id Když se vrátím k čtení.

je `attachment.data` Kopie nebo odkaz?

attachment.data Je to A std::vector<std::uint8_t> Skladování hodnoty uvnitř mapi_message Přístup k němu nezpůsobí další I/O.

Mohu před uložením odstranit přílohu?

O mapi_message API nevystavuje přímou metodu odstranění připojení ve verzi 0.1.0. Build a new message, copy the desired properties and attachments manually, a uložit nový objekt.