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

Python-Net: Kết nối tới máy chủ POP3 trong Python

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

Kết nối tới máy chủ POP3 bằng Xác thực Cơ bản

API Aspose.Email cho Python cung cấp Pop3Client lớp, cho phép các ứng dụng quản lý hộp thư qua Giao thức Bưu điện Phiên bản 3 (POP3). Sử dụng lớp này để thiết lập kết nối với máy chủ POP3. Nó là giao diện chính cho các nhà phát triển muốn tích hợp quản lý POP3 vào ứng dụng .NET của mình. Bài viết này cung cấp hướng dẫn sử dụng lớp Pop3Client một cách hiệu quả.

Đoạn mã dưới đây minh họa cách thiết lập kết nối tới máy chủ email POP3 bằng Aspose.Email Pop3Client lớp. Nó minh họa quy trình cấu hình kết nối với các tham số thiết yếu như địa chỉ máy chủ, thông tin đăng nhập người dùng, cài đặt bảo mật và số cổng. Cấu hình này cần thiết để lấy email một cách an toàn từ tài khoản Gmail.

Tạo một thể hiện của Pop3Client.
Xác định máy chủ, tên người dùng, mật khẩu, cổng và các tùy chọn bảo mật.

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

Để kết nối tới máy chủ POP3 hỗ trợ SSL, sử dụng Aspose.Email Pop3Client lớp và đặt các tùy chọn bảo mật và thuộc tính cổng. Đ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:

Kết nối tới máy chủ POP3 với xác thực APOP

APOP (Giao thức Bưu điện Xác thực) là phương pháp bảo mật để lấy email từ máy chủ mail. Nó nâng cao giao thức POP3 truyền thống bằng cách thêm lớp xác thực bảo vệ thông tin đăng nhập người dùng.

Thay vì gửi tên người dùng và mật khẩu dưới dạng văn bản thuần, APOP sử dụng giá trị băm trong quá trình xác thực. Khi đăng nhập, client tạo một hàm băm bằng khóa bí mật (mật khẩu của người dùng) và một giá trị thách thức (chuỗi duy nhất được máy chủ tạo ra).

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

Máy chủ proxy hoạt động như trung gian giữa client email của bạn và máy chủ mail khi giao tiếp với bên ngoài. Thay vì kết nối trực tiếp tới máy chủ mail, các yêu cầu email của bạn sẽ đi qua proxy, mang lại nhiều lợi thế như ẩn địa chỉ IP và truy cập nội dung bị hạn chế. Sử dụng proxy có thể nâng cao tính riêng tư và bảo mật, đặc biệt khi truy cập email qua mạng công cộng.

Aspose.Email hỗ trợ việc sử dụng máy chủ proxy, cụ thể là các phiên bản 4, 4a và 5 của giao thức proxy SOCKS. Khả năng này cho phép các nhà phát triển tạo ứng dụng có thể giao tiếp hiệu quả với máy chủ mail thông qua proxy. Pop3Client lớp cho phép các ứng dụng truy cập và thao tác các tin nhần bằng Giao thức Bưu điện Phiên bản 3 (POP3). Một phương pháp hữu ích là getmailboxinfo(), lấy thông tin quan trọng về hộp thư, như số lượng tin nhắn và tổng kích thước, giúp quản lý tài khoản email hiệu quả hơn.

Đoạn mẫu mã dưới đây minh họa cách lấy email bằng máy chủ mail proxy với Aspose.Email:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("pop.domain.com", "username", "password")
# Set proxy address, Port and Proxy
proxy_address = "192.168.203.142"
proxy_port = 1080
proxy = ae.clients.SocksProxy(proxy_address, proxy_port, ae.clients.SocksVersion.SOCKS_V5)
client.socks_proxy = proxy
mailboxInfo = client.get_mailbox_info()

Hỗ trợ Proxy HTTP

Có nhiều loại proxy khác nhau, bao gồm proxy HTTP, proxy SOCKS, và các loại khác, mỗi loại phục vụ các mục đích khác nhau và cung cấp các mức chức năng khác nhau. Các bước và cấu hình cụ thể có thể thay đổi tùy thuộc vào loại proxy được sử dụng. Đoạn mẫu mã dưới đây minh họa cách thiết lập Pop3Client với cấu hình bổ sung của proxy HTTP và lấy thông tin về hộp thư:

import aspose.email as ae

proxy = ae.clients.HttpProxy("18.222.124.59", 8080)
client = ae.clients.pop3.Pop3Client("pop.domain.com", "username", "password")
client.socks_proxy = proxy
mailboxInfo = client.get_mailbox_info()

Kết nối tới máy chủ bằng xác thực CRAM-MD5

CRAM-MD5 (Cơ chế xác thực Thách thức-Đáp trả với MD5) thường được sử dụng trong các giao thức email như POP3 và IMAP, nơi bảo mật xác thực quan trọng. Nó cung cấp mức độ bảo mật cao hơn so với việc truyền mật khẩu dạng văn bản. Aspose.Email cho .NET cho phép người dùng xác thực an toàn và truy cập máy chủ email hỗ trợ phương pháp xác thực này.

client.allowed_authentication = ae.clients.pop3.Pop3KnownAuthenticationType.CRAM_MD5

Cấu hình thời gian chờ cho thao tác mail

Aspose.Email cung cấp thuộc tính ’timeout’ của Pop3Client lớp để lấy hoặc đặt thời gian chờ cho các thao tác mail nhằm ngăn treo hoặc chặn, xử lý sự cố mạng hoặc máy chủ, nâng cao độ phản hồi và đảm bảo quản lý tài nguyên hiệu quả. Đoạn mẫu mã dưới đây cho thấy cách triển khai thuộc tính này vào dự án:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
#  60 seconds
client.timeout = 60000

Sử dụng giao thức mật mã với client POP3

Aspose.Email hỗ trợ các giao thức mật mã SSL (cũ) và TLS để cung cấp bảo mật giao tiếp. Bạn có thể bật mã hóa mật mã để bảo vệ việc trao đổi dữ liệu giữa ứng dụng và máy chủ thư.

NOTE: It's important to know that you can only configure protocol versions supported by the .NET Framework. If your current .NET Framework version does not support certain protocol versions, those unsupported versions will be disregarded and skipped. This could result in a potential downgrade in TLS security level, and it's crucial to be aware that no exceptions will be raised in this situation. Developers should exercise caution to ensure the desired TLS security level is maintained based on the supported protocols in their .NET Framework environment.

Đoạn mẫu mã sau đây minh họa cách thiết lập client POP3 với cấu hình cho giao thức mã hóa TLS 1.3 để giao tiếp an toàn:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.supported_encryption = ae.clients.base.EncryptionProtocols.TLS13

Trong trường hợp giao thức mã hóa được chỉ định không được hỗ trợ trong phiên bản hiện tại của .NET Framework, sự khác biệt trong hành vi giữa phương thức ‘SetSupportedEncryptionUnsafe’ và thuộc tính ‘SupportedEncryption’ như sau:

Nếu thuộc tính ‘SupportedEncryption’ được sử dụng, client email sẽ hạ cấp giao thức mã hóa xuống mức hỗ trợ.

Nếu phương thức ‘SetSupportedEncryptionUnsafe’ được sử dụng, client email sẽ ném ra ngoại lệ.

Python-Net: Xóa email từ máy chủ POP3 trong Python

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

Aspose.Email cho .NET cung cấp khả năng kiểm soát hoàn toàn việc quản lý tin nhắn trên máy chủ POP3. Sử dụng Pop3Client Lớp, các nhà phát triển có thể kết nối tới hộp thư và thực hiện nhiều tác vụ trên các tin nhắn từ máy chủ một cách lập trình, bao gồm xóa các tin nhắn cụ thể hoặc toàn bộ. Điều này đặc biệt hữu ích trong các ứng dụng xử lý email phía máy chủ, nơi cần làm sạch email sau khi lấy về hoặc dựa trên logic tùy chỉnh.

Bài viết này giải thích cách xóa tin nhắn bằng client POP3 của Aspose.Email trong các kịch bản khác nhau.

Xóa Email theo Chỉ mục

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

Xóa Tất cả Email

Cũng có thể gọi delete_messages() phương pháp để xóa tất cả các tin nhắn. Đoạn mã dưới đây cho thấy cách sử dụng phương pháp này:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("imap.example.com", "username", "password")

