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

Java: Kết nối tới Exchange Server bằng WebDav

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

Aspose.Email cung cấp khả năng làm việc với Exchange 2003 và 2007 bằng giao thức WebDAV bằng cách cung cấp ExchangeClient lớp. Bài viết này cho thấy cách khởi tạo đối tượng của cả hai lớp và cùng một phương thức có thể được sử dụng trong tất cả các ví dụ tiếp theo trong hướng dẫn lập trình này.

Kết nối tới Exchange bằng ExchangeClient

Các mẫu mã sau mô tả việc viết một hàm tùy chỉnh có thể được gọi trong các đoạn mã để khởi tạo ExchangeClient, có thể được sử dụng để thực hiện các thao tác Exchange khác nhau.

Java: Xóa tin nhắn từ Exchange Server bằng WebDav

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

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

Mã mẫu dưới đây xóa một tin nhắn khỏi thư mục Inbox. Cho mục đích của 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.

Java: Lấy Tin Nhắn từ Hộp Thư Exchange Server bằng WebDav

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

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 lấy thông tin cơ bản về tin nhắn, ví dụ tiêu đề, Message ID, người gửi và người nhận.

Để lấy chi tiết tin nhắn đầy đủ, Aspose.Email.Exchange cung cấp ExchangeClient.fetchMessage() phương thức. 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.

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

Để lấy tin nhắn từ hộp thư Exchange Server:

Tạo một thể hiện của loại ExchangeClient.
Xác định tên máy chủ, tên người dùng, mật khẩu và miền.
Gọi listMessages phương thức để lấy ExchangeMessageInfoCollection.
Lặp qua ExchangeMessageInfoCollection bộ sưu tập để lấy ExchangeMessageInfo.getUniqueUri các giá trị.
Gọi ExchangeClient.fetchMessage() và truyền ExchangeMessageInfo.getUniqueUri làm tham số.

Đoạn mã sau kết nối tới hộp thư Exchange Server và lấy toàn bộ tin nhắn.

Java: Lọc Tin Nhắn từ Hộp Thư Exchange bằng WebDav

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

Cái ExchangeClient lớp cung cấp phương thức listMessages() để lấy tất cả tin nhắn từ hộp thư. Để chỉ lấy tin nhắn phù hợp với một số điều kiện, sử dụng phương thức listMessages() được overload, nhận MailQuery lớp như một đối số. MailQuery lớp cung cấp các thuộc tính đa dạng để chỉ định điều kiện, ví dụ ngày, tiêu đề, người gửi và người nhận. Thêm vào đó, API cũng cho phép áp dụng bộ lọc phân biệt hoa thường khi lấy email từ hộp thư.

Lọc Tin Nhắn bằng Web Dav

Để 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 ExchangeClient.listMessages(MailQuery query) và truyền MailQuery vào tham số để chỉ lấy các tin nhắn đã lọc.

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

ExchangeClient client = new ExchangeClient("http://MachineName/exchange/Username", "username", "password", "domain");
SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");

// Query building by means of ExchangeQueryBuilder class
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
// Subject contains "Newsletter"
builder.getSubject().contains("Newsletter");

// Emails that arrived today
try {
	builder.getInternalDate().on(sdf.parse("10/05/2016 10:00:00"));
} catch (ParseException e) {
	e.printStackTrace();
}

// Build the query
MailQuery query = builder.getQuery();

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

Lấy Tin Nhắn Đáp Ứng Tiêu Chí Cụ Thể

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.

Tiêu chí Lọc Ngày Hôm Nay

Đoạn mã dưới đây cho bạn thấy 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());

Tiêu chí Lọc Khoảng Thời Gian

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

MailQueryBuilder builder = new MailQueryBuilder();
builder.getInternalDate().beforeOrEqual(new Date());
builder.getInternalDate().since(new Date(new Date().getTime() + TimeUnit.DAYS.toDays(1)));

Tiêu chí Lọc 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ể.

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

Tiêu chí Lọc 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ể.

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

Tiêu chí Lọc 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ể.

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

Tiêu chí Lọc 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 builder1 = new ExchangeQueryBuilder();
builder1.getMessageId().equals("MessageID");

Tiêu chí Lọc 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
builder1 = new ExchangeQueryBuilder();
builder1.getContentClass().equals(ContentClassType.getMDN().toString());

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

Nếu các thuộc tính QueryBuilder khác nhau được thiết lập trong các câu lệnh riêng biệt, tất cả các điều kiện sẽ được khớp. Ví dụ, để lấy một tin nhắn trong một khoảng thời gian cụ thể và từ một máy chủ nhất định, viết ba câu lệnh:

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

