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 клас. Този 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 за достъп до елементи в пощенска кутия. Използвайте Aspose.Email’s ImapClient клас за свързване към Exchange Server, използвайки протокола IMAP. За повече информация относно ImapClient клас. Първо, уверете се, че IMAP услугите са активирани за вашия Exchange Server:

Отворете Control Panel.
Отидете в 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

Този EWSClient класът има членове, които могат да се използват за получаване на информация за кутия от Exchange Server чрез извикване на IEWSClient.getMailboxInfo() метод. Той връща екземпляр от тип ExchangeMailboxInfo. Получете информация за кутията от свойства като MailboxUri, InboxUri и DraftsUri. Тази статия показва как да достъпите информация за пощенска кутия чрез Exchange Web Services.

Ако искате да се свържете с Exchange сървъра, използвайки Exchange Web Services (EWS), използвайте EWSClient клас. Този клас използва EWS за свързване и управление на елементи в Exchange сървър. Следният Java кодов откъс показва как да получите информация за пощенската кутия, използвайки 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);

Получаване на клас на съобщението

Този 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 може да се получи чрез извикване на IEWClient.listMessages метод. Получете основната информация за съобщенията, като тема, от, до и ID на съобщението, чрез 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. Възможно е също да се получи списък със съобщения от други папки. The 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 сървър и да ги запишете на диск във формати 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 сървър в паметен поток, използвайки 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

Този IEWSClient.saveMessage() методът може директно да запази съобщението във формат EML. За запазване в MSG формат, първо извикайте IEWSClient.fetchMessage() метод, който връща екземпляр на MailMessage клас. След това извикайте MailMessage.save() метод за запазване на съобщението във формат MSG. Следният кодов откъс показва как да се получат съобщения от пощенска кутия на Exchange сървър и да се запишат във формат 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 приема списък от ID за използване 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 Server използва listMessages() метод за получаване на списък със съобщения от пощенска кутия в Exchange Server. Този listMessages() методът получава основна информация за съобщенията, например тема, ID на съобщението, от и до. За пълните детайли на съобщението, Aspose.Email.Exchange предоставя метода IEWSClient.fetchMessage(). Този метод приема URI на съобщението като параметър и връща инстанция на MailMessage клас. Този MailMessage класът след това предоставя детайли за съобщението като тяло, заглавки и прикачени файлове. Научете повече за MailMessage API, или открийте как да управлявате имейли с MailMessage клас. За извличане на съобщения от пощенската кутия на Exchange сървъра:

Създайте инстанция от тип IEWSClient.
Посочете името на сървъра, потребителското име, паролата и домейна.
Извикайте listMessages, за да получите ExchangeMessageInfoCollection.
Обхождайте колекцията ExchangeMessageInfoCollection, за да получите стойностите на ExchangeMessageInfo.UniqueURI.
Извикайте IEWSClient.fetchMessage() и предайте ExchangeMessageInfo.UniqueURI като параметър.

Следният кодов откъс показва как да се свържете с пощенската кутия на Exchange сървъра и да извлечете всички съобщения, използвайки 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 за извличане на съобщение

Забележка, the FetchItem методът връща съобщението без прикачени файлове. За извличане на съобщения с прикачени файлове, използвайте FetchItem метод, описан в следващия раздел.

Този 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("==================================");
}

Изтегляне на съобщения рекурсивно

Този 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 за Java предоставя възможност за филтриране на съобщения от Exchange пощенска кутия, използвайки EWSClient и ExchangeQueryBuilder. Съобщенията могат да се филтрират по различни критерии, като дата, домейн, message-id и по известия за доставка на поща. Тази статия показва как да се филтрират съобщения от Exchange Server, използвайки различни критерии.

Филтриране на съобщения с EWS

Този IEWSClient клас предоставя listMessages() метод, който получава всички съобщения от пощенска кутия. За да получите само съобщения, отговарящи на някакво условие, използвайте претоварения listMessages() метод, който приема MailQuery клас като аргумент. Този 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);

Филтриране на съобщения по стойност на низ

