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

Java: Kết nối tới máy chủ IMAP

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

Cái ImapClient lớp cho phép các ứng dụng quản lý hộp thư IMAP bằng giao thức IMAP. ImapClient lớp được sử dụng để kết nối tới máy chủ thư IMAP và quản lý email trong các thư mục email IMAP. Để kết nối tới máy chủ IMAP

Tạo một đối tượng của ImapClient lớp.
Xác định tên máy, tên người dùng và mật khẩu trong ImapClient constructor.

Khi ImapClient phiên bản được khởi tạo, lần gọi tiếp theo tới bất kỳ thao tác nào sử dụng phiên bản này sẽ kết nối tới máy chủ. Đoạn mã sau cho bạn thấy cách kết nối tới máy chủ IMAP bằng các bước trên.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

Kết nối với máy chủ IMAP hỗ trợ SSL

Kết nối với máy chủ IMAP mô tả cách kết nối tới máy chủ IMAP trong bốn bước đơn giản:

Tạo một đối tượng của ImapClient lớp.
Xác định tên máy, tên người dùng và mật khẩu.
Xác định cổng.
Chỉ định Các tùy chọn bảo mật.

Quá trình kết nối tới máy chủ IMAP hỗ trợ SSL tương tự nhưng yêu cầu bạn đặt một vài thuộc tính khác:

Thiết lập Các tùy chọn bảo mật đến SSLImplicit.

Đoạn mã sau cho thấy cách

Đặt tên người dùng, mật khẩu và cổng.
Đặt tùy chọn bảo mật.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of the ImapClient class
ImapClient client = new ImapClient("imap.domain.com", 993, "user@domain.com", "pwd");

// Set the security mode to implicit
client.setSecurityOptions(SecurityOptions.SSLImplicit);

Kết nối tới Máy chủ qua Proxy

Các máy chủ proxy thường được dùng để giao tiếp với bên ngoài. Trong các trường hợp như vậy, các khách hàng email không thể giao tiếp qua Internet nếu không chỉ định địa chỉ proxy. Aspose.Email hỗ trợ các phiên bản 4, 4a và 5 của giao thức proxy SOCKS. Bài viết này cung cấp một mẫu thực tế về cách truy cập hộp thư bằng máy chủ proxy. Để truy cập hộp thư qua máy chủ proxy:

Khởi tạo SocksProxy với thông tin cần thiết, bao gồm địa chỉ proxy, cổng và phiên bản SOCKS.
Khởi tạo ImapClient với địa chỉ host, tên người dùng, mật khẩu và bất kỳ cài đặt nào khác.
Thiết lập máy khách SocksProxy thuộc tính cho SocksProxy đối tượng được tạo ở trên.

Đoạn mã sau cho bạn thấy cách truy xuất hộp thư qua máy chủ proxy.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP and set SecurityOptions
ImapClient client = new ImapClient("imap.domain.com", "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);

String proxyAddress = "192.168.203.142"; // proxy address
int proxyPort = 1080; // proxy port
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);

// Set the proxy
client.setProxy(proxy);

