Documentation – Làm việc với Exchange EWS Client

Java: Kết nối tới Exchange Server

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

Để kết nối tới các máy chủ Exchange 2007, 2010 và 2013 bằng Exchange Web Service, Aspose.Email cung cấp IEWSClient giao diện triển khai EWSClient lớp. EWSClient.getEWSClient phương pháp tạo và trả về một IEWSClient đối tượng được sử dụng tiếp để thực hiện các thao tác liên quan tới hộp thư Exchange và các thư mục khác. Bài viết này chỉ ra cách tạo các đối tượng của IEWSClient.

Kết nối tới Exchange Server bằng EWS

Đoạn mã dưới đây cho bạn thấy cách kết nối bằng 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;
}

Kết nối tới Exchange Server bằng IMAP

Microsoft Exchange Server hỗ trợ giao thức IMAP để truy cập các mục trong hộp thư. Sử dụng Aspose.Email’s ImapClient lớp để kết nối tới Exchange Server bằng giao thức IMAP. Để biết thêm thông tin về ImapClient lớp. Đầu tiên, hãy chắc chắn rằng dịch vụ IMAP đã được bật cho Exchange Server của bạn:

Mở Bảng Điều Khiển.
Đi tới Công cụ Quản trị, sau đó Dịch vụ.
Kiểm tra trạng thái của dịch vụ Microsoft Exchange IMAP4.
Nếu nó chưa chạy, hãy bật/bắt đầu nó.

Đoạn mã dưới đây cho bạn thấy cách kết nối và liệt kê các tin nhắn từ thư mục Inbox của Microsoft Exchange Server bằng giao thức IMAP.

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

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

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

Đoạn mã dưới đây cho bạn thấy cách sử dụng 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();
}

Sau khi kết nối tới máy chủ Exchange bằng IMAP và nhận được IMapMessageInfoCollection, Đoạn mã dưới đây cho bạn thấy cách sử dụng MessageInfo số thứ tự của đối tượng để lưu một tin nhắn cụ thể.

// 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: Làm việc với Hộp thư và Tin nhắn Exchange - Đọc Email từ máy chủ Exchange bằng Java

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

Lấy Thông tin Hộp thư bằng EWS

Cái EWSClient lớp có các thành viên có thể được sử dụng để lấy thông tin hộp thư từ Exchange Server bằng cách gọi IEWSClient.getMailboxInfo() phương thức. Nó trả về một instance của kiểu ExchangeMailboxInfo. Lấy thông tin hộp thư từ các thuộc tính như MailboxUri, InboxUri và DraftsUri. Bài viết này cho biết cách truy cập thông tin hộp thư bằng Exchange Web Services.

Nếu bạn muốn kết nối tới máy chủ Exchange bằng Exchange Web Services (EWS), sử dụng EWSClient lớp. Lớp này sử dụng EWS để kết nối và quản lý các mục trên một máy chủ Exchange. Đoạn mã Java dưới đây cho thấy cách lấy thông tin hộp thư bằng dịch vụ web 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());

Gửi Tin nhắn Email

Bạn có thể gửi tin nhắn email bằng một máy chủ Exchange với sự trợ giúp của các công cụ trong Aspose.Email.Exchange. Phương thức IEWSClient.Send() nhận một MailMessage thể hiện làm tham số và gửi email. Bài viết này giải thích cách gửi tin nhắn email bằng Exchange Web Services.

Aspose.Email cung cấp lớp IEWSClient để kết nối tới Microsoft Exchange Server bằng Exchange Web Services. Đoạn mã dưới đây cho thấy cách sử dụng EWS để gửi email bằng Microsoft Exchange Server. Đoạn mã Java dưới đây cho thấy cách gửi tin nhắn email bằng 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);

Lấy Lớp Tin nhắn

Cái getMessageClass() phương thức của ExchangeMessageInfo lớp nhận một chuỗi đại diện cho lớp của tin nhắn. Đoạn mã mẫu dưới đây cho thấy cách lấy lớp tin nhắn:

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

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

Đọc Email từ Hộp thư của Người dùng Khác

Một số tài khoản trên máy chủ Exchange có quyền truy cập vào nhiều hộp thư, và một số người dùng có nhiều tài khoản email trên cùng một máy chủ Exchange. Trong cả hai trường hợp, người dùng có thể truy cập hộp thư của người dùng khác bằng Aspose.Email cho Java. API này cung cấp cơ chế để truy cập thư mục và email từ các hộp thư khác bằng IEWSClient lớp. Chức năng này có thể đạt được bằng cách sử dụng phiên bản overload của getMailboxInfo() phương thức và cung cấp địa chỉ email người dùng làm tham số.

Đoạn mã dưới đây cho thấy cách đọc email bằng IEWSClient lớp.

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

Liệt kê Tin nhắn

Danh sách các email trong hộp thư Exchange có thể được lấy bằng cách gọi IEWSClient.listMessages phương thức. Lấy thông tin cơ bản về tin nhắn, như tiêu đề, người gửi, người nhận và ID tin nhắn, bằng cách sử dụng listMessages phương thức.

Liệt kê Tin nhắn Đơn giản

Để liệt kê các tin nhắn trong hộp thư Exchange:

Tạo một đối tượng của IEWSClient lớp.
Gọi phương thức listMessages và tạo một bộ sưu tập tin nhắn.
Lặp qua bộ sưu tập và hiển thị thông tin tin nhắn.

Đoạn mã Java dưới đây cho thấy cách kết nối tới một máy chủ exchange bằng EWS và liệt kê tin nhắn từ thư mục 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());
}

Liệt kê Tin nhắn từ Các Thư mục Khác

Các đoạn mã trên, liệt kê tất cả các tin nhắn trong thư mục Hộp đến. Cũng có thể lấy danh sách tin nhắn từ các thư mục khác. The IEWSClient.listMessages() phương thức nhận một folder URI làm tham số. Miễn là folder URI hợp lệ, bạn có thể lấy danh sách tin nhắn từ thư mục đó. Sử dụng thuộc tính IEWSClient.getMailboxInfo().getXXXFolderUri để lấy URI của các thư mục khác nhau. Phần còn lại của mã giống như việc lấy danh sách tin nhắn. Đoạn mã dưới đây cho thấy cách liệt kê tin nhắn từ các thư mục khác nhau bằng 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);

Liệt kê Tin nhắn với Hỗ trợ Phân trang

Đoạn mã Java dưới đây cho thấy cách lấy danh sách tin nhắn có hỗ trợ phân trang.

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

Lấy Thông tin Loại Tin nhắn từ ExchangeMessageInfo

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

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

Lưu Tin nhắn

Bài viết này cho biết cách lấy tin nhắn từ hộp thư máy chủ Exchange và lưu chúng vào đĩa ở định dạng EML và MSG:

Lưu dưới dạng EML trên đĩa.
Lưu vào luồng bộ nhớ.
Lưu dưới dạng MSG.

Lưu Tin nhắn dưới dạng EML

Để lấy tin nhắn và lưu ở định dạng EML:

Tạo một thể hiện của lớp IEWSClient.
Cung cấp mailboxUri, tên người dùng, mật khẩu và miền.
Gọi phương thức IEWSClient.listMessages() để nhận một thể hiện của tập hợp ExchangeMessagesInfoCollection.
Duyệt qua tập hợp ExchangeMessagesInfoCollection để lấy URI duy nhất cho mỗi tin nhắn.
Gọi phương thức IEWSClient.saveMessage() và truyền URI duy nhất làm tham số.
Cung cấp cho phương thức saveMessage() một đường dẫn tới nơi bạn muốn lưu tệp.

