Documentation – کار با کلاینت Exchange EWS

Java: اتصال به سرور Exchange

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 با استفاده از 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 با استفاده از IMAP

Microsoft Exchange Server از پروتکل IMAP برای دسترسی به آیتم‌های یک صندوق‌نامه پشتیبانی می‌کند. از Aspose.Email’s ImapClient کلاس برای اتصال به سرور Exchange با استفاده از پروتکل IMAP. برای اطلاعات بیشتر دربارهٔ ImapClient کلاس. ابتدا اطمینان حاصل کنید که سرویس‌های IMAP برای سرور Exchange شما فعال هستند:

پنل کنترل را باز کنید.
به ابزارهای مدیر (Administrator Tools) رفته، سپس Services.
وضعیت سرویس Microsoft Exchange IMAP4 را بررسی کنید.
اگر قبلاً در حال اجرا نیست، آن را فعال/شروع کنید.

قطعه کد زیر نشان می‌دهد چگونه با استفاده از پروتکل IMAP به سرور Microsoft Exchange متصل شوید و پیام‌های پوشه Inbox را فهرست کنید.

// 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 دریافت کرد IEWSClient.getMailboxInfo() متد. یک نمونه از نوع را برمی‌گرداند ExchangeMailboxInfo. اطلاعات صندوق پستی را از ویژگی‌هایی مانند MailboxUri, InboxUri و DraftsUri. این مقاله نشان می‌دهد چگونه اطلاعات صندوق ایمیل را با استفاده از Exchange Web Services دسترسی پیدا کنید.

اگر می‌خواهید با استفاده از Exchange Web Services (EWS) به سرور Exchange متصل شوید، از EWSClient کلاس. این کلاس از EWS برای اتصال و مدیریت موارد بر روی یک سرور Exchange استفاده می‌کند. قطعه کد Java زیر نشان می‌دهد که چگونه اطلاعات صندوق ایمیل را با استفاده از خدمات وب Exchange دریافت کنید.

// 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 و ابزارهای موجود در 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 می‌تواند با فراخوانی IEWSClient.listMessages متد. با استفاده از آن اطلاعات پایهٔ پیام‌ها مانند موضوع، فرستنده، گیرنده و شناسهٔ پیام (Message 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 دریافت کنید و با استفاده از EWS در قالب MSG ذخیره کنید.

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

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

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

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

دریافت ExchangeMessageInfo از URI پیام

یک پیام ایمیل توسط شناسهٔ یکتا، URI، نمایانده می‌شود و بخش جدایی‌ناپذیر ExchangeMessageInfo شیء. در صورتی که فقط URI پیام در دسترس باشد، سپس ExchangeMessageInfo شیء را می‌توان با استفاده از این اطلاعات در دسترس نیز بازیابی کرد. نسخهٔ بیش‌بارگذاری شدهٔ listMessages یک فهرست از شناسه‌ها را برای استفاده می‌گیرد ExchangeMessageInfoCollection. قطعه کد زیر نشان می‌دهد که چگونه‌ ExchangeMessageInfo از URI پیام.

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

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

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

ExchangeMessageInfoCollection messageInfoCol = client.listMessages(ids);

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

دریافت پیام‌ها از صندوق‌پستی سرور Exchange

لیست کردن پیام‌ها در سرور Exchange از listMessages() متد برای دریافت فهرست پیام‌ها از صندوق‌پستی سرور Exchange. listMessages() متد اطلاعات پایه‌ای دربارهٔ پیام‌ها را به‌دست می‌آورد، برای مثال موضوع، شناسهٔ پیام، فرستنده و گیرنده. برای دریافت جزئیات کامل پیام، 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 برای دریافت یک پیام

توجه، 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 به صورت بازگشتی استفاده شود. این به Exchange Server 2007 یا بالاتر نیاز دارد، زیرا از EWS استفاده می‌کند. قطعه کد زیر نشان می‌دهد چگونه تمام صندوق‌نامه (پوشه‌ها و زیردرخت‌ها) یک سرور Exchange را بارگیری کنید. ساختار پوشه‌ها به‌صورت محلی ایجاد می‌شود و تمام پیام‌ها بارگیری می‌شوند.

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 و خواندن و بارگیری پیام‌ها و پست‌ها از پوشه‌های عمومی. قطعه کد زیر نحوه خواندن تمام پوشه‌های عمومی و زیردرخت‌ها، و فهرست و بارگیری هر پیام موجود در این پوشه‌ها را نشان می‌دهد. این مثال تنها با 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 می‌خواند.
برخی از پیام‌ها را بر اساس معیارهای خاصی پردازش می‌کند (در این مثال، یک کلمه کلیدی در موضوع پیام جستجو می‌شود).
پیام‌هایی که شرط داده‌شده را برآورده می‌کنند به پوشه پردازش‌شده منتقل می‌کند.

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

