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

Java: Kết nối tới Máy chủ POP3

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

Cái Pop3Client lớp cho phép ứng dụng quản lý hộp thư bằng giao thức Post Office Protocol, phiên bản 3 (POP3). Để kết nối tới máy chủ, sử dụng Pop3Client lớp. Pop3Client lớp là điểm vào chính cho các nhà phát triển muốn thêm quản lý POP3 vào ứng dụng .NET của họ. Bài viết này giải thích cách sử dụng. Để kết nối tới máy chủ POP3:

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

Đoạn mã dưới đây cho bạn thấy cách kết nối với máy chủ POP3.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username, password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
System.out.println("Connected to POP3 server.");

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

Kết nối tới Máy chủ POP3 đã mô tả cách kết nối tới máy chủ POP3 trong ba bước đơn giản:

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

Quá trình kết nối tới máy chủ POP3 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:

SecurityOptions
Cổng

Để kết nối tới máy chủ POP3 hỗ trợ SSL, sử dụng Pop3Client lớp và đặt SecurityOptions và các thuộc tính Port. Đoạn mã dưới đây cho bạn thấy cách kết nối tới máy chủ POP3 hỗ trợ SSL.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username and password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
System.out.println("Connecting to POP3 server using SSL.");

Kết nối với Máy chủ APOP

POP là viết tắt của Post Office Protocol. APOP là viết tắt của Authenticated Post Office Protocol. APOP là phiên bản mở rộng của cài đặt máy chủ POP3, mã hoá tên người dùng và mật khẩu của bạn và sử dụng cơ chế xác thực được thiết kế để bảo vệ mật khẩu tài khoản POP3 khi kiểm tra email. Xác thực APOP không yêu cầu mật khẩu tài khoản được gửi dưới dạng văn bản thuần tới máy chủ email POP3.

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

Máy chủ proxy rất phổ biến để giao tiếp với bên ngoài. Trong những trường hợp này, địa chỉ proxy được sử dụng để các client email truy cập hộp thư qua Internet. 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 ví dụ thực tế về việc lấy email bằng máy chủ proxy. Để lấy email qua một máy chủ proxy:

Khởi tạo Proxy 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 Pop3Client 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.
Đặt thuộc tính Proxy của client thành Proxy đối tượng được tạo ở trên.

Đoạn mã dưới đây cho bạn thấy cách lấy email qua máy chủ proxy.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client("pop.domain.com", "username", "password");

// Set proxy address, Port and Proxy
String proxyAddress = "192.168.203.142";
int proxyPort = 1080;
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);
client.setProxy(proxy);
Pop3MailboxInfo mailboxInfo = client.getMailboxInfo();

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

// 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);
try (Pop3Client client = new Pop3Client("imap.domain.com", "username", "password")) {
    client.setProxy(proxy);
    Pop3MailboxInfo mailboxInfo = client.getMailboxInfo();
}

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ủ POP3 hỗ trợ bằng cách sử dụng getSupportedAuthentication phương thức của Pop3Client 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:

pop3Client.setAllowedAuthentication(Pop3KnownAuthenticationType.Plain);

Hỗ trợ giao thức OAuth 2.0 cho ủy quyền

OAuth 2.0 cung cấp ủy quyền

Pop3Client hỗ trợ OAuth 2.0, cung cấp các cách ủy quyền cụ thể cho ứng dụng. Các hàm khởi tạo sau được sử dụng để khởi tạo POP3Client bằng OAuth:

public Pop3Client(

            String host, /*The host name*/

            int port, /*The port number*/ 

            String username, /*The user name*/

            ITokenProvider tokenProvider, /*TokenProvider allowing to retrieve access token*/

            /*SecurityOptions*/int securityOptions) /*Security mode for a mail client*/