Đoạn mã dưới đây cho thấy cách sử dụng EWS để kết nối tới máy chủ Exchange và lưu tin nhắn dưới dạng tệp 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");
}

Lưu Tin nhắn vào Luồng Bộ nhớ

Thay vì lưu các tệp EML vào đĩa, bạn có thể lưu chúng vào một luồng bộ nhớ. Điều này hữu ích khi bạn muốn lưu luồng vào một vị trí lưu trữ như cơ sở dữ liệu. Khi luồng đã được lưu vào cơ sở dữ liệu, bạn có thể tải lại tệp EML vào MailMessage lớp. Đoạn mã dưới đây cho thấy cách lưu tin nhắn từ hộp thư máy chủ Exchange vào một luồng bộ nhớ bằng 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);
}

Lưu Tin nhắn ở Định dạng MSG

Cái IEWSClient.saveMessage() phương thức có thể trực tiếp lưu tin nhắn dưới dạng EML. Để lưu tin nhắn dưới dạng MSG, trước tiên gọi IEWSClient.fetchMessage() phương thức trả về một thể hiện của MailMessage lớp. Sau đó gọi MailMessage.save() phương thức để lưu tin nhắn dưới dạng MSG. Đoạn mã dưới đây cho thấy cách lấy tin nhắn từ hộp thư máy chủ Exchange và lưu chúng ở định dạng MSG bằng EWS.

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

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

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

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

Lấy ExchangeMessageInfo từ URI của Tin nhắn

Một tin nhắn email được đại diện bằng định danh duy nhất, URI, và là phần không thể thiếu của ExchangeMessageInfo đối tượng. Trong trường hợp chỉ có URI của tin nhắn, thì ExchangeMessageInfo đối tượng cũng có thể được truy xuất bằng thông tin có sẵn này. Phiên bản overload của listMessages lấy một danh sách các Id để sử dụng ExchangeMessageInfoCollection. Đoạn mã dưới đây cho thấy cách lấy ExchangeMessageInfo từ URI của tin nhắn.

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

Lấy Tin Nhắn từ Hộp Thư Exchange Server

Liệt kê Tin Nhắn trên Exchange Server đã sử dụng listMessages() phương thức để lấy danh sách tin nhắn từ hộp thư Exchange Server. listMessages() phương thức nhận thông tin cơ bản về tin nhắn, ví dụ: tiêu đề, ID tin nhắn, người gửi và người nhận. Để nhận chi tiết đầy đủ của tin nhắn, Aspose.Email.Exchange cung cấp phương thức IEWSClient.fetchMessage(). Phương thức này nhận URI của tin nhắn làm tham số và trả về một thể hiện của MailMessage lớp. MailMessage lớp sau đó cung cấp chi tiết tin nhắn như nội dung, tiêu đề và tệp đính kèm. Tìm hiểu thêm về MailMessage API, hoặc tìm hiểu cách quản lý email với MailMessage lớp. Để lấy tin nhắn từ Hộp thư máy chủ Exchange:

Tạo một thể hiện của kiểu IEWSClient.
Chỉ định tên máy chủ, tên người dùng, mật khẩu và miền.
Gọi listMessages để lấy ExchangeMessageInfoCollection.
Duyệt qua tập hợp ExchangeMessageInfoCollection để lấy các giá trị ExchangeMessageInfo.UniqueURI.
Gọi IEWSClient.fetchMessage() và truyền ExchangeMessageInfo.UniqueURI làm tham số.

Đoạn mã dưới đây cho thấy bạn kết nối tới hộp thư máy chủ Exchange và lấy tất cả các tin nhắn bằng cách sử dụng 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());
    }
}

Sử dụng phương thức FetchItem để lấy một tin nhắn

Lưu ý, FetchItem phương thức trả về tin nhắn không có tệp đính kèm. Để lấy tin nhắn có tệp đính kèm, sử dụng FetchItem phương thức, được mô tả trong phần dưới đây.

Cái FetchItem phương pháp này được ưu tiên hơn nếu bạn muốn lấy một MapiMessage và thao tác với các thuộc tính MAPI. Bạn cũng có thể sử dụng phương pháp này để lấy bất kỳ mục Outlook nào, chẳng hạn như liên hệ, cuộc hẹn, công việc, v.v.

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

Lấy trước kích thước tin nhắn

Microsoft Outlook InterOp cung cấp tính năng lấy kích thước tin nhắn trước khi thực tế tải toàn bộ tin nhắn từ máy chủ. Trong trường hợp Aspose.Email API, thông tin tóm tắt được lấy từ máy chủ Exchange được biểu diễn bằng ExchangeMessageInfo lớp. Nó cung cấp cùng tính năng lấy kích thước tin nhắn bằng thuộc tính Size. Để lấy kích thước tin nhắn, cuộc gọi tiêu chuẩn tới listMessages của IEWSClient được sử dụng để lấy bộ sưu tập của ExchangeMessageInfo. Đoạn mã dưới đây cho bạn thấy cách hiển thị kích thước tin nhắn bằng cách sử dụng ExchangeMessageInfo lớp.

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

Tải tin nhắn đệ quy

Cái EWSClientcủa listSubFolders() phương pháp có thể được sử dụng để lấy tin nhắn từ các thư mục và thư mục con trong hộp thư của Exchange Server một cách đệ quy. Điều này yêu cầu Exchange Server 2007 trở lên, vì nó sử dụng EWS. Đoạn mã dưới đây cho bạn thấy cách tải xuống toàn bộ hộp thư (các thư mục và thư mục con) của một Exchange Server. Cấu trúc thư mục được tạo cục bộ và tất cả các tin nhắn được tải xuống.

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) {
    }
}

Tải xuống tin nhắn từ các thư mục công cộng

Microsoft Exchange Server cho phép người dùng tạo các thư mục công cộng và đăng tin nhắn vào chúng. Để thực hiện điều này qua ứng dụng của bạn, sử dụng Aspose.Email’s EWSClient lớp để kết nối tới Exchange Server và đọc và tải xuống các tin nhắn và bài đăng từ các thư mục công cộng. Đoạn mã dưới đây cho bạn thấy cách đọc tất cả các thư mục công cộng và các thư mục con, và liệt kê và tải xuống bất kỳ tin nhắn nào được tìm thấy trong các thư mục này. Ví dụ này chỉ hoạt động với Microsoft Exchange Server 2007 trở lên vì chỉ các phiên bản này hỗ trợ 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);
        }
    }
}

Di chuyển tin nhắn

Bạn có thể di chuyển email từ thư mục này sang thư mục khác bằng cách sử dụng IEWSClient lớp di chuyển phương thức. Nó nhận các tham số:

URI duy nhất của tin nhắn cần di chuyển.
URI duy nhất của thư mục đích.

Di chuyển tin nhắn giữa các thư mục

Đoạn mã dưới đây cho bạn thấy cách di chuyển một tin nhắn trong hộp thư từ thư mục Inbox sang thư mục có tên Processed. Trong ví dụ này, ứng dụng:

Đọc tin nhắn từ thư mục Inbox.
Xử lý một số tin nhắn dựa trên tiêu chí (trong ví dụ này, chúng tôi tìm một từ khóa trong tiêu đề tin nhắn).
Di chuyển các tin nhắn đáp ứng điều kiện đã cho vào thư mục đã xử lý.

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

Xóa tin nhắn

