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.

קטע הקוד הבא מראה כיצד להציג שמות עבור כתובות דוא"ל.

הגדר גוף הודעה

ה 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 בקישור התוכן של כל אובייקט LinkedResources באוסף, והן נפתרות.
BaseUri משמש את קורא המייל לפתרון כתובות URL יחסיות בתוך הגוף, וכן לפתרון כתובות URL של קישורי תוכן יחסיים, באוסף LinkedResources.

קטע הקוד הבא מראה איך להגדיר טקסט חלופי.

ציון קידוד גוף המייל

סוג התוכן מגדיר את פורמט תוכן הדוא"ל: קידוד התווים. לדוגמה, כמה קידודים נפוצים המסופקים ב-java.nio.Charset הם:

US-ASCII - אס키 של 7 ביט, הידוע גם כ-ISO646-US, או כבלוק ה-Latin הבסיסי של התקן Unicode
ISO-8859-1 - אלפבית לטיני מספר 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 מאפיין Enum מתאר את אפשרויות הודעת מסירה למייל. כדי לבקש קבלה של קריאה לאחר שליחת מייל, פעלו לפי הצעדים הבאים:

צור מופע של המחלקה MailMessage.
ציין את השולח, המקבל וגוף ה-HTML של המייל במופע MailMessage.
ציין את DeliveryNotificationOptions במופעים אחרים של MailMessage.
צור מופע של מחלקת SmtpClient ושלח את הדוא"ל באמצעות שיטת Send.

בקשות קבלה על קריאת ההודעה עשויות שלא תמיד תתקבלנה מכיוון ש:

לקוח דוא"ל עשוי לא לתמוך בפונקציה זו.
המשתמש הסופי עשוי לבטל את הפונקציה הזו.
המשתמש הסופי עשוי לבחור לא לשלוח אחד.

קטע הקוד הבא מראה כיצד לבקש קבלה על קריאת ההודעה.

הגדרת כותרות אימייל

כותרות אימייל מייצגות תקן אינטרנט ו‑RFC מגדיר שדות כותרת שנכללים במסרי אימייל באינטרנט. ניתן לציין כותרת אימייל באמצעות MailMessage class. סוגי כותרות נפוצים מוגדרים ב‑ HeaderType class. זו מחלקה sealed הפועלת כמו Enum רגיל.

בדרך כלל כותרת מייל מכילה את השדות הבאים:

To: ניתן לציין כתובות נמען בשדה To. נמען בשדה To הוא קהל היעד העיקרי של ההודעה. ניתן לציין יותר מכתובת נמען אחת.
From: שדה זה מציג את כתובת האימייל של שולח ההודעה.
Cc: מאפשר למשתמשים לשלוח הודעה כ„Carbon Copy“ או „Courtesy Copy“. כלומר, לא מצופה שהמקבל יגיב או יפעל. בדרך כלל, צוות פיקוח מודיע באמצעות CC.
Bcc: משמעותו Blind Carbon Copy, מתייחס לשיטת שליחת הודעה למספר נמענים כך שההודעה שהם מקבלים אינה כוללת את רשימת כל הנמענים. זה מיועד להודעה סמויה.
ReplyTo: שדה כותרת זה נועד לציין לאן השולח רוצה שהתגובות ילכו.
Subject: כותרת, נושא. משמש לעיתים כסמן נושא לשרשרות הודעות שמגיבות או מגיבות להודעות אחרות.
Date: כותרת זו מציינת תאריך (וזמן). בדרך כלל זהו התאריך שבו ההודעה נכתבה ונשלחה.
XMailer: מידע על תוכנת הלקוח של השולח. לדוגמה: X-Mailer: Aspose.Email. XMailer משמש על ידי לקוחות דוא"ל. לקוחות דוא"ל שונים יהיו בעלי ערכי XMailer שונים. ערך ה‑XMailer של MS Outlook הוא Microsoft Office Outlook, Build 11.0.5510. הוא מתעלם ממנו על ידי מקבל הדוא"ל או קורא הדוא"ל.