try {
    client.selectFolder("Inbox");
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Kết nối tới máy chủ qua HTTP Proxy

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
HttpProxy proxy = new HttpProxy("18.222.124.59", 8080);
final ImapClient client = new ImapClient("imap.domain.com", "username", "password");
try {
    client.setProxy(proxy);
    client.selectFolder("Inbox");
} finally {
    if (client != null)
        client.dispose();
}

Tùy chỉnh Cơ chế Xác thực

Lấy danh sách các cơ chế xác thực được máy chủ IMAP hỗ trợ bằng cách sử dụng getSupportedAuthentication phương thức của ImapClient lớp. Phương thức này cho phép client xác định những phương thức xác thực nào có sẵn để thiết lập kết nối bảo mật với máy chủ. Sau đó, bằng cách sử dụng setAllowedAuthentication phương thức lấy (hoặc đặt) danh sách các kiểu xác thực mà người dùng cho phép, chọn cơ chế xác thực phù hợp nhất cho giao tiếp client‑server. Điều này cho phép bạn đặt phương thức xác thực cho client mail một cách rõ ràng.

Đoạn mã mẫu dưới đây cho thấy cách tùy chỉnh xác thực client email:

imapClient.setAllowedAuthentication(ImapKnownAuthenticationType.Plain);

Kết nối tới máy chủ ở chế độ chỉ đọc

Cái ImapClient lớp cung cấp một ReadOnly thuộc tính khi được đặt thành true, chỉ ra rằng không nên thay đổi trạng thái cố định của hộp thư. Mẫu mã sau minh họa việc sử dụng ImapClient.ReadOnly thuộc tính. Nó lấy số lượng tin nhắn chưa đọc, sau đó lấy một tin nhắn và lại lấy số lượng tin nhắn chưa đọc trong chế độ chỉ đọc. Số lượng tin nhắn chưa đọc vẫn giữ nguyên cho thấy trạng thái cố định của hộp thư không bị thay đổi.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapQueryBuilder imapQueryBuilder = new ImapQueryBuilder();
imapQueryBuilder.hasNoFlags(ImapMessageFlags.isRead()); /* get unread messages. */
MailQuery query = imapQueryBuilder.getQuery();

imapClient.setReadOnly(true);
imapClient.selectFolder("Inbox");
ImapMessageInfoCollection messageInfoCol = imapClient.listMessages(query);
System.out.println("Initial Unread Count: " + messageInfoCol.size());
if (messageInfoCol.size() > 0) {
    imapClient.fetchMessage(messageInfoCol.get_Item(0).getSequenceNumber());

    messageInfoCol = imapClient.listMessages(query);
    // This count will be equal to the initial count
    System.out.println("Updated Unread Count: " + messageInfoCol.size());
} else {
    System.out.println("No unread messages found");
}

Sử dụng xác thực CRAM-MD5 để Kết nối tới Máy chủ

Để đảm bảo xác thực và giao tiếp an toàn với máy chủ IMAP, bạn có thể chỉ định và buộc sử dụng CRAM-MD5 làm phương thức xác thực cho phép cho máy khách IMAP. Đoạn mã sau cho thấy cách cấu hình kiểu xác thực cho phép cho ImapClient:

imapClient.setAllowedAuthentication(ImapKnownAuthenticationType.CramMD5);

Xác Thực Thông Tin Đăng Nhập Máy Chủ Mail mà Không Gửi Email

Đôi khi cần xác minh thông tin đăng nhập mà không gửi email. Aspose.Email cung cấp validateCredentials() phương thức thực hiện thao tác này. Nếu việc xác thực thành công, đoạn mã bên trong câu lệnh if sẽ được thực thi, thường được dùng để thực hiện các hành động tiếp theo hoặc lấy dữ liệu từ máy chủ IMAP. Đoạn mã sau minh họa việc xác thực thông tin đăng nhập mà không gửi email:

try (ImapClient imapClient = new ImapClient(
        server.ImapUrl, server.ImapPort, "username", "password", SecurityOptions.Auto)) {
    imapClient.setTimeout(4000);

    if (imapClient.validateCredentials()) {
        // to do something
    }
}

Cách Đặt Thời Gian Chờ cho Các Thao Tác Mail

Mỗi thao tác mail mất một khoảng thời gian tùy thuộc vào nhiều yếu tố (độ trễ mạng, kích thước dữ liệu, hiệu suất máy chủ, v.v.). Bạn có thể đặt thời gian chờ cho tất cả các thao tác mail. Ví dụ mã dưới đây cho bạn thấy cách thực hiện điều đó bằng cách sử dụng Thời gian chờ thuộc tính. Lưu ý: bạn không nên đặt giá trị quá lớn để tránh thời gian chờ lâu trong ứng dụng của bạn.

try (ImapClient imapClient = new ImapClient("host", 993, "username", "password", SecurityOptions.SSLImplicit))
{
    imapClient.setTimeout(60000); // 60 seconds

    // some code...
}

Cách hạn chế thời gian chờ Greeting

Máy khách IMAP có thể sử dụng chế độ tự động để thiết lập kết nối. Trong chế độ này, máy khách IMAP sẽ thử tất cả các tham số kết nối có thể cho đến khi kết nối được thiết lập. Một máy chủ IMAP trong trường hợp kết nối đúng sẽ gửi một chuỗi chào tới máy khách. Các máy chủ có thể sử dụng khởi tạo kết nối SSL/TLS ngầm định hoặc rõ ràng (START TLS). Nếu chế độ kết nối không khớp (ví dụ, máy chủ chờ một kết nối SSL ngầm định nhưng máy khách cố gắng thiết lập một kết nối không bảo mật hoặc SSL rõ ràng), máy chủ sẽ không gửi chuỗi chào và người dùng sẽ phải chờ lâu cho đến khi hết thời gian chờ và máy khách chuyển sang tùy chọn kết nối tiếp theo. Để tránh vấn đề này, đã giới thiệu thuộc tính GreetingTimeout. Thuộc tính này cho phép bạn đặt thời gian chờ cho chuỗi chào, giảm thời gian thiết lập kết nối tự động.

ImapClient imapClient = new ImapClient();
imapClient.setGreetingTimeout(4000);

Java: Làm việc với Tin nhắn từ máy chủ IMAP

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

Liệt kê ID tin nhắn MIME từ máy chủ

ImapMessageInfo cung cấp MIME MessageId để xác định tin nhắn mà không cần trích xuất toàn bộ tin nhắn. Đoạn mã sau cho bạn thấy cách liệt kê MIME messageId.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient client = new ImapClient();
client.setHost("domain.com");
client.setUsername("username");
client.setPassword("password");

try {
    ImapMessageInfoCollection messageInfoCol = client.listMessages("Inbox");
    for (ImapMessageInfo info : messageInfoCol) {
        // Display MIME Message ID
        System.out.println("Message Id = " + info.getMessageId());
    }
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Liệt kê Tin nhắn từ Máy chủ

Aspose.Email cung cấp một phiên bản overload 2 thành phần của listMessages() để truy xuất một số lượng tin nhắn xác định dựa trên truy vấn. Đoạn mã sau cho bạn thấy cách liệt kê tin nhắn.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

// Select the inbox folder and Get the message info collection
ImapQueryBuilder builder = new ImapQueryBuilder();
MailQuery query = builder
        .or(builder.or(builder.or(builder.or(builder.getSubject().contains(" (1) "), builder.getSubject().contains(" (2) ")), builder.getSubject().contains(" (3) ")),
                builder.getSubject().contains(" (4) ")), builder.getSubject().contains(" (5) "));
ImapMessageInfoCollection messageInfoCol4 = client.listMessages(query, 4);
System.out.println((messageInfoCol4.size() == 4) ? "Success" : "Failure");

Liệt kê Tin nhắn từ Máy chủ Đệ quy

Giao thức IMAP hỗ trợ việc liệt kê tin nhắn đệ quy từ một thư mục hộp thư. Điều này cũng giúp liệt kê tin nhắn từ các thư mục con. Đoạn mã sau cho bạn thấy cách liệt kê tin nhắn một cách đệ quy.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an imapclient with host, user and password
ImapClient client = new ImapClient();
client.setHost("domain.com");
client.setUsername("username");
client.setPassword("password");
client.selectFolder("InBox");
ImapMessageInfoCollection msgsColl = client.listMessages(true);
System.out.println("Total Messages: " + msgsColl.size());

Liệt kê Tin nhắn với MultiConnection

ImapClient cung cấp một UseMultiConnection thuộc tính có thể được sử dụng để tạo nhiều kết nối cho các thao tác nặng. Bạn cũng có thể đặt số lượng kết nối sẽ được sử dụng trong chế độ đa kết nối bằng cách sử dụng ImapClient.ConnectionsQuantity. Đoạn mã sau minh họa việc sử dụng chế độ đa kết nối để liệt kê tin nhắn và so sánh hiệu năng của nó với chế độ kết nối đơn.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

imapClient.selectFolder("Inbox");
imapClient.setConnectionsQuantity(5);
imapClient.setUseMultiConnection(MultiConnectionMode.Enable);
long multiConnectionModeStartTime = System.currentTimeMillis();
ImapMessageInfoCollection messageInfoCol1 = imapClient.listMessages(true);
long multiConnectionModeTimeSpan = System.currentTimeMillis() - multiConnectionModeStartTime;

imapClient.setUseMultiConnection(MultiConnectionMode.Disable);
long singleConnectionModeStartTime = System.currentTimeMillis();
ImapMessageInfoCollection messageInfoCol2 = imapClient.listMessages(true);
long singleConnectionModeTimeSpan = System.currentTimeMillis() - singleConnectionModeStartTime;

double performanceRelation = singleConnectionModeTimeSpan / multiConnectionModeTimeSpan;
System.out.println("Performance Relation: " + performanceRelation);

Xin lưu ý rằng việc sử dụng chế độ đa kết nối không đảm bảo tăng hiệu suất.

Lấy tin nhắn theo thứ tự giảm dần

Aspose.Email cung cấp ImapClient.listMessagesByPage phương thức liệt kê tin nhắn có hỗ trợ phân trang. Một số overload của ImapClient.listMessagesByPage chấp nhận PageSettings như một tham số. PageSettings cung cấp một AscendingSorting thuộc tính mà khi đặt thành false, trả về email theo thứ tự giảm dần.

Mã ví dụ sau đây minh họa cách sử dụng AscendingSorting thuộc tính của PageSettings lớp để thay đổi thứ tự của email.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

PageSettings pageSettings = new PageSettings();
pageSettings.setAscendingSorting(false);
ImapPageInfo pageInfo = imapClient.listMessagesByPage(5, pageSettings);
ImapMessageInfoCollection messages = pageInfo.getItems();

for (ImapMessageInfo message : messages) {
    System.out.println(message.getSubject() + " -> " + message.getDate().toString());
}

Lấy tin nhắn từ máy chủ và lưu lên đĩa

Cái ImapClient lớp có thể lấy tin nhắn từ máy chủ IMAP và lưu chúng ở định dạng EML lên đĩa cục bộ. Các bước sau đây cần thực hiện để lưu tin nhắn lên đĩa:

Tạo một đối tượng của ImapClient lớp.
Xác định hostname, cổng, tên người dùng và mật khẩu trong ImapClient constructor.
Chọn thư mục bằng cách sử dụng selectFolder() phương thức.
Gọi listMessages phương thức để lấy ImapMessageInfoCollection đối tượng.
Lặp qua ImapMessageInfoCollection bộ sưu tập, gọi saveMessage() phương thức và cung cấp đường dẫn đầu ra cùng tên tệp.

Đoạn mã sau đây cho bạn thấy cách lấy các tin nhắn email từ máy chủ và lưu chúng.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Select the inbox folder and Get the message info collection
client.selectFolder(ImapFolderInfo.IN_BOX);
ImapMessageInfoCollection list = client.listMessages();

// Download each message
for (int i = 0; i < list.size(); i++) {
    // Save the EML file locally
    client.saveMessage(list.get_Item(i).getUniqueId(), dataDir + list.get_Item(i).getUniqueId() + ".eml");
}

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

Trong ví dụ trên, các email được lưu ở định dạng EML. Để lưu email ở định dạng MSG, ImapClient.fetchMessage() phương thức cần được gọi. Nó trả về tin nhắn dưới dạng một thể hiện của MailMessage lớp. MailMessage.save() phương thức sau đó có thể được gọi để lưu tin nhắn thành MSG. Đoạn mã sau đây cho bạn thấy cách lưu tin nhắn ở định dạng MSG.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the file directory.
String dataDir = "data/";

// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

// Select the inbox folder and Get the message info collection
client.selectFolder(ImapFolderInfo.IN_BOX);
ImapMessageInfoCollection list = client.listMessages();

// Download each message
for (int i = 0; i < list.size(); i++) {
    // Save the message in MSG format
    MailMessage message = client.fetchMessage(list.get_Item(i).getUniqueId());
    message.save(dataDir + list.get_Item(i).getUniqueId() + "_out.msg", SaveOptions.getDefaultMsgUnicode());
}

Lấy nhiều tin nhắn nhóm

ImapClient cung cấp một fetchMessages phương thức nhận một iterable của Số thứ tự hoặc ID duy nhất và trả về một danh sách của MailMessage. Đoạn mã sau minh họa việc sử dụng fetchMessages phương thức để lấy tin nhắn bằng Số thứ tự và ID duy nhất.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapMessageInfoCollection messageInfoCol = imapClient.listMessages();
System.out.println("ListMessages Count: " + messageInfoCol.size());

List<Integer> sequenceNumberAr = new ArrayList<Integer>();
List<String> uniqueIdAr = new ArrayList<String>();
for (ImapMessageInfo mi : messageInfoCol) {
    sequenceNumberAr.add(mi.getSequenceNumber());
    uniqueIdAr.add(mi.getUniqueId());
}

for (MailMessage m : imapClient.fetchMessagesBySequences(sequenceNumberAr)) {
    System.out.println("FetchMessages-sequenceNumberAr : " + m.getSubject());
}

for (MailMessage m : imapClient.fetchMessagesByUids(uniqueIdAr)) {
    System.out.println("FetchMessages-uniqueIdAr : " + m.getSubject());
}

Phân luồng Email/Tổ chức Email thành các Cuộc trò chuyện

Aspose.Email cho phép nhóm tất cả các tin nhắn chuyển tiếp, trả lời và trả lời tất cả liên quan đến cùng một cuộc trò chuyện lại với nhau theo cách phân cấp. Cơ bản, giao thức IMAP có thể hỗ trợ khả năng THREAD được định nghĩa trong RFC-5256. Ngoài ra, còn có một phần mở rộng IMAP khác do Gmail cung cấp và được mô tả là X-GM-EXT-1.

Các tính năng phân luồng email sau đây có sẵn để sử dụng:

getMessageThreads phương thức - Nhận các chuỗi hội thoại tin nhắn bằng ImapClient.
boolean getGmExt1Supported - Lấy thông tin xem phần mở rộng Gmail X-GM-EXT-1 có được hỗ trợ hay không.
boolean getThreadSupported - Lấy thông tin xem phần mở rộng THREAD có được hỗ trợ hay không.
String[] getThreadAlgorithms - Lấy các thuật toán THREAD được hỗ trợ.

Các mẫu mã sau đây cho thấy cách sử dụng các tính năng này để lấy chuỗi hội thoại email từ Gmail:

  ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password", SecurityOptions.SSLImplicit);

try {

    client.selectFolder(ImapFolderInfo.IN_BOX);

   // get a list of messages that we'll group by conversation

   ImapMessageInfoCollection messages = client.listMessages();

   // make sure the IMAP server supports X-GM-EXT-1 extension

   if (client.getGmExt1Supported()) {

       // gets unique conversationId for our example

       Set<String> conversationIds = new HashSet<String>();

       for (ImapMessageInfo messageInfo : messages) {

           if (messageInfo.getConversationId() != null)

                conversationIds.add(messageInfo.getConversationId());

       }

       for (String conversationId : conversationIds) {

           // create the necessary search conditions for a thread

           XGMThreadSearchConditions conditions = new XGMThreadSearchConditions();

            conditions.setConversationId(conversationId);

            conditions.setUseUId(true);

           // get results

           List<MessageThreadResult> conversation = client.getMessageThreads(conditions);

           // print the email conversation in hierarchically manner

           printConversaton("", conversation, messages);

            System.out.println("--------------------");

       }

   }

} finally {

    client.dispose();

}

/**

 * <p>

 * Prints the email conversation in hierarchically manner

 * </p>

 */

public static void printConversaton(String indent, Iterable<MessageThreadResult> conversation,

    Iterable<ImapMessageInfo> messages) {

   for (MessageThreadResult thread : conversation) {

       for (ImapMessageInfo messageInfo : messages) {

           if (thread.getUniqueId().equals(messageInfo.getUniqueId())) {

                System.out.println(indent + " (" + thread.getUniqueId() + ") " + messageInfo.getSubject());

               break;

           }

       }

       if (thread.getChildMessages().size() != 0) {

            printConversaton(indent += "-", thread.getChildMessages(), messages);

       }

   }

}

Mã sẽ hơi thay đổi nếu máy chủ IMAP hỗ trợ khả năng THREAD:

Kiểm tra xem máy chủ IMAP có hỗ trợ phần mở rộng THREAD không:

 if (client.getThreadSupported())

Tạo các điều kiện tìm kiếm phù hợp cho một chuỗi hội thoại:

 ThreadSearchConditions conditions = new ThreadSearchConditions();

conditions.setAlgorithm(client.getThreadAlgorithms()[0]);

conditions.setUseUId(true);

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

Trong các kịch bản, khi máy chủ email chứa một số lượng lớn tin nhắn trong hộp thư, thường muốn liệt kê hoặc lấy các tin nhắn với hỗ trợ phân trang. API Aspose.Email ImapClient cho phép bạn lấy các tin nhắn từ máy chủ với hỗ trợ phân trang.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// This example shows the paging support of ImapClient for listing messages from the server
// Available in Aspose.Email for Java and onwards
final ImapClient client = new ImapClient("host.domain.com", 993, "username", "password");
try {
    try {
        int messagesNum = 12;
        int itemsPerPage = 5;
        MailMessage message = null;
        // Create some test messages and append these to server's inbox
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35157 - " + UUID.randomUUID(),
                    "EMAILNET-35157 Move paging parameters to separate class");
            client.appendMessage(ImapFolderInfo.IN_BOX, message);
        }

        // List messages from inbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection totalMessageInfoCol = client.listMessages();
        // Verify the number of messages added
        System.out.println(totalMessageInfoCol.size());

        ////////////////// RETREIVE THE MESSAGES USING PAGING SUPPORT////////////////////////////////////

        List<ImapPageInfo> pages = new ArrayList<ImapPageInfo>();
        PageSettings pageSettings = new PageSettings();
        ImapPageInfo pageInfo = client.listMessagesByPage(itemsPerPage, 0, pageSettings);
        System.out.println(pageInfo.getTotalCount());
        pages.add(pageInfo);
        while (!pageInfo.getLastPage()) {
            pageInfo = client.listMessagesByPage(itemsPerPage, pageInfo.getNextPage().getPageOffset(), pageSettings);
            pages.add(pageInfo);
        }
        int retrievedItems = 0;

        // foreach to while statements conversion
        for (ImapPageInfo folderCol : pages) {
            retrievedItems += folderCol.getItems().size();
        }
        System.out.println(retrievedItems);
    } finally {
    }
} finally {
    if (client != null)
        client.dispose();
}

