Jak pracować z załącznikami w C++

Aspose.Email FOSS for C++ provides the mapi_attachment Klasa tworzenia załączników z surowych bajtów lub strumieni, a także mapi_message Lista przypisów do czytania przydziałów z istniejących plików MSG. Możesz dodać załączniki podczas tworzenia wiadomości i sprawdzić je podczas ładowania plików, w tym wykrywania, czy załącznik jest sam w sobie zainstalowany Pismo MSG .

Krok 1 – Zorganizuj projekt

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 - Dodaj przywiązanie plików z Bytes

Używanie mapi_message::add_attachment() Dane binarne przy tworzeniu wiadomości. Zapewnij nazwę filen, surowe bajty jako a std::vector<std::uint8_t>,i MIME Rodzaj treści:

#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 - Dodaj przywiązanie z pliku na dysku

Przeczytaj plik w wektoru bytu, a następnie przejdź do 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 – Przeczytaj załączniki z istniejącego pliku MSG

message.attachments() Powrót A const Odniesienie do wektoru obiektów przywiązania. Każda ekspozycja filename, mime_type, data (w przypadku brązowych butów) i 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 – Odkrywanie i dostęp do wbudowanych wiadomości

Niektóre pliki MSG zawierają inne pliky MSM jako dodatki (przedawane lub zaproszenia do spotkania). Używanie is_embedded_message() do odkrywania tych i dostępu do wiadomości przez 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 – Zapisz dane o przyłączeniu do dysku

Wyciągnij przypisy i napisz je do pliku za pomocą standardowych strumieni plików 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';
        }
    }
}

Wspólne problemy i rozwiązania

attachment.data Jest pusty dla znanej wielkie załącznik. Sprawdź źródło pliku MSG faktycznie zawiera dane załączników (nie link OLE). pliki MSG wyeksportowane z niektórych Klienci poczty mogą przechowywać załączniki jako odniesienia zewnętrzne, których biblioteka nie może śledzić.

is_embedded_message() Powrót true ale embedded_message Jest nullptr. i The nagłówek załącznika wskazuje wbudowany MSG, ale dane nie były rozdzielalne. sprawdź, że źródło MSG jest ważne i nie jest zakrzywione.

Uszczędzanie wyciągniętego załącznika nie działa z błądem ścieżki. Kilka filanomów zawiera znaky nieważne w systemie plików docelowych (np.., :, ? na Windows – sanitarne attachment.filename Przed rozpoczęciem budowy drogi wyjściowej.

Duże pliki MSG powodują wysoką ilość pamięci. Wystarczymapi_message::from_file() Wszystko ładuje w pamięci. dla dużych plików, otwórz podstawowy kontener CFB z cfb_reader do dostępu do indywidualnych strumieni bez pełnej materializacji wszystkich załączników.

add_attachment() Nie znaleziono w czasie kompilacji. Upewnij się, że używasz właściwego Obejmuje to: "aspose/email/foss/msg/mapi_message.hpp".Metoda jest członkiem aspose::email::foss::msg::mapi_message.

Często zadawane pytania

Jakie typy MIME powinienem używać do załączników?

Stosuj standardowy typ IANA MIME dla formatu pliku: "text/plain" Dla .txt, "application/pdf" Dla .pdf, "application/octet-stream" jako powrót do genericznego pliki binarne. typ MIME jest przechowywany jako attach_mime_tag MAPE Własność .

Czy mogę dodać ten sam plik wielokrotnie?

Każdy z nich wezwał do add_attachment() Wpisz niezależny wpis. duplikuj Nazwy filanami są dozwolone; wyróżniają się je pozycją na liście załączników.

Jak ustawić identyfikator treści dla obrazów w trybie inline?

Przejdź do struny identyfikacyjnej treści jako czwartego argumentu 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 Jest wystawiona jako attachment.content_id Kiedy czytają się z powrotem.

Jest `attachment.data` Kopia czy referencja?

attachment.data Jest A std::vector<std::uint8_t> Wartość przechowywana wewnątrz mapi_message Dostęp do niego nie powoduje dodatkowych I/O.

Czy mogę usunąć dodatek przed oszczędzaniem?

i The mapi_message API nie wyświetla bezpośredniego sposobu usuwania przywiązania w wersji 0.1.0. Build a new message, copy the desired properties and attachments manually, i uratuj nowy obiekt.