کپی کردن پیام‌ها

API Aspose.Email امکان کپی یک پیام از یک پوشه به پوشهٔ دیگر را با استفاده از 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 برای جاوا قابلیت فیلتر کردن پیام‌ها از صندوق‌پستی Exchange را با استفاده از EWSClient و ExchangeQueryBuilder. پیام‌ها می‌توانند با معیارهای مختلفی مانند تاریخ، دامنه، message-id و اعلان‌های تحویل ایمیل فیلتر شوند. این مقاله نشان می‌دهد چگونه پیام‌ها را از سرور Exchange با استفاده از معیارهای مختلف فیلتر کنید.

فیلتر کردن پیام‌ها با استفاده از EWS

این IEWSClient کلاس فراهم می‌کند listMessages() متدی که تمام پیام‌ها را از یک صندوق پستی دریافت می‌کند. برای دریافت تنها پیام‌هایی که شرطی را برآورده می‌کنند، از نسخهٔ overloaded استفاده کنید. 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);

فیلتر پیام‌ها بر اساس مقدار رشته‌ای

قطعه کد زیر نشان می‌دهد چگونه تمام ایمیل‌ها را بر اساس رشته مشخص شده در سرآیندها (موضوع، فرستنده، گیرنده، سی‌سی) فیلتر کنید. getText() متد مقدار رشته را همراه با بدنه پیام برمی‌گرداند.

 ExchangeQueryBuilder builder = new ExchangeQueryBuilder();

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

MailQuery query = builder.getQuery();

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

فیلتر پیام‌ها به ترتیب صعودی/نزولی

Aspose.Email ارائه می‌دهد ComparisonField.orderBy(boolean ascending) متد که مقدار نشان‌دهنده استفاده کلاینت از مرتب‌سازی صعودی یا نزولی بر روی فیلد جستجو را تنظیم می‌کند. این اجازه می‌دهد پیام‌های ایمیل را بر اساس معیارهای مشخص شده به ترتیب صعودی/نزولی مرتب کنید. MailQueryBuilder.

قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را به ترتیب صعودی/نزولی فیلتر کنید:

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

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

ساخت پرس‌وجوهای پیچیده

اگر متفاوت MailQueryBuilder ویژگی‌ها در یک بیان جداگانه تنظیم می‌شوند، همه شرایط مطابقت می‌یابند. برای مثال، برای دریافت پیامی در یک بازه تاریخی خاص و از یک میزبان مشخص، سه بیان بنویسید:

ترکیب پرس‌وجوها با AND

قطعه کد زیر نشان می‌دهد چگونه پرس‌وجوها را با AND ترکیب کنید.

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

ترکیب پرس‌وجوها با OR

MailQueryBuilder ارائه می‌دهد or() متد که دو MailQuery نمونه‌ها به‌عنوان پارامترها. این روش پیام‌هایی را که با هر یک از دو شرط مشخص شده مطابقت دارند، دریافت می‌کند. مثال زیر پیام‌هایی را فیلتر می‌کند که یا کلمه "test" در موضوع دارند یا "noreply@host.com" به عنوان فرستنده. قطعه کد زیر نشان می‌دهد چگونه پرس‌وجوها را با OR ترکیب کنید.

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

فیلتر ایمیل حساس به حروف

ایمیل‌ها می‌توانند با حساسیت به حروف بزرگ/کوچک فیلتر شوند با مشخص کردن پرچم IgnoreCase در معیار فیلتر همان‌طور که در قطعه کد زیر نشان داده شده است.

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

فیلتر پیام‌ها با پشتیبانی از صفحه‌بندی

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

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

Java: مدیریت موارد مکالمه

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

Aspose.Email برای Java می‌تواند برای مدیریت موارد مکالمه در Exchange Server با استفاده از EWSClient کلاس. این کلاس از Exchange Web Services استفاده می‌کند که فقط در Exchange Server 2007 و نسخه‌های بعدی موجود است. این مقاله نشان می‌دهد چگونه پیدا کردن, کپی, جابجایی و حذف موارد مکالمه در Exchange Server 2010. سرویس‌پک 1 Microsoft Exchange Server 2010 برای تمام ویژگی‌های گنجانده‌شده در این بخش مورد نیاز است.

