Documentation – Работа с MIME съобщения

Java: Създаване и задаване на съдържание на имейли

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

Създаване на ново имейл съобщение

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

За да създадете имейл съобщение от нулата:

Създайте инстанция на класа MailMessage.
Задайте темата на съобщението, като използвате setSubject() метод.
Задайте тялото на съобщението, като използвате setHtmlBody() метод.
Задайте изпращача на имейла, като използвате setFrom() метод.
Задайте получателя в полето TO, като използвате getTo().add() метод.
Задайте получателя в полето CC, като използвате getCC().add() метод.
Извикайте Save() метод за запазване на файла със съобщението на диск в формати MSG, EML и MHT.

Задаване на множество получатели

Този MailMessage представлява имейл съобщение. Инстанциите на класа MailMessage се използват за конструиране на имейл съобщения, които се предават към SMTP сървър чрез SmtpClient клас. Тази тема демонстрира как да зададете повече от един имейл адрес. Имейл адресите могат да се зададат, използвайки класа MailMessage. Имейл адресите, използвани в класа MailMessage, са:

To - Адресите на получателите могат да се зададат в полето ‘To’. Получателите в полето ‘To’ са основната аудитория на съобщението. Може да има повече от един адрес на получател.
Cc - CC означава „carbon copy“ (копие) или „courtesy copy“ (учтиво копие) и ви позволява да добавите получатели, които трябва да видят имейла, но не са задължени да предприемат действия. Мениджъри, например, или членове на вашия екип, които трябва да бъдат информирани за разговор. С Aspose.Email, адресите за CC могат да се задават в кода. По този начин автоматичните имейли, или всички имейли към конкретен адрес, могат да се копират на съответния персонал.
Bcc - Bcc, слепо копиране (blind carbon copy), ви позволява да изпратите имейл до получател, който е скрит от другите получатели. Докато 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.

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

Задаване на тяло на имейл

Този 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 – седембитов ASCII, известен също като ISO646-US, или базовия латински блок от Unicode наборa
ISO-8859-1 – ISO латинска азбука №1, известна също като ISO-LATIN-1
UTF-8 – осембитов UCS трансформационен формат
UTF-16BE – шестнайсетбитов UCS трансформационен формат, голямо-ендийен ред на байтовете
UTF-16LE – шестнайсетбитов UCS трансформационен формат, малко-ендийен ред на байтовете
UTF-16 – шестнайсетбитов UCS трансформационен формат, редът на байтовете се определя от незадължителен байтов маркер за реда.

Aspose.Email използва BodyEncoding свойство на класа MailMessage за задаване на кодиране на тялото на имейла. За да кодирате тялото на имейл съобщение, следвайте стъпките по-долу:

Създайте инстанция на класа MailMessage.
Задайте изпращача, получателя и HTML тялото на имейла в инстанцията MailMessage.
Задайте стойността на свойството BodyEncoding.
Създайте инстанция на SmtpClient клас и изпрати имейла, използвайки метода Send.

Функции на MailMessage

Този 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 клас. Това е затворен (sealed) клас, който функционира като обикновена изброяване.

Обикновено заглавка на имейл съдържа следните полета:

To: Адресите на получателите могат да се посочат в полето To. Получателите в полето To са основната аудитория на съобщението. Може да има повече от един адрес на получател.
From: Това поле показва имейл адреса на подателя на съобщението.
Cc: Позволява на потребителите да изпратят съобщение като „Carbon Copy“ или „Courtesy Copy“. Това означава, че получателят не се очаква да отговори или да действа. Обикновено надзорният персонал се уведомява чрез CC.
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

Вмъкване на заглавка на конкретно място

Този Добавяне метод на 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.

Извършване на Mail Merge

Mail merge‑овете ви помагат да създадете и изпратите партида от сходни имейл съобщения. Основата на имейлите е еднаква, но съдържанието може да бъде персонализирано. Обикновено данните за контакт на получателя (име, фамилия, фирма и др.) се използват за персонализиране на имейла.

|| | :- | |Фигура: Илюстрация как работи mail merge|

За да извършите сливане на писма (mail merge) с Aspose.Email, изпълнете следните стъпки:

Създайте функция с име signature
Създайте инстанция на 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 MB.

Try it out!

Добавяйте или премахвайте имейл прикачени файлове онлайн с безплатния 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 клас. Този 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 от прикачване

