Documentation – Работа с Exchange WebDav клиент

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. За целите на този пример, кодът:

Чете съобщения от папката Inbox.
Обработвайте съобщенията според определени критерии (в този пример намираме ключова дума в темата на съобщението).
Изтрийте съобщението.

Java: Извличане на съобщения от пощенска кутия в Exchange Server чрез WebDav

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

Изброяването на съобщения в Exchange Server използва listMessages() метод за получаване на списък със съобщения от пощенска кутия в Exchange Server. Този listMessages() методът извлича основна информация за съобщенията, например тема, Message ID, от и до.

За получаване на пълните детайли на съобщението, 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 клиент

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() метод. Получете основната информация за съобщенията, като тема, от, до и ID на съобщението, чрез listMessages() метод.

Тази статия показва как да се свържете с Exchange Server и да изброите имейлите в кутия директно или чрез WebDav. Освен това се показва как да изброите съобщения от различни папки и как да изброите съобщения по ID.

Изброяване на съобщения от 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 за 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 Server и изпратете заявка за среща, като използвате send(MailMessage) метод.

Този пример използва ExchangeClient клас, който използва WebDAV протокол за свързване към Exchange Server и може да се използва с всяка версия на Exchange Server, в която е активиран 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 клиент

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

Aspose.Email API предоставя възможност за осигуряване на логираща функция за WebDav клиента на Exchange протоколи.

Логиране за WebDav клиент

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