Bạn có thể xóa các tin email từ một thư mục bằng sự trợ giúp của IEWSClient lớp deleteItem phương thức. Nó nhận URI duy nhất của tin nhắn làm tham số.

Đoạn mã dưới đây cho thấy cách xóa một tin nhắn khỏi thư mục Inbox. Đối với ví dụ này, mã:

Đọc tin nhắn từ thư mục Inbox.
Xử lý tin nhắn dựa trên một số tiêu chí (trong ví dụ này, chúng tôi tìm một từ khóa trong tiêu đề tin nhắn).
Xóa tin nhắn.

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

Sao chép Tin nhắn

API Aspose.Email cho phép sao chép một tin nhắn từ thư mục này sang thư mục khác bằng cách sử dụng copyItem phương thức. Phiên bản overload của phương thức này trả về URI duy nhất của tin nhắn đã sao chép như được mô tả trong bài viết này.

Sao chép Tin nhắn tới Thư mục Khác

Đoạn mã dưới đây cho thấy cách sao chép một tin nhắn tới thư mục khác.

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: Lọc tin nhắn từ Hộp thư Exchange

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

Aspose.Email for Java cung cấp khả năng lọc tin nhắn từ Hộp thư Exchange bằng cách sử dụng EWSClient và ExchangeQueryBuilder. Tin nhắn có thể được lọc theo các tiêu chí khác nhau như theo ngày, miền, message-id và theo Thông báo Giao thư. Bài viết này cho thấy cách lọc tin nhắn từ Exchange Server bằng các tiêu chí khác nhau.

Lọc Tin nhắn bằng EWS

Cái IEWSClient class cung cấp listMessages() phương thức lấy tất cả tin nhắn từ hộp thư. Để chỉ lấy các tin nhắn khớp với một số điều kiện, hãy sử dụng phiên bản overload. listMessages() phương thức nhận vào MailQuery lớp như một đối số. MailQuery lớp cung cấp nhiều thuộc tính khác nhau để chỉ định các điều kiện, ví dụ: ngày, tiêu đề, người gửi và người nhận. Ngoài ra, API cũng cho phép áp dụng bộ lọc phân biệt chữ hoa/thường khi truy xuất email từ hộp thư.

Lọc Tin nhắn

Để lấy các tin nhắn đã lọc từ hộp thư:

Kết nối tới máy chủ Exchange.
Tạo một thể hiện của MailQuery và thiết lập các thuộc tính mong muốn.
Gọi phương thức IEWSClient.listMessages() và truyền MailQuery trong các tham số để chỉ lấy các tin nhắn đã lọc.

Đoạn mã sau đây cho bạn thấy cách kết nối tới hộp thư IMAP và lấy các tin nhắn có chuỗi "Newsletter" trong tiêu đề và được gửi hôm nay.

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

Lọc Tin nhắn theo Tiêu chí

Các mẫu mã trên lọc tin nhắn dựa trên tiêu đề và ngày của email. Chúng ta cũng có thể lọc theo các thuộc tính khác. Dưới đây là một số ví dụ về việc thiết lập điều kiện bằng cách sử dụng MailQuery.

Lọc Tin nhắn theo Ngày hôm nay

Đoạn mã sau đây cho bạn biết cách lọc tất cả email dựa trên ngày hôm nay.

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

Lọc Tin nhắn theo Khoảng ngày

Đoạn mã dưới đây cho bạn thấy cách lọc tất cả email dựa trên khoảng thời gian.

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

Lọc Tin nhắn theo Người gửi Cụ thể

Đoạn mã dưới đây cho bạn thấy cách lọc tất cả email dựa trên một người gửi cụ thể.

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

Lọc Tin nhắn theo Miền Cụ thể

Đoạn mã dưới đây cho bạn thấy cách lọc tất cả email dựa trên một miền cụ thể.

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

Lọc Tin nhắn theo Người nhận Cụ thể

Đoạn mã dưới đây cho bạn thấy cách lọc tất cả email dựa trên một người nhận cụ thể.

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

Lọc Tin nhắn theo MessageID

Đoạn mã dưới đây cho bạn thấy cách lọc tất cả email dựa trên MessageID.

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

Lọc Tin nhắn theo Tất cả Thông báo Giao thư

Đoạn mã dưới đây cho bạn thấy cách lọc tất cả email dựa trên tất cả các thông báo giao thư.

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

Lọc Tin nhắn theo Kích thước

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

Lọc Tin nhắn theo Giá trị Chuỗi

Đoạn mã sau đây cho bạn thấy cách lọc tất cả email dựa trên chuỗi được chỉ định trong các tiêu đề (subject, from, to, cc). The getText() phương thức trả về giá trị chuỗi cùng với phần thân của tin nhắn.

 ExchangeQueryBuilder builder = new ExchangeQueryBuilder();

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

MailQuery query = builder.getQuery();

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

Lọc Tin nhắn theo Thứ tự Tăng/Giảm

Aspose.Email cung cấp ComparisonField.orderBy(boolean ascending) phương thức thiết lập giá trị cho biết client sử dụng sắp xếp tăng hoặc giảm trên trường tìm kiếm. Nó cho phép bạn sắp xếp email theo thứ tự tăng/giảm dựa trên tiêu chí được chỉ định bởi MailQueryBuilder.

Đoạn mã dưới đây minh họa cách lọc tin nhắn theo thứ tự tăng/giảm:

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

Xây Dựng Truy Vấn Phức Tạp

Nếu khác MailQueryBuilder các thuộc tính được đặt trong một câu lệnh riêng, tất cả các điều kiện sẽ được khớp. Ví dụ, để lấy một tin trong một khoảng ngày cụ thể và từ một host nhất định, viết ba câu lệnh:

Kết Hợp Truy Vấn với AND

Đoạn mã sau cho bạn thấy cách Kết hợp Truy vấn với 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());

Kết Hợp Truy Vấn với OR

MailQueryBuilder cung cấp or() phương thức nhận hai MailQuery các thể hiện làm tham số. Nó lấy các tin nhắn khớp bất kỳ một trong hai điều kiện được chỉ định. Ví dụ dưới đây lọc tin nhắn có từ "test" trong tiêu đề hoặc "noreply@host.com" là người gửi. Đoạn mã sau cho bạn thấy cách kết hợp các truy vấn bằng OR.

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

Lọc Email Phân Biệt Hoa Thường

Email có thể được lọc dựa trên việc phân biệt chữ hoa chữ thường bằng cách chỉ định cờ IgnoreCase trong tiêu chí lọc như trong đoạn mã sau.

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

Lọc Tin nhắn với Hỗ trợ Phân trang

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: Quản Lý Các Mục Cuộc Trò Chuyện

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

Aspose.Email cho Java có thể được sử dụng để quản lý các mục cuộc trò chuyện trên Exchange Server với EWSClient lớp. Lớp này sử dụng Exchange Web Services, chỉ có sẵn trong Exchange Server 2007 và các phiên bản sau. Bài viết này cho thấy cách tìm, sao chép, di chuyển và xóa các mục cuộc trò chuyện trên Exchange Server 2010. Microsoft Exchange Server 2010 Service Pack 1 là bắt buộc cho tất cả các tính năng được bao gồm trong phần này.

Tìm Kiếm Các Cuộc Trò Chuyện

Để lấy thông tin cuộc trò chuyện từ một thư mục cụ thể trên Exchange Server:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.findConversations() để tìm tất cả các mục cuộc trò chuyện từ một thư mục.
Hiển thị các thuộc tính của mục cuộc trò chuyện như ID, chủ đề cuộc trò chuyện và trạng thái cờ.