בדרך כלל, כותרת מייל נראית כך:


 Reply-To: reply@reply.com

From: sender@sender.com

To: guangzhou@guangzhoo.com

Subject: test mail

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

X-Mailer: Aspose.Email

כדי להתאים אישית כותרת מייל, פעלו לפי הצעדים הבאים:

צור מופע של MailMessage מחלקה.
ציין To, From, CC, Bcc, ReplyTo, Subject, Date & XMailer באמצעות מופע של מחלקת MailMessage.
צור מופע של MimeHeader מחלקה וציין כותרת סודית.
הוסף את הכותרת הסודית למופע של MailMessage.

בקוד שלמטה, התאמה אישית של כותרת מייל.

קוד הקטע שלמעלה מייצר כותרת אימייל בפורמט הבא. ניתן לצפות בזה על ידי פתיחת הקובץ MsgHeaders.msg ב‑Microsoft Outlook ולאחר מכן צפייה במאפייניו.


 Reply-To: reply@reply.com

From: sender@sender.com

To: receiver1@receiver.com

CC: receiver2@receiver.com

BCC: receiver3@receiver.com

Subject: test mail

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

X-Mailer: Aspose.Email

secret-header: mystery

הכנסת כותרת במיקום ספציפי

ה הוסף מתודה של HeadersCollection מכניסה את הכותרת בסוף האוסף. עם זאת, לפעמים יש צורך להכניס כותרת במיקום מסוים. במקרה זה, המתודה Add אינה מסייעת. כדי להשיג זאת, השתמש ב‑ Insert מתודה של HeadersCollection. אם האיסוף מכיל כותרים עם שם זהה, כותרת זו תתווסף לפני כותרים אחרים עם אותו שם. להלן חתימת השיטה Insert וקוד לדוגמה לשימוש.


 Method Signature

HeaderCollection.insert(String name, String value)

הוספת כותרות מותאמות אישית למייל

דגמי התכנות שלמטה מציגים כיצד לציין כותרת מותאמת אישית במסר אימייל. ניתן לציין כותרת אימייל באמצעות מחלקת MailMessage. כדי לציין כותרת מותאמת אישית במסר אימייל, אנא פעלו לפי הצעדים הבאים:

צור מופע של המחלקה MailMessage.
ציין ערכי to, from ו‑subject באמצעות מופע של MailMessage.
הוסף את הכותרת הסודית למופע של MailMessage.
צור מופע של המחלקה SmtpClient ושלח את הדוא"ל באמצעות השיטה Send.

קטע הקוד הבא מציג כיצד להוסיף כותרות מותאמות אישית לאימייל.

חתימת אימיילים עם DKIM

Aspose.Email מאפשר לחתום על אימייל עם DKIM (DomainKeys Identified Mail). זה מאפשר לארגון לקחת אחריות על הודעה בתהליך העברה (אודות DKIM ). DKIM מוסיף חתימה דיגיטלית לכותרות הודעת האימייל שניתנת לאימות על ידי הנמענים. המפתח הציבורי של השולח מאפשר למקבל לוודא שהחתימה תואמת לתוכן ההודעה. מחלקת MailMessage dKIMSign מתודה משמשת לקביעת מידע קריפטוגרפי וחתימה לחתימת ההודעה. קטע הקוד הבא מציג כיצד לחתום על אימיילים באמצעות DKIM.

ביצוע מיזוג דואר

מיזוגי דואר מאפשרים ליצור ולשלוח קבוצת הודעות אימייל דומות. הליבה של ההודעות זהה, אך התוכן ניתן להתאמה אישית. בדרך כלל, פרטי הקשר של הנמען (שם פרטי, שם שני, חברה וכד’) משמשים להתאמת ההודעה.

|| | :- | |איור: המחשה של איך מיזוג דואר עובד|

כדי לבצע מיזוג דואר עם Aspose.Email, פעלו לפי הצעדים הבאים:

צור פונקציה בשם signature
צור מופע של MailMessage מחלקה.
ציין את השולח, המקבל, הנושא ואת גוף ההודעה.
צור חתימה לסיום המייל.
צור מופע של TemplateRoutine מחלקה והעביר לה את MailMessage מופע.
קח חתימה ב‑ TemplateRoutine מופע.
צור מופע של DataTable מחלקה.
הוסף את העמודות Receipt, FirstName ו‑LastName כמקורות נתונים במחלקת DataTable
צור מופע של DataRow מחלקה
ציין את כתובת הקבלה, שם פרטי ושם משפחה באובייקט DataRow
צור מופע של MailMessageCollection מחלקה
ציין את TemplateRoutine ו‑instances של DataTable ב‑ MailMessageCollection מופע.
צור מופע של SmtpClient מחלקה וציין את השרת, הפורט, שם המשתמש והסיסמה
שלח אימיילים באמצעות SmtpClient מתודת class BulkSendAsync

הקוד למטה שולח אימייל לאדם אחד משלושה אחרים.

Java: עבודה עם קבצים מצורפים ופריטים משובצים

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

ניהול קבצים מצורפים לאימייל

קובץ מצורף לאימייל הוא קובץ שנשלח יחד עם הודעת אימייל. הקובץ יכול להישלח כהודעה נפרדת וכן כחלק מההודעה אליה הוא מצורף. ה‑ Attachment class משמש עם ה‑ MailMessage class. כל הודעה כוללת גוף. בנוסף לגוף, ייתכן שתרצו לשלוח קבצים נוספים. קבצים אלה נשלחים כקבצים מצורפים ומיוצגים כמופע של Attachment class. ניתן לשלוח מספר בלתי מוגבל של קבצים מצורפים אך גודלם מוגבל על ידי שרת הדואר. 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 class משמש עם ה‑ 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 המאפיין של Aspose.Email API ב-Java מצביע האם קובץ המצורף הוא הודעה בתצורת TNEF.

קטע הקוד הבא מדגים כיצד לקבוע אם קובץ מצורף מתוצרת TNEF:

MailMessage eml = MailMessage.load(fileName);

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

טעינה ושמירה של קבצים מצורפים TNEF

Aspose.Email for Java מספקת מתודות ב- MapiAttachment מחלקה לביצוע הפעולות הבאות:

טעינה מ‑TNEF

static MapiAttachment loadFromTnef(String fileName) – טוען קובץ מצורף מקובץ TNEF.
static MapiAttachment loadFromTnef(InputStream stream) – טוען קובץ מצורף מזרם TNEF.

שמירה ל‑TNEF

void saveToTnef(String fileName) – שומר קובץ מצורף לקובץ TNEF.
void saveToTnef(OutputStream stream) – שומר קובץ מצורף לזרם TNEF.

דוגמת הקוד הבאה מדגימה כיצד לחלץ קובץ מצורף TNEF מהודעה, לשמור אותו לזרם או לקובץ, ואז לטעון אותו חזרה להודעה כ- MapiAttachment:

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

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

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

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

חילוץ URI של קובץ מצורף אם הקובץ הוא קובץ מצורף מסוג URI

קטע הקוד הבא מדגים כיצד לחלץ URI של קובץ מצורף.

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

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

הוספת קבצים מצורפים ברפרנס

קובץ מצורף ברפרנס הוא חלופה לקובץ מצורף מקומי. במקרים מסוימים, קבצים מצורפים ברפרנס עשויים להיות מועדפים, לדוגמה אם ברצונך לנהל את הגישה אליהם. המחלקות שלהלן משמשות לניהול ושינויים בהודעות דוא"ל ובקבצים המצורפים אליהן:

ReferenceAttachment - מייצג קובץ מצורף ברפרנס.
AttachmentPermissionType - נתוני סוג ההרשאה המשוייכים לקובץ מצורף של הפנייה לאינטרנט.
AttachmentProviderType - סוג שירות האינטרנט המנהל את הקובץ המצורף.

דוגמת הקוד הבאה מדגימה כיצד לטעון הודעת דוא"ל מקובץ, ליצור קובץ מצורף מסוג רפרנס עם מאפיינים ספציפיים, ולהוסיף את הקובץ המצורף להודעת הדוא"ל:

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

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

