Documentation – עבודה עם Exchange WebDav Client

Java: התחברות ל-Exchange Server באמצעות WebDav

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

Aspose.Email מספקת את היכולת ל-Exchange 2003 ו-2007 באמצעות פרוטוקול WebDAV על ידי חשיפה של ExchangeClient מחלקה. מאמר זה מציג כיצד ליצור מופעים של שתי המחלקות והמתודה זהה שניתנת לשימוש בכל הדוגמאות הבאות במדריך הפיתוח הזה.

התחברות ל-Exchange באמצעות ExchangeClient

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

Java: מחיקת הודעות מ-Exchange Server באמצעות WebDav

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

אתה יכול למחוק הודעות דוא"ל מתיקייה בעזרת ה- ExchangeClient.deleteMessage() שיטה. היא מקבלת את כתובת ה-URI הייחודית של ההודעה כפרמטר.

קוד הדוגמה שלמטה מוחק הודעה מתיקיית Inbox. לצורך הדוגמה, הקוד:

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

Java: הבאת הודעות מתיבת Exchange Server באמצעות WebDav

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

רשימת הודעות ב-Exchange Server השתמשה ב- listMessages() מתודה לקבלת רשימת הודעות מתיבת Exchange Server. ה- listMessages() מתודה שמקבלת מידע בסיסי על הודעות, כגון נושא, מזהה הודעה, משולח ועבור.

כדי לקבל את פרטי ההודעה המלאים, Aspose.Email.Exchange מספקת את ה- ExchangeClient.fetchMessage() מתודה. מתודה זו מקבלת את כתובת ה-URI של ההודעה כפרמטר ומחזירה מופע של ה- MailMessage מחלקה. ה- MailMessage המחלקה לאחר מכן מספקת פרטי הודעה כגון הגוף, הכותרות והקבצים המצורפים.

הבאת הודעות מתיבת Exchange Server

להבאת הודעות מתיבת Exchange Server:

צור מופע מסוג ExchangeClient.
ציין שם השרת, שם משתמש, סיסמה, ותחום.
הפעל את listMessages מתודה לקבלת ה- ExchangeMessageInfoCollection.
לולאה על ה- ExchangeMessageInfoCollection אוסף לקבלת ExchangeMessageInfo.getUniqueUri ערכים.
קרא ExchangeClient.fetchMessage() ולעביר ExchangeMessageInfo.getUniqueUri כפרמטר.

קוד המקטע הבא מתחבר לתיבת Exchange Server ומביא את כל ההודעות.

Java: סינון הודעות מתיבת הדואר של Exchange באמצעות WebDav

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

ה ExchangeClient מחלקה מספקת את המתודה listMessages() שמקבלת את כל ההודעות מתיבת הדואר. לקבלת הודעות התואמות לתנאי מסוים בלבד, השתמש במתודה העמוסת listMessages() המקבלת את MailQuery מחלקה כארגומנט. ה- MailQuery מחלקה מספקת מאפיינים שונים לציון תנאים, לדוגמה תאריך, נושא, שולח ונמען. בנוסף, ה-API מאפשר גם להחיל מסננים רגישים רישיות לאיתור דוא"לים מתיבת הדואר.

סינון הודעות באמצעות Web Dav

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

התחבר לשרת Exchange.
צור מופע של MailQuery והגדר את המאפיינים הרצויים.
קרא למתודה ExchangeClient.listMessages(MailQuery query) והעבר את ה-MailQuery בפרמטרים כדי לקבל רק את ההודעות המסוננות.

דוגמאות הקוד למטה מראות איך להתחבר לתיבת Exchange ולקבל הודעות שבהן המחרוזת "Newsletter" מופיעה בנושא ונשלחו היום.

ExchangeClient client = new ExchangeClient("http://MachineName/exchange/Username", "username", "password", "domain");
SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");

// Query building by means of ExchangeQueryBuilder class
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
// Subject contains "Newsletter"
builder.getSubject().contains("Newsletter");

// Emails that arrived today
try {
	builder.getInternalDate().on(sdf.parse("10/05/2016 10:00:00"));
} catch (ParseException e) {
	e.printStackTrace();
}

// Build the query
MailQuery query = builder.getQuery();

// Get list of messages
ExchangeMessageInfoCollection messages = client.listMessages(client.getMailboxInfo().getInboxUri(), query, false);
System.out.println("Imap: " + messages.size() + " message(s) found.");

קבל הודעות העומדות בקריטריונים ספציפיים

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

קריטריון סינון תאריך היום

קוד המקטע הבא מראה כיצד לסנן את כל הודעות הדוא"ל על בסיס תאריך היום.

// Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.getInternalDate().on(new Date());

קריטריון סינון טווח תאריכים