Đoạn mã sau cho bạn thấy cách tìm các cuộc trò chuyện.

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

Sao Chép Các Cuộc Trò Chuyện

Để sao chép các cuộc trò chuyện từ thư mục này sang thư mục khác:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.copyConversationItems() để sao chép mục cuộc trò chuyện từ thư mục nguồn tới thư mục đích.

Đoạn mã sau cho bạn thấy cách sao chép các cuộc trò chuyện.

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

Di Chuyển Các Cuộc Trò Chuyện

Để di chuyển các cuộc trò chuyện từ thư mục này sang thư mục khác:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.moveConversationItems() để di chuyển một cuộc trò chuyện từ thư mục nguồn tới thư mục đích.

Đoạn mã sau cho bạn thấy cách di chuyển các cuộc trò chuyện.

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

Xóa Các Cuộc Trò Chuyện

Để xóa các cuộc trò chuyện từ một thư mục:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.deleteConversationItems() để xóa mục cuộc trò chuyện từ thư mục nguồn.

Đoạn mã sau cho bạn thấy cách xóa các cuộc trò chuyện.

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: Làm việc với các mục Lịch trên máy chủ Exchange

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

Gửi Yêu cầu Họp

Bài viết này cho thấy cách gửi yêu cầu họp tới nhiều người nhận bằng Exchange Web Services và Aspose.Email.

Tạo một yêu cầu họp bằng lớp Appointment và đặt vị trí, thời gian và người tham dự.
Tạo một thể hiện của lớp MailMessage và đặt cuộc hẹn bằng phương thức MailMessage.addAlternateView().
Kết nối tới máy chủ Exchange và gửi yêu cầu họp bằng phương thức send(MailMessage).

Cái EWSClient lớp có thể được sử dụng để kết nối tới máy chủ Exchange có hỗ trợ Exchange Web Services (EWS). Để hoạt động, máy chủ phải là Exchange Server 2007 hoặc mới hơn. Đoạn mã sau đây cho bạn thấy cách sử dụng EWS để gửi yêu cầu họp.

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

Làm việc với các mục Lịch bằng EWS

Aspose.Email cung cấp khả năng thêm, cập nhật và hủy cuộc hẹn bằng cách sử dụng client Exchange Web Service (EWS). Các IEWSClients createAppointment, updateAppointment, và cancelAppointment các phương thức cho phép thao tác các mục lịch bằng EWS. Bài viết này cung cấp mẫu mã chi tiết về làm việc với các mục Lịch. Mẫu mã dưới đây cho thấy cách thực hiện:

Tạo một cuộc hẹn.
Cập nhật một cuộc hẹn.
Xóa/Hủy một cuộc hẹn.

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

Trả về các mục Lịch định kỳ trong Khoảng ngày được chỉ định

Aspose.Email EWSClient hỗ trợ trả về các mục lịch định kỳ trong phạm vi được chỉ định bởi StartDate và EndDate. The AppointmentQueryBuilder.setCalendarView(Date startDate, Date endDate, int maxEntriesReturned) phương thức, nếu CalendarView được chỉ định, trả về danh sách các mục lịch đơn lẻ và các lần xuất hiện của các mục lịch định kỳ trong phạm vi được xác định bởi StartDate và EndDate. Tham số maxEntriesReturned mô tả số kết quả tối đa. (Giá trị <= 0 cho tất cả kết quả).

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

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

Liệt kê Cuộc hẹn với Hỗ trợ Phân trang

Phương thức ListAppointments được cung cấp bởi IEWSClient API truy xuất danh sách đầy đủ các cuộc hẹn từ máy chủ Exchange. Điều này có thể mất thời gian nếu có số lượng lớn các cuộc hẹn trên máy chủ Exchange. API cung cấp các phương thức overload của listAppointments phương thức cung cấp hỗ trợ phân trang cho thao tác. Điều này cũng có thể được sử dụng trong các kết hợp khác nhau với tính năng truy vấn. Các phương thức overload sau đây có sẵn để liệt kê các cuộc hẹn từ máy chủ Exchange với hỗ trợ Phân trang.

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

Đoạn mã sau đây cho bạn thấy cách liệt kê các cuộc hẹn với hỗ trợ phân trang.

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

Thêm Sự kiện vào Thư mục Lịch phụ trên máy chủ Exchange

API Aspose.Email cho phép bạn tạo một thư mục Lịch phụ trên máy chủ Exchange bằng cách sử dụng IEWSClient. Các cuộc hẹn sau đó có thể được thêm, cập nhật hoặc hủy từ lịch phụ bằng cách sử dụng createAppointment, updateAppointment và cancelAppointment các phương thức. Các phương thức và thuộc tính API sau được sử dụng trong các mẫu mã dưới đây để minh họa chức năng của tính năng này. Lưu ý rằng tính năng này được hỗ trợ bởi Aspose.Email cho Java từ phiên bản 6.5.0 trở lên.

Phương thức IEWSClient.cancelAppointment(Appointment, String).
Phương thức IEWSClient.cancelAppointment(String, String).
Phương thức IEWSClient.createAppointment(Appointment, String).
Phương thức IEWSClient.createFolder(String, String, ExchangeFolderPermissionCollection, String).
Phương thức IEWSClient.fetchAppointment(String, String).
Phương thức IEWSClient.updateAppointment(Appointment, String).
Thuộc tính IEWSClient.CurrentCalendarFolderUri.

Đoạn mã sau đây cho bạn thấy cách thêm một sự kiện vào thư mục lịch phụ trên máy chủ 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();
}

Chia sẻ Lời mời Lịch

Máy chủ Microsoft Exchange cung cấp khả năng chia sẻ lịch bằng cách gửi lời mời lịch cho những người dùng khác, đã đăng ký trên cùng một máy chủ Exchange. API Aspose.Email cung cấp cùng khả năng này bằng cách cho phép chia sẻ lịch sử dụng 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();
}

Truy xuất Thông tin Thuộc tính Mở rộng từ các mục Lịch

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: Làm việc với Danh bạ trên Exchange Server

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

Các tài khoản Exchange Server chứa nhiều hơn chỉ các tin nhắn email. Ngoài ra còn có lấy, di chuyển, gửi và xóa tin nhắn email từ các máy chủ Exchange, Aspose.Email cho phép bạn làm việc với danh bạ. Bài viết này giải thích cách truy xuất thông tin danh bạ bằng Exchange Web Services. Bài viết này cũng chỉ ra cách bạn có thể liệt kê danh bạ từ thư mục Contacts hoặc tìm kiếm danh bạ dựa trên tên danh bạ.

Lấy danh bạ bằng EWS

Aspose.Email cung cấp EWSClient lớp để kết nối tới Microsoft Exchange Server bằng Exchange Web Services. Các đoạn mã sau sử dụng Exchange Web Services để đọc tất cả danh bạ. Đoạn mã dưới đây cho bạn thấy cách lấy Contacts với 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());
}

Xác định danh bạ bằng tên danh bạ

Đoạn mã dưới đây cho bạn thấy cách sử dụng get contacts với 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());
}

Xác định định dạng ghi chú của danh bạ

NotesFormat xác định kiểu định dạng văn bản ghi chú của danh bạ được định nghĩa bởi bộ liệt kê TextFormat.

Lấy danh bạ bằng Id

