Documentation – התחלה

Java: סקירת מוצר

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

ברוכים הבאים ל-Aspose.Email עבור Java!

Aspose.Email עבור Java הוא API ב‑Java שמאפשר ליישומי Java לקרוא ולכתוב מסמכי Microsoft Outlook® ללא צורך ב‑Microsoft Outlook®. Aspose.Email עבור Java מספק מספר תכונות מרכזיות כגון ניהול נמענים, נושא, גוף, קבצים מצורפים במסמכי Microsoft Outlook® MSG וקריאת אנשי קשר, הודעות ומידע על תיקיות ממסמכי Microsoft Outlook® PST. הוא יכול לשמש גם ליצירה, שינוי והמרת הודעות דוא״ל בפורמטים EML, MSG ו‑MHT.

תיאור המוצר

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

Aspose.Email for Java אינו יכול ליצור קבצי MSG (פורמט הודעות Outlook), אך מאפשר לשמור קבצי MSG לאחר ביצוע שינויים בתוכן המקורי. ניתן גם לנתח קבצים מצורפים ולשמור אותם לדיסק.

קריאת קבצי Outlook PST נתמכת גם היא. קבל תיקיות, תתי‑תיקיות, מספר הודעות, מידע על הודעות (נושא, שולח, מקבלים וכו’), ומידע על אנשי קשר מקבצי PST. חלץ הודעה מקובץ PST ושמור אותה לדיסק בפורמט MSG.

Aspose.Email for Java משמש מפתחים לביצוע מגוון משימות באפליקציות שלהם. לדוגמה, פתיחה או שמירת דוא"לים כקבצי EML או MHT, ניתוח או קריאה ושמירת הודעות Microsoft Outlook וקבצי Outlook PST, טיפול בהודעות MIME, הטמעת אובייקטים בהודעות הדוא"ל.

תכונות

תכונות פורמט קובץ הודעת דוא"ל

תומך בהודעות דוא"ל בפורמטים EML, MSG ו-MHTML.
צור הודעה חדשה.
שנה הודעה קיימת ועדכן תוכן כגון נושא, שולח, מקבלים, גוף, קבצים מצורפים, וכו'.
טען הודעה קיימת וקבל את תוכן ההודעה כגון נושא, קבצים מצורפים, שולח, מקבלים, וכו'.
נהל (הוסף/הסר) קבצים מצורפים בהודעת דוא"ל.
צור הודעת דוא"ל בפורמט HTML.
צור הודעה במצב טיוטה (MSG בלבד).
קרא קבצים מצורפים של הודעות דוא"ל מקוננות.
המר הודעות ממ/אל כל אחד מהפורמטים הנתמכים.

תכונות קובץ MSG

צור מסמכי MSG חדשים מאפס.
פתח מסמכי MSG קיימים.
גש לתוכן MSG.
שנה מסמכי MSG קיימים.
שחזר מקבלי רבים.
גש למאפייני MAPI הקשורים למסמכי MSG.
נתח קובץ מצורף ממסמך MSG.
שמור קובץ מצורף לדיסק.

תכונות קובצי PST/OST

טען קובץ PST של Outlook מהדיסק וקבל מידע על כל התיקיות שלו (תמיכה רק בפורמטים Unicode).
קבל מידע על ההודעות מכל תיקייה בקובץ PST, לדוגמה, נושא, שולח, קבצים מצורפים, וכו'.
חלץ הודעות מקובץ PST ושמור לדיסק בפורמט MSG.
קרא מידע אנשי קשר מקובץ PST ושמור לדיסק בפורמט MSG.
תמיכה בקריאה/שינוי של פורמטי קבצים OST (תמיכה ביצירת פורמט OST אינה נתמכת כרגע)

Java: פורמטים נתמכים

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

Java: מאפיינים

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

Java: דרישות מערכת

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

Aspose.Email for Java אינו דורש התקנת Microsoft Outlook, שכן Aspose.Email עצמו הוא ספריית יצירה, המרה, וניהול של מסמכי Microsoft Outlook.

מערכות הפעלה נתמכות

Aspose.Email for Java תומך בכל מערכת הפעלה שמריצה את סביבת הריצה של Java, כולל אך לא מוגבל ל:

Windows