Lấy Thư mục và Đọc Tin nhắn Đệ quy

Trong bài viết này, phần lớn các ImapClient các tính năng được sử dụng để tạo một ứng dụng liệt kê tất cả các thư mục và thư mục con một cách đệ quy từ máy chủ IMAP. Nó cũng lưu các tin nhắn trong mỗi thư mục và thư mục con ở định dạng MSG trên đĩa cứng cục bộ. Trên đĩa, các thư mục và tin nhắn được tạo và lưu theo cùng cấu trúc phân cấp như trên máy chủ IMAP. Đoạn mã sau đây cho bạn thấy cách lấy thông tin các tin nhắn và thư mục con một cách đệ quy.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() throws Exception {
    // Create an instance of the ImapClient class
    ImapClient client = new ImapClient();

    // Specify host, username, password, Port and SecurityOptions for your client
    client.setHost("imap.gmail.com");
    client.setUsername("your.username@gmail.com");
    client.setPassword("your.password");
    client.setPort(993);
    client.setSecurityOptions(SecurityOptions.Auto);
    try {
        // The root folder (which will be created on disk) consists of host and username
        String rootFolder = client.getHost() + "-" + client.getUsername();

        // Create the root folder and List all the folders from IMAP server
        new File(rootFolder).mkdirs();
        ImapFolderInfoCollection folderInfoCollection = client.listFolders();
        for (ImapFolderInfo folderInfo : folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listMessagesInFolder(folderInfo, rootFolder, client);
        }
        // Disconnect to the remote IMAP server
        client.dispose();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex);
    }

    System.out.println("Downloaded messages recursively from IMAP server.");
}

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

    // Read the messages from the current folder, if it is selectable
    if (folderInfo.getSelectable()) {
        // Send status command to get folder info
        ImapFolderInfo folderInfoStatus = client.getFolderInfo(folderInfo.getName());
        System.out.println(folderInfoStatus.getName() + " folder selected. New messages: " + folderInfoStatus.getNewMessageCount() + ", Total messages: "
                + folderInfoStatus.getTotalMessageCount());

        // Select the current folder and List messages
        client.selectFolder(folderInfo.getName());
        ImapMessageInfoCollection msgInfoColl = client.listMessages();
        System.out.println("Listing messages....");
        for (ImapMessageInfo msgInfo : msgInfoColl) {
            // Get subject and other properties of the message
            System.out.println("Subject: " + msgInfo.getSubject());
            System.out.println("Read: " + msgInfo.isRead() + ", Recent: " + msgInfo.getRecent() + ", Answered: " + msgInfo.getAnswered());

            // Get rid of characters like ? and :, which should not be included in a file name and Save the message in MSG format
            String fileName = msgInfo.getSubject().replace(":", " ").replace("?", " ");
            MailMessage msg = client.fetchMessage(msgInfo.getSequenceNumber());
            msg.save(currentFolder + "\\" + fileName + "-" + msgInfo.getSequenceNumber() + ".msg", SaveOptions.getDefaultMsgUnicode());
        }
        System.out.println("============================\n");
    } else {
        System.out.println(folderInfo.getName() + " is not selectable.");
    }

    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ImapFolderInfoCollection folderInfoCollection = client.listFolders(folderInfo.getName());
        for (ImapFolderInfo subfolderInfo : folderInfoCollection) {
            listMessagesInFolder(subfolderInfo, rootFolder, client);
        }
    } catch (java.lang.RuntimeException e) {
    }
}