# Delete all the messages
client.delete_messages()

Nếu kết nối tới máy chủ POP3 bị mất ngay sau thao tác xóa, undelete_messages() phương pháp không còn có thể gọi để khôi phục dữ liệu.

Hủy các thao tác xóa

Phương pháp undelete_messages có thể được dùng để hủy việc xóa các tin nhắn email. Đoạn mã dưới đây cho thấy cách sử dụng phương pháp này:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("imap.example.com", "username", "password")

# Cancel deletes
client.undelete_messages()

Python-Net: Liệt kê các phần mở rộng máy chủ POP3 được hỗ trợ

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

Aspose.Email cung cấp một Pop3Client lớp cho phép bạn lấy các phần mở rộng được hỗ trợ của máy chủ POP3, như IDLE, UNSELECT, QUOTA, và hơn thế nữa. Biết được các phần mở rộng nào khả dụng là rất quan trọng để xác định liệu các chức năng cụ thể có thể được sử dụng hay không. get_capabilities() 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ẫu mã dưới đây minh họa cách truy xuất các phần mở rộng của máy chủ bằng Pop3Client cho máy chủ Gmail:

Python-Net: Tính năng tiện ích - Máy khách POP3

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

Xác minh thông tin đăng nhập máy chủ thư

Aspose.Email cung cấp phương thức ‘validate_credentials()’ của Pop3Client lớp để xác minh thông tin đăng nhập (tên người dùng và mật khẩu) do người dùng cung cấp để truy cập máy chủ email POP3. Phương pháp này đảm bảo rằng thông tin đăng nhập của người dùng là chính xác và hợp lệ, cho phép họ xác thực thành công và truy cập tài khoản email bằng giao thức POP3. Nếu thông tin đăng nhập không đúng, phương pháp có thể trả về lỗi hoặc ném ngoại lệ, cho biết quá trình đăng nhập đã thất bại.

Đoạn mã dưới đây mô tả phương pháp xác minh được cung cấp bởi API:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 40000
if client.validate_credentials():
# to do something

Python-Net: Xác minh thông tin đăng nhập máy chủ POP3 trong Python

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

Aspose.Email cung cấp validate_credentials() phương thức của Pop3Client lớp để xác minh thông tin đăng nhập (tên người dùng và mật khẩu) của người dùng cho máy chủ email POP3. Phương pháp này đảm bảo thông tin đăng nhập hợp lệ, cho phép xác thực thành công và truy cập hộp thư bằng giao thức POP3. Nếu thông tin đăng nhập không đúng, phương pháp trả về ‘False’ hoặc ném ngoại lệ, cho biết xác thực thất bại.

Đoạn mã dưới đây mô tả cách xác minh thông tin đăng nhập máy chủ POP3 bằng API Aspose.Email:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 40000
if client.validate_credentials():
# to do something

Python-Net: Bật ghi nhật ký hoạt động máy chủ POP3 trong Python

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

Ghi nhật ký hoạt động cho phép bạn giám sát và ghi lại các hành động của client Pop3 khi kết nối và tương tác với máy chủ POP3. Kích hoạt tính năng này giúp khắc phục sự cố, cải thiện giám sát bảo mật và hỗ trợ tuân thủ các chính sách lưu trữ dữ liệu và quyền riêng tư.

Ví dụ dưới đây cho thấy cách bật ghi nhật ký hoạt động bằng Aspose.Email Pop3Client lớp:

Tạo một thể hiện của Pop3Client, chỉ định máy chủ, cổng, tên người dùng và mật khẩu, cùng các tùy chọn bảo mật.
Đặt đường dẫn cho tệp nhật ký bằng log_file_name thuộc tính.
Tùy chọn, điều chỉnh cài đặt ghi nhật ký bằng cách đặt use_date_in_log_file_name thuộc tính nếu cần.

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
# Set the path to the log file using the LogFileName property.
client.log_file_name = "C:\\Aspose.Email.Pop3.log"
# Set the UseDateInLogFileName property if it is necessary.
client.use_date_in_log_file_name = False

Python-Net: 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 các phương thức GetMailBoxSize() và GetMailBoxInfo().