Aspose.Email API предоставя възможността за четене на 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 форматирани прикачвания

Този Attachment.isTnef свойство на Aspose.Email Java API, което показва дали прикачването към съобщението е форматирано като TNEF.

Следният кодов откъс демонстрира как да се определи дали прикачването е форматирано като TNEF:

MailMessage eml = MailMessage.load(fileName);

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

Зареждане и записване на TNEF прикачвания

Aspose.Email for 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. Когато файлът е вграден, вместо да бъде вмъкнат или поставен в друг документ, той запазва оригиналния си формат. Вграденият документ може да бъде отворен в оригиналното приложение и модифициран.

Вграждане на обекти в имейл

Този LinkedResource клас се използва с MailMessage клас за вграждане на обекти във вашите имейл съобщения. За да добавите вграден обект, следвайте тези стъпки

Създайте инстанция на MailMessage клас.
Посочете стойностите за от, до и тема в MailMessage екземпляр.
Създайте инстанция на AlternateView клас.
Създайте инстанция на LinkedResource клас.
Заредете вграден обект в LinkedResourceCollection.
Добавете заредения вграден обект в MailMessage инстанция на класа.
Добавете AlternateView екземпляр към MailMessage инстанция на класа.

Примерите с код по-долу създават имейл съобщение както с обикновен текст, така и с HTML тела и изображение, вградено в HTML

|Изображение, вградено в имейл| | :- | || Можете да изпратите произволен брой вградени обекти. Размерът на прикачения файл е ограничен от пощенския сървър. Gmail, например, не поддържа файлове по-големи от 10 MB. Примерите с код по-долу демонстрират как да вградите обекти в имейл.

// 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 свойство. The 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

Показване на имейл информация на екрана

Този MailMessage представлява имейл съобщение и позволява на разработчиците да достъпват свойства на имейл съобщението. Информацията от заглавието (обсъдена в Извличане на заглавия на имейл) могат да бъдат извлечени и манипулирани по различни начини. Тази статия обяснява как да се покажат избрани заглавни данни от имейл и тялото му на екрана.

Създайте екземпляр на MailMessage.
Заредете имейл съобщение в екземпляра MailMessage.
Показване на съдържанието на имейла на екрана.

Кодът по-долу демонстрира как да заредите имейл съобщение и да покажете неговото съдържание – от, до, тема и тяло на имейла – на екрана.

Получаване на дата и час на съобщението

Този MailMessage класът може да се използва за извличане на датата на съобщението в UTC или в местната часова зона. Тази информация може да се обобщи както следва:

MailMessage.getDate() - връща датата в UTC
MailMessage.getLocalDate() - връща дата в местната часова зона
MailMessage.isLocalDate Връща true, ако MailMessage.getDate() е в местната часова зона

Извличане на заглавия на имейл

Заглавието на имейл представлява набор от полета, дефинирани от Интернет и RFC стандарти, включени в интернет имейл съобщения. Заглавието на имейл може да се зададе с помощта на MailMessage клас. Общите типове на заглавки са дефинирани в HeaderType клас. Това е запечатан клас, работещ като обикновено изброяване.

За да извлечете заглавия от имейл, следвайте тези стъпки:

Създайте екземпляр на клас MailMessage.
Заредете имейл съобщение в екземпляра на клас MailMessage.
След като имейл съобщението е заредено, ще получим неговото сурово съдържание. Класът MailMessage сам съдържа свойства като From, To, Cc, Subject и др. Тези свойства могат да бъдат извлечени от заглавията.
Покажете суровото съдържание.

Получаване на декодирани стойности на заглавието

Получаване и модифициране на заглавката Disposition на свързания ресурс

Свързаният ресурс може да бъде достъпен и манипулиран програмно в обекта на съобщението по имейл. The getContentDisposition() метод на LinkedResource класът получава заглавката Content-Disposition. Следният примерен код демонстрира как да се достъпи и промени името на файла на свързания ресурс:

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

Получаване на HTML тело като обикновен текст

Този 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

Зареждане и запазване на имейл съобщения

Откриване на файлов формат

Aspose.Email API предоставя възможност за откриване на файловия формат на предоставения файл със съобщението. The DetectFileFormat метод на FileFormatUtil клас може да се използва за това. Следните класове и методи могат да се използват за откриване на заредения файл формат.

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