Một danh bạ cụ thể có thể được truy xuất từ máy chủ bằng ID của nó như được minh hoạ trong đoạn mã mẫu dưới đây.

Contact fetchedContact = client.getContact(id);

Thêm danh bạ

Cái EWSClient lớp createContact() phương pháp có thể được sử dụng để thêm thông tin Contact vào Exchange Server. createContact() phương pháp nhận một Contact đối tượng làm tham số đầu vào.

Để thêm danh bạ vào Exchange Server:

Khởi tạo EWSClient với địa chỉ và thông tin xác thực.
Khởi tạo đối tượng Contact với các thuộc tính mong muốn.
Gọi phương thức CreateContact để thêm danh bạ vào Exchange Server.

Aspose.Email cung cấp EWSClient lớp để kết nối tới Microsoft Exchange Server bằng Exchange Web Services. Đoạn mã cho bạn thấy cách sử dụng Exchange Web Services để thêm danh bạ vào Exchange Server.

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

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

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

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

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

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

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

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

Cập nhật danh bạ

Thông tin danh bạ có thể được cập nhật bằng Microsoft Outlook. Aspose.Email cũng có thể cập nhật thông tin danh bạ trên Exchange Server bằng Exchange Web Service (EWS). của IEWSClient updateContact() phương pháp có thể cập nhật thông tin danh bạ trên Exchange Server.

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

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

Xóa danh bạ

Cái EWSClient class cung cấp deleteItem để truy cập và xóa danh bạ từ thư mục contacts của Exchange Server. Phương pháp này nhận ID của danh bạ làm tham số đầu vào.

Để xóa danh bạ khỏi Exchange Server:

Khởi tạo ExchangeWebServiceClient với địa chỉ và thông tin xác thực.
Xóa một danh bạ bằng ID của nó.

Đoạn mã dưới đây cho bạn thấy cách xóa danh bạ từ máy chủ Exchange bằng cách sử dụng 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: Làm việc với Danh Sách Phân Phối trên Exchange Server

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

Làm việc với Danh sách Phân phối

Aspose.Email API cung cấp khả năng tạo và đọc danh sách phân phối từ máy chủ Exchange. Danh sách phân phối có thể được tạo trên máy chủ cũng như có thể thêm thành viên vào nó bằng cách sử dụng IEWSClient. Bài viết này cho thấy cách làm việc với danh sách phân phối trên máy chủ Exchange.

Tạo Danh sách Phân phối

Đoạn mã sau cho bạn thấy cách tạo một danh sách phân phối.

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

Lấy Danh sách Phân phối Riêng tư

Đoạn mã sau cho bạn thấy cách lấy danh sách phân phối riêng tư.

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

Mở rộng Danh sách Phân phối Công cộng

Đoạn mã sau cho bạn thấy cách mở rộng Danh sách Phân phối công cộng.

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

Thêm thành viên

Thêm thành viên vào Danh sách Phân phối Riêng tư

Đoạn mã sau cho bạn thấy cách thêm thành viên vào một danh sách phân phối riêng tư.

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

Thêm thành viên mà không liệt kê

Đoạn mã sau cho bạn thấy cách thêm thành viên mà không liệt kê.

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

Gửi tới Danh sách Phân phối Riêng tư

Đoạn mã sau cho bạn thấy cách gửi tin nhắn tới một danh sách phân phối riêng tư.

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

Xóa thành viên

Xóa thành viên khỏi Danh sách Phân phối Riêng tư

Đoạn mã sau cho bạn thấy cách xóa các thành viên khỏi một danh sách phân phối riêng tư.

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

Xóa thành viên mà không liệt kê

Đoạn mã sau cho bạn thấy cách xóa các thành viên mà không liệt kê.

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

Xóa Danh sách Phân phối Riêng tư

Đoạn mã sau cho bạn thấy cách xóa một danh sách phân phối riêng tư.

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

Xóa mà không liệt kê

Đoạn mã sau cho bạn thấy cách xóa mà không cần liệt kê.

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: Làm việc với Thư mục trên Exchange Server

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

Liệt kê tất cả các thư mục từ máy chủ

API Aspose.Email cung cấp khả năng kết nối tới Exchange Server và liệt kê tất cả các thư mục và thư mục con. Bạn cũng có thể lấy tất cả các thư mục con từ mỗi thư mục một cách đệ quy. Nó cũng cung cấp khả năng liệt kê thư mục với phân trang từ client Exchange sử dụng Exchange Web Service (EWS). Bài viết này cho thấy cách lấy tất cả các thư mục con từ máy chủ Exchange và lấy thư mục với phân trang.

Đoạn mã sau đây cho bạn thấy cách liệt kê các thư mục từ Exchange Server.

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

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

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

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

Lấy Thông Tin Loại Thư Mục bằng EWS

Cái FolderType thuộc tính được cung cấp bởi ExchangeFolderInfo lớp có thể được sử dụng để lấy thông tin về loại của thư mục. Như được trình bày trong mẫu mã dưới đây.

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

Liệt Kê Thư Mục với Hỗ Trợ Phân Trang bằng EWS

Đoạn mã sau cho bạn thấy cách sử dụng hỗ trợ phân trang bằng 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());
}

Truy Cập Các Thư Mục Tùy Chỉnh hoặc Thư Mục Con của Hộp Thư

IEWSClient cho phép các nhà phát triển truy cập bất kỳ thư mục tùy chỉnh hoặc thư mục con nào từ hộp thư. The folderExists() chức năng của IEWSClient trả về URI của một thư mục/tư mục con tùy chỉnh được chỉ định, có thể được sử dụng để truy cập thư mục mục tiêu. Trong ví dụ sau, một thư mục tùy chỉnh có tên "TestInbox", được tạo dưới INBOX, được truy cập và tất cả các tin nhắn được hiển thị từ thư mục tùy chỉnh này. Để thực hiện nhiệm vụ này, các bước sau đây sẽ được thực hiện:

Khởi tạo đối tượng IEWSClient bằng cách cung cấp thông tin đăng nhập hợp lệ.
Truy cập hộp thư mặc định.
Truy cập thư mục cha, trong ví dụ này là INBOX. Thư mục cha này cũng có thể là một thư mục tùy chỉnh.
Sử dụng folderExists() để tìm kiếm thư mục con tùy chỉnh được chỉ định, ví dụ "TestInbox". Nó sẽ trả về URI của "TestInbox".
Sử dụng Uri này để truy cập tất cả các tin nhắn trong thư mục tùy chỉnh đó.

Đoạn mã sau cho bạn thấy cách truy cập các thư mục tùy chỉnh hoặc thư mục con của hộp thư với 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.");
}

Liệt Kê Các Thư Mục Công Cộng

Microsoft Exchange Server cho phép người dùng tạo các thư mục công cộng và đăng tin nhắn vào chúng. Để thực hiện điều này qua ứng dụng của bạn, sử dụng Aspose.Email’s EWSClient lớp để kết nối tới Exchange Server và đọc, tải xuống các tin nhắn và bài đăng từ các thư mục công cộng. Đoạn mã sau cho bạn thấy cách đọc tất cả các thư mục công cộng, các thư mục con, và liệt kê và tải xuống bất kỳ tin nhắn nào được tìm thấy trong các thư mục này. Ví dụ này chỉ hoạt động với Microsoft Exchange Server 2007 trở lên vì chỉ các phiên bản này hỗ trợ 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);
        }
    }
}

Sao Chép Tin Nhắn tới Thư Mục Khác

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

Đồng Bộ Các Mục Thư Mục