یافتن مکالمات

برای دریافت اطلاعات مکالمه از یک پوشهٔ خاص در Exchange Server:

به Exchange Server با استفاده از کلاس IEWSClient متصل شوید.
متد IEWSClient.findConversations() را صدا بزنید تا تمام موارد مکالمه را از یک پوشه پیدا کنید.
خواص مورد مکالمه مانند شناسه، موضوع مکالمه و وضعیت پرچم را نمایش دهید.

قطعه کد زیر نشان می‌دهد چگونه مکالمات را پیدا کنید.

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

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

کپی کردن مکالمات

برای کپی کردن مکالمات از یک پوشه به پوشهٔ دیگر:

به Exchange Server با استفاده از کلاس IEWSClient متصل شوید.
متد IEWSClient.copyConversationItems() را صدا بزنید تا مورد مکالمه را از پوشهٔ منبع به پوشهٔ مقصد کپی کنید.

قطعه کد زیر نشان می‌دهد چگونه مکالمات را کپی کنید.

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

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

جابجایی مکالمات

برای جابجا کردن مکالمات از یک پوشه به پوشهٔ دیگر:

به Exchange Server با استفاده از کلاس IEWSClient متصل شوید.
متد IEWSClient.moveConversationItems() را صدا بزنید تا یک مکالمه را از پوشهٔ منبع به پوشهٔ مقصد منتقل کنید.

قطعه کد زیر نشان می‌دهد چگونه مکالمات را جابجا کنید.

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

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

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

حذف مکالمات

برای حذف مکالمات از یک پوشه:

به Exchange Server با استفاده از کلاس IEWSClient متصل شوید.
متد IEWSClient.deleteConversationItems() را صدا بزنید تا مورد مکالمه را از پوشهٔ منبع حذف کنید.

قطعه کد زیر نشان می‌دهد چگونه مکالمات را حذف کنید.

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

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

Java: کار با موارد تقویم در سرور Exchange

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

ارسال درخواست‌های جلسه

این مقاله نشان می‌دهد چگونه یک درخواست جلسه را به چندین گیرنده با استفاده از Exchange Web Services و Aspose.Email ارسال کنیم.

یک درخواست جلسه با استفاده از کلاس Appointment ایجاد کنید و مکان، زمان و شرکت‌کنندگان را تنظیم کنید.
یک نمونه از کلاس MailMessage ایجاد کنید و تقویم را با استفاده از متد MailMessage.addAlternateView() تنظیم کنید.
به سرور Exchange متصل شوید و درخواست جلسه را با استفاده از متد send(MailMessage) ارسال کنید.

این EWSClient کلاس می‌تواند برای اتصال به سرورهای Exchange با پشتیبانی از Exchange Web Services (EWS) استفاده شود. برای کارکرد این، سرور باید Exchange Server 2007 یا بالاتر باشد. قطعه کد زیر نشان می‌دهد چگونه از EWS برای ارسال درخواست‌های جلسه استفاده کنید.

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

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

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

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

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

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

کار با موارد تقویم با استفاده از EWS

Aspose.Email امکان افزودن، به‌روزرسانی و لغو تقویم‌ها را با استفاده از کلاینت Exchange Web Service (EWS) فراهم می‌کند. IEWSClients createAppointment, updateAppointment، و cancelAppointment متدها امکان دستکاری موارد تقویم با استفاده از EWS را فراهم می‌کنند. این مقاله یک نمونه کد دقیق برای کار با موارد تقویم ارائه می‌دهد. قطعه کد زیر نشان می‌دهد چگونه:

یک قرار ملاقات ایجاد کنید.
به‌روزرسانی یک تقویم.
حذف/لغو یک تقویم.

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

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

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

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

برگرداندن موارد تقویم تکراری در بازهٔ تاریخی مشخص‌شده

Aspose.Email EWSClient از برگرداندن موارد تقویم تکراری در بازهٔ تعیین‌شده توسط StartDate و EndDate پشتیبانی می‌کند. AppointmentQueryBuilder.setCalendarView(Date startDate, Date endDate, int maxEntriesReturned) متد، در صورت مشخص شدن CalendarView، فهرستی از موارد تقویم تک و وقوع‌های موارد تقویم تکراری را در بازهٔ تعیین‌شده توسط StartDate و EndDate برمی‌گرداند. پارامتر maxEntriesReturned حداکثر تعداد نتایج را توصیف می‌کند. (مقدار <= 0 برای تمام نتایج).

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

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