Lấy UID hoặc Số Thứ Tự của Tin Nhắn

API công cộng Aspose.Email cung cấp các tính năng sau để lấy thông tin nhận dạng tin nhắn như UID hoặc số thứ tự, có thể cần thiết khi xử lý các tin nhắn nhận từ máy chủ:

MailboxInfo lớp - Đại diện cho thông tin nhận dạng của một tin nhắn trong hộp thư.

getSequenceNumber() phương thức - Lấy số thứ tự của một tin nhắn.
getUniqueId() phương thức - Lấy ID duy nhất của một tin nhắn.

MailMessage lớp - Đại diện cho một tin nhắn email và cho phép truy cập các thuộc tính của tin nhắn, ví dụ: tiêu đề, nội dung, người gửi và địa chỉ người nhận, v.v.

getItemId phương thức - Đại diện cho thông tin nhận dạng về một tin nhắn trong hộp thư.

Mẫu mã dưới đây minh họa cách lấy và hiển thị chi tiết các tin nhắn từ thư mục "INBOX" trên máy chủ IMAP bằng cách sử dụng ImapClient lớp:

try (ImapClient client = new ImapClient(imapHost, port, emailAddress, password, securityOption)) {
    ImapMessageInfoCollection msgs = client.listMessages("INBOX");
    List<Integer> seqIds = new ArrayList<>();
    for (ImapMessageInfo msg : msgs) {
        seqIds.add(msg.getSequenceNumber());
    }
    Iterable<MailMessage> msgsViaFetch = client.fetchMessagesBySequences(seqIds);
    for (MailMessage thisMsg : msgsViaFetch) {
        System.out.println("Message ID: " + thisMsg.getItemId().getUniqueId()
                + " SequenceNumber: " + thisMsg.getItemId().getSequenceNumber()
                + " Subject: " + thisMsg.getSubject());
    }
}

Truy xuất các tham số bổ sung dưới dạng thông tin tóm tắt

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("host.domain.com", "username", "password");
try {
    MailMessage message = new MailMessage("from@domain.com", "to@doman.com", "EMAILNET-38466 - " + UUID.randomUUID().toString(),
            "EMAILNET-38466 Add extra parameters for UID FETCH command");

    // append the message to the server
    String uid = client.appendMessage(message);

    // wait for the message to be appended
    Thread.sleep(5000);

    // Define properties to be fetched from server along with the message
    List<String> messageExtraFields = Arrays.asList("X-GM-MSGID", "X-GM-THRID");

    // retreive the message summary information using it's UID
    ImapMessageInfo messageInfoUID = client.listMessage(uid, messageExtraFields);

    // retreive the message summary information using it's sequence number
    ImapMessageInfo messageInfoSeqNum = client.listMessage(1, messageExtraFields);

    // List messages in general from the server based on the defined properties
    ImapMessageInfoCollection messageInfoCol = client.listMessages(messageExtraFields);

    ImapMessageInfo messageInfoFromList = messageInfoCol.get_Item(0);

    // verify that the parameters are fetched in the summary information
    for (String paramName : messageExtraFields) {
        System.out.println(messageInfoFromList.getExtraParameters().containsKey(paramName));
        System.out.println(messageInfoUID.getExtraParameters().containsKey(paramName));
        System.out.println(messageInfoSeqNum.getExtraParameters().containsKey(paramName));
    }
} finally {
    if (client != null)
        client.dispose();
}

Lấy thông tin tiêu đề List-Unsubscribe

Tiêu đề List-Unsubscribe chứa URL để hủy đăng ký các danh sách email như quảng cáo, bản tin, v.v. Để lấy tiêu đề List-Unsubscribe, sử dụng listUnsubscribe thuộc tính của ImapMessageInfo lớp. Ví dụ sau đây cho thấy cách sử dụng listUnsubscribe thuộc tính để lấy tiêu đề List-Unsubscribe.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapMessageInfoCollection messageInfoCol = imapClient.listMessages();
for (ImapMessageInfo imapMessageInfo : messageInfoCol) {
    System.out.println("ListUnsubscribe Header: " + imapMessageInfo.getListUnsubscribe());
}

Java: Làm việc với các cờ tin nhắn trên máy chủ

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

Thay đổi Cờ Tin Nhắn

Bạn có thể thay đổi cờ tin nhắn bằng cách sử dụng changeMessageFlags() phương thức. Phương thức này nhận hai tham số.

Số thứ tự tin nhắn hoặc ID duy nhất.
MessageFlag.

Các cờ sau có thể được đặt:

Đặt cờ tin nhắn

Đoạn mã mẫu sau cho bạn thấy cách thay đổi cờ tin nhắn trên máy chủ IMAP với Aspose.Email.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Mark the message as read
client.changeMessageFlags(1, ImapMessageFlags.isRead());

Xóa cờ tin nhắn

Các cờ tin nhắn cũng có thể bị xóa bằng removeMessageFlags() phương thức. Cách sử dụng tương tự như của changeMessageFlags() phương thức. Nó nhận một số thứ tự hoặc ID tin nhắn duy nhất và MessageFlag. Đoạn mã mẫu sau cho bạn thấy cách xóa cờ tin nhắn.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Remove the message flag
client.removeMessageFlags(1, ImapMessageFlags.isRead());

Đặt cờ tùy chỉnh

Bạn cũng có thể đặt cờ tùy chỉnh cho một tin nhắn bằng cách sử dụng ImapClient của API. ImapClient AddMessageFlags cung cấp khả năng đặt cờ tùy chỉnh trên các tin nhắn.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create a message
MailMessage message = new MailMessage("user@domain1.com", "user@domain2.com", "subject", "message");

// Append the message to mailbox
String uid = client.appendMessage(ImapFolderInfo.IN_BOX, message);