public Pop3Client(

            String host, /*The host name*/

            int port, /*The port number*/

            String username, /*The user name*/

            String authInfo, /*The user password or XOAUTH2 access token*/

            boolean useOAuth, /*Defines whether SASL XOAUTH2 mechanism is used to login to the server*/

            /*SecurityOptions*/int securityOptions) /*Security mode for a mail client*/

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 (Pop3Client pop3Client = new Pop3Client(
        server.Pop3Url, server.Pop3Port, "userName", "password", SecurityOptions.Auto)) {
    pop3Client.setTimeout(4000);

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

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 bảo mật với máy chủ POP3, bạn có thể chỉ định và ép buộc việc sử dụng CRAM-MD5 làm phương thức xác thực được phép cho client POP3. Đoạn mã dưới đây cho thấy cách cấu hình kiểu xác thực được phép cho Pop3Client:

popClient.setAllowedAuthentication(Pop3KnownAuthenticationType.CramMD5);

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 (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.setTimeout(60000); // 60 seconds

    // some code...
}

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

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

Aspose.Email là một thành phần mạnh mẽ cho phép thực hiện các thao tác tùy chỉnh sau một số hành động nhất định. Aspose.Email kích hoạt nhiều sự kiện, cho phép người dùng thực hiện các thao tác. Tính năng này cung cấp cho người dùng quyền kiểm soát nhiều hơn đối với ứng dụng của họ. Ví dụ, người dùng có thể thực hiện các hành động mong muốn khi:

Tất cả email hàng loạt đã được gửi.
Tin nhắn sắp được gửi.
Email đã được gửi hoàn toàn.
Khi người nhận bị máy chủ SMTP từ chối.

Các hộp thư POP3 nằm trên máy chủ POP3. Email trong những hộp thư này có thể được lấy về PC của bạn bằng cách Pop3Client. Thuộc tính Pop3Client lớp sử dụng giao thức POP3 để sao chép các tin nhắn email từ hộp thư POP3 của bạn về máy tính. Khi email đã được lấy về, bạn không cần kết nối internet trong khi đọc vì đã có thể đọc email đã lấy trên PC. Nếu bạn không cần hoặc không muốn giữ bản sao của một số tin nhắn trên máy chủ POP3, bạn có thể xóa chúng. Phần này trình bày cách xóa email bằng cách sử dụng Pop3Client lớp.

Xóa Email theo Chỉ số

Đoạn mã dưới đây xóa tất cả các tin nhắn email của một hộp thư một cách tuần tự, dựa trên chỉ số của chúng. Chỉ số không bao giờ nên <=0 trong Pop3Client.deleteMessage.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create a POP3 client
Pop3Client client = new Pop3Client("mail.aspose.com", 110, "username", "psw");
try {
    // Delete all the message one by one
    int messageCount = client.getMessageCount();
    for (int i = 1; i <= messageCount; i++) {
        client.deleteMessage(i);
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}

Xóa Tất cả Email

Chúng ta cũng có thể gọi Pop3Client.deleteMessages để xóa tất cả các tin nhắn. Đoạn mã dưới đây cho bạn thấy cách xóa tất cả email.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Delete all the messages
client.deleteMessages();

Nếu kết nối tới máy chủ POP3 bị ngắt ngay sau các thao tác xóa, bạn sẽ không thể gọi Pop3Client.cancelDeletes() để thực hiện những việc bạn muốn.

Hủy Xóa

Pop3Client.undeleteMessages có thể được sử dụng để hủy việc xóa các tin nhắn email. Đoạn mã dưới đây cho bạn thấy cách hủy việc xóa.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Cancel deletes
client.undeleteMessages();

Java: Liệt kê các Extension của Máy chủ bằng Pop3Client

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

Aspose.Email Pop3Client 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 string.

Lấy các Phần Mở Rộng của Máy Chủ

Đoạn mã mẫu dưới đây trình bày việc lấy các extension của máy chủ bằng Pop3Client cho máy chủ Gmail.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Connect and log in to POP3
Pop3Client client = new Pop3Client("pop.gmail.com", "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);
client.setPort(995);
String[] getCaps = client.getCapabilities();
for (String item : getCaps) {
    System.out.println(item);
}

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

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

Lấy thông tin Hộp thư

Chúng ta có thể lấy thông tin về hộp thư như số lượng tin nhắn và kích thước hộp thư bằng cách sử dụng getMailBoxSize và getMailBoxInfo phương thức của Pop3Client lớp.

Cái getMailBoxSize phương thức trả về kích thước của hộp thư tính bằng byte.
Cái getMailBoxInfo phương thức trả về một đối tượng kiểu Pop3MailBoxInfo.

Cũng có thể lấy số lượng tin nhắn bằng cách sử dụng MessageCount thuộc tính và kích thước bằng cách sử dụng OccupiedSize thuộc tính của Pop3MailBoxInfo lớp. Đoạn mã mẫu sau cho thấy cách lấy thông tin về hộp thư. Nó cho thấy cách:

Tạo một Pop3Client.
Kết nối đến máy chủ POP3.
Lấy kích thước của hộp thư.
Lấy thông tin hộp thư.
Lấy số lượng tin nhắn trong hộp thư.
Lấy kích thước đã chiếm.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

Pop3Client client = new Pop3Client();
// Specify host, username, password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);

// Get the size of the mailbox, Get mailbox info, number of messages in the mailbox
long nSize = client.getMailboxSize();
System.out.println("Mailbox size is " + nSize + " bytes.");
Pop3MailboxInfo info = client.getMailboxInfo();
int nMessageCount = info.getMessageCount();
System.out.println("Number of messages in mailbox are " + nMessageCount);
long nOccupiedSize = info.getOccupiedSize();
System.out.println("Occupied size is " + nOccupiedSize);

Lấy số lượng Email trong Hộp thư

Đoạn mã sau cho bạn thấy cách đếm số tin nhắn email trong hộp thư.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
Pop3Client client = new Pop3Client("pop3.server.com", "username", "password");
try {
    client.setSecurityOptions(SecurityOptions.Auto);
    int i = client.getMessageCount();
    System.out.println("Message count: " + i);
} catch (Pop3Exception ex) {
    System.out.println("Error:" + ex.toString());
}

Aspose.Email cho phép các nhà phát triển làm việc với email theo nhiều cách khác nhau. Ví dụ, họ có thể lấy thông tin tiêu đề trước khi quyết định tải xuống một email. Hoặc họ có thể lấy email từ máy chủ và lưu chúng mà không cần phân tích (nhanh hơn) hoặc sau khi phân tích (chậm hơn). Bài viết này cho thấy cách lấy và chuyển đổi email.

Truy xuất thông tin tiêu đề Email

Tiêu đề email có thể cung cấp cho chúng ta thông tin về một tin nhắn email mà chúng ta có thể dùng để quyết định có nên lấy toàn bộ tin nhắn email hay không. Thông thường, thông tin tiêu đề bao gồm người gửi, chủ đề, ngày nhận, v.v. (Tiêu đề email được mô tả chi tiết trong Tùy chỉnh tiêu đề Email. Chủ đề đó cụ thể nói về việc gửi email bằng SMTP, nhưng thông tin nội dung tiêu đề email vẫn áp dụng cho email POP3). Các ví dụ sau cho thấy cách lấy tiêu đề email từ máy chủ POP3 bằng số thứ tự tin nhắn.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username. password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
try {
    HeaderCollection headers = client.getMessageHeaders(1);
    for (int i = 0; i < headers.size(); i++) {
        // Display key and value in the header collection
        System.out.print(headers.getKey(i));
        System.out.print(" : ");
        System.out.println(headers.get(i));
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

Truy xuất tin nhắn Email

Cái Pop3Client thành phần lớp cung cấp khả năng truy xuất các tin nhắn email từ máy chủ POP3 và phân tích chúng thành một MailMessage đối tượng với sự giúp đỡ của MailMessage thành phần. The MailMessage lớp chứa nhiều thuộc tính và phương thức để thao tác nội dung email. Bằng cách sử dụng fetchMessage phương thức của Pop3Client lớp, bạn có thể nhận được một MailMessage được lấy trực tiếp từ máy chủ POP3. Đoạn mã dưới đây cho bạn thấy cách lấy một email đầy đủ từ máy chủ POP3.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username, password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
try {
    int messageCount = client.getMessageCount();
    // Create an instance of the MailMessage class and Retrieve message
    MailMessage message;
    for (int i = 1; i <= messageCount; i++) {
        message = client.fetchMessage(i);
        System.out.println("From:" + message.getFrom());
        System.out.println("Subject:" + message.getSubject());
        System.out.println(message.getHtmlBody());
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

Lấy Thông tin Tóm tắt Tin nhắn bằng Id duy nhất

Client POP3 của API có thể lấy thông tin tóm tắt tin nhắn từ máy chủ bằng cách sử dụng ID duy nhất của tin nhắn. Điều này cung cấp truy cập nhanh tới thông tin ngắn gọn của tin nhắn mà không cần phải lấy toàn bộ tin nhắn từ máy chủ. Đoạn mã dưới đây cho bạn thấy cách lấy thông tin tóm tắt tin nhắn.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String uniqueId = "unique id of a message from server";
Pop3Client client = new Pop3Client("host.domain.com", 456, "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);
Pop3MessageInfo messageInfo = client.getMessageInfo(uniqueId);

if (messageInfo != null) {
    System.out.println(messageInfo.getSubject());
    System.out.println(messageInfo.getDate());
}

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

Pop3Client 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 Pop3Client.ConnectionsQuantity. Đoạn mã dưới đây 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 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
// Create an instance of the Pop3Client class
Pop3Client pop3Client = new Pop3Client();
pop3Client.setHost("<HOST>");
pop3Client.setPort(995);
pop3Client.setUsername("<USERNAME>");
pop3Client.setPassword("<PASSWORD>");

pop3Client.setConnectionsQuantity(5);
pop3Client.setUseMultiConnection(MultiConnectionMode.Enable);
long multiConnectionModeStartTime = System.currentTimeMillis();
Pop3MessageInfoCollection messageInfoCol1 = pop3Client.listMessages();
long multiConnectionModeTimeSpan = System.currentTimeMillis() - multiConnectionModeStartTime;

pop3Client.setUseMultiConnection(MultiConnectionMode.Disable);
long singleConnectionModeStartTime = System.currentTimeMillis();
Pop3MessageInfoCollection messageInfoCol2 = pop3Client.listMessages();
long singleConnectionModeTimeSpan = System.currentTimeMillis() - singleConnectionModeStartTime;

System.out.println("multyConnectionModeTimeSpan: " + multiConnectionModeTimeSpan);
System.out.println("singleConnectionModeTimeSpan: " + singleConnectionModeTimeSpan);
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 từ máy chủ và lưu vào đĩa

Lưu tin nhắn vào đĩa mà không phân tích

Nếu bạn muốn tải xuống các tin nhắn email từ máy chủ POP3 mà không phân tích chúng, hãy sử dụng Pop3Client lớp saveMessage hàm. Các saveMessage hàm không phân tích tin nhắn email nên nhanh hơn so với fetchMessage hàm. Đoạn mã sau cho thấy cách lưu một tin nhắn theo số thứ tự của nó, trong trường hợp này là số 1. Các saveMessage phương thức lưu tin nhắn ở định dạng EML nguyên gốc mà không phân tích.

// 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 = "pop3/";
String dstEmail = dataDir + "InsertHeaders.eml";

// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username, password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);

try {
    // Save message to disk by message sequence number
    client.saveMessage(1, dstEmail);
    client.dispose();
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}
System.out.println("Retrieved email messages using POP3 ");

Phân tích tin nhắn trước khi lưu

Đoạn mã sau sử dụng Pop3Client fetchMessage phương thức để lấy một tin nhắn từ máy chủ POP3 bằng số thứ tự của nó, sau đó lưu tin nhắn vào đĩa sử dụng tiêu đề làm tên tệp.

// 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 = "pop3/";

// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username and password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);

try {
    // Fetch the message by its sequence number and Save the message using its subject as the file name
    MailMessage msg = client.fetchMessage(1);
    msg.save(dataDir + "first-message_out.eml", SaveOptions.getDefaultEml());
    client.dispose();
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

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

Pop3Client 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
// Create an instance of the Pop3Client class
Pop3Client pop3Client = new Pop3Client();
pop3Client.setHost("<HOST>");
pop3Client.setPort(995);
pop3Client.setUsername("<USERNAME>");
pop3Client.setPassword("<PASSWORD>");

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

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

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

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

Lọc tin nhắn theo Người gửi, Người nhận hoặc Ngày

Cái Pop3Client lớp, được mô tả trong Kết nối tới Máy chủ POP3, 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 để chỉ định các điều kiện truy vấn, ví dụ: ngày, tiêu đề, người gửi, người nhận, v.v. Các MailQueryBuilder lớp được sử dụng để xây dựng biểu thức tìm kiếm. Đầu tiên, tất cả các điều kiện và ràng buộc được đặt và sau đó MailQuery được điền bằng truy vấn được phát triển bởi MailQueryBuilder. Thuộc tính MailQuery đối tượng lớp được sử dụng bởi Pop3Client để trích xuất thông tin đã lọc từ máy chủ. Bài viết này cho thấy cách lọc các tin nhắn email từ một hộp thư. 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. Nó cũng trình bày việc áp dụng bộ lọc ngày và thời gian để lấy các email cụ thể từ hộp thư. Ngoài ra, nó còn chỉ cách áp dụng bộ lọc phân biệt chữ hoa chữ thường.

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ủ POP3.
Tạo một thể hiện của MailQuery và đặt các thuộc tính mong muốn.
Gọi Pop3Client.listMessages(MailQuery query) phương thức và truyền vào MailQuery trong các tham số để chỉ lấy 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ư POP3 và lấy 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 POP3
String host = "host";
int port = 110;
String username = "user@host.com";
String password = "password";
Pop3Client client = new Pop3Client(host, port, username, password);

// Set conditions, Subject contains "Newsletter", Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.getSubject().contains("Newsletter");
builder.getInternalDate().on(new Date());
// Build the query and Get list of messages
MailQuery query = builder.getQuery();
Pop3MessageInfoCollection messages = client.listMessages(query);
System.out.println("Pop3: " + messages.size() + " message(s) found.");

Lấy các 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 hỗ trợ khác. 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 cho thấy cách lọc email theo các tiêu chí khác:

Tìm email được gửi hôm nay.
Tìm email nhận được trong một khoảng thời gian.
Tìm email từ người gửi cụ thể.
Tìm email được gửi từ miền cụ thể.
Tìm email được gửi tới người nhận cụ thể.

Ngày hôm nay

Đoạn mã sau cho bạn thấy cách tìm email được gửi 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());

Khoảng ngày

Đoạn mã sau cho bạn thấy cách tìm email nhận được trong một khoảng thời gian.

// 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 calendar = Calendar.getInstance();

builder.getInternalDate().before(calendar.getTime());
calendar.add(Calendar.DATE, -7);
builder.getInternalDate().since(calendar.getTime());

Người gửi cụ thể

Đoạn mã sau cho bạn thấy cách tìm email từ 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 tìm email được gửi từ một 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 tìm email được gửi đế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 calendar = Calendar.getInstance();

builder.getInternalDate().before(calendar.getTime());
calendar.add(Calendar.DATE, -7);
builder.getInternalDate().since(calendar.getTime());

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

MailQueryBuilder cung cấp hoặc phương thức nhận hai MailQuery các thể hiện làm tham số. Nó lấy những tin nhắn phù hợp với bất kỳ một trong hai điều kiện đã chỉ định. Đoạn mã sau cho thấy cách lọc tin nhắn mà trong tiêu đề có "test" hoặc người gửi là "noreply@host.com". Đ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"));

Áp dụng bộ lọc phân biệt chữ hoa chữ thường

API cũng cung cấp khả năng lọc email từ hộp thư dựa trên tiêu chí phân biệt chữ hoa chữ thường. Các phương thức sau cung cấp khả năng tìm kiếm email bằng cách chỉ định cờ phân biệt chữ hoa chữ thường.

Method StringComparisonField.contains(String value, boolean ignoreCase)
Method StringComparisonField.equals(String value, boolean ignoreCase)
Method StringComparisonField.notContains(String boolean, bool ignoreCase)
Method StringComparisonField.notEquals(String boolean, bool ignoreCase)

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// IgnoreCase is True
MailQueryBuilder builder1 = new MailQueryBuilder();
builder1.getFrom().contains("tesT", true);
MailQuery query1 = builder1.getQuery();
Pop3MessageInfoCollection messageInfoCol1 = client.listMessages(query1);

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

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

Làm việc với Pop3Client Bất đồng bộ

Tin nhắn cũng có thể được lấy từ hộp thư bất đồng bộ bằng cách sử dụng Aspose.Email Pop3Client. Bài viết này trình bày cách lấy tin nhắn từ hộp thư một cách bất đồng bộ. Nó cũng chỉ ra 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.

Lấy Tin nhắn Bất đồng bộ

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

Pop3Client client = new Pop3Client();
client.setHost("pop.gmail.com");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.SSLImplicit);
client.setUsername("username");
client.setPassword("password");

try {
    Pop3MessageInfoCollection messages = client.listMessages();
    System.out.println("Total Number of Messages in inbox:" + messages.size());
    IAsyncResult asyncResult = client.beginFetchMessage(messages.get_Item(0).getSequenceNumber());
    MailMessage message = client.endFetchMessage(asyncResult);
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}

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 lấy danh sách tin nhắn bất đồng bộ như trong đoạn mã mẫu dưới đây.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

MailQueryBuilder builder = new MailQueryBuilder();
builder.getSubject().contains("Subject");
MailQuery query = builder.getQuery();
IAsyncResult asyncResult = client.beginListMessages(query);
Pop3MessageInfoCollection messages = client.endListMessages(asyncResult);