Documentation – Робота з клієнтом Exchange EWS

Java: Підключення до Exchange Server

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

Для підключення до серверів Exchange 2007, 2010 та 2013 за допомогою Exchange Web Service Aspose.Email надає IEWSClient інтерфейс, який реалізує EWSClient клас. The EWSClient.getEWSClient метод створює та повертає IEWSClient об’єкт, який далі використовується для виконання операцій, пов’язаних з поштовою скринькою Exchange та іншими папками. У цій статті показано, як створювати екземпляри IEWSClient.

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

У наведеному фрагменті коду показано, як підключитися за допомогою Exchange Web Service (EWS).

private static IEWSClient getExchangeEWSClient() {
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String domain = "";
    final String username = "username@onmicrosoft.com";
    final String password = "password";
    NetworkCredential credentials = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
    return client;
}

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

Microsoft Exchange Server підтримує протокол IMAP для доступу до елементів у поштовій скринці. Використовуйте ImapClient клас для підключення до Exchange Server за допомогою протоколу IMAP. Для отримання додаткової інформації про ImapClient клас. По-перше, переконайтеся, що служби IMAP увімкнені для вашого Exchange Server:

Відкрийте Панель управління.
Перейдіть у Administrator Tools, потім у Services.
Перевірте стан служби Microsoft Exchange IMAP4.
Якщо він ще не запущений, увімкніть/запустіть його.

У наведеному фрагменті коду показано, як підключитися та вивести список повідомлень з папки Inbox Microsoft Exchange Server за допомогою протоколу IMAP.

// Connect to Exchange Server using ImapClient class
ImapClient imapClient = new ImapClient("ex07sp1", "Administrator", "Evaluation1");
imapClient.setSecurityOptions(SecurityOptions.Auto);

// Select the Inbox folder
imapClient.selectFolder(ImapFolderInfo.IN_BOX);

// Get the list of messages
ImapMessageInfoCollection msgCollection = imapClient.listMessages();
for (ImapMessageInfo msgInfo : (Iterable<ImapMessageInfo>) msgCollection) {
    System.out.println(msgInfo.getSubject());
}
// Disconnect from the server
imapClient.dispose();

У наведеному фрагменті коду показано, як використовувати SSL.

public static void run() {
    // Connect to Exchange Server using ImapClient class
    ImapClient imapClient = new ImapClient("ex07sp1", 993, "Administrator", "Evaluation1");
    imapClient.setSecurityOptions(SecurityOptions.SSLExplicit);

    // Select the Inbox folder
    imapClient.selectFolder(ImapFolderInfo.IN_BOX);

    // Get the list of messages
    ImapMessageInfoCollection msgCollection = imapClient.listMessages();
    for (ImapMessageInfo msgInfo : (Iterable<ImapMessageInfo>) msgCollection) {
        System.out.println(msgInfo.getSubject());
    }
    // Disconnect from the server
    imapClient.dispose();
}

Після підключення до сервера Exchange за допомогою IMAP та отримання IMapMessageInfoCollection, У наведеному фрагменті коду показано, як використовувати MessageInfo послідовний номер об’єкта для збереження конкретного повідомлення.

// Select the Inbox folder
imapClient.selectFolder(ImapFolderInfo.IN_BOX);
// Get the list of messages
ImapMessageInfoCollection msgCollection = imapClient.listMessages();
for (ImapMessageInfo msgInfo : (Iterable<ImapMessageInfo>) msgCollection) {
    // Fetch the message from inbox using its SequenceNumber from msgInfo
    MailMessage message = imapClient.fetchMessage(msgInfo.getSequenceNumber());

    // Save the message to disc now
    message.save(dataDir + msgInfo.getSequenceNumber() + "_out.msg", SaveOptions.getDefaultMsgUnicode());
}

Java: Робота з поштовою скринькою Exchange та повідомленнями — читання електронної пошти з сервера Exchange на Java

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

Отримання інформації про скриньку за допомогою EWS

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

Якщо ви хочете підключитися до сервера Exchange за допомогою Exchange Web Services (EWS), використовуйте EWSClient клас. Цей клас використовуе EWS для підключення та управління елементами на сервері Exchange. Наступний фрагмент коду Java показує, як отримати інформацію про скриньку за допомогою Exchange Web Services.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get mailbox size, exchange mailbox info, Mailbox and Inbox folder URI
System.out.println("Mailbox size: " + client.getMailboxSize() + " bytes");
ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
System.out.println("Mailbox URI: " + mailboxInfo.getMailboxUri());
System.out.println("Inbox folder URI: " + mailboxInfo.getInboxUri());
System.out.println("Sent Items URI: " + mailboxInfo.getSentItemsUri());
System.out.println("Drafts folder URI: " + mailboxInfo.getDraftsUri());

Надсилання електронних листів

Ви можете надсилати електронні листи за допомогою Exchange Server, використовуючи інструменти в Aspose.Email.Exchange. Метод IEWSClient.Send() приймає MailMessage екземпляр як параметр і надсилає лист. У цій статті пояснюється, як надсилати електронні листи за допомогою Exchange Web Services.

Aspose.Email надає клас IEWSClient для підключення до Microsoft Exchange Server за допомогою Exchange Web Services. Наступний фрагмент коду показує, як використати EWS для надсилання листів через Microsoft Exchange Server. Наступний фрагмент коду Java показує, як надсилати електронні листи за допомогою EWS.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create instance of type MailMessage
MailMessage msg = new MailMessage();
msg.setFrom(MailAddress.to_MailAddress("sender@domain.com"));
msg.setTo(MailAddressCollection.to_MailAddressCollection("recipient@ domain.com "));
msg.setSubject("Sending message from exchange server");
msg.setHtmlBody("<h3>sending message from exchange server</h3>");

// Send the message
client.send(msg);

Отримання класу повідомлення

The getMessageClass() метод ExchangeMessageInfo клас отримує рядок, що представляє клас повідомлення. Нижче наведено приклад коду, який показує, як отримати клас повідомлення:

try (IEWSClient client = EWSClient.getEWSClient(uri, credentials))
{
    ExchangeMessageInfoCollection messageInfoCollection = client.listMessagesFromPublicFolder(publicFolder);

    for (ExchangeMessageInfo messageInfo : messageInfoCollection)
    {
        System.out.println("Message Class: " + messageInfo.getMessageClass());
    }
}

Читання листів з поштової скриньки іншого користувача

Деякі облікові записи на серверах Exchange мають право доступу до декількох скриньок, а деякі користувачі мають кілька електронних скриньок на одному сервері Exchange. У обох випадках користувачі можуть отримати доступ до скриньок інших користувачів за допомогою Aspose.Email для Java. Це API забезпечує механізм доступу до папок та листів з інших скриньок за допомогою IEWSClient клас. Цю функціональність можна реалізувати за допомогою перевантаженого getMailboxInfo() методу, передаючи адресу електронної пошти користувача як параметр.

Наступний фрагмент коду показує, як читати електронну пошту за допомогою IEWSClient клас.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get Exchange mailbox info of other email account
ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo("otherUser@domain.com");

Перелічення повідомлень

Список електронних повідомлень у поштовій скриньці Exchange можна отримати, викликавши IEWSClient.listMessages метод. Отримайте базову інформацію про повідомлення, таку як тема, від, до та ідентифікатор повідомлення, використовуючи listMessages метод.

Просте перелічення повідомлень

Щоб перелічити повідомлення у поштовій скриньці Exchange:

Створіть екземпляр IEWSClient клас.
Викличте метод listMessages і створіть колекцію повідомлень.
Пройдіться по колекції та відобразьте інформацію про повідомлення.

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

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "UserName", "Password");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    System.out.println("Subject: " + msgInfo.getSubject());
    System.out.println("From: " + msgInfo.getFrom().toString());
    System.out.println("To: " + msgInfo.getTo().toString());
    System.out.println("Message ID: " + msgInfo.getMessageId());
    System.out.println("Unique URI: " + msgInfo.getUniqueUri());
}

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

Вищенаведені фрагменти коду, перелічити всі повідомлення у папці Inbox. Також можна отримати список повідомлень з інших папок. IEWSClient.listMessages() метод приймає URI папки як параметр. Якщо URI папки дійсний, можна отримати список повідомлень з цієї папки. Використовуйте властивість IEWSClient.getMailboxInfo().getXXXFolderUri, щоб отримати URI різних папок. Решта коду така ж, як для отримання списку повідомлень. Наступний фрагмент коду показує, як перелічувати повідомлення з різних папок за допомогою EWS.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get folder URI
String strFolderURI = "";
strFolderURI = client.getMailboxInfo().getInboxUri();
strFolderURI = client.getMailboxInfo().getDeletedItemsUri();
strFolderURI = client.getMailboxInfo().getDraftsUri();
strFolderURI = client.getMailboxInfo().getSentItemsUri();

// Get list of messages from the specified folder
ExchangeMessageInfoCollection msgCollection = client.listMessages(strFolderURI);

Перелік повідомлень з підтримкою посторінкового перегляду

Наступний фрагмент коду Java показує, як отримати список повідомлень з підтримкою посторінкового перегляду.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final IEWSClient client = EWSClient.getEWSClient("exchange.domain.com", "username", "password");
try {
    try {
        // Create some test messages to be added to server for retrieval later
        int messagesNum = 12;
        int itemsPerPage = 5;
        MailMessage message = null;
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35157_1 - " + UUID.randomUUID().toString(),
                    "EMAILNET-35157 Move paging parameters to separate class");
            client.appendMessage(client.getMailboxInfo().getInboxUri(), message);
        }
        // Verfiy that the messages have been added to the server
        ExchangeMessageInfoCollection totalMessageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
        System.out.println(totalMessageInfoCol.size());

        ////////////////// RETREIVING THE MESSAGES USING PAGING SUPPORT ////////////////////////////////////

        List<ExchangeMessagePageInfo> pages = new ArrayList<ExchangeMessagePageInfo>();
        ExchangeMessagePageInfo pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
        // Total Pages Count
        System.out.println(pageInfo.getTotalCount());

        pages.add(pageInfo);
        while (!pageInfo.getLastPage()) {
            pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage, pageInfo.getPageOffset() + 1);
            pages.add(pageInfo);
        }
        int retrievedItems = 0;
        // foreach to while statements conversion
        for (ExchangeMessagePageInfo pageCol : pages) {
            retrievedItems += pageCol.getItems().size();
        }
        // Verify total message count using paging
        System.out.println(retrievedItems);
    } finally {
    }
} finally {
    client.dispose();
}

Отримання інформації про тип повідомлення з ExchangeMessageInfo

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

ExchangeMessageInfoCollection list = client.listMessages(client.getMailboxInfo().getDeletedItemsUri());
System.out.println(list.get_Item(0).getMessageInfoType()); // MessageInfoType

Збереження повідомлень

У цій статті показано, як отримати повідомлення з поштової скриньки Exchange Server та зберегти їх на диск у форматах EML і MSG:

Зберегти у форматі EML на диск.
Зберегти у пам’ять‑потік.
Зберегти у форматі MSG.

Збереження повідомлень у EML

Щоб отримати повідомлення і зберегти у форматі EML:

Створіть екземпляр класу IEWSClient.
Вкажіть mailboxUri, ім’я користувача, пароль і домен.
Викличте метод IEWSClient.listMessages(), щоб отримати екземпляр колекції ExchangeMessagesInfoCollection.
Пройдіться у циклі по колекції ExchangeMessagesInfoCollection, щоб отримати унікальний URI для кожного повідомлення.
Викличте метод IEWSClient.saveMessage() і передайте унікальний URI як параметр.
Надайте методу saveMessage() шлях, куди ви хочете зберегти файл.

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

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now save the message in disk
    client.saveMessage(strMessageURI, dataDir + msgInfo.getMessageId() + "out.eml");
}

Збереження повідомлень у пам’ять‑потік

Замість збереження файлів EML на диск їх можна зберегти у пам’ять‑потік. Це корисно, коли потрібно зберегти потік у сховище, наприклад, базу даних. Після збереження потоку у базу даних, ви можете завантажити файл EML у MailMessage клас. Наступний фрагмент коду показує, як зберегти повідомлення з поштової скриньки Exchange Server у пам’ять‑потік за допомогою EWS.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now save the message in memory stream
    ByteArrayOutputStream stream = new ByteArrayOutputStream();
    client.saveMessage(strMessageURI, stream);
}

Збереження повідомлень у форматі MSG

The IEWSClient.saveMessage() метод може безпосередньо зберегти повідомлення у форматі EML. Щоб зберегти повідомлення у форматі MSG, спершу викличте IEWSClient.fetchMessage() метод, який повертає екземпляр MailMessage клас. Потім викличте MailMessage.save() метод для збереження повідомлення у форматі MSG. Наступний фрагмент коду показує, як отримати повідомлення з поштової скриньки Exchange Server та зберегти їх у форматі MSG за допомогою EWS.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

int count = 0;
// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now get the message details using FetchMessage() and Save message as Msg
    MailMessage message = client.fetchMessage(strMessageURI);
    message.save(dataDir + (count++) + "_out.msg", SaveOptions.getDefaultMsgUnicode());
}

Отримання ExchangeMessageInfo з URI повідомлення

Електронне повідомлення представлено його унікальним ідентифікатором, URI і є невід’ємною частиною ExchangeMessageInfo об’єкт. Якщо доступний лише URI повідомлення, тоді ExchangeMessageInfo об’єкт також можна отримати, використовуючи цю доступну інформацію. Перевантажена версія listMessages приймає список ідентифікаторів для використання ExchangeMessageInfoCollection. Наступний фрагмент коду показує, як отримати ExchangeMessageInfo з URI повідомлення.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "user@domain.com", "pwd", "domain");

