Documentation – Робота з MIME повідомленнями

Java: Створення та встановлення вмісту електронних листів

Mon, 01 Jan 0001 00:00:00 +0000

Створити новий електронний лист

Aspose.Email для Java дозволяє розробникам створювати MIME (Multipurpose Internet Mail Extensions) повідомлення з нуля. Основний клас для цього у API Aspose.Email для Java є MailMessage клас. Ця тема пояснює кроки, необхідні для створення електронних листів у форматах EML, MSG і MTH за допомогою Aspose.Email для Java.

Щоб створити електронний лист з нуля:

Створіть екземпляр класу MailMessage.
Встановіть тему повідомлення, використовуючи setSubject() метод.
Встановіть тіло повідомлення, використовуючи setHtmlBody() метод.
Вкажіть відправника листа, використовуючи setFrom() метод.
Вкажіть отримувача у полі TO, використовуючи getTo().add() метод.
Вкажіть отримувача у полі CC, використовуючи getCC().add() метод.
Викличте Save() метод для збереження файлу повідомлення на диск у форматах MSG, EML та MHT.

Вказування декількох отримувачів

The MailMessage представляє електронне повідомлення. Екземпляри класу MailMessage використовуються для створення листів, які передаються до SMTP сервера за допомогою SmtpClient клас. Ця тема демонструє, як вказати більше однієї електронної адреси. Адреси електронної пошти можна вказати, використовуючи клас MailMessage. Адреси, використані в класі MailMessage, це:

To – Адреси отримувачів можна вказати у полі ‘To’. Отримувачі в полі ‘To’ є основною аудиторією повідомлення. Може бути більше однієї адреси отримувача.
Cc – CC означає «копія», або «ввічлива копія», і дозволяє додати отримувачів листа, які повинні його бачити, але не обов’язково повинні діяти за ним. Наприклад, менеджери чи члени вашої команди, яким потрібно бути в курсі розмови. За допомогою Aspose.Email можна вказати адреси CC у вашому коді. Таким чином, автоматичні листи або всі листи на певну адресу можуть копіюватися відповідальним особам.
Bcc – Bcc (прихована копія) дозволяє надсилати лист отримувачу, який прихований від інших отримувачів. Там, де CC з’являється в інформації листа, яку бачать головні отримувачі, Bcc не відображається. Це призначено для прихованого сповіщення.

Щоб вказати декілька електронних адрес у листі, виконайте такі кроки:

Створіть екземпляр класу MailMessage.
Вкажіть адреси From та кілька адрес To, Cc і Bcc, використовуючи екземпляр MailMessage.
Створіть екземпляр класу SmtpClient і надішліть лист, використовуючи метод Send.

Нижче наведений зразок коду показує, як можна вказати декілька адрес To, CC та BCC.

Зміна електронних адрес на дружні імена

Нижче наведені програмні приклади демонструють, як змінити електронні адреси на дружні імена у листі. Дружнє ім’я – це назва, більш зрозуміла людям, ніж електронна адреса, наприклад John Smith замість js346@domain.com. При надсиланні листа ми можемо асоціювати дружнє ім’я з електронною адресою у MailMessage конструктор класу.

Щоб змінити електронні адреси на дружні імена у листі, виконайте такі кроки:

Створіть екземпляр класу MailMessage та вкажіть електронні адреси у полях To і From разом із дружніми іменами.
Вкажіть електронні адреси Cc та Bcc разом з дружніми іменами, викликавши конструктор класу MailMessage у екземплярі MailMessage.
Створіть екземпляр класу SmtpClient і надішліть лист, використовуючи метод Send.

Нижче наведений фрагмент коду показує, як відображати імена для електронних адрес.

Встановити тіло листа

The MailMessage клас представляє електронне повідомлення. Екземпляри класу MailMessage використовуються для створення листів, які передаються до SMTP сервера для доставки за допомогою SmtpClient клас. Тіло листа можна вказати, використовуючи клас MailMessage. Тіло електронного листа можна задати за допомогою setHtmlBody методу в MailMessage.

На додаток до HtmlBody, у Aspose.Email є інший метод, пов’язаний з тілом листа:

isBodyHtml: повідомляє користувачеві, чи є тіло HTML чи звичайним текстом.

Ця тема показує, як визначити текст HTML‑тіла та задати альтернативний текст.

Встановлення HTML‑тіла

HtmlBody використовується для вказання HTML‑вмісту тіла повідомлення. HtmlBody має бути обгорнутий між тегами . Нижче наведений фрагмент коду показує, як задати HTML‑тіло.

Встановлення альтернативного тексту

Використайте AlternateView клас для вказання копій електронного повідомлення в різних форматах. Наприклад, якщо ви надсилаєте лист у форматі HTML, ви також можете надати версію у простому тексті на випадок, якщо деякі отримувачі використовують поштові програми, які не можуть відображати HTML‑вміст. Цей клас має два властивості, LinkedResources і BaseUri, які використовуються для розв’язання URL‑адрес у вмісті листа.

LinkedResources — це колекція об’єктів LinkedResources. При відображенні URL‑адреси у вмісті листа спочатку порівнюються з URL‑адресами у полях Content Link кожного об’єкта LinkedResources у колекції LinkedResources і розв’язуються.
BaseUri використовується читачем листа для розв’язання відносних URL-адрес у тілі, а також для розв’язання відносних URL‑посилань на контент у колекції LinkedResources.

Нижче наведений фрагмент коду показує, як задати альтернативний текст.

Вказування кодування тіла листа

Тип вмісту визначає формат електронного листа: набір символів. Наприклад, кілька поширених наборів символів, що надаються у java.nio.Charset, це:

US-ASCII – 7‑бітний ASCII, також відомий як ISO646-US, або базовий блок Latin у наборі Unicode
ISO-8859-1 – ISO латинська абетка №1, також відома як ISO-LATIN-1
UTF-8 – 8‑бітний формат трансформації UCS
UTF-16BE – 16‑бітний формат трансформації UCS, порядок байтів big-endian
UTF-16LE – 16‑бітний формат трансформації UCS, порядок байтів little-endian
UTF-16 – 16‑бітний формат трансформації UCS, порядок байтів визначається за допомогою необов’язкового маркера порядку байтів

Aspose.Email використовує BodyEncoding властивість класу MailMessage, яка задає кодування тіла листа. Щоб закодувати тіло електронного листа, виконайте наведені нижче кроки:

Створіть екземпляр класу MailMessage.
Вкажіть відправника, отримувача та HTML‑тіло листа у екземплярі MailMessage.
Вкажіть значення властивості BodyEncoding.
Створіть екземпляр SmtpClient клас і надішліть лист, використовуючи метод Send.

Функції MailMessage

The MailMessage клас представляє вміст електронного листа. Екземпляри класу MailMessage використовуються для створення листа, який передається до SMTP сервера для доставки за допомогою SmtpClient клас. У цій статті показано, як використовувати утилітні функції класу MailMessage для керування наступними можливостями електронної пошти:

Дата і час – Через клас MailMessage setDate метод, яким ми встановлюємо дату і час електронного листа.
Пріоритет повідомлення – MailPriority клас визначає рівні пріоритету для відправки електронного листа. Він може бути низьким, звичайним або високим. Пріоритет впливає на швидкість передачі та доставку.
Чутливість повідомлення – MailSensitivity клас визначає п’ять рівнів чутливості.
Повідомлення про доставку – Повідомлення про доставку інформують відправників про те, що їх лист було доставлено у вхідні повідомлення одержувача.

За замовчуванням дата – це фактична дата відправлення повідомлення, а час – час його відправлення, як це показано у Microsoft Outlook. Проте реальний час доставки листа додається самим SMTP‑сервером у заголовку листа. Наприклад, нижче наведений типовий заголовок листа, у якому поле Date було встановлено за допомогою MailMessage.setDate.

