Documentation – کار با پیام‌های MIME

Java: ایجاد و تنظیم محتوای ایمیل‌ها

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

ایجاد پیام ایمیل جدید

Aspose.Email برای جاوا به توسعه‌دهندگان امکان ایجاد پیام‌های MIME (Multipurpose Internet Mail Extensions) از ابتدا را می‌دهد. کلاس اصلی برای این منظور در API Aspose.Email برای جاوا، MailMessage کلاس. این موضوع مراحل لازم برای ایجاد پیام‌های ایمیل در فرمت‌های فایل EML، MSG و MTH با استفاده از Aspose.Email برای جاوا را توضیح می‌دهد.

برای ایجاد یک پیام ایمیل از ابتدا:

یک نمونه از کلاس MailMessage ایجاد کنید.
موضوع پیام را با استفاده از setSubject() متد.
متن پیام را با استفاده از setHtmlBody() متد.
فرستنده ایمیل را با استفاده از setFrom() متد.
گیرنده را در فیلد TO با استفاده از getTo().add() متد.
گیرنده را در فیلد CC با استفاده از getCC().add() متد.
متد را فراخوانی کنید Save() روشی برای ذخیره فایل پیام بر روی دیسک در فرمت‌های MSG، EML و MHT.

مشخص کردن چندین گیرنده

این MailMessage نمایانگر یک پیام ایمیل است. نمونه‌های کلاس MailMessage برای ساخت پیام‌های ایمیلی که با استفاده از SmtpClient کلاس. این موضوع نشان می‌دهد چگونه بیش از یک آدرس ایمیل را مشخص کنید. آدرس‌های ایمیل می‌توانند با استفاده از کلاس MailMessage تعیین شوند. آدرس‌های ایمیل استفاده شده در کلاس MailMessage عبارتند از:

To - آدرس‌های گیرنده می‌توانند در فیلد ‘To’ مشخص شوند. گیرندگان فیلد ‘To’ مخاطبان اصلی پیام هستند. می‌توان بیش از یک آدرس گیرنده داشت.
Cc - CC مخفف «کپی کربن» یا «کپی Courtesy» است و به شما امکان می‌دهد گیرندگانی را اضافه کنید که نیاز به مشاهده ایمیل دارند اما لزوماً انتظار نمی‌رود اقدام کنند. برای مثال مدیران یا اعضای تیم شما که باید از گفت‌وگو آگاه باشند. با 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 ارسال کنید.

قطعه کد زیر نشان می‌دهد چگونه نام‌ها برای آدرس‌های ایمیل نمایش داده شوند.

تنظیم بدنه ایمیل

این 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 7 بیتی، معروف به ISO646-US، یا بلوک پایه لاتین مجموعه کاراکترهای یونیکد
ISO-8859-1 - الفبای لاتین ISO شماره ۱، معروف به ISO-LATIN-1
UTF-8 - فرمت تبدیل UCS 8 بیتی
UTF-16BE - فرمت تبدیل UCS 16 بیتی، ترتیب بایت بیگ-اندین
UTF-16LE - فرمت تبدیل UCS 16 بیتی، ترتیب بایت لِتل-اندین
UTF-16 - فرمت تبدیل UCS 16 بیتی، ترتیب بایت توسط علامت ترتیب بایت اختیاری شناسایی می‌شود

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 ویژگی شمارشی توصیف می‌کند گزینه‌های اعلان تحویل برای یک ایمیل. برای درخواست رسید خوانده شدن پس از ارسال ایمیل، این مراحل را دنبال کنید:

یک نمونه از کلاس 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 در Microsoft 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 کلاس.
با استفاده از یک نمونه از کلاس MailMessage، To، From، CC، Bcc، ReplyTo، Subject، Date و XMailer را مشخص کنید.
یک نمونه از 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

درج هدر در مکان خاص

این Add متد 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، مراحل زیر را انجام دهید:

یک تابع با نام 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 مگابایت پشتیبانی نمی‌کند.

امتحان کنید!

پیوست‌های ایمیل را به‌صورت آنلاین با نسخه رایگان اضافه یا حذف کنید. 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 از پیوست

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

