Documentation – ทำงานกับข้อความ MIME

Java: การสร้างและตั้งค่าเนื้อหาอีเมล

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

สร้างข้อความอีเมลใหม่

Aspose.Email สำหรับ Java ช่วยให้ผู้พัฒนาสามารถสร้างข้อความ MIME (Multipurpose Internet Mail Extensions) ตั้งแต่ต้น คลาสหลักสำหรับวัตถุประสงค์นี้ใน API ของ Aspose.Email สำหรับ Java คือ MailMessage คลาส หัวข้อนี้อธิบายขั้นตอนที่จำเป็นในการสร้างข้อความอีเมลในรูปแบบไฟล์ EML, MSG และ MTH โดยใช้ Aspose.Email สำหรับ Java.

เพื่อสร้างข้อความอีเมลตั้งแต่ต้น:

สร้างอินสแตนซ์ของคลาส MailMessage.
ตั้งค่าหัวเรื่องของข้อความโดยใช้ setSubject() เมธอด.
ตั้งค่าพื้นข้อความของข้อความโดยใช้ setHtmlBody() เมธอด.
ตั้งค่าผู้ส่งอีเมลโดยใช้ setFrom() เมธอด.
ตั้งค่าผู้รับในช่อง TO ด้วยการใช้ getTo().add() เมธอด.
ตั้งค่าผู้รับในช่อง CC ด้วยการใช้ getCC().add() เมธอด.
เรียกใช้ Save() วิธีการบันทึกไฟล์ข้อความลงดิสก์ในรูปแบบ MSG, EML, และ MHT.

การระบุผู้รับหลายคน

นี้ 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.

โค้ดสแน็ปต่อไปนี้แสดงวิธีแสดงชื่อสำหรับที่อยู่อีเมล.

ตั้งค่า Mail Body

นี้ MailMessage คลาส แสดงข้อความอีเมล อินสแตนซ์ของคลาส MailMessage ใช้สร้างข้อความอีเมลที่ส่งไปยังเซิร์ฟเวอร์ SMTP เพื่อจัดส่งโดยใช้ SmtpClient คลาส สามารถระบุเนื้อหาเมลโดยใช้คลาส MailMessage สามารถระบุเนื้อหาอีเมลโดยใช้ setHtmlBody เมธอดใน MailMessage.

นอกจากนี้ ยังมี HtmlBody, Aspose.Email มีเมธอดอื่นที่เกี่ยวข้องกับเนื้อหาเมล:

isBodyHtml: บอกผู้ใช้ว่าตัวเนื้อหาเป็น HTML หรือข้อความธรรมดา.

หัวข้อนี้แสดงวิธีกำหนดข้อความ HTML body และตั้งค่าข้อความสำรอง.

การตั้งค่า HTML Body

HtmlBody ใช้เพื่อระบุเนื้อหา HTML ของส่วน본문ของข้อความ HtmlBody ต้องถูกครอบด้วยแท็ก ตัวอย่างโค้ดต่อไปนี้แสดงวิธีตั้งค่า HTML Body.

การตั้งค่าข้อความสำรอง

ใช้ AlternateView คลาสเพื่อระบุสำเนาของข้อความอีเมลในรูปแบบที่แตกต่างกัน ตัวอย่างเช่น หากคุณส่งข้อความในรูปแบบ HTML คุณอาจต้องการจัดเตรียมเวอร์ชันข้อความธรรมดาด้วยในกรณีที่ผู้รับบางคนใช้โปรแกรมอ่านเมลที่ไม่สามารถแสดงเนื้อหา HTML ได้ คลาสนี้มีสองคุณสมบัติ, LinkedResources และ BaseUri, ซึ่งใช้เพื่อแก้ไข URL ภายในเนื้อหาอีเมล.

LinkedResources คือคอลเลกชันของอ็อบเจ็กต์ LinkedResources เมื่อทำการแสดงผล URL ภายในเนื้อหาอีเมลจะถูกจับคู่กับ URL ใน Content Link ของแต่ละอ็อบเจ็กต์ในคอลเลกชัน LinkedResources ก่อนแล้วจึงแก้ไข.
BaseUri ถูกใช้โดยโปรแกรมอ่านเมลเพื่อแก้ไข URL เชิงสัมพันธ์ภายในเนื้อหา รวมถึงแก้ไข URL ของ Content Link เชิงสัมพันธ์ในคอลเลกชัน LinkedResources.