Нижче наведений фрагмент коду ілюструє, як можна використовувати кожну з описаних вище функцій.

Запит підтвердження прочитання

Нижченаведені приклади коду показують, як можна запросити підтвердження прочитання. Клас MailMessage DeliveryNotificationOptions Властивість Enumeration описує опції повідомлення про доставку для електронного листа. Щоб запросити підтвердження прочитання після відправки листа, виконайте такі кроки:

Створіть екземпляр класу MailMessage.
Вкажіть відправника, отримувача та HTML‑тіло листа у екземплярі MailMessage.
Вкажіть DeliveryNotificationOptions в інших екземплярах MailMessage.
Створіть екземпляр класу SmtpClient і надішліть лист, використовуючи метод Send.

Запити на підтвердження прочитання можуть не завжди виконуватись, бо:

Клієнт електронної пошти може не реалізовувати цю функцію.
У кінцевого користувача ця функція може бути вимкнена.
Кінцевий користувач може вирішити не надсилати його.

Нижче наведений фрагмент коду показує, як запросити підтвердження прочитання.

Встановити заголовки листа

Заголовки електронної пошти представляють інтернет-стандарт, а RFC визначають поля заголовків, які включені в інтернет-повідомлення електронної пошти. Заголовок листа можна задати за допомогою MailMessage клас. Спільні типи заголовків визначені у HeaderType клас. Це запечатаний клас, який працює як звичайна енумерація.

Зазвичай заголовок електронного листа містить ці поля:

To: Адреси одержувачів можна вказати у полі To. Одержувачі в полі To є основною аудиторією повідомлення. Може бути вказано декілька адрес одержувачів.
From: Це поле містить електронну адресу відправника повідомлення.
Cc: Дозволяє користувачам надсилати повідомлення як «Carbon Copy» або «Courtesy Copy». Тобто одержувач не зобов’язаний відповідати чи діяти. Зазвичай це використовується для інформування керівного персоналу.
Bcc: Скорочення від Blind Carbon Copy, означає надсилання повідомлення кільком одержувачам таким чином, щоб отримані листи не містили повного списку одержувачів. Призначено для прихованих сповіщень.
ReplyTo: Це поле заголовка вказує, куди відправник хоче отримувати відповіді.
Subject: Заголовок, назва, тема. Часто використовується як індикатор теми для повідомлень, що відповідають або коментують інші повідомлення.
Date: Цей заголовок вказує дату (і час). Зазвичай це дата, коли повідомлення було створено та відправлено.
XMailer: Інформація про клієнтське програмне забезпечення відправника. Приклад: X-Mailer: Aspose.Email XMailer використовується поштовими клієнтами. Різні поштові клієнти мають різні значення XMailer. Значення XMailer в MS Outlook — Microsoft Office Outlook, Build 11.0.5510. Воно ігнорується отримувачем електронної пошти або програмою для читання листів.

Зазвичай заголовок електронного листа виглядає приблизно так:


 Reply-To: reply@reply.com

From: sender@sender.com

To: guangzhou@guangzhoo.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

Щоб налаштувати заголовок електронного листа, виконайте такі кроки:

Створіть екземпляр MailMessage клас.
Вкажіть To, From, CC, Bcc, ReplyTo, Subject, Date та XMailer, використовуючи екземпляр класу MailMessage.
Створіть екземпляр MimeHeader клас і вкажіть секретний заголовок.
Додайте секретний заголовок до екземпляра MailMessage.

У наведеному нижче коді ми налаштували заголовок електронного листа.

Вищенаведений фрагмент коду створює заголовок електронного листа у такому форматі. Це можна спостерігати, відкривши файл MsgHeaders.msg у Microsoft Outlook і переглянувши його властивості.


 Reply-To: reply@reply.com

From: sender@sender.com

To: receiver1@receiver.com

CC: receiver2@receiver.com

BCC: receiver3@receiver.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

secret-header: mystery

Вставити заголовок у конкретному місці

The Додати метод колекції HeadersCollection вставляє заголовок у кінець колекції. Однак іноді може знадобитися вставити заголовок у конкретному місці. У цьому випадку метод Add не допоможе. Щоб це здійснити, використовуйте Insert метод колекції HeadersCollection. Якщо колекція містить заголовки з однаковою назвою, цей заголовок буде вставлений перед іншими заголовками з тією ж назвою. Нижче наведено сигнатуру методу Insert та приклад коду його використання.


 Method Signature

HeaderCollection.insert(String name, String value)

Додавання власних заголовків до листа

Нижченаведені приклади коду демонструють, як вказати власний заголовок у повідомленні електронної пошти. Заголовок листа можна задати за допомогою класу MailMessage. Щоб задати власний заголовок у повідомленні, виконайте наступні кроки:

Створіть екземпляр класу MailMessage.
Вкажіть значення to, from та subject, використовуючи екземпляр MailMessage.
Додайте секретний заголовок до екземпляра MailMessage.
Створіть екземпляр класу SmtpClient і надішліть лист, використовуючи метод Send.

Нижче наведений фрагмент коду показує, як додати власні заголовки до листа.

Підписати листи за допомогою DKIM

Aspose.Email дозволяє підписати лист за допомогою DKIM (DomainKeys Identified Mail). Це дає організації можливість взяти на себе відповідальність за повідомлення, яке перебуває в транзиті (про DKIM). DKIM додає цифровий підпис до заголовків повідомлення електронної пошти, який може бути перевірений отримувачами. Публічний ключ відправника дозволяє отримувачу підтвердити, що підпис відповідає вмісту повідомлення. Клас MailMessage dKIMSign метод використовується для встановлення криптографічної та підписної інформації з метою підпису повідомлення. Нижче наведений фрагмент коду показує, як підписати листи за допомогою DKIM.

Виконання злиття листів

Злиття листів допомагає створювати та надсилати пакет подібних електронних листів. Основна частина листів однакова, але вміст можна персоналізувати. Зазвичай для персоналізації листа використовуються контактні дані одержувача (ім’я, прізвище, компанія тощо).

|| | :- | |Фігура: Ілюстрація того, як працює злиття листів|

Щоб виконати злиття листів за допомогою Aspose.Email, виконайте такі кроки:

Створіть функцію з підписом name
Створіть екземпляр MailMessage клас.
Вкажіть відправника, одержувача, тему та текст листа.
Створіть підпис для кінця листа.
Створіть екземпляр TemplateRoutine класі і передайте йому MailMessage екземпляр.
Отримайте підпис у TemplateRoutine екземпляр.
Створіть екземпляр DataTable клас.
Додайте стовпці Receipt, FirstName та LastName як джерела даних у клас DataTable
Створіть екземпляр DataRow клас
Вкажіть адресу одержувача, ім’я та прізвище у об’єкті DataRow
Створіть екземпляр MailMessageCollection клас
Вкажіть TemplateRoutine і екземплярів DataTable у MailMessageCollection екземпляр.
Створіть екземпляр SmtpClient класу і вказати сервер, порт, ім’я користувача та пароль
Надсилати листи за допомогою SmtpClient метод класу BulkSendAsync

Нижче наведений код надсилає лист одній особі від трьох інших.

Java: Робота з вкладеннями та вбудованими об’єктами

Mon, 01 Jan 0001 00:00:00 +0000

Керування вкладеннями електронної пошти

Вкладення електронного листа — це файл, який надсилається разом з повідомленням електронної пошти. Файл може бути надісланий як окреме повідомлення, так і як частина повідомлення, до якого він приєднаний. Attachment клас використовується з MailMessage клас. Усі повідомлення містять тіло. Окрім тіла, ви можете захотіти надіслати додаткові файли. Вони надсилаються як вкладення і представлені у вигляді екземпляра Attachment клас. Ви можете надсилати будь-яку кількість вкладень, проте розмір вкладення обмежується поштовим сервером. Gmail, наприклад, не підтримує файли розміром більше 10 МБ.

Спробуйте!