eml.getAttachments().addItem(refAttach);

עבודה עם אובייקטים משובצים

אובייקט משובץ הוא אובייקט שנוצר בתוכנה אחת והוכנס בתוך מסמך או קובץ שנוצר בתוכנה אחרת. לדוגמה, גליון Excel של מיקרוסופט יכול להיות משובץ בדוח Word של מיקרוסופט, או קובץ וידאו יכול להיות משובץ במצגת PowerPoint של מיקרוסופט. כאשר קובץ משובץ, במקום להוכנס או להודבק למסמך אחר, הוא שומר על הפורמט המקורי שלו. המסמך המשובץ ניתן לפתיחה בתוכנה המקורית ולשינוי.

שיבוץ אובייקטים בדוא"ל

ה LinkedResource class משמש עם ה‑ 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 המאפיין. ה- 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);

חילוץ אובייקטים משובצים

הנושא הזה מסביר כיצד לחלץ אובייקטים משובצים מקובץ דוא"ל. אובייקט משובץ הוא אובייקט שנוצר בתוכנה אחת והוכנס dentro מסמך או קובץ שנוצר בתוכנה אחרת. לדוגמה, גליון Excel של מיקרוסופט יכול להיות משובץ בדוח Word של מיקרוסופט, או קובץ וידאו יכול להיות משובץ במצגת 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 class. סוגי כותרות נפוצים מוגדרים ב‑ HeaderType מחלקה. זו מחלקה סגורה הפועלת כמו מונה רגיל.

לחילוץ כותרות מדוא"ל, פעל לפי הצעדים הבאים:

צור מופע של מחלקת 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

טעינת ושמירת הודעות דוא"ל

איתור פורמט קובץ

ה-API של Aspose.Email מספק את היכולת לאתר את פורמט הקובץ של קובץ ההודעה המסופק. ה 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 - כותב בתים של Byte Order Mark (BOM) לקובץ הפלט.
RenderVCardInfo - כותב טקסט מ‑VCard AlternativeView לקובץ הפלט.
DisplayAsOutlook - מציג את השדה From.
RenderTaskFields - כותב שדות משימה ספציפיים לקובץ הפלט.
ללא - לא צוינה הגדרה.

קטע הקוד הבא מראה כיצד להמיר קבצי EML ל-MHTML עם הגדרות אופציונליות.

הצגת אירועי לוח שנה בזמן המרה ל‑MHTML

ה MhtFormatOptions.RenderCalendarEvent מציג את אירועי היומן בפלט MHTML. קטע הקוד הבא מראה כיצד להציג אירועי לוח שנה בזמן ההמרה ל‑MHTML.

יצוא דוא"ל ל‑MHT ללא תמונות מוטמעות

ייצוא מייל ל-MHT עם אזור זמן מותאם

MailMessage class מספקת את setTimeZoneOffset מאפיין להגדיר אזור זמן מותאם אישית בעת ייצוא ל-MHT. הקטע קוד הבא מראה כיצד לייצא מייל ל-MHT עם אזור זמן מותאם.

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

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

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

ייצוא מייל ל-EML

הקטע קוד הבא מראה כיצד לייצא מיילים ל-EML.

שמירת מייל כ-HTML

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

הגדרת אפשרויות מקומיות עבור Aspose.Email

אתה יכול להשתמש ב LocaleOptions מחלקה למקרה של מקומית ברירת מחדל בלתי מזוהה ומגדירה את המקומית המתאימה ביותר עבור ספריית Aspose Email. היא מציעה את המתודות הבאות לביצוע המשימה:

getLocale() - מחזיר את המקומית ברירת המחדל עבור Aspose.Email.
setLocale(Locale locale) ו setLocale(String localeName) - מגדיר את המקומית ברירת המחדל עבור Aspose.Email.
clear() - מנקה את המקומית ברירת המחדל עבור Aspose.Email. תשתמש במקומית ברירת המחדל עבור Java.