Microsoft Windows 2003 Server
Microsoft Windows 2008 Server
Microsoft Windows 2012 Server
Microsoft Windows XP
Microsoft Windows Vista
Microsoft Windows 7
Microsoft Windows 8, 8.1
Microsoft Windows 10

Linux

Linux (Ubuntu, openSUSE, CentOS ואחרים)

Mac

Mac OS X וכד'.

גרסאות Java נתמכות

Aspose.Email for Java תומך בגרסאות Java הבאות:

J2SE 6.0 (1.6)
J2SE 7.0 (1.7)
J2SE 8.0 (1.8)
או גבוה יותר

Java: התקנה

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

התקנת Aspose.Email for Java ממאגר Maven

Aspose מארח את כל ה-API של Java ב Aspose Artifactory. אתה יכול בקלות להשתמש Aspose.Email עבור Java API ישירות בפרויקטי Maven שלך עם תצורות פשוטות.

ציין תצורת מאגר Maven

ראשית, עליך לציין את תצורת/מיקום מאגר Maven של Aspose בקובץ pom.xml של Maven שלך כך:


 <repositories>

    <repository>

        <id>AsposeJavaAPI</id>

        <name>Aspose Java API</name>

        <url>https://releases.aspose.com/java/repo/</url>

    </repository>

</repositories>

הגדר תלות API של Aspose.Email for Java

לאחר מכן הגדר את תלות ה-API של Aspose.Email for Java בקובץ pom.xml שלך כך:


 <dependencies>

    <dependency>

        <groupId>com.aspose</groupId>

        <artifactId>aspose-email</artifactId>

        <version>19.12</version>

        <classifier>jdk16</classifier>

 </dependency>

</dependencies>

לאחר ביצוע הצעדים לעיל, תלות Aspose.Email for Java תוגדר בסופו של דבר בפרויקט Maven שלך.

Java: רישוי

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

אתה יכול להוריד גרסת הערכה של Aspose.Email עבור Java מדף ההורדות שלה. גרסת ההערכה מספקת את אותן יכולות בדיוק כמו הגרסה המורשית של המוצר. יתר על כן, גרסת ההערכה הופכת למורשית כאשר אתה רוכש רישיון ומוסיף כמה שורות קוד ליישום הרישיון.

כאשר תסיים את ההערכה של Aspose.Email, תוכל לרכוש רישיון באתר Aspose. הכיר את סוגי המנויים השונים המוצעים. אם יש לך שאלות, אל תהסס ליצור קשר עם צוות המכירות של Aspose.

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

אם ברצונך לבדוק את Aspose.Email ללא מגבלות גרסת ההערכה, בקש רישיון זמני ל-30 יום. נא עיין ב- איך לקבל רישיון זמני? לעוד מידע.

מגבלות גרסת ההערכה

גרסת ההערכה של Aspose.Email (ללא רישיון מצוין) מספקת את כל הפונקציונליות של המוצר, פרט למספר מרכיבים כמו Aspose.Email.Mail, Aspose.Email.Pop3, ו‑Aspose.Email.Imap שיש להם מגבלות הערכה.

קובץ License.txt נוסף לקובץ ההודעה שנשמר באמצעות Aspose.Email.
ניתן לחלץ רק 50 הודעות דוא"ל מתיקייה בקובץ PST.
רק 3 קבצים מצורפים וכן תמונות מוטמעות ניתנים לחילוץ מקובץ MSG.
המספר המרבי של קבצים מצורפים מעובדים בפורמט CFB הוא 1.
המספר המרבי של מקבלים מעובדים בפורמט CFB הוא 1.
מוסיף "הודעת הערכה" לשורת הנושא במהלך שמירה בפורמטים CFB, EML או MSG.
תאריך הסיום לא יכול להיות אחרי 31-12-2004 במתודה GenerateOccurrences של תבנית החזרה. זה מאפשר לך לבדוק את המוצר באופן משמעותי, אך אינו ניתן לשימוש ביישום ייצור. לדוגמה, ניתן ליצור תבנית כגון "התחלה ב‑1 בינואר 2000 וחזרה ב‑יום העבודה האחרון של כל חודש" וליצור מופעים עבורה. מופעים אחרי 31 דצמבר 2004 לא יווצרו במצב ההערכה.
מוסיף "תמונת סימן מים של הערכה" במהלך שמירה בפורמטים XPS או TIFF.
המספר המרבי של כתובות דוא"ל ו שמות תצוגה מעורפלים שנפתרים על ידי שרת MS Exchange הוא 20.
אורך מקסימלי של קובץ נתונים שניתן לגרור ולשחרר עם FileDropPanel הוא 51200 בתים.
מציג תיבת הודעה עם "הודעת הערכה" במהלך פעולה של גרור ושחרר שנעשה על ידי FileDropPanel.
רק קובץ אחד מחולץ מזרם MSO הנתון על ידי המתודה InlineAttachmentExtractor.EnumerateMsoPackage.