// Add custom flags to the added messge
client.addMessageFlags(uid, com.aspose.email.ImapMessageFlags.op_BitwiseOr(ImapMessageFlags.keyword("custom1"), ImapMessageFlags.keyword("custom1_0")));

// Retreive the messages for checking the presence of custom flag
client.selectFolder(ImapFolderInfo.IN_BOX);

ImapMessageInfoCollection messageInfos = client.listMessages();
for (ImapMessageInfo inf : messageInfos) {
    ImapMessageFlags[] flags = inf.getFlags().split();

    if (inf.containsKeyword("custom1"))
        System.out.println("Keyword found");
}

Java: Làm việc với Tệp đính kèm Tin nhắn bằng IMAP

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

Danh sách Tệp đính kèm Tin nhắn bằng Client IMAP

Để lấy thông tin về các tệp đính kèm như tên, kích thước mà không cần tải dữ liệu tệp đính kèm, hãy sử dụng các tính năng API sau:

ImapAttachmentInfo - Đại diện cho thông tin tệp đính kèm.
ImapAttachmentInfoCollection - Đại diện cho một tập hợp của ImapAttachmentInfo.
listAttachments(int sequenceNumber) - Lấy thông tin cho mỗi tệp đính kèm trong một tin nhắn.

Đoạn mã mẫu dưới đây cho thấy cách sử dụng client IMAP để lấy thông tin về các email và tệp đính kèm của chúng từ máy chủ, sau đó hiển thị chi tiết tệp đính kèm cho mỗi tin nhắn. Nó cho phép bạn truy cập và xử lý tệp đính kèm từ các email bằng giao thức IMAP.

ImapMessageInfoCollection messageInfoCollection = imapClient.listMessages();

for (ImapMessageInfo message : messageInfoCollection) {
    ImapAttachmentInfoCollection attachmentInfoCollection =
            imapClient.listAttachments(message.getSequenceNumber());

    for (ImapAttachmentInfo attachmentInfo : attachmentInfoCollection) {
        System.out.println(
                "Attachment: " + attachmentInfo.getName() + " (size: " + attachmentInfo.getSize() + ")");
    }
}

Java: Lọc tin nhắn từ máy chủ bằng khách hàng IMAP

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

Cái ImapClient class cung cấp listMessages() phương thức lấy tất cả các tin nhắn từ một hộp thư. Để chỉ lấy các tin nhắn phù hợp với một số điều kiện, sử dụng phiên bản quá tải của listMessages() phương thức nhận MailQuery được truyền làm đối số. Các MailQuery lớp cung cấp nhiều thuộc tính để xác định các điều kiện, chẳng hạn như ngày, tiêu đề, người gửi, người nhận v.v. Ví dụ đầu tiên minh họa cách lọc tin nhắn dựa trên ngày và tiêu đề. Chúng tôi cũng cho thấy cách lọc theo các tiêu chí khác và cách xây dựng các truy vấn phức tạp hơn. API cũng cung cấp khả năng áp dụng tiêu chí tìm kiếm phân biệt hoa thường để khớp chính xác tiêu chí lọc. API cũng cho phép chỉ định mã hoá chuỗi tìm kiếm để lọc tin nhắn từ hộp thư.

Lọc tin nhắn từ Hộp thư

Kết nối và đăng nhập vào máy chủ IMAP
Tạo một đối tượng của MailQuery và đặt các thuộc tính
Gọi ImapClient.listMessages(MailQuery query) phương thức và truyền vào MailQuery với các tham số để chỉ nhận các tin nhắn đã lọc.

Đoạn mã sau cho bạn thấy cách kết nối tới hộp thư IMAP và nhận các tin nhắn đến hôm nay và có từ "newsletter" trong tiêu đề.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
final String host = "host";
final int port = 143;
final String username = "user@host.com";
final String password = "password";
ImapClient client = new ImapClient(host, port, username, password);
client.selectFolder("Inbox");
// Set conditions, Subject contains "Newsletter", Emails that arrived today
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Newsletter");
builder.getInternalDate().on(new Date());
// Build the query and Get list of messages
MailQuery query = builder.getQuery();
ImapMessageInfoCollection messages = client.listMessages(query);
System.out.println("Imap: " + messages.size() + " message(s) found.");
// Disconnect from IMAP
client.dispose();

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 đề email và ngày. Chúng ta cũng có thể sử dụng các thuộc tính khác để đặt các điều kiện được hỗ trợ. Dưới đây là một số ví dụ về việc thiết lập các điều kiện bằng cách sử dụng MailQuery. Các đoạn mã sau đây cho thấy cách lọc email trên:

Ngày hôm nay.
Một khoảng thời gian.
Từ người gửi cụ thể.
Từ miền cụ thể.
Từ người nhận cụ thể.

Ngày hôm nay

Đoạn mã sau cho bạn thấy cách lọc email dựa trên Ngày hôm nay.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.getInternalDate().on(new Date());
~~
### **Date Range*
The following code snippet shows you how to filter emails on the date range.

~~~Java
// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// 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());

Người gửi cụ thể

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get emails from specific sender
builder.getFrom().contains("saqib.razzaq@127.0.0.1");

Miền cụ thể

Đoạn mã sau cho bạn thấy cách lọc email dựa trên miền cụ thể.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get emails from specific domain
builder.getFrom().contains("SpecificHost.com");

Người nhận cụ thể

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get emails sent to specific recipient
builder.getTo().contains("recipient");

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 các câu lệnh riêng biệt, sau đó mọi điều kiện sẽ được khớp. Ví dụ, nếu chúng ta muốn lấy tin nhắn trong một khoảng thời gian và từ một máy chủ cụ thể, chúng ta cần 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 các truy vấn bằng AND.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// 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 như tham số. Nó nhận các tin nhắn phù hợp với bất kỳ một trong hai điều kiện được chỉ định. Đoạn mã dưới đây cho thấy cách lọc tin nhắn mà có “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.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Specify OR condition
builder.or(builder.getSubject().contains("test"), builder.getFrom().contains("noreply@host.com"));

Lọc dựa trên InternalDate

Tin nhắn có thể được trích xuất từ máy chủ dựa trên InternalDate tuy nhiên đôi khi máy chủ không trả về tất cả tin nhắn như hiển thị trong hộp đến. Nguyên nhân có thể là múi giờ của máy chủ vì nó có thể không phải UTC cho mọi máy chủ như Gmail. Aspose gửi các lệnh như 008 SEARCH ON 4-May-2014 theo giao thức IMAP tuy nhiên kết quả có thể khác nhau do cài đặt múi giờ của máy chủ. Một thành viên mới đã được thêm vào ImapMessageInfo như InternalDate điều này hỗ trợ hơn trong việc lọc tin nhắn. Đoạn mã sau cho thấy cách sử dụng của InternalDate để lọc tin nhắn.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
final String host = "host";
final int port = 143;
final String username = "user@host.com";
final String password = "password";
ImapClient client = new ImapClient(host, port, username, password);
client.selectFolder("Inbox");

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

// Build the query and Get list of messages
MailQuery query = builder.getQuery();
ImapMessageInfoCollection messages = client.listMessages(query);
for (ImapMessageInfo info : messages) {
    System.out.println("Internal Date: " + info.getInternalDate());
}

// Disconnect from IMAP
client.dispose();

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

Đoạn mã sau cho bạn thấy cách sử dụng lọc email phân biệt chữ hoa chữ thường.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set conditions, Subject contains "Newsletter", Emails that arrived today
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Newsletter", true);
builder.getInternalDate().on(new Date());
MailQuery query = builder.getQuery();

Chỉ định Encoding cho Query Builder

API của ImapQueryBuilder bộ khởi tạo có thể được dùng để chỉ định Encoding cho chuỗi tìm kiếm. Điều này cũng có thể được đặt bằng cách sử dụng DefaultEncoding thuộc tính của MailQueryBuilder. Đoạn mã sau cho bạn thấy cách chỉ định mã hoá cho bộ xây dựng truy vấn.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set conditions
ImapQueryBuilder builder = new ImapQueryBuilder(Charset.forName("utf-8"));
builder.getSubject().contains("ğüşıöç", true);
MailQuery query = builder.getQuery();

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