Следният примерен код показва как да се открият файлови формати.

Заредете имейл съобщение

За да заредите съобщение със специфични опции за зареждане, Aspose.Email предоставя 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 със запазени дати

Този 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 с опционални настройки

Този MhtSaveOptions клас предоставя допълнителни опции за запазване на имейл съобщения във формат MHTML. Перечисление MhtFormatOptions прави възможно записването на допълнителна имейл информация във изходен MHTML. Следните допълнителни полета могат да бъдат записани:

WriteHeader - записва заглавната част на имейла във изходния файл.
WriteOutlineAttachments - записва външни прикачени файлове във изходния файл.
WriteCompleteEmailAddress - записва пълния имейл адрес във изходния файл.
NoEncodeCharacters - не трябва да се използва трансферно кодиране на символи.
HideExtraPrintHeader - скрива допълнителната печатна заглавка от върха на изходния файл.
WriteCompleteToEmailAddress - записва пълния имейл адрес на получателя във изходния файл.
WriteCompleteFromEmailAddress - записва пълния имейл адрес на подателя във изходния файл.
WriteCompleteCcEmailAddress - записва пълните имейл адреси на всички получатели с копие (CC) във изходния файл.
WriteCompleteBccEmailAddress - записва пълния имейл адрес на всички получатели със скрито копие (BCC) във изходния файл.
RenderCalendarEvent - записва текст от календарното събитие във изходния файл.
SkipByteOrderMarkInBody - записва байтове на маркера за реда на байтовете (BOM) във изходния файл.
RenderVCardInfo - записва текст от VCard AlternativeView във изходния файл.
DisplayAsOutlook - показва заглавието От.
RenderTaskFields - записва специфични полета на задачата във изходния файл.
Никакво - Не е зададена настройка.

Следният примерен код показва как да конвертирате EML файлове в MHTML с опционални настройки.

Извеждане на календарни събития при конвертиране към MHTML

Този MhtFormatOptions.RenderCalendarEvent извежда календарните събития в изходния MTHML. Следният примерен код показва как да извеждате календарни събития, докато конвертирате към MHTML.

Експортиране на имейл към MHT без вградени изображения

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

MailMessage клас предоставя 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

Този 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() - Връща подразбиращия се Locale за 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. Aspose.Email API ви позволява да четете имейл съобщения, които имат TNEF прикачени файлове и да модифицирате тяхното съдържание. След това имейлът може да бъде запазен като обикновен имейл или в същия формат, запазвайки TNEF прикачените файлове. Тази статия показва различни примерни кодове за работа със съобщения, съдържащи TNEF прикачени файлове.

Четене на съобщение със запазени TNEF прикачени файлове

Следният кодов фрагмент ви показва как да прочетете съобщение, като запазвате TNEF прикачени файлове.

Актуализиране на ресурси в TNEF прикачен файл и запазване на TNEF формата

Следният кодов фрагмент ви показва как да актуализирате ресурси в TNEF прикачен файл и да запазите TNEF формата.

Добавяне на нови прикачени файлове към главното съобщение, съдържащо TNEF

Създаване на TNEF EML от MSG

Outlook MSG файловете понякога съдържат информация като таблици и текстови стилове, които могат да се разстроят при конвертиране към EML. Създаването на TNEF съобщения от такива MSG файлове ни позволява да запазим форматирането и дори да изпратим такива съобщения чрез имейл клиентите, като запазим форматирането.

За създаване на TNEF може да се използва следният примерен код.

Откриване дали съобщението е TNEF

Обработване на отскочени съобщения

Много често е, че съобщение, изпратено до получател, може да се отскочи по различни причини, като например невалиден адрес на получателя. API на Aspose.Email разполага с възможност за обработка на такова съобщение за проверка дали е отскочено имейл съобщение или обикновено имейл съобщение. The CheckBounced метод на MailMessage класът връща валиден резултат, ако имейл съобщението е отскочил имейл.

Тази статия показва използването на BounceResult клас, който предоставя възможност за проверка дали съобщението е отскочил имейл. Той също така дава подробна информация за получателите, предприетото действие и причината за уведомлението.

Игнориране на изключения

Библиотеката предлага 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 съобщение, което може да се постигне със съответните методи на 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 файлове.