הגדרת רישיון

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

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

ניתן לטעון את הרישיון מתוך זרם או קובץ במיקומים הבאים:

נתיב מפורש.
התיקייה שמכילה את Aspose.Email.jar.

השתמש במתודה License.setLicense כדי לרשום את הרכיב. בדרך כלל הדרך הקלה ביותר להגדיר רישיון היא להניח את קובץ הרישיון באותה תיקייה שבה נמצא Aspose.Email.jar ולציין רק את שם הקובץ ללא נתיב, כפי שמוצג בדוגמה הבאה:

הגדרת רישיון מקובץ

בדוגמה זו Aspose.Email ינסה למצוא את קובץ הרישיון בתיקייה שמכילה את קבצי ה‑JAR של היישום שלך.

הגדרת רישיון מזרם

מאתחל רישיון מתוך זרם.

החל רישיון מדוד

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

הוצגה מחלקה חדשה בשם Metered לצורך יישום מפתח מבוסס מדידה. להלן קוד לדוגמה המראה כיצד להגדיר מפתחות ציבוריים ופרטיים למבוסס מדידה.

הכללת קובץ הרישיון כמשובץ

אמת את הרישיון

אפשר לאמת אם הרישיון הוגדר כראוי או לא. ה רישיון למחלקה יש את השדה isLicensed שיחזיר אמת אם הרישיון הוגדר כראוי.

Java


 License license = new License();

license.setLicense("Aspose.Email.Java.lic");

if (License.isLicensed()) {

    System.out.println("License is Set!");

}

Java: כיצד להפעיל דוגמאות

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

Download from GitHub

כל הדוגמאות של Aspose.Email for Java מאוחסנות ב‑ Github. אתה יכול לשכפל את המאגר באמצעות לקוח ה‑Github המועדף עליך או להוריד את קובץ ה‑ZIP מ‑ כאן.

חלץ את תוכן קובץ ה‑ZIP לתיקייה במחשבך. כל הדוגמאות ממוקמות בתיקייה Examples.

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

IntelliJ IDEA

לחץ על תפריט File ובחר Open. נווט לתיקיית הפרויקט ובחר בקובץ pom.xml.

זה יפתח את הפרויקט ויוריד את התלויות אוטומטית. בלשונית Project, דפדף בדוגמאות בתיקייה src/main/java. כדי להריץ דוגמה, לחץ קליק ימני על הקובץ ובחר "Run ..", הדוגמה תופעל והתפוקה תוצג בחלון הקונסול המובנה.

Eclipse

לחץ על תפריט File ובחר Import. בחר Maven - Existing Maven Projects.

נווט לתיקייה שהשכחת או הורדת מ‑GitHub ובחר בקובץ pom.xml.

זה יפתח את הפרויקט ו יוריד את התלויות באופן אוטומטי. בלשונית Package Explorer, עיין בדוגמאות בתיקייה src/main/java. כדי להפעיל דוגמה, לחץ לחיצה ימנית על הקובץ ובחר Run As - Java Application, הדוגמה תופעל והתוצאה תוצג בחלון הקונסול המובנה.

NetBeans

לחץ על תפריט File ובחר Open Project. נווט לתיקייה שהשכחת או הורדת מ‑GitHub. האייקון של תיקיית Examples יראה שמדובר בפרויקט Maven. בחר ב‑Examples ופתח אותו.