Cái ImapClient cung cấp khả năng tìm kiếm tin nhắn từ hộp thư và liệt kê chúng với hỗ trợ phân trang. Đoạn mã sau cho bạn thấy cách lọc tin nhắn với hỗ trợ phân trang.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
/// <summary>
/// This example shows how to search for messages using ImapClient of the API with paging support
/// Introduced in Aspose.Email for .NET 6.4.0
/// </summary>
final ImapClient client = new ImapClient("host.domain.com", 84, "username", "password");
try {
    try {
        // Append some test messages
        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-35128 - " + UUID.randomUUID(), "111111111111111");
            client.appendMessage(ImapFolderInfo.IN_BOX, message);
        }
        String body = "2222222222222";
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35128 - " + UUID.randomUUID(), body);
            client.appendMessage(ImapFolderInfo.IN_BOX, message);
        }

        client.selectFolder("Inbox");
        ImapQueryBuilder iqb = new ImapQueryBuilder();
        iqb.getBody().contains(body);
        MailQuery query = iqb.getQuery();

        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection totalMessageInfoCol = client.listMessages(query);
        System.out.println(totalMessageInfoCol.size());

        //////////////////////////////////////////////////////

        List<ImapPageInfo> pages = new ArrayList<ImapPageInfo>();

        PageSettings ps = new PageSettings();
        ps.setFolderName(ImapFolderInfo.IN_BOX);
        PageInfo pi = new PageInfo(itemsPerPage);
        ImapPageInfo pageInfo = client.listMessagesByPage(query, pi, ps);

        pages.add(pageInfo);
        while (!pageInfo.getLastPage()) {
            pageInfo = client.listMessagesByPage(query, pageInfo.getNextPage(), ps);
            pages.add(pageInfo);
        }
        int retrievedItems = 0;
        // foreach to while statements conversion
        for (ImapPageInfo folderCol : pages) {
            retrievedItems += folderCol.getItems().size();
        }
    } finally {
    }
} finally {
    if (client != null)
        client.dispose();
}

Lọc tin nhắn với Cờ Tùy chỉnh

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapQueryBuilder queryBuilder = new ImapQueryBuilder();

queryBuilder.hasFlags(ImapMessageFlags.keyword("custom1"));

queryBuilder.hasNoFlags(ImapMessageFlags.keyword("custom2"));

Lọc tin nhắn bằng Tìm kiếm Tùy chỉnh

Ví dụ, tiêu chuẩn RFC 3501 không cho phép tìm kiếm tin nhắn dựa trên việc có đính kèm trong tin nhắn. Nhưng Gmail cung cấp Các mở rộng IMAP cho phép thực hiện tìm kiếm như vậy. Aspose.Email cung cấp customSearch phương thức của ImapQueryBuilder lớp để thực hiện truy vấn tương ứng.

Mẫu mã dưới đây cho thấy cách truy xuất danh sách các tin nhắn email từ máy chủ có đính kèm, sử dụng giao thức IMAP và tiêu chí tìm kiếm tùy chỉnh:

ImapQueryBuilder builder = new ImapQueryBuilder();
builder.customSearch("X-GM-RAW \"has:attachment\"");
MailQuery query = builder.getQuery();
messageInfoCol = client.listMessages(query);

Java: Xóa tin nhắn từ máy chủ

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

Xóa tin nhắn

Cái ImapClient lớp có thể xóa tin nhắn từ máy chủ IMAP. ImapClient lớp deleteMessage() hàm được sử dụng để xóa tin nhắn. Nó nhận số thứ tự tin nhắn hoặc ID duy nhất làm tham số. ImapClient cung cấp deleteMessage và deleteMessages phương thức để xóa tin nhắn từng cái một hoặc nhiều tin nhắn. Đoạn mã mẫu sau cho bạn thấy cách xóa một tin nhắn email có ID tin nhắn 1 từ máy chủ IMAP.

try (ImapClient client = new ImapClient("host", "username", "password")) {
    client.setSecurityOptions(SecurityOptions.SSLImplicit);

    // Append test message
    client.selectFolder(ImapFolderInfo.IN_BOX);

    MailMessage eml = new MailMessage("from@from.com", "to@to.com");
    eml.setSubject("Message to delete");
    eml.setBody("Hey! This Message will be deleted!");
    String emlId = client.appendMessage(eml);

    // Delete appended message
    client.deleteMessage(emlId);
    client.commitDeletes();
}

Xóa nhiều tin nhắn

Có thể xóa nhiều email khỏi hộp thư bằng cách sử dụng ImapClient của API Aspose.Email. deleteMessages phương thức cung cấp một số tùy chọn để xóa nhiều tin nhắn từ máy chủ bằng cách sử dụng ID duy nhất, số thứ tự hoặc ImapMessageInfoCollection phần tử. Đoạn mã mẫu sau cho bạn thấy cách xóa nhiều tin nhắn.

try (ImapClient client = new ImapClient("host", "username", "password")) {
    client.selectFolder(ImapFolderInfo.IN_BOX);

    // Append test messages
    List<MailMessage> emlList = new ArrayList<>();
    for (int i = 0; i < 3; i++) {
        MailMessage eml = new MailMessage("from@from.com", "to@to.com");
        eml.setSubject("Message to delete " + i);
        eml.setBody("Hey! This Message will be deleted!");

        emlList.add(eml);
    }

    AppendMessagesResult appendMessagesResult = client.appendMessages(emlList);
    List<String> uidList = new ArrayList<>();
    for (String uid : appendMessagesResult.getSucceeded().getValues()) {
        uidList.add(uid);
    }

    // Bulk Delete appended Messages
    client.deleteMessagesByUids(uidList, true);
    client.commitDeletes();
}

Java: Làm việc với Thư mục trên máy chủ IMAP

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

Lấy thông tin Thư mục

Lấy thông tin về các thư mục từ máy chủ IMAP rất dễ dàng với Aspose.Email. Gọi listFolders() phương thức của ImapClient lớp. Nó trả về một đối tượng của ImapFolderInfoCollection kiểu. Lặp qua bộ sưu tập này và lấy thông tin về từng thư mục riêng lẻ trong một vòng lặp. Phương thức được overload. Bạn có thể truyền tên thư mục làm tham số để lấy danh sách các thư mục con. Đoạn mã sau đây cho bạn thấy cách lấy thông tin thư mục từ máy chủ IMAP bằng phương pháp Aspose.Email đã mô tả.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get all folders in the currently subscribed folder
ImapFolderInfoCollection folderInfoColl = client.listFolders();

// Iterate through the collection to get folder info one by one
for (ImapFolderInfo folderInfo : (Iterable<ImapFolderInfo>) folderInfoColl) {
    // Folder name and get New messages in the folder
    System.out.println("Folder name is " + folderInfo.getName());
    ImapFolderInfo folderExtInfo = client.getFolderInfo(folderInfo.getName());
    System.out.println("New message count: " + folderExtInfo.getNewMessageCount());
    System.out.println("Is it readonly? " + folderExtInfo.getReadOnly());
    System.out.println("Total number of messages " + folderExtInfo.getTotalMessageCount());
}

Xóa và Đổi tên Thư mục

Một thư mục trên máy chủ IMAP có thể được xóa hoặc đổi tên trong một dòng lệnh duy nhất với Aspose.Email:

Cái deleteFolder() phương thức chấp nhận tên thư mục làm tham số.
Đối với renameFolder() phương thức, bạn cần truyền tên thư mục hiện tại và tên thư mục mới. Đoạn mã sau đây cho bạn thấy cách xóa một thư mục khỏi máy chủ IMAP, và cách đổi tên một thư mục. Mỗi thao tác được thực hiện bằng một dòng lệnh.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Delete a folder and Rename a folder
client.deleteFolder("foldername");
client.renameFolder("foldername", "newfoldername");