لیست‌گذاری تقویم‌ها با پشتیبانی از صفحه‌بندی

متد ListAppointments ارائه‌شده توسط IEWSClient API فهرست کامل تقویم‌ها را از سرور Exchange دریافت می‌کند. اگر تعداد زیادی تقویم در سرور Exchange وجود داشته باشد ممکن است زمان ببرد. API متدهای overloaded زیر را ارائه می‌دهد. listAppointments متدی که پشتیبانی از صفحه‌بندی را به عملیات می‌دهد. این می‌تواند در ترکیب‌های مختلف با ویژگی جستجو نیز استفاده شود. متدهای overloaded زیر برای لیست کردن تقویم‌ها از سرور Exchange با پشتیبانی از صفحه‌بندی موجود هستند.

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

قطعه کد زیر نشان می‌دهد چگونه تقویم‌ها را با پشتیبانی از صفحه بندی لیست کنید.

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

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

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

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

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

افزودن رویداد به پوشهٔ تقویم ثانویه در سرور Exchange

API Aspose.Email به شما امکان می‌دهد یک پوشهٔ تقویم ثانویه را در سرور Exchange با استفاده از IEWSClient. سپس تقویم‌ها می‌توانند از تقویم ثانویه با استفاده از createAppointment, updateAppointment و cancelAppointment متدها. متدها و ویژگی‌های API زیر در نمونه‌های کد ارائه شده برای نمایش عملکرد این ویژگی استفاده می‌شوند. لطفاً توجه داشته باشید که این ویژگی از Aspose.Email برای Java نسخهٔ 6.5.0 به بعد پشتیبانی می‌شود.

متد IEWSClient.cancelAppointment(Appointment, String).
متد IEWSClient.cancelAppointment(String, String).
متد IEWSClient.createAppointment(Appointment, String).
متد IEWSClient.createFolder(String, String, ExchangeFolderPermissionCollection, String).
متد IEWSClient.fetchAppointment(String, String).
متد IEWSClient.updateAppointment(Appointment, String).
ویژگی IEWSClient.CurrentCalendarFolderUri.

قطعه کد زیر نشان می‌دهد چگونه یک رویداد را به پوشهٔ تقویم ثانویه در سرور Exchange اضافه کنید.

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

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

        String timeZone = "America/New_York";

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

به اشتراک‌گذاری دعوتنامه تقویم

سرور Microsoft Exchange امکان به اشتراک‌گذاری تقویم‌ها را با ارسال دعوتنامه‌های تقویم به کاربران دیگر که در همان سرور Exchange ثبت‌نام کرده‌اند، فراهم می‌کند. API Aspose.Email همین قابلیت را با اجازهٔ به اشتراک‌گذاری تقویم با استفاده از API EWS فراهم می‌سازد.

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

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

دریافت اطلاعات ویژگی‌های گسترده از موارد تقویم

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

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

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

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

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

Java: کار با تماس‌ها در سرور Exchange

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

حساب‌های Exchange Server بیشتر از پیام‌های ایمیل را نگهداری می‌کنند. همچنین دریافت, انتقال, ارسال و حذف پیام‌های ایمیل از سرورهای Exchange، Aspose.Email به شما امکان کار با مخاطبین را می‌دهد. این مقاله توضیح می‌دهد چگونه اطلاعات مخاطب را با استفاده از Exchange Web Services بازیابی کنید. همچنین نشان می‌دهد چگونه می‌توانید مخاطبین را از پوشه Contacts فهرست کنید یا مخاطبین را بر اساس نام مخاطب شناسایی کنید.

دریافت مخاطبین با EWS

Aspose.Email ارائه می‌دهد EWSClient کلاس برای اتصال به Microsoft Exchange Server با استفاده از Exchange Web Services. قطعه‌های کد زیر از Exchange Web Services برای خواندن تمام مخاطبین استفاده می‌کنند. قطعه کد زیر نشان می‌دهد چگونه مخاطبین را با EWS دریافت کنید.

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

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

شناسایی مخاطبین با استفاده از نام مخاطب

قطعه کد زیر نشان می‌دهد چگونه با استفاده از EWS مخاطبین را دریافت کنید

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

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

تشخیص قالب یادداشت‌های مخاطب

NotesFormat نوع قالب متنی یادداشت‌های مخاطب را که توسط شمارنده TextFormat تعریف شده است، مشخص می‌کند.

دریافت مخاطب با استفاده از شناسه