Phương thức GetMailBoxSize() trả về kích thước của hộp thư tính bằng byte.
Phương thức GetMailBoxInfo() trả về một đối tượng kiểu Pop3MailBoxInfo.

Cũng có thể lấy số lượng tin nhắn bằng thuộc tính MessageCount và kích thước bằng thuộc tính OccupiedSize. Đoạn mã mẫu dưới đây cho thấy cách lấy thông tin về hộp thư. Nó chỉ ra 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.

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

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

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

Truy xuất tin nhắn Email

Thành phần lớp Aspose.Email.Pop3 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 đối tượng MailMessage bằng sự hỗ trợ của các thành phần MailMessage. Lớp MailMessage 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 hàm FetchMessage của lớp Pop3Client, bạn có thể lấy một đối tượng MailMessage trực tiếp từ máy chủ POP3. Đoạn mã mẫu sau cho thấy cách lấy một email hoàn chỉnh từ máy chủ POP3.

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

POP3 Client 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 vào thông tin ngắn gọn của tin nhắn mà không cần tải toàn bộ tin nhắn trước. Đoạn mã mẫu sau cho thấy cách lấy thông tin tóm tắt tin nhắn.

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

Đối với các thao tác nặng, Aspose.Email cung cấp thuộc tính ‘use_multi_connection’ của Pop3Client lớp để sử dụng nhiều kết nối khi truy xuất email. Tuy nhiên, việc sử dụng chế độ này không nhất thiết sẽ tăng hiệu năng. Đoạn mã mẫu dưới đây cho thấy cách thiết lập kết nối tới máy chủ POP3, cấu hình client cho phép tối đa 5 kết nối đồng thời và bật chế độ đa kết nối để lấy thông tin về các tin nhắn có trên máy chủ:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
message_info_coll = client.list_messages()

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 hàm SaveMessage của lớp Pop3Client. Hàm SaveMessage không phân tích nội dung email nên nhanh hơn hàm FetchMessage. Đoạn mã mẫu 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. Phương thức SaveMessage lưu tin nhắn ở định dạng EML gốc mà không phân tích.

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

Sử dụng phương thức ‘fetch_message’ của đối tượng client được tạo bằng Pop3Client lớp để truy xuất tin nhắn với số thứ tự cụ thể. Đoạn mã mẫu dưới đây minh họa cách lấy một tin nhắn cụ thể và lưu nó bằng tiêu đề của tin nhắn làm tên tệp bằng cách gọi phương thức ‘save’ trên đối tượng msg:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

# Fetch the message by its sequence number and Save the message using its subject as the file name
msg = client.fetch_message(1)
msg.save("first-message_out.eml", ae.SaveOptions.default_eml)

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

Lớp Pop3Client, được mô tả trong phần Kết nối tới máy chủ POP3, cung cấp phương thức list_messages() để lấy tất cả tin nhắn từ hộp thư. Để chỉ lấy những tin nhắn thỏa mãn một số điều kiện, sử dụng phương thức ListMessages() được overload, nhận một đối số là MailQuery. Lớp MailQuery 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. Lớp MailQueryBuilder được dùng để xây dựng biểu thức tìm kiếm. Đầu tiên, đặt tất cả các điều kiện và ràng buộc, sau đó MailQuery được điền với truy vấn do MailQueryBuilder tạo ra. Đối tượng lớp MailQuery được Pop3Client dùng để trích xuất thông tin đã lọc từ máy chủ. Bài viết này chỉ ra cách lọc email 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 trình bày cách lọc theo các tiêu chí khác và cách xây dựng truy vấn phức tạp hơn. Ngoài ra, nó còn cho thấy cách áp dụng bộ lọc Ngày và Giờ để lấy các email cụ thể từ hộp thư. Thêm nữa, cách áp dụng lọc phân biệt chữ hoa chữ thường cũng được trình bày.

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à thiết lập các thuộc tính mong muốn.
Gọi phương thức Pop3Client.list_messages(MailQuery query) và truyền MailQuery vào tham số để chỉ lấy các tin nhắn đã lọc.

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

Lấy các tin nhắn đáp ứng tiêu chí cụ thể

Aspose.Email cũng cho phép xây dựng tiêu chí tìm kiếm phức tạp để truy vấn và lọc email. Để mục đích này, sử dụng MailQueryBuilder lớp và các thuộc tính của nó. Các tiêu chí để lấy dữ liệu như sau:

Lấy tin nhắn theo ngày giao nhận.
Lấy tin nhắn trong một khoảng.
Lấy tin nhắn từ một người gửi cụ thể.
Lấy tin nhắn từ một miền cụ thể.
Lấy tin nhắn tới một người nhận cụ thể.

Ngày hôm nay

Để lấy tin nhắn theo ngày giao nhận, sử dụng thuộc tính ‘internal_date’ như trong đoạn mã mẫu dưới đây:

import aspose.email as ae
from datetime import datetime

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.on(datetime.now())

Khoảng ngày

Để lấy tin nhắn trong một khoảng thời gian, sử dụng cùng thuộc tính ‘internal_date’ chỉ định khoảng ngày như trong đoạn mã mẫu dưới đây:

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
# Emails that arrived in last 7 days
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))

Người gửi cụ thể

Để lấy tin nhắn từ người gửi cụ thể, sử dụng thuộc tính ‘from_address’ như trong đoạn mã mẫu dưới đây:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("saqib.razzaq@127.0.0.1")

Miền cụ thể

Để lấy tin nhắn từ một miền cụ thể, sử dụng thuộc tính ‘from_address’ như trong đoạn mã mẫu dưới đây:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("SpecificHost.com")

Người nhận cụ thể

Để lấy tin nhắn gửi tới một người nhận cụ thể, sử dụng thuộc tính ’to’ như trong đoạn mã mẫu dưới đây:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.to.contains("recipient")

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

Đôi khi cần thỏa mãn hơn một truy vấn. Aspose.Email cho phép điều này bằng cách kết hợp các truy vấn trong nhiều câu lệnh. Tạo một MailQueryBuilder đối tượng và sử dụng các thuộc tính của nó để xây dựng các truy vấn cụ thể.

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.

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))
builder.from_address.contains("SpecificHost.com")

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