MailQueryBuilder builder = new MailQueryBuilder();

// Emails from specific host
builder.getFrom().contains("SpecificHost.com");
// AND all emails that arrived before today
builder.getInternalDate().before(new Date());
// AND all emails that arrived since 7 days ago
builder.getInternalDate().since(new Date(new Date().getTime() + TimeUnit.DAYS.toDays(-7)));

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

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

MailQueryBuilder builder = new MailQueryBuilder();
		
// Specify OR condition
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 phân biệt hoa thường bằng cách chỉ định cờ IgnoreCase trong tiêu chí lọc như ví dụ dưới đây.

//IgnoreCase is True
MailQueryBuilder builder1 = new MailQueryBuilder();
builder1.getFrom().contains("tesT", true);
MailQuery query1 = builder1.getQuery();

Java: Lấy Thông tin Hộp thư bằng Client WebDav

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

Cái ExchangeClient 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 ExchangeClient.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 chỉ cách truy cập thông tin hộp thư trực tiếp từ Exchange Server.

Lấy Thông tin Hộp thư từ Exchange Server

Để lấy thông tin Hộp thư Exchange:

Tạo một đối tượng của ExchangeClient lớp.
Chỉ định Exchange Server, tên người dùng, mật khẩu và miền trong hàm khởi tạo ExchangeClient.
Gọi ExchangeClient.getMailboxSize() phương thức để lấy kích thước hộp thư.
Gọi ExchangeClient.getMailboxInfo phương thức để lấy một instance của ExchangeMailboxInfo lớp.
Lấy thông tin hộp thư bằng cách sử dụng ExchangeMailboxInfo các thuộc tính khác nhau của lớp.

Các đoạn mã mẫu dưới đây lấy thông tin hộp thư Exchange.

Java: Liệt kê Tin nhắn từ Exchange Server bằng WebDav

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

Danh sách các email trong hộp thư Exchange có thể được lấy bằng cách gọi ExchangeClient.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.

Bài viết này chỉ cách kết nối tới Exchange Server và liệt kê email trong hộp thư trực tiếp hoặc bằng WebDav. Nó cũng chỉ cách liệt kê tin nhắn từ các thư mục khác nhau và cách liệt kê tin nhắn theo ID.

Liệt kê Tin nhắn Exchange Server

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

Tạo một đối tượng của ExchangeClient lớp.
Gọi listMessages phương thức 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ã dưới đây kết nối tới hộp thư Exchange và lấy danh sách tin nhắn từ thư mục Inbox.

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ả tin nhắn trong thư mục Inbox. Cũng có thể lấy danh sách tin nhắn từ các thư mục khác. ExchangeClient.listMessages() phương thức nhận một URI thư mục làm tham số. Miễn là URI thư mục hợp lệ, bạn có thể lấy danh sách tin nhắn từ thư mục đó.

Sử dụng ExchangeClient.getMailboxInfo().xxxFolderUri thuộc tính để 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.

Java: Di chuyển Tin nhắn từ Thư mục này sang Thư mục khác bằng WebDav

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

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 ExchangeClient.moveMessage() 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

Mã mẫu dưới đây 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 thỏa điều kiện đã cho vào thư mục Processed.

Java: Đọc email từ hộp thư của người dùng khác bằng WebDav

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

Một số tài khoản trên máy chủ Exchange có quyền truy cập 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 một cơ chế để truy cập thư mục và email từ các hộp thư khác bằng ExchangeClient lớp.

Đoạn mã mẫu dưới đây minh họa cách sử dụng ExchangeClient lớp để truy cập một hộp thư khác.

Java: Lưu Tin Nhắn từ Hộp Thư Exchange Server bằng WebDav

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

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

Lưu Tin Nhắn từ Hộp Thư Exchange Server thành EML

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

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

Lưu Tin Nhắn vào OutputStream

Thay vì lưu tệp EML vào đĩa, có thể lưu nó vào OutputStream. Đ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.

Các đoạn mã dưới đây lưu tin nhắn từ hộp thư Exchange Server vào một luồng bộ nhớ.

Lưu tin nhắn ở định dạng MSG

Cái ExchangeClient.saveMessage() phương thức có thể trực tiếp lưu tin nhắn dưới định dạng EML. Để lưu tin nhắn dưới định dạng MSG, trước tiên, gọi ExchangeClient.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 thành MSG.

Đoạn mã dưới đây lấy tin nhắn từ hộp thư Exchange Server và lưu chúng ở định dạng MSG.