یک مخاطب خاص می‌تواند با استفاده از شناسهٔ مخاطب خود از سرور بازیابی شود همان‌طور که در نمونه کد زیر نشان داده شده است.

Contact fetchedContact = client.getContact(id);

افزودن مخاطبین

این EWSClient کلاس createContact() متد می‌تواند برای افزودن اطلاعات مخاطب به سرور Exchange استفاده شود. createContact() متد یک Contact شیء به‌عنوان پارامتر ورودی.

برای افزودن مخاطبین به سرور Exchange:

مقداردهی اولیه EWSClient با آدرس و اعتبارنامه‌ها.
شی Contact را با ویژگی‌های موردنظر مقداردهی کنید.
متد CreateContact را صدا بزنید تا مخاطب به سرور Exchange اضافه شود.

Aspose.Email ارائه می‌دهد EWSClient کلاس برای اتصال به Microsoft Exchange Server با استفاده از Exchange Web Services. قطعه کد نشان می‌دهد چگونه از Exchange Web Services برای افزودن مخاطبین به یک سرور Exchange استفاده کنید.

// 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 با استفاده از Exchange Web Service (EWS) به‌روزرسانی کند. IEWSClient’s updateContact() متد می‌تواند اطلاعات مخاطب را در سرور Exchange به‌روزرسانی کند.

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. این متد شناسه مخاطب را به‌عنوان پارامتر ورودی می‌گیرد.

برای حذف مخاطبین از یک سرور Exchange:

مقداردهی اولیه ExchangeWebServiceClient با آدرس و اعتبارنامه‌ها.
حذف یک مخاطب با استفاده از شناسه‌ آن.

قطعه‌های کد زیر نشان می‌دهند چگونه مخاطبین را از یک سرور Exchange با استفاده از Exchange Web Service حذف کنید.

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

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

}
client.dispose();

Java: کار با فهرست‌های توزیعی در Exchange Server

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

کار با لیست‌های توزیع

API Aspose.Email قابلیت ایجاد و خواندن لیست‌های توزیع را از سرور 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

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

فهرست تمام پوشه‌ها از سرور

API Aspose.Email امکان اتصال به Exchange Server و فهرست‌کردن تمام پوشه‌ها و زیرپوشه‌ها را فراهم می‌کند. همچنین می‌توانید تمام زیرپوشه‌ها را به‌صورت بازگشتی از هر پوشه دریافت کنید. این API قابلیت فهرست‌گذاری پوشه‌ها با صفحه‌بندی از کلاینت Exchange با استفاده از Exchange Web Service (EWS) را نیز دارد. این مقاله نشان می‌دهد چگونه تمام زیرپوشه‌ها را از سرور Exchange دریافت کرده و پوشه‌ها را با صفحه‌بندی دریافت کنید.

قطعه کد زیر نشان می‌دهد چگونه پوشه‌ها را از سرور Exchange فهرست کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() {
    try {
        IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
        System.out.println("Downloading all messages from Inbox....");

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

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

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

دریافت اطلاعات نوع پوشه با استفاده از EWS

این 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);
        }
    }
}

کپی یک پیام به پوشهٔ دیگر

API Aspose.Email امکان کپی کردن یک پیام از یک پوشه به پوشهٔ دیگر را با استفاده از 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());
}

همگام‌سازی موارد پوشه

APIهای Aspose.Email برای Java 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
}

ایجاد پوشه‌ها و زیرپوشه‌ها

API Aspose.Email قابلیت ایجاد پوشه‌ها در یک صندوق‌نامه Exchange را فراهم می‌کند. The CreateFolder متد IEWSClient می‌تواند برای این منظور استفاده شود. برای ایجاد یک پوشه در صندوق‌نامه سرور Exchange، می‌توان از مراحل زیر استفاده کرد.

یک نمونه از IEWSClient ایجاد کنید.
ویژگی UseSlashAsFolderSeparator را طبق نیاز تنظیم کنید. اگر به true تنظیم شود، برنامه «اسلش» را به‌ عنوان جداکننده پوشه در نظر می‌گیرد و زیرپوشه پس از اسلش ایجاد می‌شود.
از متد createFolder برای ایجاد پوشه استفاده کنید.

قطعه کد زیر نشان می‌دهد چگونه پوشه‌ها و زیرپوشه‌ها ایجاد کنید.

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

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

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

پشتیبان‌گیری از پوشه‌های Exchange به PST