List<String> ids = new ArrayList<String>();
List<MailMessage> messages = new ArrayList<MailMessage>();

for (int i = 0; i < 5; i++) {
    MailMessage message = new MailMessage("user@domain.com", "receiver@domain.com", "EMAILNET-35033 - " + UUID.randomUUID().toString(),
            "EMAILNET-35033 Messages saved from Sent Items folder doesn't contain 'To' field");
    messages.add(message);
    String uri = client.appendMessage(message);
    ids.add(uri);
}

ExchangeMessageInfoCollection messageInfoCol = client.listMessages(ids);

for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) messageInfoCol) {
    // Do something ...
    System.out.println(messageInfo.getUniqueUri());
}

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

Перелік повідомлень на сервері Exchange використав listMessages() метод для отримання списку повідомлень з поштової скриньки Exchange Server. The listMessages() метод отримує базову інформацію про повідомлення, наприклад, тему, ідентифікатор повідомлення, від і до. Щоб отримати повні деталі повідомлення, Aspose.Email.Exchange надає метод IEWSClient.fetchMessage(). Цей метод приймає URI повідомлення як параметр і повертає екземпляр MailMessage клас. The MailMessage клас потім надає деталі повідомлення, такі як тіло, заголовки та вкладення. Дізнайтеся більше про MailMessage API, або дізнайтеся, як керувати електронною поштою за допомогою MailMessage клас. Щоб отримати повідомлення з поштової скриньки Exchange Server:

Створіть екземпляр типу IEWSClient.
Вкажіть назву сервера, ім’я користувача, пароль та домен.
Викличте listMessages, щоб отримати ExchangeMessageInfoCollection.
Пройдіться у циклі по колекції ExchangeMessageInfoCollection, щоб отримати значення ExchangeMessageInfo.UniqueURI.
Викличте IEWSClient.fetchMessage() і передайте ExchangeMessageInfo.UniqueURI як параметр.

Наступний фрагмент коду показує, як підключитися до поштової скриньки Exchange Server та отримати всі повідомлення за допомогою EWS.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now get the message details using FetchMessage()
    MailMessage msg = client.fetchMessage(strMessageURI);

    for (Attachment att : (Iterable<Attachment>) msg.getAttachments()) {
        System.out.println("Attachment Name: " + att.getName());
    }
}

Використання методу FetchItem для отримання повідомлення

Зауважте, що FetchItem метод повертає повідомлення без вкладень. Щоб отримати повідомлення з вкладеннями, використайте FetchItem метод, описаний у розділі нижче.

The FetchItem метод більше підходить, якщо ви хочете отримати MapiMessage і працювати з властивостями MAPI. Ви також можете використовувати цей метод для отримання будь‑якого елементу Outlook, такого як контакт, зустріч, завдання тощо.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : msgCollection)
{
    // Now get the message using FetchItem()
    MapiMessage msg = client.fetchItem(msgInfo.getUniqueUri());

    // If necessary, you can cast the MapiMessage to the proper item type to simplify working with its properties.
    MapiContact contact = (MapiContact) msg.toMapiMessageItem();
}

Попереднє отримання розміру повідомлення

Microsoft Outlook InterOp забезпечує можливість отримання розміру повідомлення до фактичного завантаження повного повідомлення з сервера. У випадку Aspose.Email API, інформація підсумку, отримана з сервера Exchange, представлена ExchangeMessageInfo клас. Він забезпечує таку ж функцію отримання розміру повідомлення за допомогою властивості Size. Для отримання розміру повідомлення використовується стандартний виклик listMessages IEWSClient, який повертає колекцію ExchangeMessageInfo. У наведеному фрагменті коду показано, як відобразити розмір повідомлення за допомогою ExchangeMessageInfo клас.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    System.out.println("Subject: " + msgInfo.getSubject());
    System.out.println("From: " + msgInfo.getFrom().toString());
    System.out.println("To: " + msgInfo.getTo().toString());
    System.out.println("Message Size: " + msgInfo.getSize());
    System.out.println("==================================");
}

Рекурсивне завантаження повідомлень

The EWSClient’s listSubFolders() метод можна використовувати для отримання повідомлень з папок і підпапок поштової скриньки Exchange Server рекурсивно. Це вимагає Exchange Server 2007 або новіший, оскільки використовується EWS. У наведеному фрагменті коду показано, як завантажити всю поштову скриньку (папки та підпапки) Exchange Server. Структура папок створюється локально, і всі повідомлення завантажуються.

public static void run() {
    try {
        downloadAllMessages();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void downloadAllMessages() {
    try {
        String rootFolder = domain + "-" + username;
        new File(rootFolder).mkdirs();
        String inboxFolder = rootFolder + "\\Inbox";
        new File(inboxFolder).mkdirs();

        System.out.println("Downloading all messages from Inbox....");
        // Create instance of IEWSClient class by giving credentials
        IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", username, password, domain);

        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 : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listMessagesInFolder(client, folderInfo, rootFolder);
        }

        System.out.println("All messages downloaded.");
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

// Recursive method to get messages from folders and sub-folders
private static void listMessagesInFolder(IEWSClient client, ExchangeFolderInfo folderInfo, String rootFolder) {
    // Create the folder in disk (same name as on IMAP server)
    String currentFolder = rootFolder + "\\" + folderInfo.getDisplayName();
    new File(currentFolder).mkdirs();

    // List messages
    ExchangeMessageInfoCollection msgInfoColl = client.listMessages(folderInfo.getUri());
    System.out.println("Listing messages....");
    int i = 0;
    for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgInfoColl) {
        // Get subject and other properties of the message
        System.out.println("Subject: " + msgInfo.getSubject());

        // Get rid of characters like ? and :, which should not be included in a file name
        String fileName = msgInfo.getSubject().replace("?", " ").replace(":", " ");

        MailMessage msg = client.fetchMessage(msgInfo.getUniqueUri());
        msg.save(dataDir + "\\" + fileName + "-" + i + ".msg");

        i++;
    }
    System.out.println("============================\n");
    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(folderInfo.getUri());
        for (ExchangeFolderInfo subfolderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            listMessagesInFolder(client, subfolderInfo, currentFolder);
        }
    } catch (java.lang.RuntimeException e) {
    }
}

Завантаження повідомлень з публічних папок

Microsoft Exchange Server дозволяє користувачам створювати публічні папки та розміщувати в них повідомлення. Щоб зробити це через ваш додаток, використовуйте Aspose.Email EWSClient клас для підключення до Exchange Server та читання і завантаження повідомлень і дописів з публічних папок. У наведеному фрагменті коду показано, як читати всі публічні папки та підпапки, а також перераховувати і завантажувати будь‑які повідомлення, знайдені в цих папках. Цей приклад працює лише з Microsoft Exchange Server 2007 або новішим, оскільки лише вони підтримують EWS.

public static void run() {
    try {
        readPublicFolders();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void readPublicFolders() {
    NetworkCredential credential = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

    ExchangeFolderInfoCollection folders = client.listPublicFolders();
    for (ExchangeFolderInfo publicFolder : (Iterable<ExchangeFolderInfo>) folders) {
        System.out.println("Name: " + publicFolder.getDisplayName());
        System.out.println("Subfolders count: " + publicFolder.getChildFolderCount());
        listMessagesFromSubFolder(publicFolder, client);

    }
}

private static void listMessagesFromSubFolder(ExchangeFolderInfo publicFolder, IEWSClient client) {
    System.out.println("Folder Name: " + publicFolder.getDisplayName());
    ExchangeMessageInfoCollection msgInfoCollection = client.listMessagesFromPublicFolder(publicFolder);
    for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) msgInfoCollection) {
        MailMessage msg = client.fetchMessage(messageInfo.getUniqueUri());
        System.out.println(msg.getSubject());
        msg.save(dataDir + msg.getSubject() + ".msg", SaveOptions.getDefaultMsgUnicode());
    }

    // Call this method recursively for any subfolders
    if (publicFolder.getChildFolderCount() > 0) {
        ExchangeFolderInfoCollection subfolders = client.listSubFolders(publicFolder);
        for (ExchangeFolderInfo subfolder : (Iterable<ExchangeFolderInfo>) subfolders) {
            listMessagesFromSubFolder(subfolder, client);
        }
    }
}

Переміщення повідомлень

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

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

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

У наведеному фрагменті коду показано, як перемістити повідомлення в поштовій скриньці з папки Inbox у папку під назвою Processed. У цьому прикладі застосунок:

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

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();

// List all messages from Inbox folder
System.out.println("Listing all messages from Inbox....");
ExchangeMessageInfoCollection msgInfoColl = client.listMessages(mailboxInfo.getInboxUri());
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgInfoColl) {
    // Move message to "Processed" folder, after processing certain messages based on some criteria
    if (msgInfo.getSubject() != null && msgInfo.getSubject().toLowerCase().contains("process this message")) {
        client.moveItem(mailboxInfo.getDeletedItemsUri(), msgInfo.getUniqueUri()); // EWS
        System.out.println("Message moved...." + msgInfo.getSubject());
    } else {
        // Do something else
    }
}

Видалення повідомлень

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

Наступний фрагмент коду показує, як видалити повідомлення з папки Inbox. Для прикладу, код:

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();

// List all messages from Inbox folder
System.out.println("Listing all messages from Inbox....");
ExchangeMessageInfoCollection msgInfoColl = client.listMessages(mailboxInfo.getInboxUri());
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgInfoColl) {
    // Delete message based on some criteria
    if (msgInfo.getSubject() != null && msgInfo.getSubject().toLowerCase().contains("delete") == true) {
        client.deleteItem(msgInfo.getUniqueUri(), DeletionOptions.getDeletePermanently()); // EWS
        System.out.println("Message deleted...." + msgInfo.getSubject());
    } else {
        // Do something else
    }
}

Копіювання повідомлень

Aspose.Email API дозволяє копіювати повідомлення з однієї папки в іншу за допомогою copyItem метод. Перевантажена версія цього методу повертає унікальний URI скопійованого повідомлення, як показано в цій статті.

Копіювання повідомлення в іншу папку

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

try {
    // Create instance of EWSClient class by giving credentials
    IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
    MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-34997 - " + UUID.randomUUID().toString(),
            "EMAILNET-34997 Exchange: Copy a message and get reference to the new Copy item");
    String messageUri = client.appendMessage(message);
    String newMessageUri = client.copyItem(messageUri, client.getMailboxInfo().getDeletedItemsUri());
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Java: Фільтрація повідомлень з поштової скриньки Exchange

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

Aspose.Email for Java надає можливість фільтрувати повідомлення з поштової скриньки Exchange за допомогою EWSClient і ExchangeQueryBuilder. Повідомлення можна фільтрувати за різними критеріями, такими як дата, домен, message-id та повідомлення про доставку пошти. У цій статті показано, як фільтрувати повідомлення з Exchange Server, використовуючи різні критерії.

Фільтрація повідомлень за допомогою EWS

The IEWSClient class надає listMessages() метод, який отримує всі повідомлення зі скриньки. Щоб отримати лише повідомлення, які відповідають певній умові, використайте перевантажений listMessages() метод, який приймає MailQuery клас як аргумент. The MailQuery клас надає різні властивості для вказання умов, наприклад, дата, тема, відправник та одержувач. Крім того, API дозволяє застосовувати фільтри чутливості до регістру при отриманні електронних листів зі скриньки.

Фільтрація повідомлень

Щоб отримати відфільтровані повідомлення зі скриньки:

Підключіться до сервера Exchange.
Створіть екземпляр MailQuery і встановіть потрібні властивості.
Викличте метод IEWSClient.listMessages() і передайте MailQuery у параметрах, щоб отримати лише відфільтровані повідомлення.

Наступний фрагмент коду показує, як підключитися до IMAP‑поштової скриньки та отримати повідомлення, у темі яких є рядок "Newsletter" і які були надіслані сьогодні.