โค้ดสแน็ปต่อไปนี้แสดงวิธีตั้งค่าข้อความสำรอง.

การระบุการเข้ารหัสเนื้อหาเมล

Content Type กำหนดรูปแบบเนื้อหาอีเมล: ชุดอักขระ ตัวอย่างเช่น ชุดอักขระที่พบบ่อยบางชุดที่มีใน java.nio.Charset คือ:

US-ASCII - ASCII 7 บิต, หรือที่เรียกว่า ISO646-US, หรือบล็อก Latin พื้นฐานของชุดอักขระ Unicode
ISO-8859-1 - ตัวอักษรละติน ISO หมายเลข 1, หรือที่รู้จักในชื่อ ISO-LATIN-1
UTF-8 - รูปแบบการแปลง UCS 8 บิต
UTF-16BE - รูปแบบการแปลง UCS 16 บิต, ลำดับไบต์แบบ big-endian
UTF-16LE - รูปแบบการแปลง UCS 16 บิต, ลำดับไบต์แบบ little-endian
UTF-16 - รูปแบบการแปลง UCS 16 บิต, ลำดับไบต์ระบุโดยเครื่องหมายลำดับไบต์ (Byte Order Mark) ที่เป็นตัวเลือก

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 และทำงานคล้าย enumeration ปกติ

โดยปกติส่วนหัวของอีเมลจะประกอบด้วยฟิลด์เหล่านี้:

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

แทรกส่วนหัวในตำแหน่งที่ต้องการ

นี้ 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

การทำ 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 เมธอด class BulkSendAsync

โค้ดด้านล่างส่งอีเมลถึงคนหนึ่งจากสามคนอื่น

Java: การทำงานกับไฟล์แนบและวัตถุฝัง

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

การจัดการไฟล์แนบอีเมล

ไฟล์แนบของอีเมลคือไฟล์ที่ส่งพร้อมกับข้อความอีเมล ไฟล์อาจถูกส่งเป็นข้อความแยกหรือเป็นส่วนหนึ่งของข้อความที่แนบอยู่ Attachment คลาสใช้ร่วมกับ MailMessage คลาส ข้อความทั้งหมดมีส่วนเนื้อหา นอกจากเนื้อหาแล้วคุณอาจต้องการส่งไฟล์เพิ่มเติม ซึ่งจะส่งเป็นไฟล์แนบและเป็นอินสแตนซ์ของ Attachment คลาส คุณสามารถส่งไฟล์แนบจำนวนไม่จำกัด แต่ขนาดไฟล์แนบจะถูกจำกัดโดยเซิร์ฟเวอร์เมล ตัวอย่างเช่น Gmail ไม่รองรับไฟล์ขนาดเกิน 10MB

ลองใช้ดู!

เพิ่มหรือลบไฟล์แนบอีเมลออนไลน์ด้วยบริการฟรี แอป Aspose.Email Editor.

การเพิ่มไฟล์แนบ

เพื่อแนบไฟล์แนบไปยังอีเมล โปรดทำตามขั้นตอนต่อไปนี้:

สร้างอินสแตนซ์ของ 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 สำหรับ 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);

การดึง Attachment 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 คลาส.
ระบุค่าจาก, ถึงและหัวเรื่องใน MailMessage อินสแตนซ์
สร้างอินสแตนซ์ของ AlternateView คลาส.
สร้างอินสแตนซ์ของ LinkedResource คลาส.
โหลดวัตถุที่ฝังเข้าไปใน LinkedResourceCollection.
เพิ่มวัตถุที่ฝังที่โหลดแล้วเข้าไปใน MailMessage อินสแตนซ์ของคลาส.
เพิ่ม AlternateView อินสแตนซ์ของ MailMessage อินสแตนซ์ของคลาส.

โค้ดสแนปเป็ทด้านล่างสร้างข้อความอีเมลที่มีส่วนข้อความธรรมดาและ HTML รวมทั้งภาพที่ฝังอยู่ใน HTML

|รูปภาพที่ฝังอยู่ในอีเมล| | :- | || คุณสามารถส่งวัตถุที่ฝังอยู่ได้จำนวนไม่จำกัด ขนาดของไฟล์แนบถูกจำกัดโดยเซิร์ฟเวอร์เมล ตัวอย่างเช่น Gmail ไม่รองรับไฟล์ที่มีขนาดเกิน 10MB โค้ดสแนปเป็ทด้านล่างแสดงวิธีการฝังวัตถุลงในอีเมล.