זה יפתח את הפרויקט ויוריד את התלויות באופן אוטומטי. בלשונית Projects, עיין בדוגמאות בחבילות המקור. כדי להפעיל דוגמה, לחץ לחיצה ימנית על הקובץ ובחר Run File, הדוגמה תופעל והתוצאה תוצג בחלון הקונסול המובנה.

תרום

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

כדי לתרום, תוכל לבצע fork למאגר, לערוך את קוד המקור וליצור pull request. אנו נסקור את השינויים ונכלול אותם במאגר אם יימצאו מועילים.

Java: תמיכה טכנית

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

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

אם אתה זקוק לעזרה, בקר בפורומים של Aspose. פרסם את שאלתך בפורום Aspose.Email for Java והיא תענה בתוך כמה שעות.

כאשר מצפים למענה בפורומים, אנא קח בחשבון הבדלי זמן.

דיווח על בעיה

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

ודא שאתה משתמש בגרסה העדכנית ביותר של המוצר לפני דיווח על הבעיה. ראה את דף ההורדות של Aspose.Email for Java כדי לגלות את הגרסה האחרונה.
הסתכל דרך פורומים, ויקי התיעוד הזה ו‑ רפרנס API לפני דיווח על בעיה. ייתכן שכבר יש תשובה לשאלתך.
כאשר מדווחים על בעיה, אנא כלל את המסמך המקורי ואולי קטע קוד שמוביל לבעיה. אם יש צורך לצרף קבצים מרובים, דחס אותם לקובץ zip אחד. בטוח לצרף מסמכים בפורומים מכיוון שרק אתה ומפתחי Aspose יכולים לגשת לקבצים המצורפים.
אנא נסה לדווח על בעיה אחת לכל שרשור. אם יש לך בעיה נוספת, דווח עליה בשרשור נפרד.

Aspose אינה מספקת תמיכה טכנית בטלפון. תמיכה טלפונית זמינה רק עבור שאלות מכירה וקנייה.

Java: משאבים

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

טבלה זו מציגה משאבים טכניים חשובים של Aspose.Email for Java.

Java: הערך את Aspose.Email

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

תוכל להוריד את Aspose.Email for Java בחינם להערכה. גרסת ההערכה מספקת כמעט את כל הפונקציונליות של המוצר עם מגבלות מסוימות. גרסת הערכה זו הופכת לרישונית כאשר אתה רוכש רישיון ומוסיף כמה שורות קוד ל החל את הרישיון.

אם ברצונך לבדוק את Aspose.Email ללא מגבלות גרסת הערכה, בקש רישיון זמני של 30 יום. עיין ב איך לקבל רישיון זמני?

מגבלות גרסת ההערכה

גרסת ההערכה של Aspose.Email (ללא רישיון מוגדר) מספקת את כל הפונקציונליות של המוצר למעט כמה רכיבים - Aspose.Email.Mail, Aspose.Email.Pop3, Aspose.Email.Ftp ו‑Aspose.Email.Imap שיש להם מגבלות הערכה:

קובץ License.txt מתווסף לקבצי ההודעות שנשמרים באמצעות Aspose.Email.
ניתן לחלץ רק 50 הודעות מייל מתיקייה בקובץ PST.
ניתן להוציא רק 3 קבצים מצורפים וכן תמונות משולבות מקובץ MSG.
מספר הקבצים המצורפים המקסימלי שנעבד בפורמט CFB הוא 1.
מספר הנמענים המקסימלי שנעבד בפורמט CFB הוא 1.
מוסיף "הודעת ערכה" לנושא בעת שמירה בפורמטים CFB, EML או MSG.
תאריך הסיום לא יכול להיות מאוחר מ-31-12-2004 במתודת GenerateOccurrences של דפוס חזרתיות. זה מאפשר לבדוק את המוצר בצורה משמעותית, אך עושה זאת בלתי אפשרי לשימוש באפליקציית ייצור. לדוגמה, ניתן ליצור דפוס כגון "החל מ-1 בינואר 2000 וחזור כל היום האחרון העובד של החודש" וליצור הופעות עבורו. הופעות לאחר 31 בדצמבר 2004 לא ייווצרו במצב הערכה
רק קובץ אחד מופק מתוך זרם MSO נתון על ידי המתודה InlineAttachmentExtractor.EnumerateMsoPackage

סימני הערכה משובצים בהודעה שנשמרה