try {
    // Connect to EWS
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String username = "username";
    final String password = "password";
    final String domain = "domain";

    IEWSClient client = EWSClient.getEWSClient(mailboxUri, username, password, domain);

    // Query building by means of ExchangeQueryBuilder class
    ExchangeQueryBuilder builder = new ExchangeQueryBuilder();

    // Set Subject and Emails that arrived today
    builder.getSubject().contains("Newsletter");
    builder.getInternalDate().on(new Date());

    MailQuery query = builder.getQuery();

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

    // Disconnect from EWS
    client.dispose();
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Фільтрація повідомлень за критеріями

Вище подані зразки коду фільтрують повідомлення за темою листа та датою. Ми можемо фільтрувати й за іншими властивостями. Нижче наведено кілька прикладів встановлення умов за допомогою MailQuery.

Фільтрація повідомлень за сьогоднішньою датою

Наступний фрагмент коду показує, як фільтрувати всі електронні листи за сьогоднішньою датою.

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

Фільтрація повідомлень за діапазоном дат

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

// Emails that arrived in last 7 days
Calendar cal = Calendar.getInstance();
builder.getInternalDate().before(cal.getTime());
cal.add(Calendar.DATE, -7);
builder.getInternalDate().since(cal.getTime());

Фільтрація повідомлень за конкретним відправником

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

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

Фільтрація повідомлень за конкретним доменом

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

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

Фільтрація повідомлень за конкретним одержувачем

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

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

Фільтрація повідомлень за MessageID

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

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

Фільтрація повідомлень за всіма сповіщеннями про доставку пошти

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

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

Фільтрація повідомлень за розміром

builder = new ExchangeQueryBuilder();
builder.getItemSize().greater(80000);

Фільтрація повідомлень за строковим значенням

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

 ExchangeQueryBuilder builder = new ExchangeQueryBuilder();

builder.getText().equals("SomeText");

MailQuery query = builder.getQuery();

ExchangeMessageInfoCollection messages = ewsClient.listMessages("InboxUri", query, false);

Фільтрація повідомлень у зростаючому/спадному порядку

Aspose.Email надає ComparisonField.orderBy(boolean ascending) метод, який встановлює значення, що вказує, чи клієнт використовує сортування за зростанням або спаданням у полі пошуку. Він дозволяє сортувати повідомлення електронної пошти у порядку зростання/спадання на підставі критеріїв, зазначених MailQueryBuilder.

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

MailQueryBuilder builder = new MailQueryBuilder();
builder.getSubject().contains("Report");
builder.getInternalDate().since(sinceDate);
builder.getSubject().orderBy(true); // sort the subject ascending
builder.getInternalDate().orderBy(false); // sort the date descending  

ExchangeMessageInfoCollection miColl = client.listMessages(client.getMailboxInfo().getInboxUri(), builder.getQuery());

Створення складних запитів

Якщо різні MailQueryBuilder властивості встановлюються окремим виразом, і всі умови збігаються. Наприклад, щоб отримати повідомлення за певним діапазоном дат і з конкретного хоста, напишіть три вирази:

Комбінування запитів за допомогою AND

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

// Emails from specific host, get all emails that arrived before today and all emails that arrived since 7 days ago
builder.getFrom().contains("SpecificHost.com");
Calendar cal = Calendar.getInstance();
builder.getInternalDate().before(cal.getTime());
cal.add(Calendar.DATE, -7);
builder.getInternalDate().since(cal.getTime());

Комбінування запитів за допомогою OR

MailQueryBuilder надає or() метод, який приймає два MailQuery екземпляри як параметри. Він отримує повідомлення, які відповідають будь-якій з двох зазначених умов. Наведений нижче приклад фільтрує повідомлення, у темі яких є слово "test" або відправником є "noreply@host.com". Наступний фрагмент коду показує, як комбінувати запити за допомогою OR.

builder.or(builder.getSubject().contains("test"), builder.getFrom().contains("noreply@host.com"));

Фільтрація електронних листів з урахуванням регістру

Електронні листи можна фільтрувати з урахуванням регістру, вказавши прапорець IgnoreCase у критерії фільтрації, як показано у наведеному фрагменті коду.

// Query building by means of ExchangeQueryBuilder class
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getSubject().contains("Newsletter", true);
builder.getInternalDate().on(new Date());
MailQuery query = builder.getQuery();

Фільтрація повідомлень з підтримкою пагінації

int itemsPerPage = 5;
String sGuid = UUID.randomUUID().toString();
String str1 = sGuid + " - " + "Query 1";
String str2 = sGuid + " - " + "Query 2";

MailQueryBuilder queryBuilder1 = new MailQueryBuilder();
queryBuilder1.getSubject().contains(str1);
MailQuery query1 = queryBuilder1.getQuery();
List<ExchangeMessagePageInfo> pages = new ArrayList<ExchangeMessagePageInfo>();
ExchangeMessagePageInfo pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), query1, itemsPerPage);
pages.add(pageInfo);
int str1Count = pageInfo.getItems().size();
while (!pageInfo.getLastPage()) {
    pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), query1, itemsPerPage, pageInfo.getPageOffset() + 1);
    pages.add(pageInfo);
    str1Count += pageInfo.getItems().size();
}

Java: Керування елементами розмови

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

Aspose.Email для Java може бути використаний для керування елементами розмов на Exchange Server за допомогою EWSClient клас. Цей клас використовує Exchange Web Services, які доступні лише в Exchange Server 2007 і пізніших випусків. У цій статті показано, як знайти, скопіювати, перемістити і видалити елементи розмов на Exchange Server 2010. Потрібен Microsoft Exchange Server 2010 Service Pack 1 для всіх функцій, включених у цей розділ.

Пошук розмов

Щоб отримати інформацію про розмову з конкретної папки на Exchange Server:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.findConversations(), щоб знайти всі елементи розмови у папці.
Відобразіть властивості елементу розмови, такі як ID, тема розмови та статус прапора.

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

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find Conversation Items in the Inbox folder
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());
// Show all conversations
for (ExchangeConversation conversation : conversations) {
    // Display conversation properties like Id and Topic
    System.out.println("Topic: " + conversation.getConversationTopic());
    System.out.println("Flag Status: " + conversation.getFlagStatus());
    System.out.println();
}

Копіювання розмов

Щоб скопіювати розмови з однієї папки в іншу:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.copyConversationItems(), щоб скопіювати елемент розмови з вихідної папки в цільову папку.

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

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find those Conversation Items in the Inbox folder which we want to copy
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());
for (ExchangeConversation conversation : conversations) {
    System.out.println("Topic: " + conversation.getConversationTopic());
    // Copy the conversation item based on some condition
    if (conversation.getConversationTopic().contains("test email")) {
        client.copyConversationItems(conversation.getConversationId(), client.getMailboxInfo().getDeletedItemsUri());
        System.out.println("Copied the conversation item to another folder");
    }
}

Переміщення розмов

Щоб перемістити розмови з однієї папки в іншу:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.moveConversationItems(), щоб перемістити розмову з вихідної папки в цільову папку.

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

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find those Conversation Items in the Inbox folder which we want to move
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());

for (ExchangeConversation conversation : conversations) {
    System.out.println("Topic: " + conversation.getConversationTopic());
    // Move the conversation item based on some condition
    if (conversation.getConversationTopic().contains("test email") == true) {
        client.moveConversationItems(conversation.getConversationId(), client.getMailboxInfo().getDeletedItemsUri());
        System.out.println("Moved the conversation item to another folder");
    }
}

Видалення розмов

Щоб видалити розмови з папки:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.deleteConversationItems(), щоб видалити елемент розмови з вихідної папки.

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

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find those Conversation Items in the Inbox folder which we want to delete
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());
for (ExchangeConversation conversation : conversations) {
    System.out.println("Topic: " + conversation.getConversationTopic());
    // Delete the conversation item based on some condition
    if (conversation.getConversationTopic().contains("test email") == true) {
        client.deleteConversationItems(conversation.getConversationId());
        System.out.println("Deleted the conversation item");
    }
}

Java: Робота з елементами календаря на сервері Exchange

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

Надсилання запитів на зустріч

У цій статті показано, як надіслати запит на зустріч кільком одержувачам, використовуючи Exchange Web Services та Aspose.Email.

Створіть запит на зустріч за допомогою класу Appointment і вкажіть місце, час та учасників.
Створіть екземпляр класу MailMessage і встановіть зустріч, використовуючи метод MailMessage.addAlternateView().
Підключіться до сервера Exchange та надішліть запит на зустріч, використовуючи метод send(MailMessage).

The EWSClient клас можна використовувати для підключення до серверів Exchange з підтримкою Exchange Web Services (EWS). Для цього сервер повинен бути Exchange Server 2007 або новішим. Наступний фрагмент коду показує, як використовувати EWS для надсилання запитів на зустріч.

try {
    // Create instance of IEWSClient class by giving credentials
    IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

    Calendar c = Calendar.getInstance();
    c.add(Calendar.HOUR_OF_DAY, 1);
    Date startTime = c.getTime();
    c.add(Calendar.MINUTE, 90);
    Date endTime = c.getTime();

    // Create the meeting request
    Appointment app = new Appointment("meeting request", startTime, endTime, MailAddress.to_MailAddress("administrator@test.com"),
            MailAddressCollection.to_MailAddressCollection("bob@test.com"));
    app.setSummary("meeting request summary");
    app.setDescription("description");

    c = Calendar.getInstance();
    c.add(Calendar.DATE, 5);
    RecurrencePattern pattern = new DailyRecurrencePattern(c.getTime());
    app.setRecurrence(pattern);

    // Create the message and set the meeting request
    MailMessage msg = new MailMessage();
    msg.setFrom(MailAddress.to_MailAddress("administrator@test.com"));
    msg.setTo(MailAddressCollection.to_MailAddressCollection("bob@test.com"));
    msg.isBodyHtml(true);
    msg.setHtmlBody("<h3>HTML Heading</h3><p>Email Message detail</p>");
    msg.setSubject("meeting request");
    msg.addAlternateView(app.requestApointment(0));

    // send the appointment
    client.send(msg);
    System.out.println("Appointment request sent");
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Робота з елементами календаря за допомогою EWS

Aspose.Email забезпечує можливість додавати, оновлювати та скасовувати зустрічі за допомогою клієнта Exchange Web Service (EWS). IEWSClients createAppointment, updateAppointment, та cancelAppointment методи дозволяють маніпулювати елементами календаря за допомогою EWS. У цій статті наведено детальний приклад роботи з елементами календаря. Наступний приклад коду показує, як:

Створити подію.
Оновити зустріч.
Видалити/скасувати зустріч.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "your.username", "your.Password");
Calendar c = Calendar.getInstance();
c.set(Calendar.MINUTE, 0);
c.set(Calendar.SECOND, 0);
c.set(Calendar.MILLISECOND, 0);
Date startTime = c.getTime();
c.add(Calendar.HOUR_OF_DAY, 1);
Date endTime = c.getTime();
String timeZone = "America/New_York";

Appointment app = new Appointment("Room 112", startTime, endTime, MailAddress.to_MailAddress("organizeraspose-email.test3@domain.com"),
        MailAddressCollection.to_MailAddressCollection("attendee@gmail.com"));
app.setTimeZone(timeZone);
app.setSummary("NETWORKNET-34136" + UUID.randomUUID().toString());
app.setDescription("NETWORKNET-34136 Exchange 2007/EWS: Provide support for Add/Update/Delete calendar items");

String uid = client.createAppointment(app);
Appointment fetchedAppointment1 = client.fetchAppointment(uid);
app.setLocation("Room 115");
app.setSummary("New summary for " + app.getSummary());
app.setDescription("New Description");
client.updateAppointment(app);

Appointment[] appointments1 = client.listAppointments();
System.out.println("Total Appointments: " + appointments1.length);
Appointment fetchedAppointment2 = client.fetchAppointment(uid);
System.out.println("Summary: " + fetchedAppointment2.getSummary());
System.out.println("Location: " + fetchedAppointment2.getLocation());
System.out.println("Description: " + fetchedAppointment2.getDescription());
client.cancelAppointment(app);
Appointment[] appointments2 = client.listAppointments();
System.out.println("Total Appointments: " + appointments2.length);

Повернення повторюваних елементів календаря у вказаному діапазоні дат

Aspose.Email EWSClient підтримує повернення повторюваних елементів календаря у діапазоні, визначеному StartDate і EndDate. AppointmentQueryBuilder.setCalendarView(Date startDate, Date endDate, int maxEntriesReturned) метод, якщо вказано CalendarView, повертає список окремих елементів календаря та випадків повторюваних елементів у діапазоні, визначеному StartDate і EndDate. Параметр maxEntriesReturned описує максимальну кількість результатів (значення <= 0 – усі результати).

ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getAppointment().setCalendarView(startDate, endDate, -1);

Appointment[] appointments = client.listAppointments(builder.getQuery());

Виведення зустрічей з підтримкою пагінації

Метод ListAppointments, який надає IEWSClient API отримує повний список зустрічей з сервера Exchange. Це може зайняти час, якщо на сервері Exchange багато зустрічей. API надає перевантажені методи listAppointments метод, який забезпечує підтримку пагінації операції. Це також можна використовувати у різних комбінаціях з функцією запитів. Доступні такі перевантажені методи для отримання списку зустрічей з підтримкою пагінації з сервера Exchange.