Додавайте або видаляйте вкладення електронної пошти онлайн за допомогою безкоштовного Aspose.Email Editor App.

Додавання вкладення

Щоб прикріпити вкладення до електронного листа, будь ласка, виконайте наступні кроки:

Створіть екземпляр MailMessage клас.
Створіть екземпляр Attachment клас.
Завантажте вкладення у Attachment екземпляр.
Додайте Attachment екземпляр у MailMessage екземпляр.

Наступний фрагмент коду показує, як додати вкладення до електронного листа.

// Create an instance of MailMessage class
MailMessage message = new MailMessage();
message.setFrom(new MailAddress("sender@from.com"));
message.getTo().add("receiver@to.com");
message.setSubject("This is message");
message.setBody("This is body");

// Load an attachment
Attachment attachment = new Attachment("1.txt");

// Add Multiple Attachment in instance of MailMessage class and Save message to disk
message.getAttachments().addItem(attachment);
message.addAttachment(new Attachment("1.jpg"));
message.addAttachment(new Attachment("1.doc"));
message.addAttachment(new Attachment("1.rar"));
message.addAttachment(new Attachment("1.pdf"));
message.save("AddAttachments.eml");

Вище ми описали, як додавати вкладення до вашого повідомлення електронної пошти за допомогою Aspose.Email. Далі показано, як видаляти вкладення та відображати інформацію про них на екрані.

Видалення вкладення

Щоб видалити вкладення, виконайте наведені нижче кроки:

Створіть екземпляр Attachment клас.
Завантажте вкладення в екземпляр Attachment клас.
Додайте вкладення до екземпляра MailMessage клас.
Видаліть вкладення з екземпляра Attachment клас, використовуючи MailMessage екземпляр класу.

Наступний фрагмент коду показує, як видалити вкладення.

// Create an instance of MailMessage class
MailMessage eml = new MailMessage();
eml.setFrom(new MailAddress("sender@from.com"));
eml.getTo().add("receiver@to.com");

// Load an attachment
Attachment attachment = new Attachment("1.txt");
eml.getAttachments().addItem(attachment);

// Remove attachment from your MailMessage
eml.getAttachments().removeItem(attachment);

Відображення назви файлу вкладення

Щоб відобразити назву файлу вкладення, виконайте такі кроки:

Пройдіться по вкладеннях у повідомленні електронної пошти та
1. Збережіть кожне вкладення.
2. Відобразіть назви всіх вкладень на екрані.

Наступний фрагмент коду показує, як відобразити назву файлу вкладення на екрані.

MailMessage eml = MailMessage.load("Attachments.eml");

for (Attachment attachment : eml.getAttachments()) {
    // Display the attachment file name
    System.out.println(attachment.getName());
}

Витягування вкладень електронної пошти

У цьому розділі пояснюється, як витягнути вкладення з файлу електронної пошти. Вкладення електронної пошти — це файл, який надсилається разом із повідомленням. Файл може бути надісланий як окреме повідомлення, так і як частина повідомлення, до якого він прикріплений. У всіх повідомленнях електронної пошти є можливість надсилати додаткові файли. Вони надсилаються як вкладення і представлені як екземпляри Attachment клас. The Attachment клас використовується з MailMessage клас для роботи з вкладеннями. Щоб витягти вкладення з повідомлення електронної пошти, виконайте такі кроки:

Створіть екземпляр MailMessage клас.
Завантажте файл електронного листа у MailMessage екземпляр.
Створіть екземпляр Attachment клас та використовуйте його в циклі для витягнення всіх вкладень.
Збережіть вкладення та відобразіть його на екрані.

|Витягнуті вкладення в електронному листі| | :- | || Наступний фрагмент коду показує, як витягнути вкладення електронної пошти.

MailMessage eml = MailMessage.load("Message.eml", new MsgLoadOptions());

for (Attachment attachment : eml.getAttachments()) {
    attachment.save("MessageEmbedded_out.eml");
    System.out.println(attachment.getName());
}

Отримання Content-Description з вкладення

API Aspose.Email надає можливість читати Content-Description вкладення з його заголовка. Наступний фрагмент коду показує, як отримати опис вмісту з вкладення.

MailMessage eml = MailMessage.load("EmailWithAttachEmbedded.eml");
System.out.println(eml.getAttachments().get_Item(0).getHeaders().get_Item("Content-Description"));

Визначення, чи є вкладення вбудованим повідомленням

Наступний фрагмент коду демонструє, як визначити, чи є вкладення вбудованим повідомленням.

MailMessage eml = MailMessage.load("EmailWithAttachEmbedded.eml");

System.out.println(eml.getAttachments().get_Item(0).isEmbeddedMessage()
        ? "Attachment is an embedded message."
        : "Attachment isn't an embedded message.");

Визначення вкладень у форматі TNEF

The Attachment.isTnef властивість API Aspose.Email для Java, яка вказує, чи є вкладення повідомлення у форматі TNEF.

Наступний фрагмент коду демонструє, як визначити, чи є вкладення у форматі TNEF:

MailMessage eml = MailMessage.load(fileName);

for (Attachment attachment : eml.getAttachments()) {
    System.out.println("Is Attachment TNEF?: " + attachment.isTnef());
}

Завантаження та збереження TNEF‑вкладень

Aspose.Email для Java надає методи в MapiAttachment клас для виконання наступних операцій:

Завантаження з TNEF

static MapiAttachment loadFromTnef(String fileName) – Завантажує вкладення з TNEF-файлу.
static MapiAttachment loadFromTnef(InputStream stream) – Завантажує вкладення з TNEF-потоку.

Збереження у TNEF

void saveToTnef(String fileName) – Зберігає вкладення у TNEF-файл.
void saveToTnef(OutputStream stream) – Зберігає вкладення у TNEF-потік.

Наступний приклад коду демонструє, як витягти TNEF‑вкладення з повідомлення, зберегти його у потік або файл, а потім завантажити його назад у повідомлення як MapiAttachment:

// Load message containing a TNEF attachment (winmail.dat)
MapiMessage msg = MapiMessage.load("message.eml");

// Save the first attachment to a TNEF stream
ByteArrayOutputStream bos = new ByteArrayOutputStream();
msg.getAttachments().get(0).saveToTnef(bos);

// Load attachment back from the TNEF stream
ByteArrayInputStream bis = new ByteArrayInputStream(bos.toByteArray());
MapiAttachment fromtnefAttachment = MapiAttachment.loadFromTnef(bis);
msg.getAttachments().addMapiAttachment(fromtnefAttachment);

// Load TNEF attachment directly from a file
fromtnefAttachment = MapiAttachment.loadFromTnef("winmail.dat");
msg.getAttachments().addMapiAttachment(fromtnefAttachment);

Витягування URI вкладення, якщо воно є URI‑вкладенням

Наступний фрагмент коду демонструє, як витягти URI вкладення.

MailMessage eml = MailMessage.load("fileName");

Attachment attachment = eml.getAttachments().get_Item(0);
if (attachment.isUri()) {
    InputStream inputStream = attachment.getContentStream();
    String uri = new String(IOUtils.toByteArray(inputStream), Charset.forName("utf-8"));
    System.out.println("Attachment URI: " + uri);
}

Додавання довідкових вкладень

Довідкове вкладення є альтернативою локальному файлу вкладення. У деяких випадках довідкові вкладення можуть бути кращими, наприклад, якщо потрібно керувати їх доступом. Нижче наведені класи, які використовуються для керування та маніпулювання повідомленнями електронної пошти та їх вкладеннями:

ReferenceAttachment - Представляє довідкове вкладення.
AttachmentPermissionType - Дані типу дозволу, пов’язані з веб‑посиланням на вкладення.
AttachmentProviderType - Тип веб‑служби, що маніпулює вкладенням.

Наступний приклад коду демонструє, як завантажити повідомлення електронної пошти з файлу, створити довідкове вкладення з певними властивостями та додати його до повідомлення електронної пошти:

MailMessage eml = MailMessage.load("fileName");

ReferenceAttachment refAttach = new ReferenceAttachment("https://[attach_uri]")
refAttach.setName("Document.docx");
refAttach.setProviderType(AttachmentProviderType.OneDrivePro);
refAttach.setPermissionType(AttachmentPermissionType.AnyoneCanEdit);

eml.getAttachments().addItem(refAttach);

Робота з вбудованими об’єктами

Вбудований об’єкт — це об’єкт, створений в одній програмі та включений у документ або файл, створений іншою програмою. Наприклад, електронна таблиця Microsoft Excel може бути вбудована у звіт Microsoft Word, або відеофайл може бути вбудований у презентацію Microsoft PowerPoint. Коли файл вбудовується, а не вставляється чи копіюється в інший документ, він зберігає свій оригінальний формат. Вбудований документ можна відкрити у первинній програмі та змінити.

Вбудовування об’єктів в електронний лист

The LinkedResource клас використовується з MailMessage клас для вбудовування об’єктів у ваші повідомлення електронної пошти. Щоб додати вбудований об’єкт, виконайте наступні кроки

Створіть екземпляр MailMessage клас.
Вкажіть значення полів From, To та Subject у MailMessage екземпляр.
Створіть екземпляр AlternateView клас.
Створіть екземпляр LinkedResource клас.
Завантажте вбудований об’єкт у LinkedResourceCollection.
Додайте завантажений вбудований об’єкт у MailMessage екземпляр класу.
Додайте AlternateView екземпляр до MailMessage екземпляр класу.

Нижче наведені фрагменти коду створюють повідомлення електронної пошти з простим текстом та HTML‑тілом, а також зображенням, вбудованим в HTML

|Зображення, вбудоване в електронний лист| | :- | || Ви можете надіслати будь-скільки вбудованих об’єктів. Розмір вкладення обмежений поштовим сервером. Наприклад, Gmail не підтримує файли розміром понад 10 МБ. Нижче наведені фрагменти коду, що демонструють, як вбудовувати об’єкти в електронний лист.

// Create an instance of the MailMessage class and Set the addresses and Set the content
MailMessage mail = new MailMessage();
mail.setFrom(new MailAddress("sender@from.com"));
mail.getTo().add("receiver@to.com");
mail.setSubject("This is an email");

// Create the plain text part It is viewable by those clients that don't support HTML
AlternateView plainView = AlternateView.createAlternateViewFromString("This is my plain text content", null, "text/plain");

// Create the HTML part.To embed images, we need to use the prefix 'cid' in the img src value. 
// The cid value will map to the Content-Id of a Linked resource. 
// Thus <img src='cid:barcode'> will map to a LinkedResource with a ContentId of //'barcode'.
AlternateView htmlView = AlternateView.createAlternateViewFromString("Here is an embedded image.<img src=cid:barcode>", null, "text/html");

// Create the LinkedResource (embedded image) and Add the LinkedResource to the appropriate view
LinkedResource barcode = new LinkedResource("1.jpg", MediaTypeNames.Image.JPEG);
barcode.setContentId("barcode");

mail.getLinkedResources().addItem(barcode);
mail.getAlternateViews().addItem(plainView);
mail.getAlternateViews().addItem(htmlView);
mail.save("EmbeddedImage_out.msg", SaveOptions.getDefaultMsgUnicode());

Видалення вбудованих об’єктів з електронної пошти

LinkedResourceCollection доступна через MailMessage.LinkedResources властивість. Цей LinkedResourceCollection колекція надає метод для повного видалення вбудованих об’єктів, доданих до повідомлення електронної пошти. Використовуйте перевантажену версію методу LinkedResourceCollection.removeAt метод для видалення всіх слідів вбудованого об’єкта з повідомлення електронної пошти.

Наведений нижче зразок коду показує, як видалити вбудовані об’єкти з повідомлення електронної пошти.

// Load the test message with Linked Resources
MailMessage msg = MailMessage.load("EmlWithLinkedResources.eml");

// Remove a LinkedResource
msg.getLinkedResources().removeAt(0, true);

// Now clear the Alternate View for linked Resources
msg.getAlternateViews().get_Item(0).getLinkedResources().clear(true);

Витягування вбудованих об’єктів

У цьому розділі пояснюється, як витягнути вбудовані об’єкти з файлу електронної пошти. Вбудований об’єкт — це об’єкт, створений в одній програмі та включений у документ або файл, створений іншою програмою. Наприклад, електронна таблиця Microsoft Excel може бути вбудована в звіт Microsoft Word, або відеофайл може бути вбудований у презентацію Microsoft PowerPoint. Коли файл вбудовується, а не вставляється або копіюється в інший документ, він зберігає свій оригінальний формат. Вбудований документ можна відкрити у первинній програмі та змінити його. Щоб витягнути вбудований об’єкт з повідомлення електронної пошти, виконайте такі кроки:

Створіть екземпляр MailMessage клас.
Завантажте файл електронного листа у MailMessage екземпляр.
Створіть цикл і створіть екземпляр Attachment клас у цьому.
Збережіть вкладення та відобразіть його на екрані.
Вкажіть адресу відправника та отримувача у MailMessage екземпляр.
Надіслати електронний лист, використовуючи SmtpClient клас.

Нижченаведений фрагмент коду витягує вбудовані об’єкти з листа.

|Витягнуті вбудовані об’єкти у листі| | :- | || Нижченаведений фрагмент коду показує, як витягти вбудовані об’єкти.

MailMessage mailMsg = MailMessage.load("Message.msg", new MsgLoadOptions());

for (Attachment attachment : mailMsg.getAttachments()) {
    attachment.save("MessageEmbedded_out.msg");
    System.out.println(attachment.getName());
}

Ідентифікація та витяг вбудованого вкладення з MSG у форматі RTF

Нижченаведений код можна використати для повідомлень у форматі RTF, щоб розрізнити та витягти вкладення, які є Inline або відображаються як іконка у тілі повідомлення. Фрагмент коду показує, як ідентифікувати та витягти вбудоване вкладення з MSG у форматі RTF.

public static void extractInlineAttachments() {
    MapiMessage message = MapiMessage.load("MSG file with RTF Formatting.msg");
    for (MapiAttachment attachment : message.getAttachments()) {

        if (isAttachmentInline(attachment)) {
            try {
                saveAttachment(attachment, UUID.randomUUID().toString());
            } catch (Exception ex) {
                System.err.println(ex);
            }
        }
    }
}

static boolean isAttachmentInline(MapiAttachment attachment) {
    for (MapiProperty property : attachment.getObjectData().getProperties().get_Values()) {
        if ("\u0003ObjInfo".equals(property.getName())) {
            byte[] data = property.getData();
            int odtPersist1 = data[1] << 8 | data[0];
            return (odtPersist1 & 0x40) == 0;
        }
    }
    return false;
}

static void saveAttachment(MapiAttachment attachment, String fileName) throws IOException {
    for (MapiProperty property : attachment.getObjectData().getProperties().get_Values()) {
        if ("Package".equals(property.getName())) {
            try (FileOutputStream fs = new FileOutputStream(fileName)) {
                fs.write(property.getData(), 0, property.getData().length);
            }
        }
    }
}

Отримання вкладень з підписаного листа

Підписані листи містять одне вкладення smime.p7m. Це означає, що лист зашифрованний за допомогою SMIME. Формат файлу smime.p7m — це цифровий підпис. Щоб переглянути вміст цього листа, використайте RemoveSignature метод. Метод повертає MailMessage об’єкт без цифрового підпису.

MailMessage signedEml = MailMessage.load("signed.eml");