דוגמת הקוד הבאה מדגימה כיצד לטעון הודעת אימייל מקובץ תוך שימוש בהגדרות המקומיות שצוינו:

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

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

MailMessage.load("document.msg");

קוד זה מבטיח שהיישום וספריית Aspose.Email משתמשים במקומיות שהוגדרו לטיפול בשפה, מדינה והקפדות תרבותיות.

הודעות אימייל המכילות קבצים מצורפים ב‑TNEF

Transport Neutral Encapsulation Format (TNEF) הוא פורמט קבצים מצורפים קנייני של אימייל המשמש ב‑Microsoft Outlook ו‑Microsoft Exchange Server. ה‑API של Aspose.Email מאפשר לך לקרוא הודעות אימייל עם קבצים מצורפים בפורמט TNEF ולשנות את תוכנם. לאחר מכן ניתן לשמור את האימייל כאימייל רגיל או באותו פורמט, תוך שמירה על הקבצים המצורפים ב‑TNEF. מאמר זה מציג דוגמאות קוד שונות לעבודה עם הודעות המכילות קבצים מצורפים ב‑TNEF.

קריאת הודעה תוך שמירה על קבצים מצורפים ב‑TNEF

מקטע הקוד הבא מראה כיצד לקרוא הודעה תוך שמירה על קבצים מצורפים בפורמט TNEF.

עדכון משאבים בקובץ מצורף TNEF ושמירה על פורמט TNEF

מקטע הקוד הבא מראה כיצד לעדכן משאבים בקובץ מצורף TNEF ולשמר את פורמט ה‑TNEF.

הוספת קבצים מצורפים חדשים להודעה ראשית המכילה TNEF

יצירת TNEF EML מתוך MSG

קבצי Outlook MSG מכילים לעיתים מידע כמו טבלאות וסגנונות טקסט שעשויים להשתבש אם הם מומרים ל‑EML. יצירת הודעות TNEF מקבצים כאלה מאפשרת לשמור על העיצוב ואפילו לשלוח הודעות אלה דרך לקוחות האימייל תוך שמירה על העיצוב.

ליצירת ה‑TNEF, ניתן להשתמש בקוד הדוגמה הבא.

זיהוי אם הודעה היא TNEF

עיבוד הודעות קופצות

זה מאוד נפוץ שהודעה שנשלחת למקבל עשויה לחזור משיקולים שונים כגון כתובת מקבל לא חוקית. ל‑Aspose.Email API יש את היכולת לעבד הודעה כזו על מנת לבדוק האם היא הודעת דואר קפוצה או הודעת דואר רגילה. ה בדיקת הודעות קופצות שיטה של MailMessage מחלקה מחזירה תוצאה תקפה אם הודעת האימייל היא הודעה חוזרת.

מאמר זה מציג את השימוש ב‑ BounceResult מחלקה המספקת את היכולת לבדוק אם הודעה היא אימייל חוזר. היא גם נותנת מידע מפורט על הנמענים, הפעולה שננקטה והסיבה להודעה.

התעלמות משגיאות

הספרייה מציעה 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, הפreamble הוא הטקסט שמופיע אחרי הכותרות ולפני גבול ה-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 Enum. לאֶנוּמֶרציה ProgressEventType יש את החברים הבאים.

MimeStructureCreated: אירוע זה מודיע כי מבנה ה-MIME נוצר.
MimePartSaved: אירוע זה מודיע כי שמירת חלק MIME אחד הושלמה.
SavedToStream: אירוע זה מודיע שכל חלקי ה-MIME נשמרים ל‑stream.

דוגמת הקוד הבאה מדגימה את השימוש ב-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 class. הסדר שבו מתווספות הכותרות מחליט את סדר הצגת המידע.

התמונה שלהלן משווה את שלושת הפלטים שנוצרו על ידי קוד הדוגמה.

קטע הקוד הבא מדגים את השימוש ב‑ MhtSaveOptions.RenderingHeaders מאפיין לקביעת הסדר שבו המידע מוצג בקבצי MHTML המוצאים.