קוד המקטע הבא מראה כיצד לסנן את כל הודעות הדוא"ל על בסיס טווח תאריכים.

MailQueryBuilder builder = new MailQueryBuilder();
builder.getInternalDate().beforeOrEqual(new Date());
builder.getInternalDate().since(new Date(new Date().getTime() + TimeUnit.DAYS.toDays(1)));

קריטריון סינון שולח ספציפי

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

MailQueryBuilder builder = new MailQueryBuilder();
// Get emails from specific sender
builder.getFrom().contains("saqib.razzaq@127.0.0.1");

קריטריון סינון תחום ספציפי

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

MailQueryBuilder builder = new MailQueryBuilder();
// Get emails from specific domain
builder.getFrom().contains("SpecificHost.com");

קריטריון סינון נמען ספציפי

קוד המקטע הבא מראה כיצד לסנן את כל הודעות הדוא"ל על בסיס נמען ספציפי.

MailQueryBuilder builder = new MailQueryBuilder();
// Get emails sent to specific recipient
builder.getTo().contains("recipient");

קריטריון סינון לפי MessageID

קוד המקטע הבא מראה כיצד לסנן את כל הודעות הדוא"ל על בסיס MessageID.

// Get email with specific MessageId
ExchangeQueryBuilder builder1 = new ExchangeQueryBuilder();
builder1.getMessageId().equals("MessageID");

קריטריון סינון כל הודעות משלוח דואר

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

// Get Mail Delivery Notifications
builder1 = new ExchangeQueryBuilder();
builder1.getContentClass().equals(ContentClassType.getMDN().toString());

בניית שאילתות מורכבות

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

שילוב שאילתות עם AND

MailQueryBuilder builder = new MailQueryBuilder();

// Emails from specific host
builder.getFrom().contains("SpecificHost.com");
// AND all emails that arrived before today
builder.getInternalDate().before(new Date());
// AND all emails that arrived since 7 days ago
builder.getInternalDate().since(new Date(new Date().getTime() + TimeUnit.DAYS.toDays(-7)));

שילוב שאילתות עם OR

QueryBuilder מספקת את המתודה or() המקבלת שני מופעים של MailQuery כפרמטרים. היא משיגה הודעות התואמות לאחד משני התנאים שהוגדרו. הדוגמה למטה מסננת הודעות שבהן יש את המילה "test" בנושא או "noreply@host.com" כשולח.

MailQueryBuilder builder = new MailQueryBuilder();
		
// Specify OR condition
builder.or(builder.getSubject().contains("test"), builder.getFrom().contains("noreply@host.com"));

סינון דוא"ל רגיש רישיות

ניתן לסנן הודעות דוא"ל על בסיס רגישות רישיות על ידי ציון הדגל IgnoreCase בתנאי הסינון כפי שמוצג בדוגמה הבאה.

//IgnoreCase is True
MailQueryBuilder builder1 = new MailQueryBuilder();
builder1.getFrom().contains("tesT", true);
MailQuery query1 = builder1.getQuery();

Java: קבלת מידע על תיבת הדואר באמצעות WebDav Client

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

ה ExchangeClient המחלקה כוללת חברים שניתן להשתמש בהם לקבל מידע על תיבת דואר מ‑Exchange Server על ידי קריאה ל‑ ExchangeClient.getMailboxInfo מתודה. היא מחזירה מופע מסוג ExchangeMailboxInfo. קבל מידע על תיבת הדואר מתכונות כגון MailboxUri, InboxUri , ו- DraftsUri.

מאמר זה מראה כיצד לגשת למידע של תיבת דואר ישירות מ‑Exchange Server.

קבלת מידע תיבת דואר מ‑Exchange Server

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

צור מופע של ExchangeClient מחלקה.
ציין את Exchange Server, שם משתמש, סיסמה ודומיין בבונה של ExchangeClient.
הפעל את ExchangeClient.getMailboxSize() מתודה לקבלת גודל תיבת הדואר.
הפעל את ExchangeClient.getMailboxInfo מתודה לקבלת מופע של ExchangeMailboxInfo מחלקה.
קבל את מידע תיבת הדואר באמצעות ExchangeMailboxInfo תכונות שונות של המחלקה.

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

Java: רשימת הודעות מ‑Exchange Server באמצעות WebDav

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

ניתן לקבל רשימת הודעות אימייל בתיבת דואר של Exchange על ידי קריאה ל‑ ExchangeClient.listMessages() מתודה. קבל מידע בסיסי על הודעות, כגון נושא, ממן, אל ומזהה הודעה, באמצעות listMessages() שיטה.

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

רשימת הודעות מ‑Exchange Server

לרשימת ההודעות בתיבת דואר של Exchange:

צור מופע של ExchangeClient מחלקה.
הפעל את listMessages מתודה ויצירת אוסף הודעות.
עבור על האוסף והצג מידע על ההודעה.

קטע הקוד למטה מתחבר לתיבת הדואר של Exchange ומקבל את רשימת ההודעות מתיקיית הדואר הנכנס.

רשימת הודעות מתיקיות שונות

קטעי הקוד שלמעלה מציגים את כל ההודעות בתיקיית הדואר הנכנס. ניתן גם לקבל את רשימת ההודעות מתיקיות אחרות. ה‑ ExchangeClient.listMessages() מתודה מקבלת URI של תיקייה כפרמטר. כל עוד ה‑URI תקף, ניתן לקבל את רשימת ההודעות מאותה תיקייה.

Use ExchangeClient.getMailboxInfo().xxxFolderUri נכס לקבל את ה‑URI של תיקיות שונות. שאר הקוד זהה לאופן קבלת רשימת הודעות.

Java: הזזת הודעות מתיקייה אחת לאחרת באמצעות WebDav

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

ניתן להעביר הודעות דוא"ל מתיקייה אחת לאחרת בעזרת ה‑ ExchangeClient.moveMessage() מתודה. היא מקבלת את הפרמטרים:

ה‑URI הייחודי של ההודעה שיש להעביר.
ה‑URI הייחודי של תיקיית היעד.

הזזת הודעות בין תיקיות

קוד הדוגמה למטה שמזיז הודעה בתיבת דואר מתיקיית הדואר הנכנס לתיקייה בשם Processed. בדוגמה זו, היישום:

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

Java: קריאת הודעות דוא"ל מתיבת הדואר של משתמש אחר באמצעות WebDav

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

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

קטע הקוד שלמטה מדגים כיצד להשתמש ב- ExchangeClient מחלקה לגישה לתיבת דואר אחרת.

Java: שמירת הודעות מתיבת Exchange Server באמצעות WebDav

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

מאמר זה מראה כיצד לקבל הודעות מתיבת Exchange Server ולשמור אותן לדיסק בפורמטים EML ו-MSG.

שמירת הודעות מתיבת Exchange Server ל-EML

כדי לקבל הודעות ולשמור בפורמט EML:

צור מופע של ExchangeClient מחלקה.
ספק את שם השרת, שם משתמש, סיסמה ותחום.
הפעל את ExchangeClient.listMessages() מתודה לקבלת מופע של ExchangeMessagesInfoCollection אוסף.
לולאה על ה- ExchangeMessagesInfoCollection אוסף לקבלת ה-URI הייחודי לכל הודעה.
הפעל את ExchangeClient.saveMessage() מתודה והעברת ה-URI הייחודי כפרמטר.
ספק saveMessage() מתודה עם נתיב למיקום שבו ברצונך לשמור את הקובץ.

שמירת הודעות ל-OutputStream

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

קוד המקטעים למטה שומר הודעות מתיבת Exchange Server לזרם זיכרון.

שמירת הודעות בפורמט MSG

ה ExchangeClient.saveMessage() שיטה יכולה לשמור ישירות את ההודעה בפורמט EML. כדי לשמור את ההודעות בפורמט MSG, תחילה יש לקרוא ל- ExchangeClient.fetchMessage() שיטה שמחזירה מופע של MailMessage מחלקה. לאחר מכן קרא ל- MailMessage.save() מתודה לשמירת ההודעה ל-MSG.

קוד המקטע הבא מביא הודעות מתיבת Exchange Server ושומר אותם בפורמט MSG.

Java: שלח הודעת דוא"ל באמצעות Exchange Server עם WebDav

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

אפשר לשלוח הודעות דוא"ל באמצעות Exchange Server בעזרת הכלים ב-com.aspose.email. ה- ExchangeClient.send() שיטה מקבלת MailMessage מופע כפרמטר ושולח את הדוא"ל. מאמר זה מסביר כיצד לשלוח הודעות דוא"ל באמצעות Exchange Client של ממשק ה-API.

שליחת הודעות דוא"ל באמצעות Exchange WebDav

לשליחת דוא"לים באמצעות Exchange Server:

צור מופע של ExchangeClient מחלקה.
ציין שם השרת, שם משתמש, סיסמה, ותחום.
צור מופע של MailMessage מחלקה.
ציין את השולח, הנמען, הנושא ועוד MailMessage מאפיינים.
הפעל את ExchangeClient.send() שיטה לשליחת הדוא"ל.

קוד הדוגמה למטה שולח הודעות דוא"ל באמצעות Exchange Server.

Java: שליחת בקשות פגישה עם Exchange Server באמצעות WebDav

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