if (signedEml.isSigned()) {
    for (int i = 0; i < signedEml.getAttachments().size(); i++) {
        System.out.println("Signed email attachment" + i + ": " + signedEml.getAttachments().get_Item(i).getName());
    }

    // The email is signed. Remove a signature.
    MailMessage eml = signedEml.removeSignature();

    System.out.println("Signature removed.");

    for (int i = 0; i < eml.getAttachments().size(); i++) {
        System.out.println("Email attachment" + i + ": " + eml.getAttachments().get_Item(i).getName());
    }
}

Робота з Content-Type та Content-Disposition

Aspose.Email API надає можливість працювати з вкладенням Content-Type і Content-Disposition з заголовка вкладення. Нижче наведений фрагмент коду показує, як отримати та змінити опис вмісту вкладення.

Відображення параметрів Content-Type та Content-Disposition

Нижче наведений фрагмент коду показує, як вивести параметри Content-Type та Content-Disposition на екран:

void run(MailMessage message) {
    // Attachments
    for (Attachment attachment : message.getAttachments()) {
        ContentDisposition contentDisposition = attachment.getContentDisposition();
        printContentDisposition(contentDisposition);
        ContentType contentType = attachment.getContentType();
        printContentType(contentType);
    }
    // Linked Resources
    for (LinkedResource attachment : message.getLinkedResources()) {
        ContentDisposition contentDisposition = attachment.getContentDisposition();
        printContentDisposition(contentDisposition);
        ContentType contentType = attachment.getContentType();
        printContentType(contentType);
    }
}

void printContentType(ContentType contentType) {
    System.out.println("media-type: " + contentType.getMediaType());
    System.out.println("charset: " + contentType.getCharSet());
    System.out.println("name: " + contentType.getName());
}

void printContentDisposition(ContentDisposition contentDisposition) {
    System.out.println("disposition-type: " + contentDisposition.getDispositionType());
    System.out.println("is-inline: " + contentDisposition.getInline());
    System.out.println("filename: " + contentDisposition.getFileName());
    System.out.println("creation-date: " + contentDisposition.getCreationDate());
    System.out.println("modification-date: " + contentDisposition.getModificationDate());
    System.out.println("read-date: " + contentDisposition.getReadDate());
    System.out.println("size: " + contentDisposition.getSize());
}

Використання параметрів Content-Type та Content-Disposition з вкладеннями

Нижче наведений фрагмент коду показує, як використовувати параметри Content-Type та Content-Disposition з вкладенням:

MailMessage eml = MailMessage.load(fileName);

Attachment attachment = new Attachment(pdfFileName, new ContentType("application/octet-stream"));
attachment.getContentDisposition().setDispositionType("attachment");
attachment.getContentDisposition().setFileName(fileName);

eml.addAttachment(attachment);

Java: Витягування вмісту повідомлень з електронних листів

Mon, 01 Jan 0001 00:00:00 +0000

Відображення інформації електронної пошти на екрані

The MailMessage представляє повідомлення електронної пошти та дозволяє розробникам отримувати доступ до його властивостей. Інформація заголовка (обговорюється в Витягування заголовків електронної пошти) можна витягнути та маніпулювати різними способами. У цій статті пояснюється, як відобразити обрану інформацію заголовків електронної пошти та тіло листа на екрані.

Створіть екземпляр MailMessage.
Завантажте повідомлення електронної пошти у екземпляр MailMessage.
Відобразіть вміст електронного листа на екрані.

Нижче наведений код демонструє, як завантажити повідомлення електронної пошти та відобразити його вміст — відправника, отримувача, тему та тіло листа — на екрані.

Отримання дати і часу повідомлення

The MailMessage клас можна використати для отримання дати повідомлення в UTC або в місцевому часовому поясі. Цю інформацію можна підсумувати наступним чином:

MailMessage.getDate() - повертає дату в UTC
MailMessage.getLocalDate() - повертає дату у локальному часовому поясі
MailMessage.isLocalDate Повертає true, якщо MailMessage.getDate() у локальному часовому поясі

Витягування заголовків електронної пошти

Заголовок електронної пошти представляє набір полів заголовка, визначений стандартами Internet та RFC, що включені у повідомлення електронної пошти. Заголовок електронної пошти можна вказати за допомогою MailMessage клас. Спільні типи заголовків визначені у HeaderType клас. Це запечатаний клас, який працює як звичайне перерахування.

Щоб витягнути заголовки з електронної пошти, виконайте такі кроки:

Створіть екземпляр класу MailMessage.
Завантажте повідомлення електронної пошти в екземпляр класу MailMessage.
Після завантаження повідомлення електронної пошти ми отримаємо його необроблений вміст. Клас MailMessage містить такі властивості, як From, To, Cc, Subject тощо. Ці властивості можна витягнути з заголовків.
Відобразіть необроблений вміст.

Отримати декодовані значення заголовків

Отримати та змінити заголовок розташування пов’язаного ресурсу

Пов’язаний ресурс можна отримати та маніпулювати ним програмно в об’єкті електронного листа. The getContentDisposition() метод LinkedResource клас отримує заголовок Content‑Disposition. Нижче наведений приклад коду, який демонструє, як отримати доступ та змінити ім’я файлу пов’язаного ресурсу:

MailMessage eml = MailMessage.load(fileName);
eml.getLinkedResources().get_Item(0).getContentDisposition().setFileName("changed.png");

Отримати HTML‑тіло у вигляді простого тексту

The MailMessage клас забезпечує можливість витягти HTML‑тіло повідомлення у вигляді простого тексту. Клас MailMessage надає GetHtmlBodyText метод, який повертає HTML‑тіло у вигляді простого тексту. Метод GetHtmlBodyText приймає булевий параметр, який вказує, чи має тіло містити URL‑адреси. Передача параметра true означає, що HTML‑тіло має містити URL‑адреси.

Наступний фрагмент коду демонструє використання методу GetHtmlBodyText для отримання HTML‑тела електронного листа у вигляді простого тексту.

Отримати X.500 Exchange адреси з листів

Aspose.Email для Java дозволяє безпосередньо отримати X.500 адреси Exchange через MailAddress клас. За допомогою X500Address властивість, за допомогою якої можна отримати адресу електронної пошти у форматі Exchange X.500, коли вона доступна. Нижче наведений приклад коду показує, як завантажити повідомлення електронної пошти та отримати X.500 адресу відправника:

MailMessage mailMessage = MailMessage.load(fileName);
String exaddr = mailMessage.getFrom().getX500Address();

Якщо адреса X.500 існує, вона буде повернена як рядок і може бути використана для подальшої обробки або журналювання в застосунках, які взаємодіють з системами на базі Exchange.

Витягнути та вбудувати пов’язані зображення як вкладення у HTML‑повідомленнях

Aspose.Email ExtractHTMLBodyResourcesAsAttachments метод HtmlSaveOption клас визначає, чи витягати ресурси HTML‑тіла як вкладення. Таким чином, можна витягнути вміст, пов’язаний з зображеннями, з HTML‑тіла та вбудувати його як вкладення у MIME‑повідомлення. Пов’язані зображення зберігаються та правильно асоціюються з листом, підвищуючи цілісність вмісту та доступність офлайн.

Наступний приклад коду демонструє, як виконати це завдання:

MailMessage mailMessage = MailMessage.load("input.eml");
HtmlSaveOptions options = new HtmlSaveOptions();
options.setExtractHTMLBodyResourcesAsAttachments(true);
options.setResourceHtmlRenderingHandler(new ResourceHtmlRenderingHandler() {
    public void invoke(final Object sender, final ResourceHtmlRenderingEventArgs e) {
        System.out.println(e.getPathToResourceFile() + " " + ((Attachment)sender).getContentId());
    }
});

Java: Завантаження та збереження повідомлень

Mon, 01 Jan 0001 00:00:00 +0000

Завантаження та збереження електронних листів

Виявити формат файлу

API Aspose.Email забезпечує можливість виявлення формату файлу наданого повідомлення. The DetectFileFormat метод FileFormatUtil клас можна використати для цього. Наступні класи та методи можна застосовувати для визначення завантаженого формату файлу.