AppointmentCollection IEWSClient.listAppointments(int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(String folderUri, int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(MailQuery query, int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(String folderUri, MailQuery query, int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.listAppointments(String folderUri, int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.listAppointments(MailQuery query, int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.listAppointments(String folderUri, MailQuery query, int itemsPerPage, int itemOffset).

Наступний фрагмент коду показує, як вивести список зустрічей з підтримкою пагінації.

        IEWSClient client = EWSClient.getEWSClient("exchange.domain.com", "username", "password");
        try {
            try {
                Appointment[] appts = client.listAppointments();
                System.out.println(appts.length);

                Calendar c = Calendar.getInstance();
                c.set(Calendar.MINUTE, 0);
                c.set(Calendar.SECOND, 0);
                c.set(Calendar.MILLISECOND, 0);

                int appNumber = 10;
                Map<String, Appointment> appointmentsDict = new HashMap<String, Appointment>();
                for (int i = 0; i < appNumber; i++) {
                    c.set(Calendar.HOUR_OF_DAY, i + 1);
                    Date startTime = c.getTime();
                    c.set(Calendar.HOUR_OF_DAY, i + 2);
                    Date endTime = c.getTime();

                    String timeZone = "America/New_York";
                    Appointment appointment = new Appointment("Room 112", startTime, endTime, MailAddress.to_MailAddress("from@domain.com"),
                            MailAddressCollection.to_MailAddressCollection("to@domain.com"));
                    appointment.setTimeZone(timeZone);
                    appointment.setSummary("NETWORKNET-35157_3 - " + UUID.randomUUID().toString());
                    appointment.setDescription("EMAILNET-35157 Move paging parameters to separate class");
                    String uid = client.createAppointment(appointment);
                    appointmentsDict.put(uid, appointment);
                }
                AppointmentCollection totalAppointmentCol = AppointmentCollection.to_AppointmentCollection(client.listAppointments());

                ///// LISTING APPOINTMENTS WITH PAGING SUPPORT ///////
                int itemsPerPage = 2;
                List<AppointmentPageInfo> pages = new ArrayList<AppointmentPageInfo>();
                AppointmentPageInfo pagedAppointmentCol = client.listAppointmentsByPage(itemsPerPage);
                System.out.println(pagedAppointmentCol.getItems().size());
                pages.add(pagedAppointmentCol);
                while (!pagedAppointmentCol.getLastPage()) {
                    pagedAppointmentCol = client.listAppointmentsByPage(itemsPerPage, pagedAppointmentCol.getPageOffset() + 1);
                    pages.add(pagedAppointmentCol);
                }
                int retrievedItems = 0;
                // foreach to while statements conversion
                for (AppointmentPageInfo folderCol : pages) {
                    retrievedItems += folderCol.getItems().size();
                }
            } finally {
            }
        } finally {
            client.dispose();
        }

Додавання події до вторинної папки Calendar на сервері Exchange

API Aspose.Email дозволяє створити вторинну папку Calendar на сервері Exchange за допомогою IEWSClient. Потім зустрічі можна додавати, оновлювати або скасовувати у вторинному календарі за допомогою createAppointment, updateAppointment і cancelAppointment методи. Нижче у прикладах коду використані наведені API‑методи та властивості, щоб продемонструвати функціональність цієї можливості. Зауважте, що ця можливість підтримується Aspose.Email for Java, починаючи з версії 6.5.0.

Метод IEWSClient.cancelAppointment(Appointment, String).
Метод IEWSClient.cancelAppointment(String, String).
Метод IEWSClient.createAppointment(Appointment, String).
Метод IEWSClient.createFolder(String, String, ExchangeFolderPermissionCollection, String).
Метод IEWSClient.fetchAppointment(String, String).
Метод IEWSClient.updateAppointment(Appointment, String).
Властивість IEWSClient.CurrentCalendarFolderUri.

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "your.username", "your.Password");
try {
    try {
        // Create an appointmenta that will be added to secondary calendar folder

        Calendar c = Calendar.getInstance();
        c.set(Calendar.MINUTE, 0);
        c.set(Calendar.SECOND, 0);
        c.set(Calendar.MILLISECOND, 0);
        Date startTime = c.getTime();
        c.add(Calendar.HOUR_OF_DAY, 1);
        Date endTime = c.getTime();

        String timeZone = "America/New_York";

        Appointment[] listAppointments;
        Appointment appointment = new Appointment("Room 121", startTime, endTime, MailAddress.to_MailAddress("from@domain.com"),
                MailAddressCollection.to_MailAddressCollection("attendee@domain.com"));
        appointment.setTimeZone(timeZone);
        appointment.setSummary("EMAILNET-35198 - " + UUID.randomUUID().toString());
        appointment.setDescription("EMAILNET-35198 Ability to add event to Secondary Calendar of Office 365");

        // Verify that the new folder has been created
        ExchangeFolderInfoCollection calendarSubFolders = client.listSubFolders(client.getMailboxInfo().getCalendarUri());

        String getfolderName;
        String setFolderName = "New Calendar";
        boolean alreadyExits = false;

        // Verify that the new folder has been created already exits or not

        for (int i = 0; i < calendarSubFolders.size(); i++) {
            getfolderName = calendarSubFolders.get_Item(i).getDisplayName();

            if (getfolderName.equals(setFolderName)) {
                alreadyExits = true;
            }
        }

        if (alreadyExits) {
            System.out.println("Folder Already Exists");
        } else {
            // Create new calendar folder
            client.createFolder(client.getMailboxInfo().getCalendarUri(), setFolderName, null, "IPF.Appointment");

            System.out.println(calendarSubFolders.size());

            // Get the created folder URI
            String newCalendarFolderUri = calendarSubFolders.get_Item(0).getUri();

            // appointment api with calendar folder uri
            // Create
            client.createAppointment(appointment, newCalendarFolderUri);
            appointment.setLocation("Room 122");
            // update
            client.updateAppointment(appointment, newCalendarFolderUri);
            // list
            listAppointments = client.listAppointments(newCalendarFolderUri);

            // list default calendar folder
            listAppointments = client.listAppointments(client.getMailboxInfo().getCalendarUri());

            // Cancel
            client.cancelAppointment(appointment, newCalendarFolderUri);
            listAppointments = client.listAppointments(newCalendarFolderUri);

            // appointment api with context current calendar folder uri
            client.setCurrentCalendarFolderUri(newCalendarFolderUri);
            // Create
            client.createAppointment(appointment);
            appointment.setLocation("Room 122");
            // update
            client.updateAppointment(appointment);
            // list
            listAppointments = client.listAppointments();

            // list default calendar folder
            listAppointments = client.listAppointments(client.getMailboxInfo().getCalendarUri());

            // Cancel
            client.cancelAppointment(appointment);
            listAppointments = client.listAppointments();

        }
    } finally {
    }
} finally {
    client.dispose();
}

Запрошення до спільного календаря

Сервер Microsoft Exchange надає можливість ділитися календарями, надсилаючи запрошення іншим користувачам, зареєстрованим на тому ж сервері Exchange. API Aspose.Email забезпечує таку ж можливість, дозволяючи ділитися календарем за допомогою API EWS.

final IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
try {
    // delegate calendar access permission
    ExchangeDelegateUser delegateUser = new ExchangeDelegateUser("sharingfrom@domain.com", ExchangeDelegateFolderPermissionLevel.NotSpecified);
    delegateUser.getFolderPermissions().setCalendarFolderPermissionLevel(ExchangeDelegateFolderPermissionLevel.Reviewer);
    client.delegateAccess(delegateUser, "sharingfrom@domain.com");

    // Create invitation
    MapiMessage mapiMessage = client.createCalendarSharingInvitationMessage("sharingfrom@domain.com");
    MailConversionOptions options = new MailConversionOptions();
    options.setConvertAsTnef(true);
    MailMessage mail = mapiMessage.toMailMessage(options);
    client.send(mail);
} finally {
    client.dispose();
}

Отримання інформації про розширені атрибути елементів календаря

IEWSClient client = EWSClient.getEWSClient("https://exchange.office365.com/Exchange.asmx", "username", "password");

java.util.List<String> uriList = java.util.Arrays.asList(client.listItems(client.getMailboxInfo().getCalendarUri()));

// Define the Extended Attribute Property Descriptor for searching purpose
// In this case, we have a K1 Long named property for Calendar item
UUID uuid = UUID.fromString("00020329-0000-0000-C000-000000000046");
PropertyDescriptor propertyDescriptor = new PidNamePropertyDescriptor("K1", PropertyDataType.Integer32, uuid);

java.util.List<PropertyDescriptor> propertyDescriptors = java.util.Arrays.asList(new PropertyDescriptor[] { propertyDescriptor });
IGenericList<MapiCalendar> mapiCalendarList = client.fetchMapiCalendar(uriList, propertyDescriptors);

for (MapiCalendar cal : mapiCalendarList) {
    for (MapiNamedProperty namedProperty : (Iterable<MapiNamedProperty>) cal.getNamedProperties().getValues()) {
        System.out.println(namedProperty.getNameId() + " = " + namedProperty.getInt32());
    }
}

Java: Робота з контактами на Exchange Server

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

Облікові записи Exchange Server містять не лише електронні листи. А також отримання, переміщення, надсилання і видалення електронних листів з серверів Exchange, Aspose.Email дозволяє працювати з контактами. У цій статті пояснюється, як отримати інформацію про контакти за допомогою Exchange Web Services. У статті також показано, як перелічити контакти з папки Contacts або визначити контакти за іменем контакту.

Отримання контактів за допомогою EWS

Aspose.Email надає EWSClient клас для підключення до Microsoft Exchange Server за допомогою Exchange Web Services. Наведені нижче фрагменти коду використовують Exchange Web Services для читання усіх контактів. У наведеному фрагменті коду показано, як отримати контакти за допомогою EWS.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

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

Визначення контактів за ім’ям контакту

У наведеному фрагменті коду показано, як отримати контакти за допомогою EWS

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// List all the contacts
Contact[] contacts = client.resolveContacts("Changed Name", ExchangeListContactsOptions.FetchPhoto);
for (Contact c : contacts) {
    MapiContact contact = Contact.to_MapiContact(c);
    // Display name and email address
    System.out.println("Name: " + contact.getNameInfo().getDisplayName() + "+ Email Address: " + contact.getElectronicAddresses().getEmail1());
}

Визначення формату нотаток контакту

NotesFormat вказує тип формату тексту нотаток контактів, визначений перелічувачем TextFormat.

Отримати контакт за ідентифікатором

Конкретний контакт можна отримати з сервера за його ідентифікатором, як показано у наведеному прикладі коду.

Contact fetchedContact = client.getContact(id);

Додавання контактів

The EWSClient клас createContact() метод можна використовувати для додавання інформації про контакт до Exchange Server. createContact() метод приймає Contact об’єкт як вхідний параметр.

Щоб додати контакти до Exchange Server:

Ініціалізуйте EWSClient з адресою та обліковими даними.
Ініціалізуйте об’єкт Contact з потрібними властивостями.
Викличте метод CreateContact, щоб додати контакт до Exchange Server.

Aspose.Email надає EWSClient клас для підключення до Microsoft Exchange Server за допомогою Exchange Web Services. У фрагменті коду показано, як використовувати Exchange Web Services для додавання контактів до Exchange Server.

// Set mailboxURI, Username, password, domain information
String mailboxUri = "https://ex2010/ews/exchange.asmx";
String username = "test.exchange";
String password = "pwd";
String domain = "ex2010.local";
NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// Create New Contact
Contact contact = new Contact();

// Set general info
contact.setGender(Gender.Male);
contact.setDisplayName("Frank Lin");
contact.setCompanyName("ABC Co.");
contact.setJobTitle("Executive Manager");
PhoneNumber tmp0 = new PhoneNumber();
tmp0.setNumber("123456789");
tmp0.setCategory(PhoneNumberCategory.getHome());

// Add Phone numbers
contact.getPhoneNumbers().add(tmp0);
AssociatedPerson tmp1 = new AssociatedPerson();
tmp1.setName("Catherine");
tmp1.setCategory(AssociatedPersonCategory.getSpouse());

// contact's associated persons
contact.getAssociatedPersons().add(tmp1);
AssociatedPerson tmp2 = new AssociatedPerson();
tmp2.setName("Bob");
tmp2.setCategory(AssociatedPersonCategory.getChild());
contact.getAssociatedPersons().add(tmp2);
AssociatedPerson tmp3 = new AssociatedPerson();
tmp3.setName("Merry");
tmp3.setCategory(AssociatedPersonCategory.getSister());
contact.getAssociatedPersons().add(tmp3);
Url tmp4 = new Url();
tmp4.setHref("www.blog.com");
tmp4.setCategory(UrlCategory.getBlog());

// URLs
contact.getUrls().add(tmp4);
Url tmp5 = new Url();
tmp5.setHref("www.homepage.com");
tmp5.setCategory(UrlCategory.getHomePage());
contact.getUrls().add(tmp5);
EmailAddress tmp6 = new EmailAddress();
tmp6.setAddress("Frank.Lin@Abc.com");
tmp6.setDisplayName("Frank Lin");
tmp6.setCategory(EmailAddressCategory.getEmail1());

// Set contact's Email address
contact.getEmailAddresses().add(tmp6);

try {
    client.createContact(contact);
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Оновлення контактів

Інформацію про контакт можна оновити за допомогою Microsoft Outlook. Aspose.Email також може оновлювати інформацію про контакти на Exchange Server за допомогою Exchange Web Service (EWS). IEWSClient’s updateContact() метод може оновлювати інформацію про контакти на Exchange Server.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// List all the contacts and Loop through all contacts
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
Contact contact = contacts[0];
System.out.println("Name: " + contact.getDisplayName());
contact.setDisplayName("David Ch");
client.updateContact(contact);

Видалення контактів

The EWSClient class надає deleteItem для доступу та видалення контактів з папки contacts на Exchange Server. Цей метод приймає ідентифікатор контакту як вхідний параметр.

Щоб видалити контакти з Exchange Server:

Ініціалізуйте ExchangeWebServiceClient з адресою та обліковими даними.
Видалити контакт за його ідентифікатором.

У наведених фрагментах коду показано, як видаляти контакти з сервера Exchange за допомогою Exchange Web Service.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

String strContactToDelete = "John Teddy";
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
for (Contact contact : contacts) {
    if (contact.getDisplayName().equals(strContactToDelete))
        client.deleteItem(contact.getId().getEWSId(), DeletionOptions.getDeletePermanently());

}
client.dispose();

Java: Робота зі списками розсилки на Exchange Server

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

Робота зі списками розсилки

Aspose.Email API надає можливість створювати та читати списки розсилки з сервера Exchange. Списки розсилки можна створювати на сервері, а також додавати до них учасників за допомогою IEWSClient. У цій статті показано, як працювати зі списками розсилки на сервері Exchange.

Створення списку розсилки

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setDisplayName("test private list");
MailAddressCollection members = new MailAddressCollection();
members.add("address1@host.com");
members.add("address2@host.com");
members.add("address3@host.com");
client.createDistributionList(distributionList, members);

Отримати приватний список розсилки

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
for (ExchangeDistributionList distributionList : distributionLists) {
    MailAddressCollection members = client.fetchDistributionList(distributionList);
    for (MailAddress member : (Iterable<MailAddress>) members) {
        System.out.println(member.getAddress());
    }
}

Розширити публічний список розсилки

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

MailAddressCollection members = client.expandDistributionList(new MailAddress("public.distribution.list@host.com"));
for (MailAddress member : (Iterable<MailAddress>) members) {
    System.out.println(member.getAddress());
}

Додавання учасників

Додавання учасників до приватного списку розсилки

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
MailAddressCollection newMembers = new MailAddressCollection();
newMembers.add("address4@host.com");
newMembers.add("address5@host.com");
client.addToDistributionList(distributionLists[0], newMembers);

Додати учасників без створення списку

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setId("list's id");
distributionList.setChangeKey("list's change key");
MailAddressCollection newMembers = new MailAddressCollection();
newMembers.add("address6@host.com");
client.addToDistributionList(distributionList, newMembers);

Надіслати до приватного списку розсилки

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

ExchangeDistributionList[] distributionLists = client.listDistributionLists();
MailAddress distributionListAddress = distributionLists[0].toMailAddress();
MailMessage message = new MailMessage(new MailAddress("from@host.com"), distributionListAddress);
message.setSubject("sendToPrivateDistributionList");
client.send(message);

Видалення учасників

Видалення учасників з приватного списку розсилки

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
MailAddressCollection members = client.fetchDistributionList(distributionLists[0]);
MailAddressCollection membersToDelete = new MailAddressCollection();
membersToDelete.addMailAddress(members.get_Item(0));
membersToDelete.addMailAddress(members.get_Item(1));
client.deleteFromDistributionList(distributionLists[0], membersToDelete);

Видалити учасників без створення списку

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setId("list's id");
distributionList.setChangeKey("list's change key");
MailAddressCollection membersToDelete = new MailAddressCollection();
MailAddress addressToDelete = new MailAddress("address", true);
// addressToDelete.Id.EWSId = "member's id";
membersToDelete.addMailAddress(addressToDelete);
client.addToDistributionList(distributionList, membersToDelete);

Видалити приватний список розсилки

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
client.deleteDistributionList(distributionLists[0], true);

Видалити без списку

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

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setId("list's id");
client.deleteDistributionList(distributionList, true);

Java: Робота з папками на Exchange Server

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

Перелік усіх папок із сервера

Aspose.Email API забезпечує можливість підключення до Exchange Server та перелічення усіх папок і підпапок. Ви також можете рекурсивно отримати всі підпапки кожної папки. Також передбачена можливість перебору папок з посторінковим відображенням із клієнта Exchange за допомогою Exchange Web Service (EWS). У цій статті показано, як отримати всі підпапки з сервера Exchange та отримати папки з пагінацією.

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() {
    try {
        IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "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 : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listSubFolders(client, folderInfo);
        }

        System.out.println("All messages downloaded.");
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void listSubFolders(IEWSClient client, ExchangeFolderInfo folderInfo) {
    // Create the folder in disk (same name as on IMAP server)
    System.out.println(folderInfo.getDisplayName());
    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(folderInfo.getUri());
        for (ExchangeFolderInfo subfolderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            listSubFolders(client, subfolderInfo);
        }
    } catch (java.lang.RuntimeException e) {
    }
}

Отримання інформації про тип папки за допомогою EWS

The FolderType властивість, надана ExchangeFolderInfo клас можна використовувати для отримання інформації про тип папки. Це показано у наведеному нижче прикладі коду.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

ExchangeFolderInfoCollection folderInfoCol = client.listSubFolders(client.getMailboxInfo().getRootUri());
for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCol) {
    switch (folderInfo.getFolderType()) {
    case ExchangeFolderType.Appointment:
        // handle Appointment
        break;
    case ExchangeFolderType.Contact:
        // handle Contact
        break;
    case ExchangeFolderType.Task:
        // handle Task
        break;
    case ExchangeFolderType.Note:
        // handle email message
        break;
    case ExchangeFolderType.StickyNote:
        // handle StickyNote
        break;
    case ExchangeFolderType.Journal:
        // handle Journal
        break;
    default:
        break;
    }
}

Перерахунок папок з підтримкою посторінкового відображення за допомогою EWS

Наступний фрагмент коду показує, як використовувати підтримку посторінкового відображення за допомогою EWS.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "UserName", "Password");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());
int itemsPerPage = 5;
List<PageInfo> pages = new ArrayList<PageInfo>();
PageInfo pagedMessageInfoCol = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
pages.add(pagedMessageInfoCol);
while (!pagedMessageInfoCol.getLastPage()) {
    pagedMessageInfoCol = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
    pages.add(pagedMessageInfoCol);
}
pagedMessageInfoCol = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
while (!pagedMessageInfoCol.getLastPage()) {
    client.listMessages(client.getMailboxInfo().getInboxUri());
}

Доступ до користувацьких папок або підпапок поштової скриньки

IEWSClient дозволяє розробникам отримати доступ до будь‑якої користувацької папки або підпапки поштової скриньки. folderExists() функція IEWSClient повертає URI вказаної користувацької папки/підпапки, який потім може бути використаний для доступу до цільової папки. У наступному прикладі доступ до користувацької папки з назвою "TestInbox", створеної під INBOX, і відображаються всі повідомлення з цієї папки. Щоб виконати це завдання, виконайте наступні кроки:

Ініціалізуйте об’єкт IEWSClient, надавши дійсні облікові дані.
Отримайте доступ до поштової скриньки за замовчуванням.
Отримайте доступ до батьківської папки, яка в цьому прикладі є INBOX. Ця батьківська папка також може бути користувацькою папкою.
Використайте folderExists(), щоб шукати вказану користувацьку підпапку, наприклад "TestInbox". Він поверне URI "TestInbox".
Використайте цей URI, щоб отримати доступ до всіх повідомлень у цій користувацькій папці.

Наступний фрагмент коду показує, як отримати доступ до користувацьких папок або підпапок поштової скриньки за допомогою EWS.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create ExchangeMailboxInfo, ExchangeMessageInfoCollection instance
ExchangeMailboxInfo mailbox = client.getMailboxInfo();
ExchangeMessageInfoCollection messages = null;
ExchangeFolderInfo subfolderInfo = new ExchangeFolderInfo();

// Check if specified custom folder exisits and Get all the messages info from the target Uri
ExchangeFolderInfo[] referenceToSubfolderInfo = { subfolderInfo };
client.folderExists(mailbox.getInboxUri(), "TestInbox", /* out */ referenceToSubfolderInfo);
subfolderInfo = referenceToSubfolderInfo[0];

// if custom folder exists
if (subfolderInfo != null) {
    messages = client.listMessages(subfolderInfo.getUri());

    // Parse all the messages info collection
    for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) messages) {
        String strMessageURI = info.getUniqueUri();
        // now get the message details using FetchMessage()
        MailMessage msg = client.fetchMessage(strMessageURI);
        System.out.println("Subject: " + msg.getSubject());
    }
} else {
    System.out.println("No folder with this name found.");
}

Перелік публічних папок

Microsoft Exchange Server дозволяє користувачам створювати публічні папки та розміщувати в них повідомлення. Щоб зробити це через ваш додаток, використовуйте Aspose.Email EWSClient клас для підключення до Exchange Server та читання і завантаження повідомлень і дописів з публічних папок. Наступний фрагмент коду показує, як читати всі публічні папки та підпапки, а також перераховувати та завантажувати будь-які повідомлення, знайдені в цих папках. Цей приклад працює лише з Microsoft Exchange Server 2007 і вище, оскільки тільки вони підтримують EWS.

public static void run() {
    try {
        readPublicFolders();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void readPublicFolders() {
    NetworkCredential credential = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

    ExchangeFolderInfoCollection folders = client.listPublicFolders();
    for (ExchangeFolderInfo publicFolder : (Iterable<ExchangeFolderInfo>) folders) {
        System.out.println("Name: " + publicFolder.getDisplayName());
        System.out.println("Subfolders count: " + publicFolder.getChildFolderCount());
        listMessagesFromSubFolder(publicFolder, client);

    }
}

private static void listMessagesFromSubFolder(ExchangeFolderInfo publicFolder, IEWSClient client) {
    System.out.println("Folder Name: " + publicFolder.getDisplayName());
    ExchangeMessageInfoCollection msgInfoCollection = client.listMessagesFromPublicFolder(publicFolder);
    for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) msgInfoCollection) {
        MailMessage msg = client.fetchMessage(messageInfo.getUniqueUri());
        System.out.println(msg.getSubject());
        msg.save(dataDir + msg.getSubject() + ".msg", SaveOptions.getDefaultMsgUnicode());
    }

    // Call this method recursively for any subfolders
    if (publicFolder.getChildFolderCount() > 0) {
        ExchangeFolderInfoCollection subfolders = client.listSubFolders(publicFolder);
        for (ExchangeFolderInfo subfolder : (Iterable<ExchangeFolderInfo>) subfolders) {
            listMessagesFromSubFolder(subfolder, client);
        }
    }
}

Копіювання повідомлення в іншу папку

Aspose.Email API дозволяє копіювати повідомлення з однієї папки в іншу, використовуючи copyItem метод. Перевантажена версія цього методу повертає унікальний URI скопійованого повідомлення, як показано в цій статті.

try {
    // Create instance of EWSClient class by giving credentials
    IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
    MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-34997 - " + UUID.randomUUID().toString(),
            "EMAILNET-34997 Exchange: Copy a message and get reference to the new Copy item");
    String messageUri = client.appendMessage(message);
    String newMessageUri = client.copyItem(messageUri, client.getMailboxInfo().getDeletedItemsUri());
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Синхронізація елементів папки

Aspose.Email для Java API IEWSClient надає можливість синхронізації вмісту папки Exchange. syncFolder метод, представлений IEWSClient клас можна використовувати для виконання синхронізації інформації про папку за вказаною папкою. Наступний фрагмент коду показує, як синхронізувати інформацію про папку Exchange.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
MailMessage message1 = new MailMessage("user@domain.com", "user@domain.com", "EMAILNET-34738 - " + UUID.randomUUID().toString(), "EMAILNET-34738 Sync Folder Items");
client.send(message1);

MailMessage message2 = new MailMessage("user@domain.com", "user@domain.com", "EMAILNET-34738 - " + UUID.randomUUID().toString(), "EMAILNET-34738 Sync Folder Items");
client.send(message2);

ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
SyncFolderResult result = client.syncFolder(client.getMailboxInfo().getInboxUri(), null);
System.out.println(result.getNewItems().size());
System.out.println(result.getChangedItems().size());
System.out.println(result.getReadFlagChanged().size());
System.out.println(result.getDeletedItems().length);

Отримання дозволів для папок Exchange

Користувачам призначаються дозволи до публічних папок на Exchange Server, що обмежує/визначає рівень доступу користувача до цих папок. Це ExchangeFolderPermission клас надає набір властивостей дозволу для папок Exchange, таких як PermissionLevel, чи можуть вони canCreateItems, deleteItems, і виконувати інші завдання, зазначені у властивостях дозволу. Дозволи можна отримати за допомогою getFolderPermissions() метод IEWSClient. У цій статті показано, як отримати дозволи, застосовані до публічної папки, для всіх користувачів, які мають доступ до спільних папок.

Щоб виконати це завдання:

Ініціалізуйте EWSClient.
Використайте listPublicFolders, щоб отримати список усіх публічних папок
Отримайте дозволи, пов’язані з папкою, використовуючи метод getFolderPermissions()

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

String folderName = "DesiredFolderName";

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeFolderInfoCollection folders = client.listPublicFolders();
ExchangeFolderPermissionCollection permissions = new ExchangeFolderPermissionCollection();

ExchangeFolderInfo publicFolder = null;
try {
    for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folders)
        if (folderInfo.getDisplayName().equals(folderName))
            publicFolder = folderInfo;

    if (publicFolder == null)
        System.out.println("public folder was not created in the root public folder");

    ExchangePermissionCollection folderPermissionCol = client.getFolderPermissions(publicFolder.getUri());
    for (ExchangeBasePermission perm : (Iterable<ExchangeBasePermission>) folderPermissionCol) {
        if (perm instanceof ExchangeFolderPermission)
            System.out.println("Permission is null.");
        else {
            ExchangeFolderPermission permission = (ExchangeFolderPermission) perm;

            System.out.println("User's primary smtp address: " + permission.getUserInfo().getPrimarySmtpAddress());
            System.out.println("User can create Items: " + permission.canCreateItems());
            System.out.println("User can delete Items: " + permission.getDeleteItems());
            System.out.println("Is Folder Visible: " + permission.isFolderVisible());
            System.out.println("Is User owner of this folder: " + permission.isFolderOwner());
            System.out.println("User can read items: " + permission.getReadItems());
        }
    }
    ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
    // Get the Permissions for the Contacts and Calendar Folder
    ExchangePermissionCollection contactsPermissionCol = client.getFolderPermissions(mailboxInfo.getContactsUri());
    ExchangePermissionCollection calendarPermissionCol = client.getFolderPermissions(mailboxInfo.getCalendarUri());
} finally {
    // Do the needfull
}

