Ako pracovať s prílohami v C++

Aspose.Email FOSS for C++ provides the mapi_attachment Trieda na vytváranie príloh z surových bajtov alebo prúdov a mapi_message Prílohy na čítanie príloh z existujúcich súborov MSG. Pri zostavovaní správ môžete pridávať prílohy a kontrolovať ich pri načítaní súborov, vrátane zistenia, či je príloha sama o sebe vloženou MSG Správa o správe.

Krok 1 - Vytvorenie 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 – Pridať prílohu súboru z bajtov

Používať mapi_message::add_attachment() binárne údaje pri zostavovaní správy. Zadajte názov súboru, surové bajty ako a std::vector<std::uint8_t>,a na miesto, kde sa nachádza 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 – Pridať prílohu z súboru na disku

Prečítajte si súbor do bajtového vektoru a potom ho odošlite 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 – Prečítajte si prílohy z existujúceho súboru MSG

message.attachments() Vráť sa A const odkaz na vektor pripojených objektov. Každá expozícia filename, mime_type, data (zberné zvyky sú aj naďalej) 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 – Detekcia a prístup k vloženým správam

Niektoré súbory obsahujú iné súbory ako prílohy (predávané alebo pozvánky na schôdzu). Používať is_embedded_message() na zistenie týchto a prístup k vloženému hláseniu prostredníctvom 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žiť pripojené údaje na disk

Extrahujte prílohy a napíšte ich do súboru pomocou štandardných prúdov C++:

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

Bežné problémy a riešenia

attachment.data je prázdna pre známeho veľkého pripútanosti. Overiť zdroj súboru MSG skutočne obsahuje prílohy (nie prepojenie OLE). MSG súbory exportované z niektorých poštových klientov môžu ukladať prílohy ako externé odkazy, ktoré knižnica nemôže sledovať.

is_embedded_message() Vrátiť sa true ale embedded_message je nullptr. Na príloha označuje vloženú MSG, ale údaje neboli čitateľné. skontrolujte, či je zdroj je platný a nie je odrezaný.

Uložiť extrahované pripojenie zlyhá s chybou cesty. Niektoré prílohy súborov obsahujú znaky, ktoré sú neplatné v cieľovom súborovom systéme (napr.., :, ? je Výchova - sanitizácia attachment.filename predtým, ako sa vytvorí výstupná cesta.

Veľké súbory MSG spôsobujú vysoké využitie pamäte. - smapi_message::from_file() Loading Všetko pripojené údaje do pamäte. Pre veľké súbory otvorte základný kontajner CFB s cfb_reader prístup k jednotlivým prúdom bez toho, aby sa úplne materializovali všetky prílohy.

add_attachment() Nenašiel sa v čase zostavy. Uistite sa, že používate správne Zahŕňa to: "aspose/email/foss/msg/mapi_message.hpp".Metóda je členom aspose::email::foss::msg::mapi_message.

Často kladené otázky

Aké typy MIME by som mal použiť pre prílohy?

Pre formát súboru použite štandardný typ IANA MIME: "text/plain" pre .txt, "application/pdf" pre .pdf, "application/octet-stream" ako generický fallback pre binárne súbory. typ MIME je uložený ako attach_mime_tag nehnuteľnostiach v majetku.

Môžem pripojiť rovnaký súbor viackrát?

Áno, každý hovor na add_attachment() Vložte nezávislý prílohu. duplikát sú povolené názvy súborov; rozlišujú sa podľa polohy v zozname príloh.

Ako nastaviť Content-ID pre inline obrázky?

Preneste reťazec ID obsahu ako štvrtý argument na 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 vystavený ako attachment.content_id Keď čítam späť.

je `attachment.data` Kópia alebo referencia?

attachment.data je a std::vector<std::uint8_t> uložená hodnotou vo vnútri mapi_message Objekt: Prístup k nemu nespôsobí ďalšie I/O.

Môžem odstrániť prílohu pred uložením?

Na mapi_message API nevystavuje priamu metódu odstránenia pripojenia vo verzii 0.1.0. Build a new message, copy the desired properties and attachments manually, a uložiť nový objekt.