// 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 คลาสนี้เป็นคลาสที่ปิดใช้งานและทำงานเหมือนกับการ enumerations ปกติ.

เพื่อดึงส่วนหัวจากอีเมล ให้ทำตามขั้นตอนต่อไปนี้:

สร้างอินสแตนซ์ของคลาส MailMessage.
โหลดข้อความอีเมลในอินสแตนซ์ของคลาส MailMessage.
หลังจากโหลดข้อความอีเมลแล้ว เราจะได้เนื้อหาดิบของมัน คลาส MailMessage เองมีคุณสมบัติเช่น From, To, Cc, Subject เป็นต้น คุณสมบัติเหล่านี้สามารถดึงจากส่วนหัวได้
แสดงเนื้อหาดิบ.

รับค่าหัวข้อที่ถอดรหัสแล้ว

ดึงและแก้ไขหัวข้อ Disposition ของทรัพยากรที่เชื่อมโยง

ทรัพยากรที่เชื่อมโยงสามารถเข้าถึงและจัดการได้โดยโปรแกรมในอ็อบเจกต์ข้อความอีเมล 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 for 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 - เขียนไบต์ Byte Order Mark (BOM) ลงไฟล์ผลลัพธ์.
RenderVCardInfo - เขียนข้อความจาก VCard AlternativeView ลงไฟล์ผลลัพธ์.
DisplayOutlook - แสดงส่วนหัว From.
RenderTaskFields - เขียนฟิลด์งานเฉพาะลงไฟล์ผลลัพธ์.
ไม่มี - ไม่ได้ระบุการตั้งค่า.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีแปลงไฟล์ EML เป็น MHTML พร้อมการตั้งค่าเพิ่มเติม.

เรนเดอร์เหตุการณ์ปฏิทินขณะแปลงเป็น MHTML

นี้ MhtFormatOptions.RenderCalendarEvent เรนเดอร์เหตุการณ์ปฏิทินไปยัง MTHML ผลลัพธ์. โค้ดตัวอย่างต่อไปนี้แสดงวิธีเรนเดอร์เหตุการณ์ปฏิทินขณะแปลงเป็น MHTML.

ส่งออกอีเมลเป็น MHT โดยไม่มีภาพในบรรทัด

ส่งออกอีเมลเป็น MHT พร้อมเขตเวลาแบบกำหนดเอง

MailMessage class ให้ setTimeZoneOffset คุณสมบัติสำหรับตั้งค่าเขตเวลาแบบกำหนดเองเมื่อส่งออกเป็น MHT. โค้ดตัวอย่างต่อไปนี้แสดงวิธีการส่งออกอีเมลเป็น MHT พร้อมตั้งค่าเขตเวลาแบบกำหนดเอง.

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

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

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

การส่งออกอีเมลเป็น EML

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการส่งออกอีเมลเป็นไฟล์ EML.

บันทึกอีเมลเป็น HTML

นี้ 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) - ตั้งค่า locale เริ่มต้นที่เกี่ยวข้องสำหรับ Aspose.Email.
clear() - ล้าง locale เริ่มต้นสำหรับ Aspose.Email จะใช้ locale เริ่มต้นสำหรับ Java.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีโหลดข้อความเมลจากไฟล์โดยใช้การตั้งค่า locale ที่ระบุ:

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 ใช้ locale ที่ระบุสำหรับการจัดการภาษา ประเทศ และขนบธรรมเนียมวัฒนธรรม

ข้อความอีเมลที่มีไฟล์แนบ TNEF

Transport Neutral Encapsulation Format (TNEF) เป็นรูปแบบไฟล์แนบอีเมลที่เป็นกรรมสิทธิ์ใช้โดย Microsoft Outlook และ Microsoft Exchange Server API ของ Aspose.Email อนุญาตให้คุณอ่านข้อความอีเมลที่มีไฟล์แนบ TNEF และแก้ไขเนื้อหาของมัน จากนั้นอีเมลสามารถบันทึกเป็นอีเมลปกติหรือรูปแบบเดียวกันโดยคงไฟล์แนบ TNEF บทความนี้แสดงตัวอย่างโค้ดต่างๆ สำหรับการทำงานกับข้อความที่มีไฟล์แนบ TNEF.

อ่านข้อความโดยคงไฟล์แนบ TNEF