Đoạn mã mẫu sau cho bạn cách kết hợp các truy vấn với OR.

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.either(builder.subject.contains("test"), builder.from_address.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 của StringComparisonField lớp cung cấp khả năng tìm kiếm email với cờ phân biệt chữ hoa chữ thường.

Phương thức Aspose.Email.StringComparisonField.contains(value, ignore_case) Phương thức Aspose.Email.StringComparisonField.equals(value, ignore_case) Phương thức Aspose.Email.StringComparisonField.not_contains(value, ignore_case) Phương thức Aspose.Email.StringComparisonField.not_equals(value, ignore_case)

Đoạn mã mẫu sau cho thấy cách triển khai khả năng này vào dự án của bạn:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("noreply@host.com", True)

Python-Net: Lấy Email từ máy chủ POP3 trong Python

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

Lấy Thông tin Hộp thư và Đếm Tin nhắn

API Aspose.Email cho phép bạn thực hiện nhiều thao tác với các tin nhắn trên máy chủ, bao gồm việc 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 get_mailbox_size() và get_mailbox_info() các phương thức.

Cái get_mailbox_size() phương thức trả về kích thước của hộp thư tính bằng byte.
Cái get_mailbox_info() 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 message_count thuộc tính và kích thước bằng cách sử dụng thuộc tính occupied_size. Đoạn mã mẫu sau cho thấy cách lấy thông tin về hộp thư. Nó chỉ ra 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.

Chỉ Đếm Số Tin Nhắn

Đoạn mã mẫu trên minh họa cách lấy thống kê hộp thư như kích thước hoặc không gian đã sử dụng cùng với tổng số tin nhắn trong hộp thư. Đoạn mã mẫu phía dưới sẽ cho bạn cách truy xuất trực tiếp số lượng email trong hộp thư. Phương pháp này đơn giản và nhanh hơn nếu bạn chỉ cần đếm số tin nhắn.

Chỉ Lấy Phần Đầu Email

Aspose.Email cho phép các nhà phát triển truy cập siêu dữ liệu email mà không cần tải xuống toàn bộ nội dung tin nhắn. Trong nhiều trường hợp, việc chỉ xem phần đầu của email - như người gửi, tiêu đề và ngày nhận - là hữu ích để xác định liệu tin nhắn có đáng tải về hay không. Cách tiếp cận này giảm tải cho máy chủ và cải thiện hiệu suất, đặc biệt khi làm việc với các hộp thư lớn qua kết nối POP3.

Đoạn mã mẫu sau minh họa cách kết nối tới một máy chủ POP3 và chỉ lấy phần đầu (header) của một tin nhắn cụ thể bằng cách sử dụng số thứ tự của nó. Hoạt động nhẹ này giúp bạn đưa ra quyết định thông minh về việc tải xuống hoặc bỏ qua email nào.

Tải Xuống Email từ Máy Chủ

Aspose.Email Pop3Client lớp cung cấp khả năng truy xuất các tin nhắn email từ máy chủ POP3 và chuyển chúng thành các đối tượng MailMessage. Điều này được thực hiện thông qua các thuộc tính và phương thức của MailMessage lớp, giúp việc xử lý nội dung email trở nên dễ dàng. Bằng cách sử dụng fetch_message phương thức của Pop3Client lớp, bạn có thể nhận được một MailMessage instance trực tiếp từ máy chủ POP3. Đoạn mã mẫu sau minh họa cách lấy toàn bộ một email từ máy chủ:

Lấy Thông tin Tóm tắt Tin nhắn theo ID Duy Nhất

POP3 Client của API cho phép bạn lấy thông tin tóm tắt về các tin nhắn từ máy chủ bằng cách sử dụng ID duy nhất của chúng. Tính năng này cung cấp khả năng truy cập nhanh vào các chi tiết quan trọng của một tin nhắn mà không cần tải xuống toàn bộ nội dung trước. Đoạn mã mẫu sau minh họa cách truy cập thông tin tóm tắt tin nhắn bằng Aspose.Email Python API:

Liệt kê Tin nhắn bằng Nhiều Kết nối

Đối với các thao tác nặng, Aspose.Email cung cấp use_multi_connection thuộc tính của Pop3Client lớp để sử dụng nhiều kết nối khi truy xuất email. Cần lưu ý rằng việc bật chế độ này không phải lúc nào cũng đảm bảo cải thiện hiệu năng. Đoạn mã mẫu dưới đây cho thấy cách thiết lập kết nối tới máy chủ POP3, cấu hình client cho phép tối đa 5 kết nối đồng thời và kích hoạt chế độ đa kết nối để lấy thông tin về các tin nhắn lưu trên máy chủ:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
message_info_coll = client.list_messages()

Python-Net: Lấy Email từ máy chủ POP3 trong Python

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

Lưu Email vào Đĩa mà không Phân tích

Để tải xuống email từ máy chủ POP3 mà không phân tích, bạn có thể sử dụng save_message phương thức của Aspose.Email Pop3Client lớp. Đoạn mã mẫu dưới đây minh họa cách lưu một tin nhắn bằng số thứ tự của nó, trong trường hợp này là số 1. save_message phương thức giữ nguyên định dạng EML gốc mà không phân tích:

Phân tích Tin nhắn trước khi Lưu

Bạn có thể lấy một tin nhắn email cụ thể bằng cách sử dụng fetch_message phương thức của Pop3Client lớp, chỉ định số thứ tự mong muốn cho đối tượng client. Đoạn mã mẫu dưới đây cho thấy cách lấy một tin nhắn cụ thể và sau đó lưu nó bằng tiêu đề của tin nhắn làm tên tệp bằng cách gọi save phương thức trên đối tượng msg:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

# Fetch the message by its sequence number and Save the message using its subject as the file name
msg = client.fetch_message(1)
msg.save("first-message_out.eml", ae.SaveOptions.default_eml)

Lọc Email từ Máy chủ theo Tiêu chí

Aspose.Email Pop3Client class cung cấp list_messages() 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 list_messages(query) 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.

Để xây dựng biểu thức tìm kiếm, sử dụng MailQueryBuilder lớp. Đầu tiên, định nghĩa tất cả các điều kiện và ràng buộc cần thiết, sau đó điền đối tượng MailQuery với truy vấn được tạo bởi MailQueryBuilder. Pop3Client sử dụng đối tượng MailQuery này để lấy thông tin đã lọc từ máy chủ.

Đoạn mã mẫu dưới đây trình bày cách lọc và lấy email từ tài khoản Gmail dựa trên các tiêu chí khác nhau bao gồm tiêu đề, ngày nội bộ, người gửi và người nhận. Nó cũng hiển thị lọc phân biệt chữ hoa chữ thường và minh họa cách xây dựng các truy vấn phức tạp một cách hiệu quả.

Thiết lập kết nối tới máy chủ Gmail POP3 bằng Pop3Client lớp với địa chỉ máy chủ, cổng, tên người dùng và mật khẩu đã chỉ định. Các tùy chọn bảo mật được đặt thành AUTO cho kết nối an toàn.
Tạo một đối tượng của MailQueryBuilder để xây dựng tiêu chí tìm kiếm cho việc lọc email.
Lọc theo Tiêu đề:
- Email chứa "Newsletter" trong tiêu đề được xác định làm điều kiện lọc.
Lọc theo Ngày nội bộ:
- Một bộ lọc được đặt cho email nhận được vào ngày hiện tại.
- Một bộ lọc bổ sung được thêm vào để lấy email nhận được trong tuần qua.
Lọc theo Người gửi:
- Các bộ lọc được áp dụng để tìm email từ một địa chỉ email cụ thể (saqib.razzaq@127.0.0.1) và bao gồm email từ một miền nhất định (SpecificHost.com).
Lọc theo Người nhận:
- Một bộ lọc được chỉ định để tìm email gửi tới một người nhận cụ thể.
Kết hợp truy vấn bằng toán tử OR để tìm email mà hoặc khớp tiêu đề cho trước hoặc được gửi từ địa chỉ cụ thể.
Lọc Phân biệt Chữ HOA/THƯỜNG:
- Một bộ lọc phân biệt chữ hoa chữ thường cho tiêu đề chứa "Newsletter" được chỉ định (đánh dấu bằng tham số True).
Liệt kê Tin nhắn:
- Phương thức list_messages() được gọi với truy vấn đã xây dựng để lấy các tin nhắn đã lọc từ hộp thư.
Cuối cùng, in số lượng tin nhắn đã lọc.

Lọc email theo ngày

Để lấy các tin nhắn theo ngày giao, hãy sử dụng internal_date thuộc tính như được hiển thị trong mẫu mã dưới đây:

import aspose.email as ae
from datetime import datetime

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.on(datetime.now())

Lọc email theo khoảng ngày

Để lấy các tin nhắn trong một khoảng ngày, hãy sử dụng cùng internal_date thuộc tính chỉ định khoảng ngày như được hiển thị trong mẫu mã dưới đây:

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
# Emails that arrived in last 7 days
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))