FileFormatType Клас
FileFormatInfo Клас
FileFormatUtil Клас
FileFormatUtil.detectFileFormat(Stream) Method
FileFormatUtil.detectFileFormat(String) Method

Наступний фрагмент коду показує, як виявити формати файлів.

Завантажити електронний лист

Щоб завантажити повідомлення з певними параметрами завантаження, Aspose.Email надає the LoadOptions клас, який можна використати наступним чином:

Зберегти формат вбудованих повідомлень під час завантаження

Збереження та конвертація електронних листів

Aspose.Email спрощує конвертацію будь‑якого типу повідомлення в інший формат. Щоб продемонструвати цю можливість, код у цій статті завантажує три типи повідомлень з диска та зберігає їх у інших форматах. Базовий клас SaveOptions і класи EmlSaveOptions, MsgSaveOptions, MhtSaveOptions, HtmlSaveOptions для додаткових налаштувань під час збереження MailMessage можна використати для збереження повідомлень у інші формати. У статті показано, як використати ці класи для збереження прикладу листа у вигляді:

EML‑формат.
Outlook MSG.
MHTML‑формат.
HTML‑формат.

Завантажити та зберегти електронний лист

Наступний фрагмент коду показує, як завантажити EML‑повідомлення та зберегти його на диск у тому ж форматі.

Завантажити та зберегти електронний лист, зберігаючи оригінальні межі

Наступний фрагмент коду показує, як завантажити EML та зберегти його як EML, зберігаючи оригінальні межі.

Збереження у форматі EML з збереженням TNEF‑вкладень

Наступний фрагмент коду показує, як зберегти у форматі EML, зберігаючи TNEF‑вкладення.

Зберегти EML у MSG

Наступний фрагмент коду показує, як завантажити EML‑повідомлення та конвертувати його у MSG, використовуючи відповідний параметр з SaveOptions.

Зберегти EML у MSG зі збереженими датами

The MsgSaveOptions клас дозволяє зберегти вихідне повідомлення у файл Outlook Message (MSG), зберігаючи дати. Наступний фрагмент коду показує, як зберігати у форматі MSG зі збереженими датами.

Зберегти EML у MHTML

Різні параметри MHTML можна використати для досягнення потрібних результатів. Наступний фрагмент коду показує, як завантажити EML‑повідомлення у MailMessage і конвертувати його у MHTML з датою повідомлення в системі UTC.

// Set options for MHTML output
MhtSaveOptions saveOptions = SaveOptions.getDefaultMhtml();
// save a message date as UTC date
saveOptions.setPreserveOriginalDate(false);

// Initialize and load an existing EML file
try (MailMessage mailMessage = MailMessage.load(dataDir + "Message.eml")) {
    mailMessage.save(outDir + "Message_out.mhtml", saveOptions);
}

Форматувати MHT‑заголовки глобально під час збереження з EML

З Aspose.Email ви можете використовувати глобальні параметри форматування заголовка Mht. Глобальні параметри встановлюють спільне форматування заголовка Mht для всіх MhtSaveOptions екземплярів. Ця функція розроблена для уникнення налаштування форматування для кожного екземпляра MhtSaveOptions.

Використайте наступні методи GlobalFormattingOptions клас і наведений нижче приклад коду для встановлення форматування заголовка Mht:

setPageHeaderFormat(String value) - PageHeaderFormat для екземплярів HeadersFormattingOptions, якщо DefaultPageHeaderFormat не встановлено.
setHeaderFormat(String value) - HeaderFormat для екземплярів HeadersFormattingOptions, якщо DefaultHeaderFormat не встановлено.
setBeforeHeadersFormat(String value) - BeforeHeadersFormat для екземплярів HeadersFormattingOptions, якщо BeforeHeadersFormat не встановлено.
setAfterHeadersFormat(String value) - AfterHeadersFormat для екземплярів HeadersFormattingOptions, якщо AfterHeadersFormat не встановлено.

// saveOptions1 and saveOptions2 have the same mht header formatting
MhtSaveOptions saveOptions1 = new MhtSaveOptions();
MhtSaveOptions saveOptions2 = new MhtSaveOptions();

Конвертувати EML у MHTML з додатковими налаштуваннями

The MhtSaveOptions клас надає додаткові параметри для збереження електронних листів у формат MHTML. Перелічувач MhtFormatOptions дає можливість записати додаткову інформацію листа у вихідний MHTML. Можна записати наступні додаткові поля:

WriteHeader - записує заголовок листа у вихідний файл.
WriteOutlineAttachments - записує позначені вкладення у вихідний файл.
WriteCompleteEmailAddress - записує повну електронну адресу у вихідний файл.
NoEncodeCharacters - не слід використовувати кодування передачі символів.
HideExtraPrintHeader - приховує додатковий заголовок друку у верхній частині вихідного файлу.
WriteCompleteToEmailAddress - записує повну адресу отримувача у вихідний файл.
WriteCompleteFromEmailAddress - записує повну адресу відправника у вихідний файл.
WriteCompleteCcEmailAddress - записує повні електронні адреси будь‑яких отримувачів у копії (Cc) у вихідний файл.
WriteCompleteBccEmailAddress - записує повну електронну адресу будь‑якого отримувача в копії (Bcc) у вихідний файл.
RenderCalendarEvent - записує текст з календарної події у вихідний файл.
SkipByteOrderMarkInBody - записує байти маркера порядку байтів (BOM) у вихідний файл.
RenderVCardInfo - записує текст з VCard AlternativeView у вихідний файл.
DisplayAsOutlook - відображає заголовок From.
RenderTaskFields - записує певні поля завдання у вихідний файл.
None - Не вказано налаштування.

Наступний фрагмент коду показує, як конвертувати файли EML у MHTML з додатковими налаштуваннями.

Рендерити події календаря під час конвертації у MHTML

The MhtFormatOptions.RenderCalendarEvent виводить події календаря у вихідний MHTML. Наступний фрагмент коду показує, як рендерити події календаря під час конвертації у MHTML.

Експортувати лист у MHT без вбудованих зображень

Експорт електронного листа у MHT з кастомізованим часовим поясом

MailMessage class надає setTimeZoneOffset властивість для встановлення кастомізованого часового поясу під час експорту у MHT. У наведеному фрагменті коду показано, як експортувати електронний лист у MHT з кастомізованим часовим поясом.

MailMessage msg = MailMessage.load(filename, new MsgLoadOptions());
msg.setDate(new Date());

// Set the timezone offset in milliseconds
msg.setTimeZoneOffset(5*60*60*1000);

MhtSaveOptions mhtOptions = new MhtSaveOptions();
mhtOptions.setMhtFormatOptions(MhtFormatOptions.WriteHeader);
msg.save(dataDir + "ExportToMHTWithCustomTimezone_out.mhtml", mhtOptions);

Експорт електронного листа у EML

У наведеному фрагменті коду показано, як експортувати електронні листи у формат EML.

Зберегти електронний лист у HTML

The HtmlSaveOptions клас дозволяє експортувати тіло повідомлення у HTML. У наведеному фрагменті коду показано, як зберегти повідомлення у форматі HTML.

Збереження електронного листа у HTML з відносним шляхом до ресурсів

Під час експорту електронних листів у формат HTML можна вибрати збереження ресурсів листа з відносними шляхами. Ця функція забезпечує більшу гнучкість у тому, як ресурси пов’язуються у вихідному HTML‑файлі, що спрощує обмін та відображення збережених листів на різних системах. HtmlSaveOptions.UseRelativePathToResources властивість забезпечує можливість зберігати ресурси з відносними шляхами. Типове значення властивості — false (ресурси зберігаються з абсолютними шляхами). При встановленні в true ресурси зберігаються з відносними шляхами. HTML‑файли з відносними шляхами більш портативні і можуть коректно відображатися незалежно від структури файлової системи хостинг‑оточення. Ви можете обирати між абсолютними та відносними шляхами залежно від вимог. Ви можете визначати кастомні шляхи для ресурсів, використовуючи ResourceHtmlRenderingHandler подія.