API Aspose.Email cho Java IEWSClient cung cấp tính năng đồng bộ một thư mục Exchange cho nội dung của nó. The syncFolder phương thức được cung cấp bởi IEWSClient lớp có thể được sử dụng để thực hiện đồng bộ thông tin thư mục trên một thư mục được chỉ định. Đoạn mã sau cho bạn thấy cách đồng bộ thông tin thư mục 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);

Lấy Quyền cho Các Thư Mục Exchange

Người dùng được gán quyền cho các thư mục công cộng trên Exchange Server, điều này giới hạn/định rõ mức độ truy cập của người dùng vào những thư mục này. The ExchangeFolderPermission lớp cung cấp một tập hợp các thuộc tính quyền cho các thư mục Exchange như PermissionLevel, liệu họ có thể canCreateItems, deleteItems, và thực hiện các tác vụ khác theo các thuộc tính quyền. Các quyền có thể được lấy bằng cách sử dụng getFolderPermissions() phương thức của IEWSClient. Bài viết này cho thấy cách lấy các quyền đã áp dụng cho một thư mục công cộng cho tất cả người dùng có quyền truy cập vào các thư mục được chia sẻ.

Để thực hiện nhiệm vụ này:

Khởi tạo EWSClient.
Sử dụng listPublicFolders để lấy danh sách tất cả các thư mục công cộng
Lấy các quyền liên quan đến một thư mục bằng cách sử dụng phương thức getFolderPermissions()

Đoạn mã sau cho bạn thấy cách sử dụng EWSClient lớp để lấy quyền đã áp dụng cho một thư mục.

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
}

Tạo Thư Mục và Thư Mục Con

API Aspose.Email cung cấp khả năng tạo thư mục trong hộp thư Exchange. CreateFolder phương thức của IEWSClient có thể được sử dụng cho mục đích này. Để tạo một thư mục trong hộp thư Exchange server, có thể thực hiện các bước sau.

Tạo một thể hiện của IEWSClient.
Thiết lập thuộc tính UseSlashAsFolderSeparator theo yêu cầu. Nếu đặt thành true, ứng dụng sẽ xem "Slash" là dấu phân tách thư mục và thư mục con sẽ được tạo sau dấu gạch chéo.
Sử dụng phương thức createFolder để tạo thư mục.

Đoạn mã sau đây cho bạn thấy cách tạo các thư mục và thư mục con.

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

Sao lưu Thư mục Exchange sang PST

Thường thì người dùng có thể muốn sao lưu tất cả hoặc một phần các thư mục hộp thư. Aspose.Email cung cấp khả năng sao lưu tất cả hoặc các thư mục hộp thư Exchange đã chỉ định sang PST. Bài viết này mô tả việc sao lưu các thư mục Exchange sang PST với mã mẫu. Để sao lưu các thư mục trên máy chủ Exchange, có thể thực hiện các bước sau.

Khởi tạo IEWSClient với thông tin xác thực người dùng
Thêm thông tin thư mục cần thiết vào ExchangeFolderInfoCollection
Sử dụng phương pháp sao lưu của client để xuất nội dung thư mục sang PST

Đoạn mã sau đây cho bạn thấy cách sao lưu các thư mục exchange sang 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: Làm việc với Quy tắc trên Exchange Server

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

Quản lý Quy tắc

Aspose.Email cho Java có thể được sử dụng để quản lý các quy tắc trên Exchange Server bằng cách sử dụng EWSClient lớp. Lớp này sử dụng Exchange Web Services (EWS), có sẵn trong Exchange Server 2007 và các phiên bản sau. Để minh họa cách quản lý quy tắc, bài viết này giải thích cách:

Đọc các quy tắc đã có trên máy chủ.
Tạo một quy tắc mới.
Cập nhật một quy tắc hiện có.

Microsoft Exchange Server 2010 Service Pack 1 là yêu cầu cho tất cả các tính năng được mô tả trong bài viết này.

Đọc Quy tắc

Để lấy tất cả các quy tắc từ Exchange Server:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.getInboxRules() để lấy mọi quy tắc.
Trong một vòng lặp foreach, duyệt qua mọi quy tắc và hiển thị các thuộc tính của quy tắc như điều kiện, hành động và tên.

Đoạn mã sau đây cho bạn thấy cách đọc các quy tắc.

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

Tạo một Quy tắc Mới

Để tạo một quy tắc mới trên Exchange Server, thực hiện các bước sau:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Tạo một thể hiện mới của lớp InboxRule và thiết lập các thuộc tính bắt buộc sau:
1. Tên hiển thị
2. Điều kiện
3. Hành động
Gọi phương thức IEWSClient.createInboxRule() để tạo quy tắc.

Đoạn mã sau đây cho bạn thấy cách tạo một quy tắc mới.

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

Cập nhật một Quy tắc

Để cập nhật một quy tắc trên Exchange Server:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.getInboxRules() để lấy mọi quy tắc.
Trong một vòng lặp foreach, duyệt qua tất cả các quy tắc và lấy quy tắc bạn muốn thay đổi bằng cách khớp DisplayName trong một điều kiện.
Cập nhật các thuộc tính của quy tắc
Gọi phương thức IEWSClient.updateInboxRule() để cập nhật quy tắc.

Đoạn mã sau đây cho bạn thấy cách cập nhật một quy tắc.

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: Làm việc với Nhiệm vụ trên máy chủ Exchange

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

Làm việc với các tác vụ

Aspose.Email hỗ trợ xử lý tác vụ trên Exchange bằng cách sử dụng ExchangeTask lớp. Các thuộc tính khác nhau được lộ ra bởi ExchangeTask, giống như Tiêu đề, Trạng thái, Ngày đến hạn, và Ưu tiên, có thể được sử dụng để cấu hình nhiệm vụ trên Exchange. The EWSClient lớp công khai các hàm như createTask, updateTask, và deleteTask được sử dụng để xử lý nhiệm vụ trên Exchange. Bài viết này cho biết cách:

Tạo một nhiệm vụ mới.
Đặt múi giờ cho nhiệm vụ.
Cập nhật một nhiệm vụ.
Xóa một nhiệm vụ.
Gửi Yêu cầu Nhiệm vụ
Lưu Nhiệm vụ vào Đĩa

Tạo Nhiệm vụ Mới

Đoạn mã sau đây cho bạn thấy cách tạo một nhiệm vụ mới.

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

Chỉ định Múi giờ

Cái IEWSClient giao diện và ExchangeTask cung cấp thuộc tính TimeZoneId để đặt thông tin múi giờ khi tạo nhiệm vụ. Đoạn mã sau đây cho bạn thấy cách chỉ định múi giờ.

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

Cập nhật Nhiệm vụ

Các đoạn mã sau đây cho thấy cách cập nhật một nhiệm vụ trên máy chủ 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);
}

Xóa Nhiệm vụ

Đoạn mã sau đây cho bạn thấy cách xóa một nhiệm vụ trên máy chủ 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());
    }
}

Gửi Yêu cầu Nhiệm vụ

Dịch vụ Aspose.Email Exchange cung cấp khả năng gửi yêu cầu nhiệm vụ tương tự Outlook. Đoạn mã sau đây cho bạn thấy cách tải tin nhắn yêu cầu nhiệm vụ từ đĩa và gửi nó bằng cách sử dụng 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);

Lưu Nhiệm vụ vào Đĩa

Aspose.Email cũng cho phép lưu Nhiệm vụ Exchange vào đĩa ở định dạng Outlook MSG. Đoạn mã sau đây cho bạn thấy cách lưu một nhiệm vụ vào đĩa.

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