Thêm một tin nhắn mới vào thư mục

Bạn có thể thêm một tin nhắn mới vào thư mục bằng cách sử dụng MailMessage và ImapClient lớp. Đầu tiên, tạo một MailMessage đối tượng bằng cách cung cấp các giá trị chủ đề, người nhận và người gửi. Sau đó đăng ký vào một thư mục và thêm tin nhắn vào đó. Đoạn mã sau đây cho bạn thấy cách thêm một tin nhắn mới vào thư mục.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create a message
MailMessage msg = new MailMessage("user@domain1.com", "user@domain2.com", "subject", "message");

// Subscribe to the Inbox folder and Append the newly created message
client.selectFolder(ImapFolderInfo.IN_BOX);
client.subscribeFolder(client.getCurrentFolder().getName());
client.appendMessage(client.getCurrentFolder().getName(), msg);

Thêm nhiều tin nhắn với hỗ trợ MultiConnection

Bạn có thể thêm nhiều tin nhắn bằng cách sử dụng appendMessages phương thức do ImapClient lớp. appendMessages phương thức chấp nhận một danh sách của MailMessage và thêm nó vào thư mục hiện tại nếu thư mục không được cung cấp làm tham số. ImapClient cũng hỗ trợ chế độ MultiConnection cho các thao tác tải nặng. Đoạn mã sau đây cho bạn thấy cách thêm nhiều tin nhắn bằng cách sử dụng chế độ MultiConnection.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

List<MailMessage> messages = new ArrayList<MailMessage>();
for (int i = 0; i < 20; i++) {
    MailMessage message = new MailMessage("<EMAIL ADDRESS>", "<EMAIL ADDRESS>", "Test Message - " + UUID.randomUUID().toString(), "IMAP Group Append with MultiConnection");
    messages.add(message);
}

imapClient.setConnectionsQuantity(5);
imapClient.setUseMultiConnection(MultiConnectionMode.Enable);
imapClient.appendMessages(messages);

Xin lưu ý rằng việc sử dụng chế độ đa kết nối không đảm bảo tăng hiệu suất.

Di chuyển thư sang Thư mục Hộp thư khác

Aspose.Email for Java cho phép di chuyển một tin nhắn từ một thư mục hộp thư này sang thư mục khác bằng cách sử dụng ImapClient API. The moveMessage phương thức sử dụng ID duy nhất của tin nhắn và tên thư mục đích để di chuyển tin nhắn tới thư mục đích. Đoạn mã dưới đây cho bạn thấy cách di chuyển tin nhắn sang thư mục hộp thư khác.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// This example shows how to move a message from one folder of a mailbox to another one using the ImapClient API of Aspose.Email for Java
// Available from Aspose.Email for Java onwards
// -------------- Available API Overload Members --------------
// void ImapClient.moveMessage(IConnection iConnection, int sequenceNumber, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(IConnection iConnection, String uniqueId, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(int sequenceNumber, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(String uniqueId, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(IConnection iConnection, int sequenceNumber, String folderName)
// void ImapClient.moveMessage(IConnection iConnection, String uniqueId, String folderName)
// void ImapClient.moveMessage(int sequenceNumber, String folderName)
// void ImapClient.moveMessage(String uniqueId, String folderName)

final ImapClient client = new ImapClient("host.domain.com", 993, "username", "password");
try {
    String folderName = "EMAILNET-35151";
    if (!client.existFolder(folderName))
        client.createFolder(folderName);
    try {
        MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35151 - " + UUID.randomUUID(),
                "EMAILNET-35151 ImapClient: Provide option to Move Message");
        client.selectFolder(ImapFolderInfo.IN_BOX);
        // Append the new message to Inbox folder
        String uniqueId = client.appendMessage(ImapFolderInfo.IN_BOX, message);
        ImapMessageInfoCollection messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
        // Now move the message to the folder EMAILNET-35151
        client.moveMessage(uniqueId, folderName);
        client.commitDeletes();
        // Verify that the message was moved to the new folder
        client.selectFolder(folderName);
        messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
        // Verify that the message was moved from the Inbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
    } finally {
        try {
            client.deleteFolder(folderName);
        } catch (java.lang.RuntimeException e) {
        }
    }
} finally {
    if (client != null)
        client.dispose();
}

Sao chép thư vào Thư mục Hộp thư khác