اغلب کاربران ممکن است بخواهند از تمام یا برخی از پوشه‌های صندوق نامه یک نسخه پشتیبان بگیرند. Aspose.Email امکان پشتیبان‌گیری از تمام یا پوشه‌های صندوق‌نامه Exchange مشخص‌شده به یک فایل PST را فراهم می‌کند. این مقاله توضیح می‌دهد چگونه پوشه‌های Exchange را به PST با کد نمونه پشتیبان‌گیری کنید. برای پشتیبان‌گیری از پوشه‌های سرور Exchange، می‌توان مراحل زیر را دنبال کرد.

IEWSClient را با اعتبار کاربر مقداردهی اولیه کنید
اطلاعات پوشه مورد نیاز را به ExchangeFolderInfoCollection اضافه کنید
از روش پشتیبان‌گیری کلاینت برای استخراج محتویات پوشه به PST استفاده کنید

قطعه کد زیر نشان می‌دهد چگونه پوشه‌های Exchange را به PST پشتیبان‌گیری کنید.

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

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

Java: کار با قوانین در سرور Exchange

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

مدیریت قوانین

Aspose.Email for Java می‌تواند برای مدیریت قوانین در سرور Exchange با استفاده از EWSClient کلاس. این کلاس از Exchange Web Services (EWS) استفاده می‌کند که در Exchange Server 2007 و نسخه‌های بعدی در دسترس هستند. برای نشان دادن نحوه مدیریت قوانین، این مقاله توضیح می‌دهد چگونه:

خواندن قوانینی که قبلاً بر روی سرور هستند.
ایجاد یک قانون جدید.
به‌روزرسانی یک قانون موجود.

Microsoft Exchange Server 2010 Service Pack 1 برای تمام ویژگی‌های توصیف شده در این مقاله مورد نیاز است.

خواندن قوانین

برای دریافت تمام قوانین از سرور Exchange:

با استفاده از کلاس IEWSClient به سرور Exchange متصل شوید.
متد 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، مراحل زیر را انجام دهید:

با استفاده از کلاس IEWSClient به سرور Exchange متصل شوید.
یک نمونه جدید از کلاس 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:

با استفاده از کلاس IEWSClient به سرور Exchange متصل شوید.
متد IEWSClient.getInboxRules() را برای دریافت تمام قوانین فراخوانی کنید.
در یک حلقه foreach، تمام قوانین را مرور کرده و قانون موردنظر را با مطابقت نام نمایشی (DisplayName) در شرط بدست آورید.
به‌روز کردن ویژگی‌های قانون
متد IEWSClient.updateInboxRule() را برای به‌روز کردن قانون فراخوانی کنید.

قطعه کد زیر نشان می‌دهد چگونه یک قانون را به‌روز کنید.

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

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

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

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

Java: کار با وظایف در سرور Exchange

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

کار با وظایف

Aspose.Email از پردازش کارها روی Exchange با استفاده از ExchangeTask کلاس. ویژگی‌های مختلفی که توسط آن ارائه می‌شوند ExchangeTask, مانند Subject, وضعیت, تاریخ مهلت، و اولویت، می‌تواند برای پیکربندی وظیفه در Exchange استفاده شود. The EWSClient کلاس توابعی مانند را معرض می‌کند createTask, updateTask، و deleteTask که برای پردازش وظایف در Exchange استفاده می‌شوند. این مقاله نشان می‌دهد چگونه:

ایجاد یک وظیفه جدید.
تنظیم منطقه زمانی یک وظیفه.
به‌روزرسانی یک وظیفه.
حذف یک وظیفه.
ارسال درخواست وظیفه
ذخیرهٔ وظیفه در دیسک

ایجاد وظیفه جدید

قطعه کد زیر نشان می‌دهد چگونه یک وظیفهٔ جدید ایجاد کنید.

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

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

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

مشخص‌کردن منطقه زمانی

این IEWSClient رابط و ExchangeTask ویژگی TimeZoneId را برای تنظیم اطلاعات منطقه زمانی هنگام ایجاد یک وظیفه فراهم می‌کند. قطعه کد زیر نشان می‌دهد چگونه منطقه زمانی را مشخص کنید.

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

به‌روزرسانی وظیفه

قطعه کدهای زیر نشان می‌دهند چگونه یک وظیفه را در سرور Exchange به‌روزرسانی کنید.

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

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

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

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

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

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

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

حذف وظیفه

قطعه کد زیر نشان می‌دهد چگونه یک وظیفه را در سرور Exchange حذف کنید.

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

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

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

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

ارسال درخواست وظیفه