این Attachment.isTnef ویژگی API جاوا Aspose.Email نشان می‌دهد آیا پیوست پیام به‌صورت 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-attachment باشد

قطعه کد زیر نشان می‌دهد چگونه 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 کلاس.
مقادیر From، To و Subject را در MailMessage نمونه.
یک نمونه از AlternateView کلاس.
یک نمونه از LinkedResource کلاس.
بارگذاری یک شیء جاسازی‌شده در LinkedResourceCollection.
شیء جاسازی‌شدهٔ بارگذاری‌شده را به MailMessage نمونهٔ کلاس.
افزودن AlternateView نمونه به MailMessage نمونهٔ کلاس.

قطعات کد زیر یک پیام ایمیل با هر دو بدنهٔ متن ساده و HTML و یک تصویر جاسازی‌شده در HTML تولید می‌کنند

|تصویر جاسازی‌شده در ایمیل| | :- | || می‌توانید هر تعداد اشیاء جاسازی‌شده ارسال کنید. حجم پیوست توسط سرور ایمیل محدود می‌شود. به عنوان مثال، Gmail از فایل‌های بزرگتر از ۱۰ مگابایت پشتیبانی نمی‌کند. قطعات کد زیر نشان می‌دهند چگونه اشیاء را به یک ایمیل جاسازی کنید.

// 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

API Aspose.Email امکان کار با پیوست را فراهم می‌کند 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 اگر MailMessage.getDate() در منطقه زمانی محلی باشد، true برمی‌گرداند

استخراج هدرهای ایمیل

هدر ایمیل مجموعهٔ استاندارد فیلدهای هدر تعریف‌شده توسط اینترنت و RFC را که در پیام‌های ایمیل اینترنتی گنجانده می‌شود، نشان می‌دهد. می‌توان هدر ایمیل را با استفاده از MailMessage کلاس. انواع هدرهای رایج در HeaderType کلاس. این یک کلاس sealed است که مانند شمارش معمولی عمل می‌کند.

برای استخراج هدرها از یک ایمیل، مراحل زیر را دنبال کنید:

یک نمونه از کلاس MailMessage ایجاد کنید.
یک پیام ایمیل را در نمونهٔ کلاس MailMessage بارگذاری کنید.
پس از بارگذاری یک پیام ایمیل، محتوای خام آن را دریافت می‌کنیم. کلاس MailMessage خود شامل ویژگی‌هایی مانند From، To، Cc، Subject و غیره است. این ویژگی‌ها می‌توانند از هدرها استخراج شوند.
محتوای خام را نمایش دهید.

دریافت مقادیر سرصفحه‌های رمزگشایی‌شده

دریافت و تغییر هدر وضعیت منبع لینک‌شده

منبع لینک‌شده می‌تواند به‌صورت برنامه‌نویسی در شی پیام ایمیل دسترسی پیدا کرده و دستکاری شود. 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 برای جاوا به شما امکان دسترسی مستقیم به آدرس‌های X.500 Exchange را از طریق MailAddress کلاس. با X500Address با این ویژگی، می‌توانید آدرس ایمیل را در قالب X.500 Exchange زمانی که موجود باشد دریافت کنید. نمونه کد زیر نشان می‌دهد چگونه یک پیام ایمیل را بارگذاری کرده و آدرس 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 فراهم می‌کند 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 (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 - نمایش سرآیند From.
RenderTaskFields - فیلدهای خاص Task را در فایل خروجی می‌نویسد.
هیچ‌کدام - تنظیمی مشخص نشده.

قطعه کد زیر نشان می‌دهد چگونه فایل‌های 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. این 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. این encrypt() و decrypt() متدها شی MailMessage را برای تأثیرات اعمال شده برمی‌گردانند و در هنگام رمزنگاری/رمزگشایی پیام‌ها باید مورد توجه قرار گیرد. رمزنگاری و رمزگشایی پیام‌ها شامل مراحل زیر است:

ایجاد پیام جدید یا بارگذاری پیام موجود
رمزنگاری پیام با استفاده از فایل گواهینامه
ارسال پیام یا ذخیره‌سازی آن
رمزگشایی پیام برحسب نیاز

کد نمونه زیر نشان می‌دهد چگونه پیام‌ها را رمزنگاری و رمزگشایی کنید.

بررسی رمزنگاری پیام

Aspose.Email MailMessage کلاسی که امکان بررسی اینکه آیا پیام رمزنگاری شده است یا نه را می‌دهد. 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)