Створення папок і підпапок

Aspose.Email API надає можливість створювати папки в поштовій скриньці Exchange. CreateFolder метод IEWSClient можна використовувати для цього. Щоб створити папку в поштовій скриньці сервера Exchange, можна виконати такі кроки.

Створіть екземпляр IEWSClient.
Встановіть властивість UseSlashAsFolderSeparator за потребою. Якщо встановити в true, застосунок буде вважати «слеш» роздільником папок, і підпапка буде створена після слеша.
Використайте метод createFolder для створення папки.

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

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

String inbox = client.getMailboxInfo().getInboxUri();
String folderName1 = "EMAILNET-35054";
String subFolderName0 = "2015";
String folderName2 = folderName1 + "/" + subFolderName0;
String folderName3 = folderName1 + " / 2015";
ExchangeFolderInfo rootFolderInfo = null;
ExchangeFolderInfo folderInfo = null;

try {
    client.setUseSlashAsFolderSeparator(true);
    client.createFolder(client.getMailboxInfo().getInboxUri(), folderName1);
    client.createFolder(client.getMailboxInfo().getInboxUri(), folderName2);
} finally {
    ExchangeFolderInfo[] referenceToRootFolderInfo = { rootFolderInfo };
    boolean outRefCondition0 = client.folderExists(inbox, folderName1, /* out */ referenceToRootFolderInfo);
    rootFolderInfo = referenceToRootFolderInfo[0];
    if (outRefCondition0) {
        ExchangeFolderInfo[] referenceToFolderInfo = { folderInfo };
        boolean outRefCondition1 = client.folderExists(inbox, folderName2, /* out */ referenceToFolderInfo);
        folderInfo = referenceToFolderInfo[0];
        if (outRefCondition1)
            client.deleteFolder(folderInfo.getUri(), true);
        client.deleteFolder(rootFolderInfo.getUri(), true);
    }
}