מאמר זה מציג כיצד לשלוח בקשת פגישה למספר נמענים באמצעות Microsoft Exchange Server ו‑Aspose.Email. הוא גם מסביר איך להתאים את הקוד לעבודה עם Exchange Web Services.

שליחת בקשות פגישה באמצעות Web Dav

לשליחת בקשת פגישה:

צור בקשת פגישה באמצעות Appointment מחלקה והגדר את המיקום, הזמן והמשתתפים.
צור מופע של MailMessage מחלקה והגדר את הפגישה באמצעות MailMessage.addAlternateView() שיטה.
התחבר לשרת Exchange ושלח את בקשת הפגישה באמצעות send(MailMessage) שיטה.

דוגמה זו משתמשת ב‑ ExchangeClient מחלקה, אשר משתמשת ב‑ WebDAV פרוטוקול להתחברות ל‑Exchange Server וניתן להשתמש בו עם כל גרסת Exchange שבה WebDAV מופעל, לדוגמה Exchange 2000, 2003 או 2007.

קטעי הקוד המשמשים לשליחת בקשת הפגישה מוצגים למטה:

Java: עבודה עם אנשי קשר ב-Exchange Server באמצעות WebDav

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

מאמר זה מסביר כיצד לאחזר מידע על אנשי קשר מ-Exchange Server ישירות. מאמר זה גם מציג כיצד ניתן לרשום אנשי קשר מתיקיית Contacts.

קבלת אנשי קשר מ-Exchange Server

ה ExchangeClient מחלקה’ listContacts() ניתן להשתמש בשיטה כדי לקבל מידע על אנשי קשר מ-Exchange Server. listContacts() השיטה דורשת את כתובת ה-URI של תיקיית Contacts, שניתן לקבל בקלות באמצעות ה- ExchangeMailboxInfo.ContactsUri מאפיין.

כדי לקבל אנשי קשר מ-Exchange Server:

אתחל את מחלקת ExchangeClient עם כתובת ופרטי זיהוי.
קבל את כתובת ה-URI של תיקיית Contacts באמצעות המאפיין ExchangeClient.getMailboxInfo().getContactsUri().
קרא למתודה listContacts(). היא מחזירה מערך של MapiContact.
בצע לולאת foreach על מערך MapiContact כדי לקרוא את פרטי איש הקשר.

קטע הקוד הבא מציג כיצד להשתמש ב- ExchangeClient מחלקה לקריאת כל אנשי הקשר מ-Exchange Server.

String mailboxURI = "http://ex2003/exchange/administrator"; // WebDAV
String username = "administrator";
String password = "pwd";
String domain = "domain.local";

// Credentials for connecting to Exchange Server
NetworkCredential credential = new NetworkCredential(username, password, domain);
ExchangeClient client = new ExchangeClient(mailboxURI, credential);

// List all the contacts
MapiContact[] contacts = client.listContacts(client.getMailboxInfo().getContactsUri());
for (MapiContact contact : contacts)
{
    // Display name and email address
    System.out.println("Name: " + contact.getNameInfo().getDisplayName() + ", Email Address: " + contact.getElectronicAddresses().getEmail1());
}

Java: עבודה עם תיקיות ב-WebDav

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

רישום כל התיקיות מהשרת

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

שימוש ב-WebDav

קטע הקוד הבא מציג כיצד לרשום תיקיות מ-Exchange Server.

public static void run() {
    try {
        ExchangeClient client = new ExchangeClient("http://ex07sp1/exchange/Administrator", "user", "pwd", "domain");
        System.out.println("Downloading all messages from Inbox....");

        ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
        System.out.println("Mailbox URI: " + mailboxInfo.getMailboxUri());
        String rootUri = client.getMailboxInfo().getRootUri();
        // List all the folders from Exchange server
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(rootUri);
        for (ExchangeFolderInfo folderInfo : folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listSubFolders(client, folderInfo);
        }

        System.out.println("All messages downloaded.");
    } catch (Exception ex) {
        System.err.println(ex);
    }
}

private static void listSubFolders(ExchangeClient client, ExchangeFolderInfo folderInfo) {
    System.out.println(folderInfo.getDisplayName());
    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ExchangeFolderInfoCollection folderInfoCollection = client.ListSubFolders(folderInfo.Uri);
        for (ExchangeFolderInfo subfolderInfo : folderInfoCollection) {
            listSubFolders(client, subfolderInfo);
        }
    } catch (Exception ex) {
        System.err.println(ex);
    }
}

Java: תמיכה ברישום ב‑WebDav Client

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

API של Aspose.Email מספק את היכולת לספק תשתית רישום ל‑WebDav client של פרוטוקולי Exchange.

רישום עבור WebDav Client

client.setLogFileName("logs/exchange");
// OR
ExchangeClient.setCommonLogFileName("logs/exchange");