Збереження з типово відносним шляхом до ресурсів

MapiMessage msg = MapiMessage.load(sourceFileName);

HtmlSaveOptions htmlSaveOptions = new HtmlSaveOptions();
htmlSaveOptions.setResourceRenderingMode(ResourceRenderingMode.SaveToFile);
htmlSaveOptions.setUseRelativePathToResources(true);

msg.save("target.html", htmlSaveOptions);

У цьому випадку ресурси будуть збережені у папці [html file name].files, в тому ж шляху, що й файл .html, і HTML буде посилатися на ресурси через відносні шляхи.

Збереження з абсолютним шляхом до ресурсів

MapiMessage msg = MapiMessage.load(sourceFileName);

HtmlSaveOptions htmlSaveOptions = new HtmlSaveOptions();
htmlSaveOptions.setResourceRenderingMode(ResourceRenderingMode.SaveToFile);
htmlSaveOptions.setUseRelativePathToResources(false);

msg.save("target.html", htmlSaveOptions);

Як і в першому випадку, ресурси за замовчуванням будуть збережені у папці [html file name].files, але HTML буде посилатися на ресурси за допомогою абсолютних шляхів.

Кастомний відносний шлях за допомогою події ResourceHtmlRenderingHandler

MapiMessage msg = MapiMessage.load(sourceFileName);

HtmlSaveOptions htmlSaveOptions = new HtmlSaveOptions();
htmlSaveOptions.setResourceRenderingMode(ResourceRenderingMode.SaveToFile);
htmlSaveOptions.setUseRelativePathToResources(false);

htmlSaveOptions.setResourceHtmlRenderingHandler(new ResourceHtmlRenderingHandler() {
    @Override
    public void invoke(Object sender, ResourceHtmlRenderingEventArgs args) {
        if (sender instanceof AttachmentBase) {
            AttachmentBase attachment = (AttachmentBase) sender;
            // Since UseRelativePathToResources = true, you should assign a relative path to the PathToResourceFile property.
            args.setPathToResourceFile("images\\" + attachment.getContentType().getName());
        }
    }
});

msg.save(targetPath + "A Day in the Park.html", htmlSaveOptions);

Використовуючи ResourceHtmlRenderingHandler подія, ви можете встановити кастомні відносні або абсолютні шляхи для ресурсів. При налаштуванні шляхів за допомогою ResourceHtmlRenderingHandler обробник події, і оскільки UseRelativePathToResources встановлено в true, вам слід призначити відносний шлях до PathToResourceFile властивість для забезпечення коректного посилання.

Збереження кастомних іконок у повідомленні під час конвертації у HTML

Іноді повідомлення містить вбудовані вкладення, які відображаються як зображення іконок у тілі повідомлення. Такі повідомлення можуть створювати проблеми під час конвертації у HTML, оскільки зображення іконок втрачаються. Це пов’язано з тим, що іконки вкладень не зберігаються безпосередньо в повідомленні.

Користувач Aspose.Email може налаштувати іконки для вкладень при конвертації повідомлення у HTML. Для цього HtmlSaveOptions.ResourceHtmlRendering подія використовується для налаштування відображення файлів ресурсів (наприклад, вкладень) під час збереження електронного листа у файл HTML. У наведеному нижче прикладі коду обробник події використовується для динамічного встановлення шляху до файлів ресурсів (іконок) залежно від типу вмісту вкладення. Це дозволяє кастомізовано відображати ресурси у HTML‑виводі залежно від їх типу файлу.


 HtmlSaveOptions options = new HtmlSaveOptions();

options.setResourceHtmlRenderingHandler(new ResourceHtmlRenderingHandler() {

   @Override

   public void invoke(Object sender, ResourceHtmlRenderingEventArgs e) {

        AttachmentBase attachment = (AttachmentBase) sender;

        e.setCaption(attachment.getContentType().getName());

       if (attachment.getContentType().getName().endsWith(".pdf")) {

            e.setPathToResourceFile("pdf_icon.png");

       } else if (attachment.getContentType().getName().endsWith(".docx")) {

            e.setPathToResourceFile("word_icon.jpg");

       } else if (attachment.getContentType().getName().endsWith(".jpg")) {

            e.setPathToResourceFile("jpeg_icon.png");

       } else {

            e.setPathToResourceFile("not_found_icon.png");

       }

   }

});

options.setResourceRenderingMode(ResourceRenderingMode.SubstituteFromFile);

String fileName = "message.msg";

MailMessage mailMessage = MailMessage.load(fileName);

mailMessage.save("fileName.html", options);

Встановлення часу та часового поясу при збереженні EML у HTML

Користувачі Aspose.Email можуть встановити формати відображення часу та часового поясу в HtmlSaveOptions. The HeadersFormattingOptions клас дозволяє вказати параметри форматування заголовків під час збереження MailMessage у форматі Mhtml або Html. Наступні методи HtmlFormatOptions клас визначає поля, які будуть відображені у вихідному файлі:

RenderCalendarEvent - Вказує, що текст з календарної події має бути записаний у вихідний mhtml.
RenderVCardInfo - Вказує, що текст з VCard AlternativeView має бути записаний у вихідний html.

У наведеному прикладі коду показано, як встановити час та часовий пояс під час збереження EML у HTML:

MailMessage msg = MailMessage.load("fileName");
HtmlSaveOptions options = new HtmlSaveOptions();
options.setHtmlFormatOptions(HtmlFormatOptions.WriteHeader);
options.getFormatTemplates().set_Item("DateTime", "MM d yyyy HH:mm tt");

Збереження у HTML без вбудованих ресурсів

Збереження повідомлення як шаблон Outlook (.oft)

У наведеному фрагменті коду показано, як зберегти повідомлення як шаблон Outlook (.oft).

Java: Утиліти - MailMessage

Mon, 01 Jan 0001 00:00:00 +0000

Шифрування та дешифрування повідомлень

Aspose.Email надає можливість шифрування та дешифрування електронних листів. У цій статті показано, як завантажити існуюче або нове повідомлення та зашифрувати його за допомогою MailMessage. The encrypt() і decrypt() методи повертають об’єкт MailMessage з застосованими ефектами, і про це потрібно пам’ятати під час шифрування/дешифрування повідомлень. Процес шифрування та дешифрування повідомлень включає наступні кроки:

Створити нове повідомлення або завантажити існуюче
Зашифрувати повідомлення за допомогою файлу сертифіката
Надіслати повідомлення або зберегти його
Розшифрувати повідомлення за потребою

Наступний фрагмент коду показує, як шифрувати та дешифрувати повідомлення.

Перевірка повідомлення на шифрування

Aspose.Email MailMessage клас дозволяє перевірити, чи зашифровано повідомлення. The isEncrypted властивість MailMessage дозволяє перевіряти це, як показано у наведеному прикладі коду.

Шифрування повідомлень за допомогою X509Certificate

Aspose.Email надає API для роботи з зашифрованими повідомленнями за допомогою X509Certificate:

MailMessage клас має наступні методи для роботи з шифруванням повідомлень:

public MailMessage attachSignature(X509Certificate2 certificate, boolean detached) - Створює підписане повідомлення.
public MailMessage attachSignature(X509Certificate2 certificate) - Створює підписане повідомлення.
public X509Certificate2[] checkSignatureCert() - Перевіряє підпис існуючого MailMessage.
public MailMessage decrypt(X509Certificate2 certificate)
public MailMessage encrypt(X509Certificate2 certificate)
public MailMessage encrypt(X509Certificate2[] certificates)

Налаштування параметрів локалі для Aspose.Email

Ви можете використати LocaleOptions клас у випадку невизначеної локалі за замовчуванням та встановлює найбільш підходящу локаль для бібліотеки Aspose Email. Він пропонує наступні методи для виконання завдання:

getLocale() - Повертає локаль за замовчуванням для Aspose.Email.
setLocale(Locale locale) і setLocale(String localeName) - Встановлює локаль за замовчуванням для Aspose.Email.
clear() - Очищає локаль за замовчуванням для Aspose.Email. Буде використана локаль за замовчуванням для Java.

Наступний приклад коду демонструє, як завантажити лист з файлу, використовуючи вказані налаштування локалі:

final Locale locale = new Locale("en", "DE");
Locale.setDefault(locale);

// set Locale for Aspose Email lib
LocaleOptions.setLocale("en-US");
// or
//LocaleOptions.setLocale(new Locale("en", "US"));

MailMessage.load("document.msg");

Цей код гарантує, що застосунок та бібліотека Aspose.Email використовують вказані локалі для обробки мови, країни та культурних особливостей.

Повідомлення з TNEF‑вкладеннями

Transport Neutral Encapsulation Format (TNEF) — це власний формат вкладень електронної пошти, що використовується Microsoft Outlook та Microsoft Exchange Server. API Aspose.Email дозволяє читати листи з вкладеннями TNEF та змінювати їх вміст. Після цього лист можна зберегти як звичайний лист або у тому ж форматі, зберігаючи TNEF‑вкладення. У цій статті показано різні приклади коду для роботи з листами, що містять TNEF‑вкладення.

Читання повідомлення з збереженням TNEF‑вкладень

Наступний фрагмент коду показує, як прочитати повідомлення, зберігаючи вкладення TNEF.

Оновлення ресурсів у TNEF‑вкладенні та збереження формату TNEF

Наступний фрагмент коду показує, як оновити ресурси у TNEF‑вкладенні та зберегти формат TNEF.

Додавання нових вкладень до головного повідомлення, що містить TNEF

Створення TNEF EML з MSG

MSG‑файли Outlook іноді містять інформацію, таку як таблиці та стилі тексту, які можуть бути порушені при конвертації у EML. Створення TNEF‑повідомлень з таких MSG‑файлів дозволяє зберегти форматування та навіть надсилати такі повідомлення через поштові клієнти, зберігаючи форматування.

Для створення TNEF можна використати наступний приклад коду.

Виявлення, чи є повідомлення TNEF

Обробка повернутих повідомлень

Дуже часто повідомлення, надіслане одержувачу, може повернутися (bounce) з будь‑якої причини, наприклад через недійсну адресу отримувача. API Aspose.Email має можливість обробляти таке повідомлення для перевірки, чи є воно повернутим електронним листом чи звичайним листом. The CheckBounced метод MailMessage клас повертає коректний результат, якщо електронне повідомлення є bounced‑листом.

У цій статті показано використання BounceResult клас, який забезпечує можливість перевірки, чи є повідомлення bounced‑листом. Він також надає детальну інформацію про одержувачів, вжиті дії та причину сповіщення.

Ігнорувати виключення

Бібліотека пропонує an ExceptionManager клас для впровадження можливості ігнорування виключень у функціональність вашого застосунку. Нижче наведено фрагмент коду, який демонструє, як встановити зворотний виклик для обробки виключень:

 ExceptionManager.setIgnoreExceptionsHandler( new IgnoreExceptionsCallback() {

   //exception path: {Module}\{Method}\{Action}\{GUID}

   //example: MailMessage\Load\DecodeTnefAttachment\64149867-679e-4645-9af0-d46566cae598

   public boolean invoke(AsposeException ex, String path) {

       //Ignore all exceptions on MailMessage.Load

       return path.equals("MailMessage\\Load");

   }

});

Або використайте альтернативу:

 ExceptionManager.setIgnoreAll(true);

Також ви можете встановити зворотний виклик для журналу ігнорованих виключень:

ExceptionManager.setIgnoreExceptionsLogHandler( new IgnoreExceptionsLogCallback() {

   public void invoke(String message) {

        System.out.println("=== EXCEPTION IGNORED === " + message);

   }

});

Користувач буде повідомлений, що виключення можна ігнорувати, за допомогою повідомлення про помилку. Наприклад:

Виключення у повідомленні:

AsposeArgumentException: properties should not be empty.

Якщо ви хочете ігнорувати виключення і продовжити виконання, ви можете використати:

ExceptionManager.getIgnoreList().add("MailMessage\\Load\\DecodeTnefAttachment\\64149867-679e-4645-9af0-d46566cae598")

Invalid TNEF Attachment will be interpreted as regular attachment.

Байєсовий аналізатор спаму

Aspose.Email надає можливість фільтрації електронної пошти за допомогою байєсового аналізатора спаму. Він надає the SpamAnalyzer клас для цієї мети. У цій статті показано, як навчити фільтр розрізняти спам та звичайні електронні листи на основі бази слів.

Отримання преамбули та епіграфа з EML‑повідомлень

У форматі MIME преамбуль — це текст, який розташовується після заголовків і перед першою межою multipart. Епіграф — це текст, який розташовується після останньої межі і перед кінцем повідомлення. Цей текст зазвичай не видимий користувачам у поштових клієнтах, проте деякі реалізації MIME можуть використовувати його для вставки приміток одержувачам, які читають повідомлення за допомогою програм, несумісних з MIME.

Наступний фрагмент коду показує, як отримати преамбулу та епіграф з EML‑повідомлення, що може бути здійснено за допомогою відповідних методів of the MailMessage клас:

setPreamble(String value) - Отримує або встановлює текст преамбули.
setEpilogue(String value) - Отримує або встановлює текст епіграфа.

// Gets or sets a preamble text.
public String getPreamble, setPreamble

// Gets or sets an epilogue text.
public String getEpilogue, setEpilogue

Java: Відстеження прогресу конвертації документа

Mon, 01 Jan 0001 00:00:00 +0000

Відстеження прогресу конвертації документа

Aspose.Email надає можливість відстежувати прогрес конвертації документа. Для цього API забезпечує SaveOptions.CustomProgressHandler. який представляє метод, що обробляє події прогресу. Типи подій прогресу представляються ProgressEventType перерахування. Перерахування ProgressEventType містить такі члени.

MimeStructureCreated: Ця подія повідомляє, що створена MIME‑структура.
MimePartSaved: Ця подія повідомляє про завершення збереження однієї MIME‑частини.
SavedToStream: Ця подія повідомляє, що всі MIME‑частини збережені у потік.

Наступний приклад коду демонструє використання SaveOptions.CustomProgressHandler та перерахування ProgressEventType для відстеження прогресу конвертації документа.

Нижче наведений код користувацького класу, який використовується у наведеному вище прикладі коду.

Java: Відображення гіперпосилань із власним стилем

Mon, 01 Jan 0001 00:00:00 +0000

Іноді може знадобитися виводити гіперпосилання з певним стилем відповідно до вимог вашого застосунку. Для цього Aspose.Email надає HyperlinkRenderingCallback. Ви можете передати HyperlinkRenderingCallback як параметр MailMessage.GetHtmlBodyText.

Наступний фрагмент коду показує, як використати HyperlinkRenderingCallback для виведення гіперпосилань у власному стилі.

Методи RenderHyperlinkWithHref та RenderHyperlinkWithoutHref призначені лише для демонстрації рендерингу гіперпосилань і не призначені для використання у продакшені.

Java: Відображати інформацію у власному порядку у файлах MHTML

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email надає MhtSaveOptions.RenderingHeaders властивість, яка повертає список заголовків для рендерингу. Ви можете додати заголовки, використовуючи MhtTemplateName клас. Порядок, у якому додаються заголовки, визначає порядок відображення інформації.

Наступне зображення порівнює три виходи, створені прикладом коду.

Нижче наведений фрагмент коду демонструє використання MhtSaveOptions.RenderingHeaders властивість для встановлення порядку, у якому інформація відображається у вихідних файлах MHTML.