Резервне копіювання папок Exchange у PST

Часто трапляється, що користувачі хочуть зробити резервну копію всіх або деяких папок поштової скриньки. Aspose.Email надає можливість створювати резервну копію всіх або вказаних папок Exchange у PST. У цій статті описано, як робити резервні копії папок Exchange у PST за допомогою прикладу коду. Щоб створити резервну копію папок сервера Exchange, можна виконати такі кроки.

Ініціюйте IEWSClient з обліковими даними користувача
Додайте необхідну інформацію про папку до ExchangeFolderInfoCollection
Використайте метод резервного копіювання клієнта для експорту вмісту папки у PST

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

String dataDir = "data/";
// Create instance of IEWSClient class by providing credentials
final String mailboxUri = "https://ews.domain.com/ews/Exchange.asmx";
final String domain = "";
final String username = "username";
final String password = "password";
NetworkCredential credential = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

// Get Exchange mailbox info of other email account
ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
ExchangeFolderInfo info = client.getFolderInfo(mailboxInfo.getInboxUri());
ExchangeFolderInfoCollection fc = new ExchangeFolderInfoCollection();
fc.addItem(info);
client.backup(fc, dataDir + "Backup_out.pst", BackupOptions.None);

Java: Робота з правилами на Exchange Server

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

Керування правилами

Aspose.Email for Java можна використовувати для керування правилами на Exchange Server за допомогою EWSClient клас. Цей клас використовує Exchange Web Services (EWS), які доступні в Exchange Server 2007 та пізніших випусках. Щоб продемонструвати, як керувати правилами, ця стаття пояснює, як:

Прочитати правила, які вже є на сервері.
Створити нове правило.
Оновити існуюче правило.

Microsoft Exchange Server 2010 Service Pack 1 потрібен для всіх функцій, описаних у цій статті.

Читання правил

Щоб отримати всі правила з Exchange Server:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.getInboxRules() для отримання всіх правил.
У циклі foreach перегляньте всі правила і відобразіть їх властивості, такі як умови, дії та назва.

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

IEWSClient client = EWSClient.getEWSClient(mailboxURI, credential);

System.out.println("Connected to Exchange server");

// Get all Inbox Rules
InboxRule[] inboxRules = client.getInboxRules();

// Display information about each rule
for (InboxRule inboxRule : inboxRules) {
    System.out.println("Display Name: " + inboxRule.getDisplayName());

    // Check if there is a "From Address" condition
    if (inboxRule.getConditions().getFromAddresses().size() > 0) {
        for (MailAddress fromAddress : (Iterable<MailAddress>) inboxRule.getConditions().getFromAddresses()) {
            System.out.println("From: " + fromAddress.getDisplayName() + " - " + fromAddress.getAddress());
        }
    }
    // Check if there is a "Subject Contains" condition
    if (inboxRule.getConditions().containsSubjectStrings().size() > 0) {
        // foreach to while statements conversion
        for (String subject : inboxRule.getConditions().containsSubjectStrings()) {
            System.out.println("Subject contains: " + subject);
        }
    }
    // Check if there is a "Move to Folder" action
    if (inboxRule.getActions().getMoveToFolder().length() > 0) {
        System.out.println("Move message to folder: " + inboxRule.getActions().getMoveToFolder());
    }
}

Створення нового правила

Щоб створити нове правило на Exchange Server, виконайте наступні кроки:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Створіть новий екземпляр класу InboxRule і встановіть наступні обов’язкові властивості:
1. НазваВідображення
2. Умови
3. Дії
Викличте метод IEWSClient.createInboxRule() для створення правила.

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

IEWSClient client = EWSClient.getEWSClient(mailboxURI, credential);

System.out.println("Connected to Exchange server");

InboxRule rule = new InboxRule();
rule.setDisplayName("Message from client ABC");

// Add conditions
RulePredicates newRules = new RulePredicates();
// Set Subject contains string "ABC" and Add the conditions
newRules.containsSubjectStrings().addItem("ABC");
newRules.getFromAddresses().addMailAddress(new MailAddress("administrator@ex2010.local", true));
rule.setConditions(newRules);

// Add Actions and Move the message to a folder
RuleActions newActions = new RuleActions();
newActions.setMoveToFolder("120:AAMkADFjMjNjMmNjLWE3NzgtNGIzNC05OGIyLTAwNTgzNjRhN2EzNgAuAAAAAABbwP+Tkhs0TKx1GMf0D/cPAQD2lptUqri0QqRtJVHwOKJDAAACL5KNAAA=AQAAAA==");
rule.setActions(newActions);
client.createInboxRule(rule);

Оновлення правила

Щоб оновити правило на Exchange Server:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.getInboxRules() для отримання всіх правил.
У циклі foreach перегляньте всі правила і отримайте правило, яке потрібно змінити, підбираючи DisplayName у умові.
Оновити властивості правила
Викличте метод IEWSClient.updateInboxRule() для оновлення правила.

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

IEWSClient client = EWSClient.getEWSClient(mailboxURI, credential);

System.out.println("Connected to Exchange server");

// Get all Inbox Rules
InboxRule[] inboxRules = client.getInboxRules();

// Loop through each rule
for (InboxRule inboxRule : inboxRules) {
    System.out.println("Display Name: " + inboxRule.getDisplayName());
    if ("Message from client ABC".equals(inboxRule.getDisplayName())) {
        System.out.println("Updating the rule....");
        inboxRule.getConditions().getFromAddresses().set_Item(0, new MailAddress("administrator@ex2010.local", true));
        client.updateInboxRule(inboxRule);
    }
}

Java: Робота з задачами на сервері Exchange

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

Робота з завданнями

Aspose.Email підтримує обробку завдань на Exchange за допомогою ExchangeTask клас. Різні властивості, що надаються ExchangeTask, наприклад Subject, Статус, Термін, та Пріоритет, можна використати для налаштування задачі на Exchange. The EWSClient клас відкриває функції, такі як createTask, updateTask, та deleteTask які використовуються для обробки задач на Exchange. У цій статті показано, як:

Створити нову задачу.
Встановити часовий пояс задачі.
Оновити задачу.
Видалити задачу.
Надіслати запит на задачу
Зберегти задачу на диск

Створити нову задачу

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

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create Exchange task object
ExchangeTask task = new ExchangeTask();

// Set task subject and status to In progress
task.setSubject("New-Test");
task.setStatus(ExchangeTaskStatus.InProgress);
client.createTask(client.getMailboxInfo().getTasksUri(), task);

Вказання часового поясу

The IEWSClient інтерфейс і ExchangeTask надають властивість TimeZoneId для встановлення інформації про часовий пояс під час створення задачі. Наступний фрагмент коду показує, як вказати часовий пояс.

client.setTimezoneId("Central Europe Standard Time");

Оновити задачу

Наступні фрагменти коду показують, як оновити задачу на сервері Exchange.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get all tasks info collection from exchange
ExchangeMessageInfoCollection tasks = client.listMessages(client.getMailboxInfo().getTasksUri());

// Parse all the tasks info in the list
for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) tasks) {
    // Fetch task from exchange using current task info
    ExchangeTask task = client.fetchTask(info.getUniqueUri());

    // Update the task status to NotStarted
    task.setStatus(ExchangeTaskStatus.NotStarted);

    // Set the task due date
    SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");
    task.setDueDate(sdf.parse("26/02/2013 00:00:00"));

    // Set task priority
    task.setPriority(MailPriority.Low.getValue());

    // Update task on exchange
    client.updateTask(task);
}

Видалити задачу

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

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get all tasks info collection from exchange
ExchangeMessageInfoCollection tasks = client.listMessages(client.getMailboxInfo().getTasksUri());

// Parse all the tasks info in the list
for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) tasks) {
    // Fetch task from exchange using current task info
    ExchangeTask task = client.fetchTask(info.getUniqueUri());

    // Check if the current task fulfills the search criteria
    if (task.getSubject().equals("test")) {
        // Delete task from exchange
        client.deleteItem(task.getUniqueUri(), DeletionOptions.getDeletePermanently());
    }
}

Надсилання запиту на задачу

Сервіс Aspose.Email Exchange забезпечує можливість надсилати запити на задачу, подібно до Outlook. Наступний фрагмент коду показує, як завантажити повідомлення запиту на задачу з диска та надіслати його за допомогою IEWSClient.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

MsgLoadOptions options = new MsgLoadOptions();
options.setPreserveTnefAttachments(true);

// load task from .msg file
MailMessage eml = MailMessage.load(dataDir + "task.msg", options);
eml.setFrom(MailAddress.to_MailAddress("firstname.lastname@domain.com"));
eml.getTo().clear();
eml.getTo().addMailAddress(new MailAddress("firstname.lastname@domain.com"));
client.send(eml);

Збереження задачі на диск

Aspose.Email також дозволяє зберігати задачі Exchange на диск у форматі Outlook MSG. Наступний фрагмент коду показує, як зберегти задачу на диск.

ExchangeTask task = new ExchangeTask();
task.setSubject("TASK-ID - " + UUID.randomUUID());
task.setStatus(ExchangeTaskStatus.InProgress);

Calendar cal = Calendar.getInstance();
task.setStartDate(cal.getTime());
cal.add(Calendar.DATE, 3);
task.setDueDate(cal.getTime());
task.save(dstEmail);

Виведення задач з сервера Exchange

IEWSClient надає listTasks метод, який можна використовувати для отримання задач з Exchange Web Service. Він має кілька перевантажень, що дозволяють отримати список задач з певної папки або за певними критеріями пошуку. Нижче наведено приклад коду, що ілюструє отримання всіх або конкретних задач з папки Tasks.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// Listing Tasks from Server
client.setTimezoneId("Central Europe Standard Time");
TaskCollection taskCollection = client.listTasks(client.getMailboxInfo().getTasksUri());

// print retrieved tasks' details
int iTasksCount = taskCollection.size();
for (int i = 0; i < iTasksCount; i++) {
    ExchangeTask task = (ExchangeTask) taskCollection.get_Item(i);
    System.out.println(task.getSubject());
    System.out.println(task.getStartDate());
    System.out.println(task.getDueDate());
}

// Listing Tasks from server based on Query - Completed and In-Progress
Integer[] selectedStatuses = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.InProgress };
ExchangeQueryBuilder queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().in(Arrays.asList(selectedStatuses));
MailQuery query = queryBuilder.getQuery();

taskCollection = client.listTasks(client.getMailboxInfo().getTasksUri(), query);

// print retrieved tasks' details
iTasksCount = taskCollection.size();
for (int i = 0; i < iTasksCount; i++) {
    ExchangeTask task = (ExchangeTask) taskCollection.get_Item(i);
    System.out.println(task.getSubject());
    System.out.println(task.getStartDate());
    System.out.println(task.getDueDate());
}

Фільтрація задач з сервера Exchange

Aspose.Email забезпечує можливість отримувати конкретні задачі з сервера замість отримання всіх задач. API можна використовувати для отримання задач за їх статусом, наприклад Completed, Deferred, In Progress, Not started або Waiting on others. ExchangeQueryBuilder клас можна використовувати для вказання потрібного критерію за допомогою властивості Status. Він також дозволяє вказувати кілька умов для отримання потрібних задач з сервера Exchange. Це продемонстровано у наведеному прикладі коду.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Set timezone for tasks
client.setTimezoneId("Central Europe Standard Time");

// We use these status values for specifying in queries
Integer[] values = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.Deferred, ExchangeTaskStatus.InProgress, ExchangeTaskStatus.NotStarted,
        ExchangeTaskStatus.WaitingOnOthers };

messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri());

// Now retrieve the tasks with specific statuses
for (int status : values) {
    queryBuilder = new ExchangeQueryBuilder();
    queryBuilder.getTaskStatus().equals(status);
    query = queryBuilder.getQuery();
    messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);
    fetchedTask = client.fetchTask(messageInfoCol.get_Item(0).getUniqueUri());
}

// retrieve all other than specified
for (int status : values) {
    queryBuilder = new ExchangeQueryBuilder();
    queryBuilder.getTaskStatus().notEquals((int) status);
    query = queryBuilder.getQuery();
    messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);
}