پیکربندی گزینه‌های Locale برای Aspose.Email

می‌توانید استفاده کنید LocaleOptions کلاس در صورت عدم شناسایی locale پیش‌فرض، مناسب‌ترین locale را برای کتابخانه Aspose Email تنظیم می‌کند. این کلاس متدهای زیر را برای انجام این کار ارائه می‌دهد:

getLocale() - بازگرداندن Locale پیش‌فرض برای Aspose.Email.
setLocale(Locale locale) و setLocale(String localeName) - تنظیم منطقه پیش‌فرض مرتبط با Aspose.Email.
clear() - تنظیمات پیش‌فرض منطقه‌ای برای Aspose.Email را پاک می‌کند. به‌عنوان تنظیم پیش‌فرض برای جاوا استفاده خواهد شد.

نمونه کد زیر نشان می‌دهد چگونه یک پیام ایمیل را از یک فایل با استفاده از تنظیمات منطقه‌ای مشخص بارگذاری کنید:

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

قالب بسته‌بندی بی‌طرف انتقال (TNEF) یک قالب پیوست ایمیل اختصاصی است که توسط Microsoft Outlook و Microsoft Exchange Server استفاده می‌شود. API Aspose.Email به شما امکان می‌دهد پیام‌های ایمیلی که پیوست‌های TNEF دارند را بخوانید و محتوای آن‌ها را تغییر دهید. سپس ایمیل می‌تواند به‌صورت یک ایمیل معمولی یا به همان قالب، با حفظ پیوست‌های TNEF ذخیره شود. این مقاله نمونه‌های کد مختلفی برای کار با پیام‌های حاوی پیوست‌های TNEF نشان می‌دهد.

خواندن پیام با حفظ پیوست‌های TNEF

کد نمونه زیر نشان می‌دهد چگونه یک پیام را با حفظ پیوست‌های TNEF بخوانید.

به‌روزرسانی منابع در پیوست TNEF و حفظ قالب TNEF

کد نمونه زیر نشان می‌دهد چگونه منابع در یک پیوست TNEF را به‌روزرسانی و قالب TNEF را حفظ کنید.

افزودن پیوست‌های جدید به پیام اصلی حاوی TNEF

ایجاد TNEF EML از MSG

پیام‌های Outlook MSG گاهی شامل اطلاعاتی مانند جدول‌ها و سبک‌های متنی هستند که در صورت تبدیل به EML ممکن است دچار اختلال شوند. ایجاد پیام‌های TNEF از چنین فایل‌های MSG به ما اجازه می‌دهد قالب‌بندی را حفظ کنیم و حتی این پیام‌ها را از طریق کلاینت‌های ایمیل با همان قالب ارسال کنیم.

برای ایجاد TNEF، می‌توانید از کد نمونه زیر استفاده کنید.

تشخیص اینکه آیا پیام TNEF است

پردازش پیام‌های برگشتی

امکان دارد پیامی که به گیرنده ارسال می‌شود به دلایلی مانند آدرس نامعتبر گیرنده بازگردد. API Aspose.Email قابلیت پردازش چنین پیامی را برای بررسی اینکه آیا ایمیل برگشتی است یا پیام ایمیل عادی دارد. The بررسی ایمیل برگشتی متد از 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، پیش‌متن متنی است که پس از سرآیندها و پیش از اولین حد مرزی چندبخشی ظاهر می‌شود. اپیلوگ متنی است که پس از آخرین حد مرزی و پیش از پایان پیام ظاهر می‌شود. این متن معمولاً برای کاربران در برنامه‌خوان‌های ایمیل قابل مشاهده نیست، اما برخی پیاده‌سازی‌های 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.