API Aspose.Email cung cấp khả năng sao chép một tin nhắn từ thư mục hộp thư này sang thư mục hộp thư khác. Nó cho phép sao chép một tin nhắn đơn lẻ cũng như nhiều tin nhắn bằng cách sử dụng copyMessage và copyMessages phương thức. copyMessages phương thức cung cấp khả năng sao chép nhiều tin nhắn từ thư mục nguồn của một hộp thư sang thư mục hộp thư đích. Đoạn mã sau đây cho bạn thấy cách sao chép tin nhắn sang một thư mục hộp thư khác.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("exchange.aspose.com", "username", "password");
try {
    // Create the destination folder
    String folderName = "EMAILNET-35242";
    if (!client.existFolder(folderName))
        client.createFolder(folderName);
    try {
        // Append a couple of messages to the server
        MailMessage message1 = new MailMessage("asposeemail.test3@aspose.com", "asposeemail.test3@aspose.com", "EMAILNET-35242 - " + UUID.randomUUID(),
                "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        String uniqueId1 = client.appendMessage(message1);

        MailMessage message2 = new MailMessage("asposeemail.test3@aspose.com", "asposeemail.test3@aspose.com", "EMAILNET-35242 - " + UUID.randomUUID(),
                "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        String uniqueId2 = client.appendMessage(message2);

        // Verify that the messages have been added to the mailbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection msgsColl = client.listMessages();
        for (ImapMessageInfo msgInfo : msgsColl)
            System.out.println(msgInfo.getSubject());

        // Copy multiple messages using the CopyMessages command and Verify that messages are copied to the destination folder
        client.copyMessagesByUids(Arrays.asList(uniqueId1, uniqueId2), folderName);

        client.selectFolder(folderName);
        msgsColl = client.listMessages();
        for (ImapMessageInfo msgInfo : msgsColl)
            System.out.println(msgInfo.getSubject());
    } finally {
        try {
            client.deleteFolder(folderName);
        } catch (java.lang.RuntimeException e) {
        }
    }
} finally {
    if (client != null)
        client.dispose();
}

Làm việc với các Thư mục Hộp thư Dùng Đặc biệt

Một số kho tin nhắn IMAP bao gồm các hộp thư dùng đặc biệt, chẳng hạn như các hộp lưu bản nháp hoặc tin đã gửi. Nhiều client email cho phép người dùng chỉ định nơi lưu bản nháp hoặc tin đã gửi, nhưng việc cấu hình chúng yêu cầu người dùng biết các hộp thư mà máy chủ đã dành cho các mục đích này. Aspose.Email có thể xác định các hộp thư dùng đặc biệt này bằng cách sử dụng ImapMailboxInfo lớp để làm cho việc làm việc với chúng dễ dàng hơn. Mẫu mã sau đây minh họa cách truy cập các hộp thư dùng đặc biệt này bằng cách sử dụng ImapMailboxInfo lớp.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();
System.out.println(mailboxInfo.getInbox());
System.out.println(mailboxInfo.getDraftMessages());
System.out.println(mailboxInfo.getJunkMessages());
System.out.println(mailboxInfo.getSentMessages());
System.out.println(mailboxInfo.getTrash());

Java: Làm việc với ImapClient bất đồng bộ

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

Tin nhắn có thể được truy xuất từ hộp thư một cách bất đồng bộ bằng cách sử dụng Aspose.Email ImapClient. Bài viết này trình bày việc truy xuất tin nhắn từ hộp thư một cách bất đồng bộ. Bài viết cũng cho thấy cách liệt kê tin nhắn bằng cách cung cấp tiêu chí tìm kiếm sử dụng MailQuery.

Truy xuất Tin nhắn bất đồng bộ

Đoạn mã sau cho bạn thấy cách truy xuất tin nhắn một cách bất đồng bộ.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
try (ImapClient client = new ImapClient("host", "username", "password")) {
    client.selectFolder("Issues/SubFolder");
    ImapMessageInfoCollection messages = client.listMessages();
    IAsyncResult ar = client.beginFetchMessage(messages.get_Item(0).getSequenceNumber());
    MailMessage message = client.endFetchMessage(ar);
}

Liệt kê Tin nhắn Bất đồng bộ với MailQuery

Cái MailQuery lớp có thể được sử dụng để chỉ định tiêu chí tìm kiếm nhằm truy xuất danh sách tin nhắn xác định một cách bất đồng bộ như được hiển thị trong mẫu mã sau.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Subject");
MailQuery query = builder.getQuery();
IAsyncResult asyncResult = client.beginListMessages(query);
ImapMessageInfoCollection messages = client.endListMessages(asyncResult);

Java: Liệt kê các phần mở rộng của máy chủ IMAP

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

Aspose.Email ImapClient cho phép bạn lấy các phần mở rộng mà máy chủ hỗ trợ như IDLE, UNSELECT, QUOTA, v.v. Điều này giúp xác định tính khả dụng của một phần mở rộng trước khi sử dụng client cho chức năng cụ thể đó. The getCapabilities() phương thức trả về các loại phần mở rộng được hỗ trợ dưới dạng mảng chuỗi. Đoạn mã sau đây cho bạn thấy cách truy xuất các phần mở rộng.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
ImapClient client = new ImapClient("imap.gmail.com", "username", "password");
String[] getCapabilities = client.getCapabilities();
for (String getCap : getCapabilities) {
    System.out.println(getCap);
}

Java: Hỗ trợ Lệnh IMAP IDLE

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

API Aspose.Email ImapClient cung cấp khả năng mở kết nối tới máy chủ và chờ đợi sự xuất hiện của một tin nhắn email. Điều này cho phép tránh việc liên tục truy vấn máy chủ để kiểm tra email mới tới. Đoạn mã sau cho bạn thấy cách Hỗ trợ Lệnh IMAP Idle.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
ImapClient client = new ImapClient("imap.domain.com", "username", "password");

client.startMonitoring(new ImapMonitoringEventHandler() {
    public void invoke(Object sender, ImapMonitoringEventArgs e) {
        System.out.println(e.getNewMessages().length);
        System.out.println(e.getDeletedMessages().length);
    }
});
client.stopMonitoring("Inbox");

Java: Hỗ trợ Lệnh IMAP IDLE và Các Tiện ích mở rộng

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

Hỗ trợ Lệnh IMAP Idle

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
ImapClient client = new ImapClient("imap.domain.com", "username", "password");

client.startMonitoring(new ImapMonitoringEventHandler() {
    public void invoke(Object sender, ImapMonitoringEventArgs e) {
        System.out.println(e.getNewMessages().length);
        System.out.println(e.getDeletedMessages().length);
    }
});
client.stopMonitoring("Inbox");

Hỗ trợ các Tiện ích mở rộng IMAP

API Aspose.Email cung cấp hỗ trợ cho các tiện ích mở rộng IMAP. Các tiện ích mở rộng IMAP sau hiện đang được API hỗ trợ. Những tiện ích mở rộng này không được tất cả máy chủ hỗ trợ.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password");
try {
    // Set SecurityOptions
    client.setSecurityOptions(SecurityOptions.Auto);
    System.out.println(client.getIdSupported());

    ImapIdentificationInfo serverIdentificationInfo1 = client.introduceClient();
    ImapIdentificationInfo serverIdentificationInfo2 = client.introduceClient(ImapIdentificationInfo.getDefaultValue());

    // Display ImapIdentificationInfo properties
    System.out.println(serverIdentificationInfo1.toString() + serverIdentificationInfo2.toString());
    System.out.println(serverIdentificationInfo1.getName());
    System.out.println(serverIdentificationInfo1.getVendor());
    System.out.println(serverIdentificationInfo1.getSupportUrl());
    System.out.println(serverIdentificationInfo1.getVersion());
} finally {
    if (client != null)
        client.dispose();
}

Lệnh Danh sách Mở rộng IMAP4

Đoạn mã dưới đây cho bạn thấy cách sử dụng lệnh danh sách mở rộng IMAP4.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password");
try {
    ImapFolderInfoCollection folderInfoCol = client.listFolders("*");
    System.out.println("Extended List Supported: " + client.getExtendedListSupported());
    for (ImapFolderInfo folderInfo : (Iterable<ImapFolderInfo>) folderInfoCol) {
        if (folderInfo.getName().equals("[Gmail]/All Mail"))
            System.out.println("Has Children: " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Bin"))
            System.out.println("Bin has children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Drafts"))
            System.out.println("Drafts has children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Important"))
            System.out.println("Important has Children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Sent Mail"))
            System.out.println("Sent Mail has Children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Spam"))
            System.out.println("Spam has Children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Starred"))
            System.out.println("Starred has Children? " + folderInfo.hasChildren());
    }
} finally {
    if (client != null)
        client.dispose();
}

Java: Hoạt động Sao lưu và Khôi phục IMAP

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

Aspose.Email for Java cung cấp khả năng sao lưu và khôi phục tin nhắn. Đối với mục tiêu này, API cung cấp các phương thức sau.

Bài viết này minh họa cách sao lưu và khôi phục tin nhắn bằng cách sử dụng ImapClient lớp.

Sao lưu Tin nhắn

Để sao lưu tin nhắn, sử dụng ImapClient.backup phương thức như được minh họa trong đoạn mã dưới đây.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();

ImapFolderInfo info = imapClient.getFolderInfo(mailboxInfo.getInbox().getName());
ImapFolderInfoCollection infos = new ImapFolderInfoCollection();
infos.addItem(info);

imapClient.backup(infos, dataDir + "\\ImapBackup.pst", com.aspose.email.BackupSettings.to_BackupSettings(BackupOptions.Recursive));

Khôi phục Tin nhắn

Để sao lưu tin nhắn, sử dụng ImapClient.restore phương thức như được minh họa trong đoạn mã dưới đây.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

ImapRestoreSettings settings = new ImapRestoreSettings();
settings.setRecursive(true);
PersonalStorage pst = PersonalStorage.fromFile(dataDir + "\\ImapBackup.pst");
imapClient.restore(pst, settings);

Hoạt động Sao lưu và Khôi phục IMAP với MultiConnection

Khi làm việc với số lượng lớn tin nhắn, quá trình sao lưu/khôi phục có thể mất thời gian dài. Vì vậy, API cung cấp hỗ trợ đa kết nối trong quá trình sao lưu và khôi phục. Để bật chế độ MultiConnection, đặt ImapClient.UseMultiConnection thuộc tính để MultiConnectionMode.Enable. Các đoạn mã dưới đây minh họa hoạt động sao lưu và khôi phục với chế độ MultiConnection được bật.

Sao lưu Tin nhắn với MultiConnection

Các đoạn mã dưới đây minh họa hoạt động sao lưu với chế độ MultiConnection được bật.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

imapClient.setUseMultiConnection(MultiConnectionMode.Enable);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();

ImapFolderInfo info = imapClient.getFolderInfo(mailboxInfo.getInbox().getName());
ImapFolderInfoCollection infos = new ImapFolderInfoCollection();
infos.addItem(info);

imapClient.backup(infos, dataDir + "\\ImapBackup.pst", com.aspose.email.BackupSettings.to_BackupSettings(BackupOptions.Recursive));

Khôi phục Tin nhắn với MultiConnection

Các đoạn mã dưới đây minh họa hoạt động khôi phục với chế độ MultiConnection được bật.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

imapClient.setUseMultiConnection(MultiConnectionMode.Enable);

ImapRestoreSettings settings = new ImapRestoreSettings();
settings.setRecursive(true);
PersonalStorage pst = PersonalStorage.fromFile(dataDir + "\\Outlook.pst");
imapClient.restore(pst, settings);