// specifying multiple criterion
Integer[] selectedStatuses = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.InProgress };

queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().in(Arrays.asList(selectedStatuses));
query = queryBuilder.getQuery();
messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);

// list all those which are not in our specified statuses
queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().notIn(Arrays.asList(selectedStatuses));
query = queryBuilder.getQuery();
messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);

Java: Робота з конфігурацією користувача на сервері

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

Керування конфігурацією користувачів

Aspose.Email для Java може бути використаний для керування конфігурацією користувачів на Exchange Server за допомогою EWSClient клас. Цей клас використовує Exchange Web Services, які доступні лише в Exchange Server 2007 та пізніших випусків. У цій статті розглядається, як читати, створювати, оновлювати та видаляти конфігурації користувачів на Exchange Server 2010. Потрібен Microsoft Exchange Server 2010 Service Pack 1 для всіх функцій, описаних у цій статті. Наступний фрагмент коду показує, як підключитися до Exchange Server 2010 у всіх прикладах цієї статті.

private static IEWSClient getExchangeEWSClient() {
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String domain = "";
    final String username = "username@ASE305.onmicrosoft.com";
    final String password = "password";
    NetworkCredential credentials = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
    return client;
}

Читання конфігурації користувача

Щоб отримати інформацію про конфігурацію користувача конкретної папки з Exchange Server:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.getUserConfiguration(), щоб отримати конфігурацію користувача для папки.
Відобразіть властивості конфігурації користувача, такі як ID, назва та елементи словника у вигляді пар ключ‑значення.

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

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Get the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = client.getUserConfiguration(userConfigName);

System.out.println("Configuration Id: " + userConfig.getId());
System.out.println("Configuration Name: " + userConfig.getUserConfigurationName().getName());
System.out.println("Key value pairs:");
// foreach to while statements conversion
for (Object key : userConfig.getDictionary().keySet()) {
    System.out.println(key + ": " + userConfig.getDictionary().get(key).toString());
}

Створення конфігурацій користувачів

Щоб створити конфігурацію користувача для конкретної папки на Exchange Server:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.createUserConfiguration(), щоб створити конфігурацію користувача для папки.

Наступний фрагмент коду показує, як створювати конфігурації користувачів.

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Create the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = new UserConfiguration(userConfigName);
userConfig.getDictionary().put("key1", "value1");
userConfig.getDictionary().put("key2", "value2");
userConfig.getDictionary().put("key3", "value3");
client.createUserConfiguration(userConfig);

Оновлення конфігурації користувача

Щоб оновити конфігурацію користувача для конкретної папки в Exchange Server:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.updateUserConfiguration(), щоб оновити конфігурацію користувача для папки.

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

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Create the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = client.getUserConfiguration(userConfigName);
userConfig.setId(null);

// Update User Configuration
userConfig.getDictionary().put("key1", "new-value1");
client.updateUserConfiguration(userConfig);

Видалення конфігурації користувача

Щоб видалити конфігурацію користувача для конкретної папки в Exchange Server:

Підключіться до Exchange Server за допомогою класу IEWSClient.
Викличте метод IEWSClient.deleteUserConfiguration(), щоб видалити конфігурацію користувача для папки.

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

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Delete User Configuration
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
client.deleteUserConfiguration(userConfigName);

Java: Корисні функції

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

Надсилання повідомлення з варіантом голосування

Microsoft Outlook дозволяє користувачам створювати опитування під час складання нового повідомлення. Це здійснюється шляхом включення варіантів голосування, таких як Так, Ні, Можливо тощо. Клас FollowUpOptions, пропонований Aspose.Email, надає властивість VotingButtons, яку можна використовувати для встановлення або отримання значення варіантів голосування. У цій статті наведено детальний приклад створення MapiMessage з варіантами голосування для створення опитування та надсилання повідомлення за допомогою клієнта Exchange Web Service (EWS).

Створення та надсилання повідомлення з варіантами голосування

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

String address = "firstname.lastname@aspose.com";

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
MailMessage message = createTestMessage(address);

// Set FollowUpOptions Buttons
FollowUpOptions options = new FollowUpOptions();
options.setVotingButtons("Yes;No;Maybe;Exactly!");

client.send(message, options);

Прикладні методи, використані у прикладах

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

private static MailMessage createTestMessage(String address) {
    MailMessage eml = new MailMessage(address, address, "Flagged message",
            "Make it nice and short, but descriptive. The description may appear in search engines' search results pages...");

    return eml;
}

Створення RE та FW повідомлень з файлів MSG

IEWSClient дозволяє розробникам створювати RE (Reply/Reply All) та FW (Forward) повідомлення з вихідного повідомлення. Вихідне повідомлення ідентифікується шляхом вибору певного ExchangeMessageInfo з ExchangeMessageInfoCollection отримано за допомогою IEWSClient.listMessages(). Інший аргумент — це фактичний MailMessage для надсилання як RE або FW повідомлення. Наступний фрагмент коду показує, як створити тестовий аккаунт, який використовується для надсилання повідомлення, після чого демонструються функції Reply та Forward щодо цього повідомлення. Щоб виконати це завдання:

Ініціалізуйте об’єкт IEWSClient, надавши дійсні облікові дані.
Надіслати кілька прикладних повідомлень.
Викличте функції IEWSClient.reply(), IEWSClient.replyAll() і IEWSClient.forward() для надсилання повідомлень.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

try {
    MailMessage message = new MailMessage("user@domain.com", "user@domain.com", "TestMailRefw - " + UUID.randomUUID().toString(),
            "TestMailRefw Implement ability to create RE and FW messages from source MSG file");

    client.send(message);

    ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
    if (messageInfoCol.size() == 1)
        System.out.println("1 message in Inbox");
    else
        System.out.println("Error! No message in Inbox");

    MailMessage message1 = new MailMessage("user@domain.com", "user@domain.com", "TestMailRefw - " + UUID.randomUUID().toString(),
            "TestMailRefw Implement ability to create RE and FW messages from source MSG file");

    client.send(message1);
    messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());

    if (messageInfoCol.size() == 2)
        System.out.println("2 messages in Inbox");
    else
        System.out.println("Error! No new message in Inbox");

    MailMessage message2 = new MailMessage("user@domain.com", "user@domain.com", "TestMailRefw - " + UUID.randomUUID().toString(),
            "TestMailRefw Implement ability to create RE and FW messages from source MSG file");
    message2.getAttachments().addItem(Attachment.createAttachmentFromString("Test attachment 1", "Attachment Name 1"));
    message2.getAttachments().addItem(Attachment.createAttachmentFromString("Test attachment 2", "Attachment Name 2"));

    // Reply, Replay All and forward Message
    client.reply(message2, messageInfoCol.get_Item(0));
    client.replyAll(message2, messageInfoCol.get_Item(0));
    client.forward(message2, messageInfoCol.get_Item(0));
} catch (java.lang.RuntimeException ex) {
    System.out.println("Error in program" + ex.getMessage());
}

Підтримка OAuth для EWS з Office 365

Aspose.Email API забезпечує підтримку Exchange Web Service (EWS) з Office 365. API‑ EWSClient інтерфейс надає перегружений метод, який забезпечує OAuthNetworkCredential як вхідні дані для доступу до облікового запису Exchange через OAuth. Користувач має вказати Authority, Client Id, Client App Uri та параметри Resource, щоб це працювало. Наступний фрагмент коду демонструє підтримку OAuth для EWS з Office 365.

// token provider
/*ITokenProvider provider = new ITokenProvider() {

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        return null;
    }
};

NetworkCredential credentials = new OAuthNetworkCredential(provider);*/

// accessToken
NetworkCredential credentials = new OAuthNetworkCredential("accessToken");

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", credentials);
client.listMessages();

Підтримка журналювання в клієнтах Exchange

Aspose.Email API надає можливість забезпечити журналювання клієнта Exchange Web Service.

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

client.setLogFileName("logs/ews");
// OR
EWSClient.setCommonLogFileName("logs/ews");

Додавання заголовків у запити EWS

Aspose.Email API дозволяє додавати заголовки до запитів Exchange. Це можна використати для додавання різних заголовків до запитів EWS з різними цілями. Прикладом може бути додавання заголовка X-AnchorMailbox, який використовується для управління проблемами обмеження (throttling) на сервері Exchange. Метод addHeader інтерфейсу IEWSClient використовується для додавання заголовків до запитів EWS, як показано у наведеному фрагменті коду.

final IEWSClient client = EWSClient.getEWSClient("exchange.domain.com/ews/Exchange.asmx", "username", "password", "");
try {
    client.addHeader("X-AnchorMailbox", "username@domain.com");
    ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
} finally {
    client.dispose();
}

Повернути ідентифікатор запиту клієнта у заголовку

The return-client-request-id заголовок надсилається у запиті і використовується сервером для визначення, чи client-request-id заголовок, зазначений клієнтом, має бути повернутий у відповіді сервера. У цій операції використовуються такі методи:

getReturnClientRequestId()
setReturnClientRequestId(boolean value) - Отримати або встановити прапор, який вказує, чи клієнт вимагає, щоб сервер повернув ідентифікатор запиту.

try (IEWSClient client = createEWSClient())
{
    // Client will create random id and pass it to the server.
    // The server should include this id in request-id header of all responses.
    client.setReturnClientRequestId(true);
    
    client.setLogFileName("ews.log");
    client.getMailboxInfo();
}

Робота з уніфікованими повідомленнями

Aspose.Email може отримувати інформацію про уніфіковані повідомлення з Exchange Server 2010. Уніфіковані повідомлення, такі як отримання інформації про конфігурацію, ініціація вихідного виклику, отримання інформації про телефонний виклик за ID виклику та завершення виклику за ID, наразі підтримуються. Наведений приклад коду показує, як отримати конфігураційну інформацію уніфікованих повідомлень з Microsoft Exchange Server 2010.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);
UnifiedMessagingConfiguration umConf = client.getUMConfiguration();

Отримання підказок електронної пошти

Microsoft Exchange Server додав кілька нових функцій у версіях Exchange Server 2010 та 2013. Одна з них дозволяє користувачам отримувати підказки під час складання електронного листа. Ці підказки дуже корисні, оскільки надають інформацію до надсилання листа. Наприклад, якщо в списку отримувачів вказана неправильна електронна адреса, підказка повідомить, що адреса недійсна. Підказки також дозволяють бачити відповіді «не в офісі» перед відправленням листа: Exchange Server (2010 і 2013) надсилає підказку під час складання, якщо один або кілька отримувачів встановили автоматичні відповіді. Для всіх функцій, продемонстрованих у цій статті, потрібен Service Pack 1 для Microsoft Exchange Server 2010. Наступний фрагмент коду показує, як використовувати EWSClient клас, який використовує Exchange Web Services, доступний у Microsoft Exchange Server 2007 та пізніших версіях.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
System.out.println("Connected to Exchange server...");
// Provide mail tips options
MailAddressCollection addrColl = new MailAddressCollection();
addrColl.addMailAddress(new MailAddress("test.exchange@ex2010.local", true));
addrColl.addMailAddress(new MailAddress("invalid.recipient@ex2010.local", true));
GetMailTipsOptions options = new GetMailTipsOptions(MailAddress.to_MailAddress("administrator@ex2010.local"), addrColl, MailTipsType.All);

// Get Mail Tips
MailTips[] tips = client.getMailTips(options);

// Display information about each Mail Tip
for (MailTips tip : tips) {
    // Display Out of office message, if present
    if (tip.getOutOfOffice() != null) {
        System.out.println("Out of office: " + tip.getOutOfOffice().getReplyBody().getMessage());
    }

    // Display the invalid email address in recipient, if present
    if (tip.getInvalidRecipient() == true) {
        System.out.println("The recipient address is invalid: " + tip.getRecipientAddress());
    }
}

Імперсонація Exchange

Імперсонація в Exchange дозволяє комусь діяти від імені іншого облікового запису та виконувати завдання і операції, використовуючи дозволи імперсонованого аккаунту замість своїх. У той час як делегування дозволяє користувачам діяти від імені інших, імперсонація дозволяє їм діяти як інші користувачі. Aspose.Email підтримує імперсонацію Exchange. EWSClient клас надає методи ImpersonateUser і ResetImpersonation для реалізації цієї функції.

Щоб виконати це завдання:

Ініціалізувати ExchangeWebServiceClient для користувача 1.
Ініціалізувати ExchangeWebServiceClient для користувача 2.
Додати тестові повідомлення до облікових записів.
Увімкнути імперсонацію.
Скинути імперсонацію.

Наступний фрагмент коду показує, як використовувати EWSClient клас для реалізації функції імперсонації.

// Create instance's of EWSClient class by giving credentials
IEWSClient client1 = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser1", "pwd", "domain");
IEWSClient client2 = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser2", "pwd", "domain");
{
    String folder = "Drafts";
    try {
        for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client1.listMessages(folder))
            client1.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
        String subj1 = "NETWORKNET_33354 User User1";
        client1.appendMessage(folder, new MailMessage("User1@exchange.conholdate.local", "To@aspsoe.com", subj1, ""));

        for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client2.listMessages(folder))
            client2.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
        String subj2 = "NETWORKNET_33354 User User2";
        client2.appendMessage(folder, new MailMessage("User2@exchange.conholdate.local", "To@aspose.com", subj2, ""));

        ExchangeMessageInfoCollection messInfoColl = client1.listMessages(folder);
        // Assert.AreEqual(1, messInfoColl.Count);
        // Assert.AreEqual(subj1, messInfoColl[0].Subject);

        client1.impersonateUser(ItemChoice.PrimarySmtpAddress, "User2@exchange.conholdate.local");
        ExchangeMessageInfoCollection messInfoColl1 = client1.listMessages(folder);
        // Assert.AreEqual(1, messInfoColl1.Count);
        // Assert.AreEqual(subj2, messInfoColl1[0].Subject);

        client1.resetImpersonation();
        ExchangeMessageInfoCollection messInfoColl2 = client1.listMessages(folder);
        // Assert.AreEqual(1, messInfoColl2.Count);
        // Assert.AreEqual(subj1, messInfoColl2[0].Subject);
    } finally {
        try {
            for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client1.listMessages(folder))
                client1.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
            for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client2.listMessages(folder))
                client2.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
        } catch (java.lang.RuntimeException e) {
        }
    }
}