Liệt kê Nhiệm vụ từ máy chủ Exchange

IEWSClient cung cấp listTasks phương thức có thể được sử dụng để lấy các nhiệm vụ từ Exchange Web Service. Nó có một số overload cho phép truy xuất danh sách nhiệm vụ từ một thư mục cụ thể hoặc bằng một số tiêu chí tìm kiếm. Mẫu mã dưới đây minh họa việc lấy toàn bộ hoặc các nhiệm vụ cụ thể từ thư mục 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());
}

Lọc Nhiệm vụ từ máy chủ Exchange

Aspose.Email cung cấp khả năng truy xuất các nhiệm vụ cụ thể từ máy chủ thay vì truy xuất toàn bộ nhiệm vụ. API có thể được sử dụng để lấy nhiệm vụ theo trạng thái như Completed, Deferred, In Progress, Not started hoặc Waiting on others. The ExchangeQueryBuilder lớp có thể được sử dụng để chỉ định tiêu chí mong muốn bằng thuộc tính Status. Nó cũng cho phép chỉ định nhiều điều kiện để truy xuất các nhiệm vụ mong muốn từ máy chủ Exchange. Điều này được minh họa bằng mẫu mã sau.

// 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: Làm việc với Cấu Hình Người Dùng trên Máy Chủ

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

Quản Lý Cấu Hình Người Dùng

Aspose.Email cho Java có thể được sử dụng để quản lý cấu hình người dùng trên Exchange Server với EWSClient lớp. Lớp này sử dụng Exchange Web Services, chỉ có sẵn trong Exchange Server 2007 và các phiên bản sau. Trong bài viết này, chúng ta sẽ xem cách đọc, tạo, cập nhật và xóa cấu hình người dùng trên Exchange Server 2010. Microsoft Exchange Server 2010 Service Pack 1 là bắt buộc cho tất cả các tính năng được mô tả trong bài viết. Đoạn mã sau cho bạn thấy cách kết nối tới Exchange Server 2010 trong tất cả các ví dụ của bài viết.

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

Đọc Cấu Hình Người Dùng

Để lấy thông tin cấu hình người dùng của một thư mục cụ thể từ Exchange Server:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.getUserConfiguration() để lấy cấu hình người dùng cho một thư mục.
Hiển thị các thuộc tính cấu hình người dùng như ID, tên và các mục từ điển dưới dạng cặp khóa-giá trị.

Đoạn mã sau cho bạn thấy cách đọc cấu hình người dùng.

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

Tạo Cấu Hình Người Dùng

Để tạo cấu hình người dùng cho một thư mục cụ thể trên Exchange Server:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.createUserConfiguration() để tạo cấu hình người dùng cho một thư mục.

Đoạn mã sau cho bạn thấy cách tạo cấu hình người dùng.

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

Cập Nhật Cấu Hình Người Dùng

Để cập nhật cấu hình người dùng cho một thư mục cụ thể trong Exchange Server:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.updateUserConfiguration() để cập nhật cấu hình người dùng cho một thư mục.

Đoạn mã sau cho bạn thấy cách cập nhật cấu hình người dùng.

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

Xóa Cấu Hình Người Dùng

Để xóa cấu hình người dùng cho một thư mục cụ thể trong Exchange Server:

Kết nối tới Exchange Server bằng lớp IEWSClient.
Gọi phương thức IEWSClient.deleteUserConfiguration() để xóa cấu hình người dùng cho một thư mục.

Đoạn mã sau cho bạn thấy cách xóa cấu hình người dùng.

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: Tính năng tiện ích

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

Gửi tin với tùy chọn Bình chọn

Microsoft Outlook cho phép người dùng tạo một cuộc thăm dò khi soạn tin mới. Điều này được thực hiện bằng cách bao gồm các tùy chọn bình chọn như Có, Không, Có thể, v.v. Lớp FollowUpOptions được Aspose.Email cung cấp, có thuộc tính VotingButtons cho phép đặt hoặc lấy giá trị các tùy chọn bình chọn. Bài viết này đưa ra ví dụ chi tiết về việc tạo MapiMessage với các tùy chọn bình chọn để tạo một cuộc thăm dò và sau đó gửi tin bằng client Exchange Web Service (EWS).

Tạo và Gửi tin với tùy chọn Bình chọn

Đoạn mã sau cho bạn thấy cách tạo một tin mới và sau đó gửi nó kèm tùy chọn bình chọn.

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

Các phương thức mẫu trong ví dụ

Đoạn mã sau cho bạn thấy cách sử dụng các phương thức được dùng trong ví dụ trên.

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

Tạo tin RE và FW từ tệp MSG

IEWSClient cho phép các nhà phát triển tạo tin RE (Reply/Reply All) và FW (Forward) từ một tin nguồn. Tin nguồn được xác định bằng cách chọn một ExchangeMessageInfo từ ExchangeMessageInfoCollection được lấy bởi IEWSClient.listMessages(). Tham số khác là thực tế MailMessage để gửi như tin RE hoặc FW. Đoạn mã sau cho bạn thấy cách tạo một tài khoản mẫu được dùng để gửi tin và sau đó các tính năng Trả lời và Chuyển tiếp tin được minh họa với tin mẫu đó. Để thực hiện nhiệm vụ này:

Khởi tạo đối tượng IEWSClient bằng cách cung cấp thông tin đăng nhập hợp lệ.
Gửi một vài tin nhắn mẫu.
Gọi các hàm IEWSClient.reply(), IEWSClient.replyAll() và IEWSClient.forward() để gửi tin nhắn.

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

Hỗ trợ OAuth cho EWS với Office 365

Aspose.Email API cung cấp hỗ trợ cho Exchange Web Service (EWS) với Office 365. API’s EWSClient giao diện cung cấp phương thức overload cung cấp OAuthNetworkCredential được sử dụng làm đầu vào để truy cập tài khoản Exchange qua OAuth. Người dùng cần cung cấp Authority, Client Id, Client App Uri và các tham số Resource để hoạt động. Đoạn mã sau cho thấy Hỗ trợ OAuth cho EWS với 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();

Hỗ trợ Ghi log trong Client Exchange

Aspose.Email API cung cấp khả năng cung cấp tiện ích ghi log cho client Exchange Web Service.

Ghi log cho EWS Client

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

Thêm Header trong Yêu cầu EWS

Aspose.Email API cho phép thêm header vào các yêu cầu Exchange. Điều này có thể được dùng để thêm header vào các yêu cầu EWS cho các mục đích khác nhau. Một ví dụ là thêm header X-AnchorMailbox được sử dụng để quản lý các vấn đề throttling trên máy chủ Exchange. Phương thức addHeader của IEWSClient được dùng để thêm header vào các yêu cầu EWS như trong đoạn mã sau.

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

Trả về ID Yêu cầu Client trong Header

Cái return-client-request-id header được gửi trong yêu cầu và được server sử dụng để xác định liệu client-request-id header được client chỉ định nên được trả về trong phản hồi của server. Các phương thức sau được sử dụng trong thao tác này:

getReturnClientRequestId()
setReturnClientRequestId(boolean value) - Lấy hoặc đặt cờ để chỉ ra liệu client có yêu cầu phía server trả về ID yêu cầu hay không.

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

Làm việc với Nhắn tin Thống nhất