โค้ดตัวอย่างต่อไปนี้แสดงวิธีอ่านข้อความโดยคงทิ้งไฟล์แนบ TNEF

อัปเดตทรัพยากรในไฟล์แนบ TNEF และคงรูปแบบ TNEF

โค้ดตัวอย่างต่อไปนี้แสดงวิธีอัปเดตทรัพยากรในไฟล์แนบ TNEF และคงรูปแบบ TNEF

เพิ่มไฟล์แนบใหม่ไปยังข้อความหลักที่มี TNEF

สร้าง TNEF EML จาก MSG

ไฟล์ MSG ของ Outlook บางครั้งมีข้อมูลเช่นตารางและสไตล์ข้อความที่อาจเสียหายหากแปลงเป็น EML การสร้างข้อความ TNEF จากไฟล์ MSG ดังกล่าวทำให้เรารักษาการจัดรูปแบบและแม้กระทั่งส่งข้อความเหล่านี้ผ่านไคลเอนต์อีเมลโดยคงรูปแบบเดิม.

เพื่อสร้าง TNEF สามารถใช้โค้ดตัวอย่างต่อไปนี้.

ตรวจจับว่าข้อความเป็น TNEF หรือไม่

ประมวลผลข้อความที่ตีกลับ

เป็นเรื่องปกติที่ข้อความที่ส่งถึงผู้รับอาจถูกตีกลับด้วยเหตุผลใดๆ เช่น ที่อยู่ผู้รับไม่ถูกต้อง. Aspose.Email API มีความสามารถในการประมวลผลข้อความดังกล่าวเพื่อตรวจสอบว่าเป็นอีเมลตีกลับหรือเป็นอีเมลปกติ. The ตรวจสอบอีเมลตีกลับ เมธอดของ MailMessage คลาสจะคืนผลลัพธ์ที่ถูกต้องหากข้อความอีเมลเป็น bounced email.

บทความนี้แสดงการใช้ของ BounceResult คลาสที่ให้ความสามารถในการตรวจสอบว่าข้อความเป็นอีเมลที่ bounced หรือไม่ นอกจากนี้ยังให้ข้อมูลโดยละเอียดเกี่ยวกับผู้รับ การดำเนินการที่ทำและเหตุผลของการแจ้งเตือน.

ละเว้นข้อยกเว้น

ไลบรารีมี ExceptionManager คลาสสำหรับนำความสามารถในการละเว้นข้อยกเว้นเข้าสู่ฟังก์ชันการทำงานของแอปพลิเคชันของคุณ. โค้ดตัวอย่างด้านล่างแสดงวิธีตั้งค่า callback เพื่อตอบสนองข้อยกเว้น:

 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);

คุณยังสามารถตั้งค่าฟังก์ชัน callback สำหรับ บันทึกข้อยกเว้นที่ละเลย:

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 ให้ความสามารถในการกรองอีเมลโดยใช้ตัววิเคราะห์สแปมแบบเบย์ส. มันให้ SpamAnalyzer คลาสสำหรับจุดประสงค์นี้. บทความนี้แสดงวิธีการฝึกตัวกรองให้แยกระหว่างสแปมและอีเมลปกติโดยอ้างอิงจากฐานข้อมูลคำ.

การรับส่วนเปิดต้นและส่วนต่อท้ายจากข้อความ EML

ในรูปแบบ MIME, preamble คือข้อความที่ปรากฏหลังส่วนหัวและก่อนขอบเขต multipart แรก. epilogue คือข้อความที่ปรากฏหลังขอบเขตสุดท้ายและก่อนจบข้อความ. ข้อความนี้มักไม่แสดงให้ผู้ใช้เห็นในโปรแกรมอ่านเมล, แต่การนำไปใช้ของ 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 enumeration. enumeration ProgressEventType มีสมาชิกต่อไปนี้.

MimeStructureCreated: เหตุการณ์นี้แจ้งว่าโครงสร้าง MIME ถูกสร้างขึ้น.
MimePartSaved: เหตุการณ์นี้แจ้งว่าการบันทึกส่วน MIME หนึ่งเสร็จสิ้น.
SavedToStream: เหตุการณ์นี้แจ้งว่าทุกส่วนของ MIME ถูกบันทึกลงสตรีมแล้ว.

โค้ดตัวอย่างต่อไปนี้แสดงการใช้ SaveOptions.CustomProgressHandler และ enumeration 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 ที่ส่งออก