Функція Auto Discover за допомогою EWS

Aspose.Email API дозволяє виявити налаштування сервера Exchange за допомогою клієнта EWS.

AutodiscoverService svc = new AutodiscoverService();
svc.setCredentials(new NetworkCredential(email, password));

IGenericDictionary</* UserSettingName */Integer, Object> userSettings = svc.getUserSettings(email, UserSettingName.ExternalEwsUrl).getSettings();
String ewsUrl = (String) userSettings.get_Item(UserSettingName.ExternalEwsUrl);
System.out.println("Auto discovered EWS Url: " + ewsUrl);

Переривання відновлення PST на сервер Exchange

Aspose.Email API дозволяє відновити файл PST на сервер Exchange. Однак, якщо операція триває довго через великий розмір PST‑файлу, може знадобитися задати критерій для переривання операції. Це можна реалізувати за допомогою API, як показано у наведеному прикладі коду.

final IEWSClient client = EWSClient.getEWSClient("https://exchange.office365.com/ews/exchange.asmx", "username", "password");
try {
    final long startTime = System.currentTimeMillis();
    final AtomicInteger processedItems = new AtomicInteger(0);
    final long S15 = 15 * 1000;

    BeforeItemCallback callback = new BeforeItemCallback() {
        public void invoke(ItemCallbackArgs item) {
            if (System.currentTimeMillis() - startTime > S15) {
                throw new AbortRestoreException();
            }

            processedItems.incrementAndGet();
        }
    };

    try {
        // create a test pst and add some test messages to it
        PersonalStorage pst = PersonalStorage.create(new ByteArrayOutputStream(), FileFormatVersion.Unicode);
        FolderInfo folder = pst.getRootFolder().addSubFolder("My test folder");
        for (int i = 0; i < 20; i++) {
            MapiMessage message = new MapiMessage("from@gmail.com", "to@gmail.com", "subj", "body");
            folder.addMessage(message);
        }
        RestoreSettings rs = new RestoreSettings();
        rs.setBeforeItemCallback(callback);

        // now restore the PST with callback
        client.restore(pst, rs);
        System.out.println("Success!");
    } catch (AbortRestoreException e) {
        System.out.println("Timeout! " + processedItems.get());
    }
} finally {
    client.dispose();
}

Java: Фільтрація зустрічей з Exchange Server

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

Фільтрація зустрічей за допомогою EWS

The IEWSClient надає можливість фільтрувати зустрічі з Exchange server за допомогою ExchangeQueryBuilder. Зустрічі можна фільтрувати за:

Дати
Повторення

Фільтрація зустрічей за датами

IEWSClient client = EWSClient.getEWSClient(mailboxUri, username, password, domain);

SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");
Date startTime = sdf.parse("15/09/2017 00:00:00");
Date endTime = sdf.parse("10/10/2017 00:00:00");
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getAppointment().getStart().since(startTime);
builder.getAppointment().getEnd().beforeOrEqual(endTime);
MailQuery query = builder.getQuery();
Appointment[] appointments = client.listAppointments(query);

Фільтрація зустрічей за повторюваними подіями

builder = new ExchangeQueryBuilder();
builder.getAppointment().isRecurring().equals(false);
query = builder.getQuery();
appointments = client.listAppointments(query);

Java: Робота з розширеними атрибутами елементів Exchange

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

Aspose.Email API дозволяє створювати, отримувати та оновлювати розширені властивості повідомлень за допомогою EWS‑клієнта API. У наведеному зразку коду це продемонстровано шляхом створення розширеного атрибуту, додавання його до повідомлення на сервері та отримання повідомлення як MapiMessage з сервера Exchange за допомогою клієнтської fetchItem.

// Define a PidTagBodyContentId extended property
PropertyDescriptor extendedProperty = KnownPropertyList.BODY_CONTENT_ID;

// Create a message and set an extended property value
MapiMessage msg = new MapiMessage("from@from.com", "to@to.com",
        "Test message", "This is a test message");
msg.setProperty(extendedProperty, "03454432-6230-4e4b-887f-a498ea223599");

// Append message
String uri = ewsClient.appendMessage(ewsClient.getMailboxInfo().getInboxUri(), msg, true);

// Fetch appended item. Pass the extended property descriptor as method parameter.
MapiMessage fetchedMsg = ewsClient.fetchItem(uri, Arrays.asList(new PropertyDescriptor[] { extendedProperty }));

// Print the extended property value
System.out.println(fetchedMsg.getProperties().get_Item(extendedProperty).getString());

Java: Робота з In-Place Archive

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

In-Place Archives в Office 365

In-Place Archives в Office 365 надає користувачам додатковий простір для зберігання. Після ввімкнення архівних скриньок користувачі можуть отримувати доступ і зберігати повідомлення в своїй архівній скриньці за допомогою Microsoft Outlook та Outlook в вебі. Коли скринька з увімкненим In-Place архівуванням відкривається в Outlook, архівна скринька відображається як окрема скринька.

Переміщення елементів до In-Place Archive

Aspose.Email API можна використати для переміщення елементів у архівну поштову скриньку користувача за допомогою IEWSClient.archiveItem метод. IEWSClient.archiveItem метод надає чотири перевантаження, які перелічені нижче.

archiveItem(String sourceFolderUri, Appointment appointment)
archiveItem(String sourceFolderUri, ExchangeTask task)
archiveItem(String sourceFolderUri, MapiMessageItemBase item)]
archiveItem(String sourceFolderUri, String uniqueId)

Наведений нижче приклад коду демонструє використання IEWSClient.archiveItem метод переміщення електронного листа до архівної поштової скриньки за допомогою UniqueUri.

NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    System.out.println("Subject:" + msgInfo.getSubject());
    client.archiveItem(client.getMailboxInfo().getInboxUri(), msgInfo.getUniqueUri());
}
client.dispose();

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

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

Aspose.Email підтримує доступ до повідомлень зі спільної скриньки. Щоб це здійснити, підключіться до вашої основної скриньки за допомогою EWSClient клас. Щоб отримати доступ до повідомлень зі спільної скриньки, ви передаєте спільну скриньку як параметр-рядок у listMessages або listItems метод.

Наступний приклад коду показує, як доступатися до повідомлень зі спільної скриньки за допомогою listItems метод.

final String mailboxUri = "<HOST>";
final String domain = "";
final String username = "<EMAIL ADDRESS>";
final String password = "<PASSWORD>";
final String sharedEmail = "<SHARED EMAIL ADDRESS>";
NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

String[] items = client.listItems(sharedEmail, "Inbox");

for (String item : items) {
    MapiMessage msg = client.fetchItem(item);
    System.out.println("Subject:" + msg.getSubject());
}
client.dispose();

Java: Підтримка TLS 1.2 та AutodiscoverService

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

Aspose.Email for Java тепер підтримує TLS 1.2 за допомогою SAAJ API. EWSClient надає статичну властивість useSAAJAPI яку можна встановити в true для використання TLS 1.2. Aspose.Email for Java також підтримує AutodiscoverService для TLS 1.2. Нижченаведені приклади коду демонструють використання SAAJ API та AutodiscoverService для TLS 1.2.

Використовувати SAAJ API

Java EE SOAP Client, який використовується в режимі SAAJAPI - https://docs.oracle.com/cd/E19651-01/817-2151-10/wsgjaxm.html.

Нижченаведений приклад коду демонструє використання SAAJ API шляхом встановлення EWSClient.useSAAJAPI властивість встановити в true.

У наступному фрагменті коду буде призначений заголовок базової автентифікації:

EWSClient.useSAAJAPI(true);
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testuser", "pw", "domain");
client.listMessages();

У наступному фрагменті коду буде призначений заголовок автентифікації OAUTH2:

EWSClient.useSAAJAPI(true);
// token provider
/*ITokenProvider provider = new ITokenProvider() {

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        return null;
    }
};

NetworkCredential credentials = new OAuthNetworkCredential(provider);*/

// accessToken
NetworkCredential credentials = new OAuthNetworkCredential("accessToken");

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", credentials);
client.listMessages();

Зауважте, що в цьому режимі API не керує процесом NTLM‑автентифікації. Для NTLM‑автентифікації потрібен Java Authenticator.

Фрагмент коду NTLM‑автентифікації для Java 8:

import java.net.Authenticator;
import java.net.PasswordAuthentication;
import java.net.URL;

static Authenticator getAuthenticator(String user, String pw, String domain) {
    final String username = domain + "\\" + user;
    final String password = pw;
    System.out.println("New Credentials " + username);
    return new Authenticator() {
        protected PasswordAuthentication getPasswordAuthentication() {
            System.out.println("Authenticate " + username);
            return new PasswordAuthentication(username, password.toCharArray());
        }
    };
}

EWSClient.useSAAJAPI(true);
System.setProperty("http.auth.preference", "NTLM");
Authenticator.setDefault(getAuthenticator("user", "pw", ""));
IEWSClient client = EWSClient.getEWSClient(new URL("https://domain.com/ews/Exchange.asmx"));

static Authenticator getAuthenticator() {

    // This block is written for suppressing a bug in sun implementation.
    // In Sun Impl client doesn't authenticate user for each connection,
    // uses cached credentials instead.
    sun.net.www.protocol.http.AuthCacheValue.setAuthCache(new sun.net.www.protocol.http.AuthCache() {
        public void remove(String pkey, sun.net.www.protocol.http.AuthCacheValue entry) {
        }
        public void put(String pkey, sun.net.www.protocol.http.AuthCacheValue value) {
        }
        public sun.net.www.protocol.http.AuthCacheValue get(String pkey, String skey) {
            return null;
        }
    });

    return new Authenticator() {
        protected PasswordAuthentication getPasswordAuthentication() {
            return getEmbeddedCredentials(getRequestingURL());
        }

        PasswordAuthentication getEmbeddedCredentials(URL url) {
            if (url == null) {
                return null;
            }
            String userInfo = url.getUserInfo();
            int colon = userInfo == null ? -1 : userInfo.indexOf(":");
            if (colon == -1) {
                return null;
            } else {
                String userName = userInfo.substring(0, colon);
                String pass;
                try {
                    pass = URLDecoder.decode(userInfo.substring(colon + 1), "UTF-8");
                } catch (UnsupportedEncodingException e) {
                    pass = "";
                }
                System.out.println("Authenticate " + userInfo);
                return new PasswordAuthentication("\\" + userName, pass.toCharArray());
            }
        }
    };
}

static URL getURL(String url, String user, String pw, String domain) throws Exception {
    String host = new URL(url).getHost();
    URL endpoint = new URL(url.replace(host, user + ":" + URLEncoder.encode(pw, "UTF-8") + "@" + host));

    return endpoint;
}

EWSClient.useSAAJAPI(true);
Authenticator.setDefault(getAuthenticator());

System.setProperty("http.auth.preference", "NTLM");
IEWSClient client1 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user1", "pw", "domain"));
IEWSClient client2 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user2", "pw", "domain"));

Починаючи з Java 9, Authenticator можна встановити для з’єднання:

static Map<String, Authenticator> authInfo = new HashMap<String, Authenticator>();
static URL getURL(String url, final String user, final String pw, final String domain) throws MalformedURLException {
    URL endpoint = new URL(new URL(url), "", new URLStreamHandler() {
        protected URLConnection openConnection(URL url) throws IOException {
            URL target = new URL(url.toString());
            HttpURLConnection connection = (HttpURLConnection) target.openConnection();
            // Cache for User@Url
            Authenticator auth = authInfo.get(user + "@" + url);
            if (auth == null) {
                auth = new Authenticator() {
                    protected PasswordAuthentication getPasswordAuthentication() {
                        System.out.println("Authenticate " + user);
                        return new PasswordAuthentication(domain + "\\" + user, pw.toCharArray());
                    }
                };
                authInfo.put(user + "@" + url, auth);
            }
            connection.setAuthenticator(auth);

            return connection;
        }
    });

    return endpoint;
}

EWSClient.useSAAJAPI(true);
System.setProperty("http.auth.preference", "NTLM");
IEWSClient client1 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user1", "pw", "domain"));
IEWSClient client2 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user2", "pw", "domain"));

Примітка: API JAXB вважаються API Java EE, тому вони більше не входять до базового класичного шляху в Java SE 9.

Maven JAXB залежності:

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
</dependency>
<dependency>
    <groupId>com.sun.xml.messaging.saaj</groupId>
    <artifactId>saaj-impl</artifactId>
</dependency>

Використовувати AutodiscoverService

Нижченаведений приклад коду демонструє використання AutodiscoverService для TLS 1.2

AutodiscoverService service = new AutodiscoverService();
service.setCredentials(new NetworkCredential("user", "password"));
GetUserSettingsResponse response = service.getUserSettings("userSmtpAddress", UserSettingName.ExternalEwsUrl, UserSettingName.UserDisplayName);