Java: Gửi Thư Email bằng Máy Chủ Exchange với WebDav

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

Bạn có thể gửi email bằng Exchange Server với sự trợ giúp của các công cụ trong com.aspose.email. ExchangeClient.send() phương thức nhận một MailMessage được truyền như tham số và gửi email. Bài viết này giải thích cách gửi email bằng Exchange Client của API.

Gửi Thư Email bằng Exchange WebDav

Để gửi email bằng máy chủ Exchange:

Tạo một đối tượng của ExchangeClient lớp.
Xác định tên máy chủ, tên người dùng, mật khẩu và miền.
Tạo một đối tượng của MailMessage lớp.
Xác định người gửi, người nhận, tiêu đề và các MailMessage các thuộc tính.
Gọi ExchangeClient.send() phương thức để gửi email.

Mã mẫu dưới đây gửi email bằng Exchange Server.

Java: Gửi Yêu cầu Họp với Exchange Server bằng WebDav

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

Bài viết này chỉ cách gửi yêu cầu họp tới nhiều người nhận bằng Microsoft Exchange Server và Aspose.Email. Nó cũng giải thích cách điều chỉnh mã để làm việc với Exchange Web Services.

Gửi Yêu Cầu Họp bằng Web Dav

Để gửi yêu cầu họp:

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

Ví dụ này sử dụng ExchangeClient lớp, sử dụng WebDAV giao thức để kết nối tới Exchange Server và có thể dùng với bất kỳ phiên bản Exchange Server nào có kích hoạt WebDAV, ví dụ Exchange 2000, 2003 hoặc 2007.

Các đoạn mã được dùng để gửi yêu cầu họp được đưa ra dưới đây:

Java: Làm việc với danh bạ trên Exchange Server bằng WebDav

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

Bài viết này giải thích cách lấy thông tin danh bạ trực tiếp từ Exchange Server. Bài viết này cũng cho thấy cách bạn có thể liệt kê danh bạ từ thư mục Contacts.

Lấy danh bạ từ Exchange Server

Cái ExchangeClient class’ listContacts() phương thức có thể được sử dụng để lấy thông tin danh bạ từ Exchange Server. listContacts() phương thức yêu cầu URI của thư mục Contacts, có thể dễ dàng lấy được bằng ExchangeMailboxInfo.ContactsUri thuộc tính.

Để lấy danh bạ từ Exchange Server:

Khởi tạo lớp ExchangeClient với địa chỉ và thông tin xác thực.
Lấy URI của thư mục Contacts bằng thuộc tính ExchangeClient.getMailboxInfo().getContactsUri().
Gọi phương thức listContacts(). Phương thức này trả về một mảng MapiContact.
Thực hiện vòng lặp foreach trên mảng MapiContact để đọc thông tin danh bạ.

Đoạn mã sau đây cho bạn thấy cách sử dụng ExchangeClient lớp để đọc tất cả danh bạ từ Exchange Server.

String mailboxURI = "http://ex2003/exchange/administrator"; // WebDAV
String username = "administrator";
String password = "pwd";
String domain = "domain.local";

// Credentials for connecting to Exchange Server
NetworkCredential credential = new NetworkCredential(username, password, domain);
ExchangeClient client = new ExchangeClient(mailboxURI, credential);

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

Java: Làm việc với thư mục trên WebDav

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. Bài viết này cho thấy cách lấy tất cả các thư mục con từ Exchange server và lấy các thư mục theo phân trang.

Sử dụng WebDav

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

public static void run() {
    try {
        ExchangeClient client = new ExchangeClient("http://ex07sp1/exchange/Administrator", "user", "pwd", "domain");
        System.out.println("Downloading all messages from Inbox....");

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

        System.out.println("All messages downloaded.");
    } catch (Exception ex) {
        System.err.println(ex);
    }
}

private static void listSubFolders(ExchangeClient client, ExchangeFolderInfo folderInfo) {
    System.out.println(folderInfo.getDisplayName());
    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ExchangeFolderInfoCollection folderInfoCollection = client.ListSubFolders(folderInfo.Uri);
        for (ExchangeFolderInfo subfolderInfo : folderInfoCollection) {
            listSubFolders(client, subfolderInfo);
        }
    } catch (Exception ex) {
        System.err.println(ex);
    }
}

Java: Hỗ trợ Ghi nhật ký trong Client WebDav

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

API Aspose.Email cung cấp khả năng cung cấp tiện ích ghi nhật ký cho client WebDav của các giao thức Exchange.

Ghi nhật ký cho Client WebDav

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