Как работать с приложениями в C++
Aspose.Email FOSS for C++ provides the mapi_attachment Класс для создания приложений от сырых байтов или потоков, а также mapi_message Список приложений для чтения Приложения из существующих файлов MSG. Вы можете добавлять вложения при составлении сообщений и проверять их при загрузке файлов, в том числе обнаружение того, является ли сам файл-приложение встроенным Послание от имени.
Шаг 1 — Составление проекта
git clone https://github.com/aspose-email-foss/Aspose.Email-FOSS-for-Cpp.gitadd_subdirectory(Aspose.Email-FOSS-for-Cpp)
target_link_libraries(your_target PRIVATE AsposeEmailFoss::AsposeEmailFoss)Шаг 2 — Добавление файла в приложении из байтов
Используйте mapi_message::add_attachment() Присоединение бинарных данных при составлении сообщения. Подайте имя файла, сырые байты как a std::vector<std::uint8_t>,И в том числе и с MIME Тип контента :
#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"));
}Шаг 3 — Добавление приложения из файла на диске
Читайте файл в байт-вектор, а затем перейдите его на 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"));
}Шаг 4 — Прочитать приложения из существующего MSG файла
message.attachments() Возвращаем а const ссылка на вектор прикрепленных объектов. Каждый экспонат filename, mime_type, data (в том числе и в «Роснефтье») и 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';
}
}Шаг 5 — обнаружение и доступ к встроенным сообщениям
Некоторые файлы содержат другие файла, как приложения (преднаправления или приглашения на встречу). Используйте is_embedded_message() обнаружить их и получить доступ к заложенному сообщению через 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";
}
}
}Шаг 6 — Сохранение данных приложений на диск
Вытяните файлы приложений и запишите их в файл с помощью стандартных потоков 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';
}
}
}Общие проблемы и решения
attachment.data Пустота для известного привязанности. Проверьте источник файла MSG фактически содержит данные приложения (не ссылку OLE). MSG файлы, экспортируемые из некоторых Клиенты почтовой связи могут хранить приложения в качестве внешних ссылок, которые библиотека не может отслеживать.
is_embedded_message() возвращаются true Но embedded_message Это nullptr. ТЭ Заголовок приложения указывает на встроенный MSG, но данные не были просматриваемы. источник MSG является действительным и не отрезанным.
Сохранение вывешенного прикрепления не удается с ошибкой пути. Некоторые файлы прикрепления содержат недействительные символы в целевой файловой системе (например,., :, ? Он Очищение - Sanitise attachment.filename Перед тем как построить выходный путь.
Большие файлы MSG вызывают высокое использование памяти. ¦mapi_message::from_file() загрузить все файлов в память. Для больших файла открывайте основный контейнер CFB с cfb_reader доступ к отдельным потокам без полной материализации всех приложений.
add_attachment() Не найдено в сборник времени. Убедитесь, что вы используете правильный Включает в себя: "aspose/email/foss/msg/mapi_message.hpp".Метод является членом aspose::email::foss::msg::mapi_message.
Часто задаваемые вопросы
Какие типы MIME я должен использовать для приложений?
Для файлового формата используйте стандартный тип IANA MIME: "text/plain" для .txt, "application/pdf" для .pdf, "application/octet-stream" Как генеральный фальцбек для бинарные файлы. тип MIME хранится как attach_mime_tag Имущество «Спец-перевозки» .
Можно ли прикрепить один и тот же файл несколько раз?
Да, каждый звонок к add_attachment() Добавляется независимый вход. дублировать Допускаются имена файлов; они отличаются по местоположению в списке приложений.
Как настроить Content-ID для инлайн изображений?
Передайте строку ID контента в качестве четвертого аргумента для 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 Он выставлен как attachment.content_id Когда читать назад.
И есть attachment.data Копия или ссылка?
attachment.data Это а std::vector<std::uint8_t> хранится по стоимости внутри mapi_message Доступ к нему не вызывает дополнительных I/O.
Могу ли я удалить приставку перед сбережением?
ТЭ mapi_message API не выявляет прямой метод удаления прикрепления в версии 0.1.0. Build a new message, copy the desired properties and attachments manually, И сохранить новый объект.