Lọc email theo người gửi

Để lấy các tin nhắn từ một người gửi cụ thể, hãy sử dụng from_address thuộc tính như được hiển thị trong mẫu mã dưới đây:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("saqib.razzaq@127.0.0.1")

Lọc email theo miền

Để lấy các tin nhắn từ một miền cụ thể, hãy sử dụng from_address thuộc tính như được hiển thị trong mẫu mã dưới đây:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("SpecificHost.com")

Lọc email theo người nhận

Để lấy các tin nhắn cho một người nhận cụ thể, hãy sử dụng to thuộc tính như được hiển thị trong mẫu mã dưới đây:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.to.contains("recipient")

Xây dựng các truy vấn tìm kiếm phức tạp

Đôi khi cần thiết phải đáp ứng nhiều hơn một truy vấn. Aspose.Email cho phép kết hợp các truy vấn trong nhiều câu lệnh. Tạo một MailQueryBuilder đối tượng và sử dụng các thuộc tính của nó để xây dựng các truy vấn cụ thể.

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

Đoạn mã mẫu sau cho bạn cách kết hợp các truy vấn với toán tử AND:

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))
builder.from_address.contains("SpecificHost.com")

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

Đoạn mã mẫu sau cho bạn cách kết hợp các truy vấn với toán tử OR:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.either(builder.subject.contains("test"), builder.from_address.contains("noreply@host.com"))

Áp dụng Lọc Phân biệt Chữ HOA/THƯỜNG

Đoạn mã mẫu sau cho thấy cách triển khai khả năng này vào dự án của bạn:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("noreply@host.com", True)