Следният кодов откъс показва как да филтрирате всички имейли въз основа на указания низ в заглавните полета (тема, от, до, копие). The 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

Следният фрагмент от код показва как да комбинирате заявки с И.

// 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“ като подател. Следният фрагмент от код показва как да комбинирате заявки с ИЛИ.

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 Server

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

Изпращане на заявки за срещи

Тази статия показва как да изпратите заявка за среща до множество получатели, използвайки Exchange Web Services и Aspose.Email.

Създайте заявка за среща, използвайки класа Appointment, и задайте място, време и участници.
Създайте инстанция на класа MailMessage и задайте срещата, използвайки метода MailMessage.addAlternateView().
Свържете се със сървъра Exchange и изпратете заявка за среща, използвайки метода send(MailMessage).

Този 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. The 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 Server с поддръжка на странициране.

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();
        }

Добавяне на събитие към вторична календарна папка в Exchange Server

Aspose.Email API ви позволява да създадете вторична календарна папка в Exchange Server, използвайки 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 сървър. Aspose.Email API предоставя същата възможност, като позволява споделяне на календара чрез EWS API.

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.

Извличане на контакт по ID

Определен контакт може да бъде извлечен от сървъра, използвайки неговото ID, както е показано в следния примерен код.

Contact fetchedContact = client.getContact(id);

Добавяне на контакти

Този 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);

Изтриване на контакти

Този EWSClient клас предоставя deleteItem за достъп и изтриване на контакти от папката Contacts на Exchange Server. Този метод приема ID на контакта като входен параметър.

За изтриване на контакти от Exchange Server:

Инициализирайте ExchangeWebServiceClient с адрес и идентификационни данни.
Изтриване на контакт, използвайки неговото ID.

Следните кодови откъси показват как да изтривате контакти от 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 Server.

// 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

Този 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 пощенска кутия. The CreateFolder метод на IEWSClient може да се използва за тази цел. За да създадете папка в пощенската кутия на Exchange сървъра, могат да се следват следните стъпки.

Създайте инстанция на IEWSClient.
Задайте свойството UseSlashAsFolderSeparator, както е необходимо. Ако е зададено на true, приложението ще счита "Slash" за разделител на папки и подпапката ще бъде създадена след наклонената черта.
Използвайте метода 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 Server

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);

Задаване на часовата зона

Този 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 Server

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 Server

Aspose.Email предоставя възможност за извличане на конкретни задачи от сървъра вместо всички задачи. API‑то може да се използва за извличане на задачи според статуса им, като Завършени, Отложени, В процес, Не започнали или Изчакващи други. The ExchangeQueryBuilder Класът може да се използва за задаване на желан критерий, използвайки свойството Status. Той също така позволява задаване на множество условия за извличане на желани задачи от Exchange Server. Това е демонстрирано в следния примерен код.

// 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, която се използва за управление на проблемите с ограничаването на натоварването в 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();
}

Връщане на идентификатора на клиентската заявка в заглавката

Този 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) изпраща съвет, докато се съставя имейл, ако един или повече получатели имат зададени отговори извън офиса. За всички функции, демонстрирани в тази статия, е необходим Microsoft Exchange Server 2010 Service Pack 1. Следният фрагмент от код показва как се използва 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 Server, използвайки 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 Server

Aspose.Email API ви позволява да възстановите PST файл в Exchange Server. Въпреки това, ако операцията отнема дълго поради голям размер на 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

Този IEWSClient осигурява възможност за филтриране на назначения от Exchange сървъра, използвайки 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 архиви в Office 365

In-Place архивите в 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. The 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 клиентът, използван в режим SAAJAPI - https://docs.oracle.com/cd/E19651-01/817-2151-10/wsgjaxm.html.

Следният примерен код демонстрира използването на SAAJ API чрез задаване на EWSClient.useSAAJAPI свойство на true.

В следващия кодов фрагмент ще бъде зададен Basic заглавие за удостоверяване:

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"));

Забележка: JAXB API‑те се считат за Java EE API‑те и затова вече не се включват по подразбиране в classpath‑а на 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);