Aspose.Email có thể lấy thông tin nhắn thống nhất từ Exchange Server 2010. Nhắn tin thống nhất như lấy thông tin cấu hình, khởi tạo cuộc gọi đi, lấy thông tin cuộc gọi theo ID và ngắt cuộc gọi theo ID hiện đang được hỗ trợ. Đoạn mã mẫu dưới đây cho thấy cách lấy thông tin cấu hình nhắn tin thống nhất từ Microsoft Exchange Server 2010.

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

Nhận Lời khuyên Email

Microsoft Exchange Server đã thêm một số tính năng mới với Exchange Server 2010 và 2013. Một trong số đó cho phép người dùng nhận lời khuyên email khi soạn tin. Những lời khuyên này rất hữu ích vì chúng cung cấp thông tin trước khi email được gửi. Ví dụ, nếu địa chỉ email trong danh sách người nhận sai, một lời khuyên sẽ hiển thị để thông báo rằng địa chỉ email không hợp lệ. Lời khuyên email cũng cho phép bạn xem các phản hồi ngoài giờ làm việc trước khi gửi email: Exchange Server (2010 & 2013) gửi lời khuyên khi email đang được soạn nếu một hoặc nhiều người nhận đã thiết lập phản hồi ngoài giờ. Service Pack 1 cho Microsoft Exchange Server 2010 là yêu cầu cho tất cả các tính năng được trình bày trong bài viết này. Đoạn mã sau cho bạn thấy cách sử dụng EWSClient lớp sử dụng Exchange Web Services, có sẵn trong Microsoft Exchange Server 2007 và các phiên bản sau.

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

Mạo danh Exchange

Mạo danh Exchange cho phép ai đó mạo danh tài khoản khác và thực hiện các nhiệm vụ và thao tác bằng quyền của tài khoản đã mạo danh thay vì quyền của mình. Trong khi ủy quyền cho phép người dùng hành động thay mặt người khác, Mạo danh cho phép họ hành động như người dùng khác. Aspose.Email hỗ trợ Mạo danh Exchange. The EWSClient lớp cung cấp các phương thức ImpersonateUser và ResetImpersonation để hỗ trợ tính năng này.

Để thực hiện nhiệm vụ này:

Khởi tạo ExchangeWebServiceClient cho người dùng 1.
Khởi tạo ExchangeWebServiceClient cho người dùng 2.
Thêm các tin nhắn thử nghiệm vào các tài khoản.
Bật Mạo danh.
Đặt lại Mạo danh.

Đoạn mã sau cho bạn thấy cách sử dụng EWSClient lớp để triển khai tính năng Mạo danh.

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

Tính năng Tự động Khám phá bằng EWS

Aspose.Email API cho phép bạn khám phá các thiết lập của Exchange Server bằng cách sử dụng EWS Client.

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

Hủy Khôi phục PST tới Exchange Server

Aspose.Email API cho phép bạn khôi phục tệp PST vào Exchange Server. Tuy nhiên, nếu thao tác mất nhiều thời gian do kích thước PST lớn, có thể cần chỉ định tiêu chí để hủy bỏ thao tác. Điều này có thể thực hiện bằng API như trong đoạn mã mẫu dưới đây.

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: Lọc các cuộc hẹn từ Exchange Server

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

Lọc các cuộc hẹn với EWS

Cái IEWSClient cung cấp khả năng lọc các cuộc hẹn từ Exchange server bằng cách sử dụng ExchangeQueryBuilder. Các cuộc hẹn có thể được lọc dựa trên:

Ngày
Các lần lặp lại

Lọc các cuộc hẹn theo ngày

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

Lọc các cuộc hẹn theo sự kiện lặp lại

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

Java: Làm việc với Thuộc tính Mở rộng của các mục Exchange

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

Aspose.Email API cho phép bạn tạo, truy xuất và cập nhật các thuộc tính mở rộng của tin nhắn bằng cách sử dụng client EWS của API. Đoạn mẫu mã dưới đây minh họa điều này bằng cách tạo một thuộc tính mở rộng, thêm nó vào tin nhắn trên máy chủ và truy xuất tin nhắn như MapiMessage từ máy chủ Exchange bằng cách sử dụng client của 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: Làm việc với Lưu trữ tại chỗ

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

Lưu trữ tại chỗ trong Office 365

Lưu trữ tại chỗ trong Office 365 cung cấp cho người dùng không gian lưu trữ bổ sung. Sau khi bật hộp thư lưu trữ, người dùng có thể truy cập và lưu trữ tin nhắn trong Hộp thư Lưu trữ bằng Microsoft Outlook và Outlook trên Web. Khi hộp thư đã bật lưu trữ tại chỗ được mở bằng Outlook, hộp thư lưu trữ sẽ hiển thị như một hộp thư riêng biệt.

Di chuyển các mục vào Lưu trữ tại chỗ

Aspose.Email API có thể được dùng để di chuyển các mục vào hộp thư lưu trữ của người dùng bằng cách sử dụng IEWSClient.archiveItem phương thức. IEWSClient.archiveItem phương thức cung cấp bốn overload được liệt kê dưới đây.

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

Ví dụ mã dưới đây minh họa việc sử dụng IEWSClient.archiveItem phương thức để di chuyển email tới Hộp thư Lưu trữ bằng cách sử dụng 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: Lấy tin nhắn từ Hộp thư chung

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

Aspose.Email hỗ trợ truy cập tin nhắn từ hộp thư chung. Để đạt được điều này, bạn kết nối tới hộp thư chính của mình bằng cách sử dụng EWSClient lớp. Để truy cập tin nhắn từ hộp thư chung, bạn truyền hộp thư chung dưới dạng tham số chuỗi tới listMessages hoặc listItems phương thức.

Đoạn mã mẫu dưới đây cho thấy cách truy cập tin nhắn từ hộp thư chung bằng cách sử dụng listItems phương thức.

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: Hỗ trợ TLS 1.2 và AutodiscoverService

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

Aspose.Email cho Java hiện hỗ trợ TLS 1.2 bằng cách sử dụng SAAJ API. EWSClient cung cấp một thuộc tính tĩnh useSAAJAPI có thể được đặt thành true để sử dụng TLS 1.2. Aspose.Email cho Java cũng hỗ trợ AutodiscoverService cho TLS 1.2. Các mẫu mã sau đây minh họa việc sử dụng SAAJ API và AutodiscoverService cho TLS 1.2.

Sử dụng SAAJ API

Java EE SOAP Client được sử dụng với chế độ SAAJAPI - https://docs.oracle.com/cd/E19651-01/817-2151-10/wsgjaxm.html.

Mẫu mã sau đây minh họa việc sử dụng SAAJ API bằng cách thiết lập EWSClient.useSAAJAPI thuộc tính thành true.

Trong đoạn mã tiếp theo, tiêu đề xác thực Basic sẽ được gán:

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

Trong đoạn mã tiếp theo, tiêu đề xác thực OAUTH2 sẽ được gán:

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

Lưu ý rằng trong chế độ này, API không kiểm soát quá trình xác thực NTLM. Java Authenticator là cần thiết cho việc xác thực NTLM.

Đoạn mã xác thực NTLM cho 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"));

Kể từ Java 9, Authenticator có thể được thiết lập cho kết nối:

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

Lưu ý: Các API JAXB được coi là API Java EE, do đó không còn có trong đường dẫn lớp mặc định trong Java SE 9.

Các phụ thuộc 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>

Sử dụng AutodiscoverService

Mẫu mã sau đây minh họa việc sử dụng AutodiscoverService cho TLS 1.2

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