Documentation – Робота з Exchange WebDav Client

Java: Підключення до сервера Exchange за допомогою WebDav

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

Aspose.Email забезпечує можливість роботи з Exchange 2003 та 2007 за допомогою протоколу WebDAV, надаючи ExchangeClient клас. У цій статті показано, як створювати об’єкти обох класів, і той самий метод можна використовувати у всіх наступних прикладах у цьому посібнику.

Підключення до Exchange за допомогою ExchangeClient

Наступні приклади коду показують написання власної функції, яку можна викликати у кодових сегментах для створення ExchangeClient, які потім можна використовувати для виконання різних операцій Exchange.

Java: Видалення листів з сервера Exchange за допомогою WebDav

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

Ви можете видаляти електронні листи з папки за допомогою ExchangeClient.deleteMessage() метод. Він приймає унікальний URI повідомлення як параметр.

Нижченаведений зразок коду видаляє повідомлення з папки Inbox. Для цілей цього прикладу код:

Читає повідомлення з папки Inbox.
Обробка листів за певними критеріями (у цьому прикладі ми шукаємо ключове слово в темі листа).
Видалити повідомлення.

Java: Отримання повідомлень з поштової скриньки Exchange Server за допомогою WebDav

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

Перелік повідомлень на сервері Exchange використав listMessages() метод для отримання списку повідомлень з поштової скриньки Exchange Server. The listMessages() метод отримує базову інформацію про повідомлення, наприклад тему, ID повідомлення, від та до.

Щоб отримати повні деталі повідомлення, Aspose.Email.Exchange надає ExchangeClient.fetchMessage() метод. Цей метод приймає URI повідомлення як параметр і повертає екземпляр MailMessage клас. The 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

The ExchangeClient клас надає метод listMessages(), який отримує всі повідомлення зі скриньки. Щоб отримати лише повідомлення, що відповідають певній умові, використайте перевантажений метод listMessages(), який приймає MailQuery клас як аргумент. The 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 клієнта

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

The ExchangeClient клас має члени, які можна використовувати для отримання інформації про поштову скриньку з Exchange Server шляхом виклику ExchangeClient.getMailboxInfo метод. Повертає екземпляр типу ExchangeMailboxInfo. Отримати інформацію про поштову скриньку зі властивостей, таких як MailboxUri, InboxUri , та DraftsUri.

У цій статті показано, як отримати інформацію про поштову скриньку безпосередньо з Exchange Server.

Отримання інформації про поштову скриньку з сервера Exchange

Щоб отримати інформацію про поштову скриньку 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 і отримує список повідомлень з папки Inbox.

Перелік повідомлень з різних папок

Наведених вище фрагментів коду виводять усі повідомлення у папці Inbox. Можливо також отримати список повідомлень з інших папок. ExchangeClient.listMessages() метод приймає URI папки як параметр. Якщо URI папки дійсний, ви можете отримати список повідомлень з цієї папки.

Використайте ExchangeClient.getMailboxInfo().xxxFolderUri властивість для отримання URI різних папок. Решта коду така сама, як і при отриманні списку повідомлень.

Java: Переміщення повідомлень з однієї папки в іншу за допомогою WebDav

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

Ви можете переміщати електронні повідомлення з однієї папки в іншу за допомогою ExchangeClient.moveMessage() метод. Приймає параметри:

Унікальний URI повідомлення, яке потрібно перемістити.
Унікальний URI папки призначення.

Переміщення повідомлень між папками

Наведений нижче приклад коду переміщує повідомлення в поштовій скриньці з папки Inbox у папку під назвою Processed. У цьому прикладі застосунок:

Читає повідомлення з папки Inbox.
Обробляє частину повідомлень за певним критерієм (у цьому прикладі — шукає ключове слово у темі повідомлення).
Переміщує повідомлення, які відповідають заданій умові, у папку 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

The 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. The 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 Server, в якій увімкнено WebDAV, наприклад, Exchange 2000, 2003 чи 2007.

Нижче наведено фрагменти коду, що використовується для надсилання запиту на зустріч:

Java: Робота з контактами на сервері Exchange за допомогою WebDav

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

У цій статті пояснюється, як безпосередньо отримати інформацію про контакти з сервера Exchange. У статті також показано, як можна вивести список контактів із папки Contacts.

Отримання контактів з сервера Exchange

The ExchangeClient клас’ listContacts() метод можна використати для отримання інформації про контакти з сервера Exchange. listContacts() метод потребує URI папки Contacts, який можна легко отримати за допомогою ExchangeMailboxInfo.ContactsUri властивість.

Щоб отримати контакти з сервера Exchange:

Ініціалізуйте клас ExchangeClient, вказавши адресу та облікові дані.
Отримайте URI папки Contacts за допомогою властивості ExchangeClient.getMailboxInfo().getContactsUri().
Викличте метод listContacts(). Він повертає масив MapiContact.
Виконайте цикл foreach по масиву MapiContact, щоб прочитати інформацію про контакти.

Наступний фрагмент коду показує, як використовувати ExchangeClient клас для читання всіх контактів з сервера Exchange.

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 та виводити список усіх папок і підпапок. Ви також можете рекурсивно отримувати всі підпапки кожної папки. У цій статті показано, як отримати усі підпапки з сервера Exchange та отримати папки з розбиттям на сторінки.

Використання WebDav

Наступний фрагмент коду показує, як вивести список папок з сервера Exchange.

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 клієнті

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

Aspose.Email API забезпечує можливість надання функції логування клієнта WebDav протоколів Exchange.

Логування для WebDav клієнта

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