سرویس Aspose.Email Exchange امکان ارسال درخواست‌های وظیفه مشابه Outlook را فراهم می‌کند. قطعه کد زیر نشان می‌دهد چگونه یک پیام درخواست وظیفه را از دیسک بارگذاری کرده و با استفاده از آن ارسال کنید. IEWSClient.

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

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

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

ذخیرهٔ وظیفه در دیسک

Aspose.Email همچنین امکان ذخیرهٔ وظایف Exchange در دیسک به فرمت Outlook MSG را می‌دهد. قطعه کد زیر نشان می‌دهد چگونه یک وظیفه را در دیسک ذخیره کنید.

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

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

لیست‌گذاری وظایف از سرور Exchange

IEWSClient ارائه می‌دهد listTasks متدی که می‌تواند وظایف را از یک Exchange Web Service بازیابی کند. این متد چند overload دارد که می‌توان برای دریافت فهرست وظایف از یک پوشه خاص یا با استفاده از برخی معیارهای جستجو استفاده کرد. نمونه کد زیر بدست آوردن همه یا وظایف خاص از پوشه Tasks را نشان می‌دهد.

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

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

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

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

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

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

فیلتر کردن وظایف از سرور Exchange

Aspose.Email امکان بازیابی وظایف خاص از سرور را به جای دریافت تمام وظایف فراهم می‌کند. API می‌تواند وظایف را بر اساس وضعیت وظیفه مانند Completed، Deferred، In Progress، Not started یا Waiting on others بازیابی کند. ExchangeQueryBuilder کلاس می‌تواند برای تعیین معیار دلخواه با استفاده از ویژگی Status استفاده شود. همچنین امکان تعیین چندین شرط برای دریافت وظایف دلخواه از سرور Exchange را می‌دهد. این در نمونه کد زیر نشان داده شده است.

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

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

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

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

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

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

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

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

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

Java: کار با پیکربندی کاربر بر روی سرور

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

مدیریت پیکربندی کاربر

Aspose.Email برای Java می‌تواند برای مدیریت پیکربندی کاربر بر روی Exchange Server با استفاده از EWSClient کلاس. این کلاس از Exchange Web Services استفاده می‌کند که فقط در Exchange Server 2007 و نسخه‌های بعدی موجود است. در این مقاله، نحوهٔ خواندن، ایجاد، به‌روزرسانی و حذف پیکربندی‌های کاربر در Exchange Server 2010 را می‌بینیم. سرویس پک 1 Exchange Server 2010 برای تمام ویژگی‌های توضیح‌داده‌شده در این مقاله لازم است. قطعه کد زیر نشان می‌دهد چگونه در تمام مثال‌های این مقاله به 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() را صدا بزنید تا پیکربندی کاربر برای یک پوشه دریافت شود.
خواص پیکربندی کاربر مانند شناسه، نام و آیتم‌های دیکشنری را به صورت جفت کلید‑مقدار نمایش دهید.

قطعه کد زیر نشان می‌دهد چگونه پیکربندی کاربر را بخوانید.

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 (پاسخ/پاسخ به همه) و FW (انتقال) را از یک پیام منبع ایجاد کنند. پیام منبع با انتخاب یک 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

API Aspose.Email پشتیبانی از Exchange Web Service (EWS) با Office 365 را فراهم می‌کند. EWSClient رابط متدی overload ارائه می‌دهد که 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

API Aspose.Email امکان فراهم کردن قابلیت ثبت لاگ برای کلاینت Exchange Web Service را فراهم می‌کند.

ثبت لاگ برای کلاینت EWS

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

افزودن سرآیندها به درخواست‌های EWS

API Aspose.Email امکان افزودن سرآیندها به درخواست‌های Exchange را فراهم می‌کند. این می‌تواند برای افزودن سرآیندهای مختلف به درخواست‌های EWS برای مقاصد متفاوت استفاده شود. یکی از مثال‌ها افزودن سرآیند X-AnchorMailbox است که برای مدیریت مسائل محدودیت (throttling) در سرور Exchange استفاده می‌شود. متد addHeader از IEWSClient برای افزودن سرآیندها به درخواست‌های EWS همان‌طور که در قطعه کد زیر نشان داده شده استفاده می‌شود.

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

بازگرداندن شناسه درخواست کلاینت در سرآیند

این 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 بازیابی کند. پیام‌رسانی یکپارچه مانند دریافت اطلاعات پیکربندی، آغاز یک تماس خروجی، بازیابی اطلاعات تماس تلفنی بر اساس شناسه تماس و قطع تماس بر اساس شناسه در حال حاضر پشتیبانی می‌شود. نمونه کد زیر نشان می‌دهد چگونه اطلاعات پیکربندی پیام‌رسانی یکپارچه را از Microsoft Exchange Server 2010 بازیابی کنید.

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

دریافت نکات ایمیلی

Microsoft Exchange Server با نسخه‌های Exchange Server 2010 و 2013 چند قابلیت جدید افزود. یکی از این قابلیت‌ها به کاربران اجازه می‌دهد هنگام نوشتن ایمیل نکات ایمیلی (mail tips) دریافت کنند. این نکات بسیار مفید هستند زیرا پیش از ارسال ایمیل اطلاعاتی را ارائه می‌دهند. برای مثال، اگر آدرس ایمیل در فهرست گیرندگان اشتباه باشد، یک نکته نشان داده می‌شود تا شما بدانید آدرس ایمیل نامعتبر است. نکات ایمیلی همچنین به شما امکان می‌دهند پاسخ‌های خارج از دفتر را قبل از ارسال ایمیل ببینید: 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 برای کاربر ۱.
راه‌اندازی ExchangeWebServiceClient برای کاربر ۲.
اضافه کردن پیام‌های آزمایشی به حساب‌ها.
فعال‌سازی جابجایی هویت.
بازنشانی جابجایی هویت.

قطعه کد زیر نشان می‌دهد چگونه از 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) {
        }
    }
}

ویژگی کشف خودکار با استفاده از EWS

API Aspose.Email به شما امکان کشف تنظیمات سرور Exchange را با استفاده از کلاینت EWS می‌دهد.

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

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

لغو عملیات بازیابی PST به سرور Exchange

API Aspose.Email به شما امکان بازیابی یک فایل PST به سرور Exchange را می‌دهد. با این حال، اگر عملیات به دلیل حجم بزرگ فایل PST زمان زیادی ببرد، ممکن است نیاز به تعیین معیاری برای قطع عملیات باشد. این کار می‌تواند با استفاده از API همان‌طور که در کد نمونه زیر نشان داده شده انجام شود.

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

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

            processedItems.incrementAndGet();
        }
    };

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

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

Java: فیلتر کردن قرارها از سرور Exchange

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 آیتم‌های 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

بایگانی‌های در محل در Office 365

بایگانی‌های در محل در Office 365 فضای ذخیره‌سازی اضافی برای کاربران فراهم می‌کند. پس از فعال‌سازی صندوق‌های بایگانی، کاربران می‌توانند پیام‌ها را در صندوق بایگانی خود با استفاده از Microsoft Outlook و Outlook در وب دسترسی و ذخیره کنند. هنگامی که صندوق‌پستی با بایگانی در محل فعال با Outlook باز شود، صندوق بایگانی به‌عنوان یک صندوق‌پستی جداگانه نمایش داده می‌شود.

جابجایی آیتم‌ها به بایگانی در محل

API Aspose.Email می‌تواند برای جابجایی آیتم‌ها به صندوق بایگانی کاربران با استفاده از IEWSClient.archiveItem متد. IEWSClient.archiveItem متد چهار overload ارائه می‌دهد که در زیر فهرست شده‌اند.

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 اکنون با استفاده از SAAJ API از TLS 1.2 پشتیبانی می‌کند. The EWSClient یک ویژگی ایستاتیک فراهم می‌کند useSAAJAPI که می‌تواند برای استفاده از TLS 1.2 به true تنظیم شود. Aspose.Email for Java همچنین پشتیبانی می‌کند AutodiscoverService برای TLS 1.2. نمونه‌های کد زیر استفاده از SAAJ API و AutodiscoverService برای TLS 1.2.

استفاده از SAAJ API

کلاینت SOAP Java EE مورد استفاده در حالت 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، Authenticator جاوا مورد نیاز است.

قطعه کد احراز هویت NTLM برای Java 8:

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

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

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

static Authenticator getAuthenticator() {

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

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

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

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

    return endpoint;
}

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

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

از زمان Java 9، می‌توان Authenticator را برای اتصال تنظیم کرد:

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

            return connection;
        }
    });

    return endpoint;
}

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

نکته: APIهای JAXB به عنوان APIهای Java EE در نظر گرفته می‌شوند و بنابراین دیگر در مسیر کلاس پیش‌فرض Java SE 9 موجود نیستند.

وابستگی‌های Maven JAXB:

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

استفاده از AutodiscoverService

نمونه کد زیر استفاده از را نشان می‌دهد AutodiscoverService برای TLS 1.2

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