Documentation – ทำงานกับ POP3 Client

Python-Net: การเชื่อมต่อกับเซิร์ฟเวอร์ POP3 ใน Python

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

เชื่อมต่อกับเซิร์ฟเวอร์ POP3 ด้วยการตรวจสอบสิทธิ์พื้นฐาน

Aspose.Email for Python API ให้ Pop3Client คลาสนี้ช่วยใหแอปพลิเคชันจัดการกล่องอีเมลผ่านโปรโตคอล Post Office Protocol รุ่น 3 (POP3) ใช้คลาสนี้เพื่อสร้างการเชื่อมต่อกับเซิร์ฟเวอร์ POP3 เป็นอินเทอร์เฟซหลักสำหรับนักพัฒนาที่ต้องการนำการจัดการ POP3 ไปใช้ในแอปพลิเคชัน .NET ของตน บทความนี้ให้คำแนะนำในการใช้คลาส Pop3Client อย่างมีประสิทธิภาพ.

โค้ดสแนิปต์ต่อไปนี้แสดงวิธีสร้างการเชื่อมต่อกับเซิร์ฟเวอร์อีเมล POP3 โดยใช้ Aspose.Email Pop3Client คลาส แสดงกระบวนการตั้งค่าการเชื่อมต่อด้วยพารามิเตอร์ที่สำคัญ เช่น ที่อยู่เซิร์ฟเวอร์, ข้อมูลรับรองผู้ใช้, การตั้งค่าความปลอดภัยและหมายเลขพอร์ต การตั้งค่านี้จำเป็นสำหรับการดึงอีเมลอย่างปลอดภัยจากบัญชี Gmail.

สร้างอินสแตนซ์ของ Pop3Client.
ระบุโฮสต์, ชื่อผู้ใช้, รหัสผ่าน, พอร์ตและตัวเลือกความปลอดภัย.

เชื่อมต่อกับเซิร์ฟเวอร์ POP3 ที่เปิดใช้งาน SSL

เพื่อเชื่อมต่อกับเซิร์ฟเวอร์ POP3 ที่เปิดใช้งาน SSL ให้ใช้ Aspose.Email Pop3Client คลาสและตั้งค่าตัวเลือกความปลอดภัยและพอร์ต ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเชื่อมต่อกับเซิร์ฟเวอร์ POP3 ที่เปิดใช้งาน SSL:

เชื่อมต่อกับเซิร์ฟเวอร์ POP3 ด้วยการตรวจสอบสิทธิ์ APOP

APOP (Authenticated Post Office Protocol) เป็นวิธีที่ปลอดภัยสำหรับการดึงอีเมลจากเซิร์ฟเวอร์เมล โดยเพิ่มชั้นการตรวจสอบสิทธิ์ที่ปกป้องข้อมูลรับรองผู้ใช้.

แทนที่จะส่งชื่อผู้ใช้และรหัสผ่านเป็นข้อความธรรมดา APOP ใช้ค่าที่ผ่านการแฮชในกระบวนการตรวจสอบสิทธิ์ เมื่อเข้าสู่ระบบ ลูกค้าจะสร้างแฮชโดยใช้กุญแจลับ (รหัสผ่านของผู้ใช้) และค่าท้า (สตริงเฉพาะที่เซิร์ฟเวอร์สร้าง).

เชื่อมต่อกับเซิร์ฟเวอร์ POP3 ผ่าน Proxy

เซิร์ฟเวอร์พร็อกซี่ทำหน้าที่เป็นตัวกลางระหว่างไคลเอนต์อีเมลของคุณและเซิร์ฟเวอร์เมลเมื่อติดต่อกับโลกภายนอก แทนการเชื่อมต่อโดยตรงไปยังเซิร์ฟเวอร์เมล คำขออีเมลของคุณจะผ่านพร็อกซี่ ซึ่งให้ประโยชน์หลายประการ รวมถึงการซ่อนที่อยู่ IP ของคุณและการเข้าถึงเนื้อหาที่ถูกจำกัด การใช้เซิร์ฟเวอร์พร็อกซี่สามารถเพิ่มความเป็นส่วนตัวและความปลอดภัย โดยเฉพาะเมื่อเข้าถึงอีเมลผ่านเครือข่ายสาธารณะ.

Aspose.Email ให้การสนับสนุนการใช้เซิร์ฟเวอร์พร็อกซี่ โดยเฉพาะเวอร์ชัน 4, 4a, และ 5 ของโปรโตคอล SOCKS proxy ความสามารถนี้ทำให้นักพัฒนาสร้างแอปพลิเคชันที่สื่อสารกับเซิร์ฟเวอร์เมลผ่านพร็อกซี่ได้อย่างมีประสิทธิภาพ คุณสมบัติของมัน Pop3Client คลาสนี้ทำให้แอปพลิเคชันเข้าถึงและจัดการข้อความโดยใช้ Post Office Protocol รุ่น 3 (POP3) วิธีที่เป็นประโยชน์หนึ่งคือ getmailboxinfo(), ซึ่งดึงข้อมูลสำคัญของกล่องจดหมาย เช่น จำนวนข้อความและขนาดรวม ช่วยทำให้การจัดการบัญชีอีเมลเป็นระบบระเบียบมากขึ้น.

ตัวอย่างโค้ดด้านล่างแสดงวิธีดึงอีเมลโดยใช้เซิร์ฟเวอร์เมล์พร็อกซี่กับ 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()

การสนับสนุน HTTP Proxy

มีประเภทของพร็อกซีหลายแบบ รวมถึง HTTP proxy, SOCKS proxy และอื่น ๆ แต่ละแบบมีจุดประสงค์และระดับการทำงานที่แตกต่างกัน ขั้นตอนและการกำหนดค่าเฉพาะอาจแตกต่างกันตามประเภทของพร็อกซีที่ใช้ ตัวอย่างโค้ดด้านล่างแสดงวิธีตั้งค่า Pop3Client พร้อมการกำหนดค่าเพิ่มเติมของ HTTP proxy และดึงข้อมูลเกี่ยวกับกล่องจดหมาย:

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

เชื่อมต่อกับเซิร์ฟเวอร์ผ่านการตรวจสอบสิทธิ์ CRAM-MD5

CRAM-MD5 (กลไกการตรวจสอบสิทธิ์แบบ Challenge-Response ด้วย MD5) มักใช้ในโปรโตคอลอีเมลเช่น POP3 และ IMAP ที่การตรวจสอบสิทธิ์ที่ปลอดภัยเป็นสิ่งสำคัญ ให้ระดับความปลอดภัยที่แข็งแกร่งกว่าการส่งรหัสผ่านเป็นข้อความธรรมดา Aspose.Email for .NET อนุญาตให้ผู้ใช้ตรวจสอบสิทธิ์อย่างปลอดภัยและเข้าถึงเซิร์ฟเวอร์เมลที่รองรับวิธีการตรวจสอบนี้.

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

กำหนดค่า Timeout สำหรับการดำเนินการเมล

Aspose.Email ให้คุณสมบัติ ’timeout’ ของ Pop3Client คลาสนี้เพื่อรับหรือกำหนดค่าตัว timeout สำหรับการดำเนินการเมลเพื่อป้องกันการค้างหรือบล็อก จัดการปัญหาเครือข่ายหรือเซิร์ฟเวอร์ ปรับปรุงความตอบสนอง และรับประกันการจัดการทรัพยากรอย่างมีประสิทธิภาพ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีนำคุณสมบัตินี้ไปใช้ในโครงการ:

import aspose.email as ae

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

ใช้โปรโตคอลการเข้ารหัสกับ POP3 Client

Aspose.Email รองรับโปรโตคอลการเข้ารหัส SSL (ล้าสมัย) และ TLS เพื่อให้ความปลอดภัยในการสื่อสาร คุณสามารถเปิดใช้การเข้ารหัสเชิงคริปโตเพื่อปกป้องการแลกเปลี่ยนข้อมูลระหว่างแอปพลิเคชันของคุณและเซิร์ฟเวอร์เมลได้.

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.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีตั้งค่า POP3 client ด้วยการกำหนดค่าของโปรโตคอลการเข้ารหัส TLS 1.3 เพื่อการสื่อสารที่ปลอดภัย:

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

ในกรณีที่โปรโตคอลการเข้ารหัสที่ระบุไม่รองรับในเวอร์ชันปัจจุบันของ .NET Framework ความแตกต่างของพฤติกรรมระหว่างเมธอด ‘SetSupportedEncryptionUnsafe’ กับคุณสมบัติ ‘SupportedEncryption’ มีดังต่อไปนี้:

หากใช้คุณสมบัติ ‘SupportedEncryption’ ลูกค้าอีเมลจะลดระดับโปรโตคอลการเข้ารหัสลงไปยังระดับที่รองรับ.

หากใช้เมธอด ‘SetSupportedEncryptionUnsafe’ ลูกค้าอีเมลจะขว้างข้อยกเว้น.

Python-Net: การลบอีเมลจากเซิร์ฟเวอร์ POP3 ใน Python

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

Aspose.Email for .NET ให้การควบคุมเต็มรูปแบบในการจัดการข้อความบนเซิร์ฟเวอร์ POP3 โดยใช้ Pop3Client คลาสนี้ทำให้นักพัฒนาสามารถเชื่อมต่อกับกล่องจดหมายและดำเนินการหลายอย่างกับข้อความจากเซิร์ฟเวอร์ได้โดยอัตโนมัติ เช่น การลบข้อความเฉพาะหรือทั้งหมด ซึ่งมีประโยชน์อย่างยิ่งในแอปพลิเคชันการประมวลผลเมลฝั่งเซิร์ฟเวอร์ที่ต้องทำความสะอาดอีเมลหลังจากดึงข้อมูลหรือตามตรรกะที่กำหนดเอง.

บทความนี้อธิบายวิธีลบข้อความโดยใช้ Aspose.Email POP3 client ในสถานการณ์ต่างๆ.

ลบอีเมลตามดัชนี

โค้ดสแนิปต์ต่อไปนี้แสดงวิธีลบข้อความทั้งหมดในกล่องจดหมายทีละหนึ่ง โดยอ้างอิงตามตำแหน่งของมัน หมายเลขตำแหน่งไม่ควรเป็น <=0 ใน Pop3Client.DeleteMessage.

Delete All Emails

ยังสามารถเรียกใช้ delete_messages() เมธอดเพื่อทำการลบข้อความทั้งหมด ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้เมธอดนี้:

import aspose.email as ae

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

# Delete all the messages
client.delete_messages()

หากการเชื่อมต่อกับเซิร์ฟเวอร์ POP3 สิ้นสุดลงทันทีหลังจากการลบข้อมูล, the undelete_messages() เมธอดนี้ไม่สามารถเรียกใช้เพื่อคืนค่าข้อมูลได้อีกต่อไป.

ยกเลิกการดำเนินการลบ

เมธอด undelete_messages สามารถใช้เพื่อยกเลิกการลบข้อความอีเมล ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้เมธอดนี้:

import aspose.email as ae

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

# Cancel deletes
client.undelete_messages()

Python-Net: คุณลักษณะอรรถประโยชน์ - ลูกค้า POP3

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

ตรวจสอบข้อมูลประจำตัวของเมลเซิร์ฟเวอร์

Aspose.Email มีเมธอด ‘validate_credentials()’ ของ Pop3Client คลาสเพื่อยืนยันข้อมูลประจำตัว (ชื่อผู้ใช้และรหัสผ่าน) ที่ผู้ใช้ให้เพื่อเข้าถึงเซิร์ฟเวอร์อีเมล POP3 วิธีนี้รับประกันว่าข้อมูลประจำตัวการเข้าสู่ระบบของผู้ใช้ถูกต้องและเป็นจริง ทำให้ผู้ใช้สามารถรับรองตัวตนสำเร็จและเข้าถึงบัญชีอีเมลของตนโดยใช้โปรโตคอล POP3 หากข้อมูลประจำตัวที่ให้ผิดวิธีอาจคืนข้อผิดพลาดหรือโยนข้อยกเว้นแสดงว่าการเข้าสู่ระบบล้มเหลว.

โค้ดตัวอย่างด้านล่างแสดงวิธีการตรวจสอบที่ 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: ตรวจสอบข้อมูลประจำตัวเซิร์ฟเวอร์ POP3 ใน Python

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

Aspose.Email ให้ validate_credentials() เมธอดของ Pop3Client คลาสเพื่อยืนยันข้อมูลประจำตัวการเข้าสู่ระบบของผู้ใช้ (ชื่อผู้ใช้และรหัสผ่าน) สำหรับเซิร์ฟเวอร์อีเมล POP3 วิธีนี้รับประกันว่าข้อมูลประจำตัวเป็นจริง ทำให้การรับรองตัวตนสำเร็จและเข้าถึงกล่องเมลโดยใช้โปรโตคอล POP3 หากข้อมูลประจำตัวไม่ถูกต้อง เมธอดจะคืนค่า ‘False’ หรือโยนข้อยกเว้นแสดงว่าการรับรองความถูกต้องล้มเหลว.

โค้ดตัวอย่างด้านล่างแสดงวิธีตรวจสอบข้อมูลประจำตัวเซิร์ฟเวอร์ POP3 ด้วย Aspose.Email 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: รายการส่วนขยายที่เซิร์ฟเวอร์ POP3 รองรับ

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

Aspose.Email มี Pop3Client คลาสที่ช่วยให้คุณดึงส่วนขยายที่เซิร์ฟเวอร์ POP3 รองรับ เช่น IDLE, UNSELECT, QUOTA ฯลฯ การรู้ว่ามีส่วนขยายใดบ้างเป็นสิ่งสำคัญสำหรับการตัดสินใจว่าฟังก์ชันเฉพาะสามารถใช้ได้หรือไม่. get_capabilities() เมธอดนี้คืนค่าประเภทของส่วนขยายที่รองรับเป็นอาเรย์ของสตริง.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงส่วนขยายของเซิร์ฟเวอร์โดยใช้ Pop3Client สำหรับเซิร์ฟเวอร์ Gmail:

Python-Net: Working with Messages from Server

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

รับข้อมูลกล่องจดหมาย

เราสามารถรับข้อมูลเกี่ยวกับกล่องจดหมาย เช่น จำนวนข้อความและขนาดกล่องจดหมายโดยใช้เมธอด GetMailBoxSize() และ GetMailBoxInfo()

เมธอด GetMailBoxSize() คืนค่าขนาดของกล่องจดหมายเป็นไบต์.
เมธอด GetMailBoxInfo() คืนค่าอ็อบเจกต์ประเภท Pop3MailBoxInfo.

นอกจากนี้ยังสามารถรับจำนวนข้อความโดยใช้คุณสมบัติ MessageCount และขนาดโดยใช้คุณสมบัติ OccupiedSize ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการรับข้อมูลเกี่ยวกับกล่องจดหมาย แสดงวิธีการ:

สร้าง Pop3Client.
เชื่อมต่อกับเซิร์ฟเวอร์ POP3
รับขนาดของกล่องจดหมาย
รับข้อมูลกล่องจดหมาย
รับจำนวนข้อความในกล่องจดหมาย
รับขนาดที่ใช้

การรับจำนวนอีเมลในกล่องจดหมาย

โค้ดสแนปต่อไปนี้แสดงวิธีนับจำนวนข้อความอีเมลในกล่องจดหมาย

Aspose.Email ให้ผู้พัฒนาสามารถทำงานกับอีเมลได้หลายวิธี ตัวอย่างเช่น พวกเขาสามารถดึงข้อมูลส่วนหัวก่อนตัดสินใจดาวน์โหลดอีเมล หรือสามารถดึงอีเมลจากเซิร์ฟเวอร์และบันทึกโดยไม่ต้องแปลง (เร็วกว่า) หรือหลังจากแปลงแล้ว (ช้ากว่า) บทความนี้แสดงวิธีดึงและแปลงอีเมล

ดึงข้อมูลส่วนหัวอีเมล

ส่วนหัวของอีเมลสามารถให้ข้อมูลเกี่ยวกับข้อความอีเมลที่เราสามารถใช้ตัดสินใจว่าจะดึงข้อความทั้งหมดหรือไม่ โดยทั่วไปข้อมูลส่วนหัวจะมีผู้ส่ง, หัวเรื่อง, วันที่รับ เป็นต้น (ส่วนหัวของอีเมลอธิบายรายละเอียดในหัวข้อ Customizing Email Headers หัวข้อนี้เกี่ยวกับการส่งอีเมลด้วย SMTP แต่ข้อมูลส่วนหัวของอีเมลยังคงใช้ได้กับอีเมล POP3) ตัวอย่างต่อไปนี้แสดงวิธีดึงส่วนหัวของอีเมลจากเซิร์ฟเวอร์ POP3 โดยใช้หมายเลขลำดับของข้อความ

ดึงข้อความอีเมล

คอมโพเนนต์คลาส Aspose.Email.Pop3 ให้ความสามารถในการดึงข้อความอีเมลจากเซิร์ฟเวอร์ POP3 และแปลงเป็นอินสแตนซ์ MailMessage ด้วยความช่วยเหลือของคอมโพเนนต์ MailMessage คลาส MailMessage มีคุณสมบัติและเมธอดหลายอย่างสำหรับจัดการเนื้อหาอีเมล โดยการใช้ฟังก์ชัน FetchMessage ของคลาส Pop3Client คุณสามารถรับอินสแตนซ์ MailMessage โดยตรงจากเซิร์ฟเวอร์ POP3 ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงข้อความอีเมลครบชุดจากเซิร์ฟเวอร์ POP3

Retrieving Message Summary Information using Unique Id

คลายเอนท์ POP3 Client ของ API สามารถดึงข้อมูลสรุปของข้อความจากเซิร์ฟเวอร์โดยใช้ ID ที่เป็นเอกลักษณ์ของข้อความ ซึ่งทำให้เข้าถึงข้อมูลสั้นของข้อความได้อย่างรวดเร็วโดยไม่ต้องดึงข้อความเต็มจากเซิร์ฟเวอร์ก่อน ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการดึงข้อมูลสรุปของข้อความ

Listing Messages with MultiConnection

สำหรับการทำงานที่มีภาระหนัก Aspose.Email มีคุณสมบัติ ‘use_multi_connection’ ของ Pop3Client คลาสเพื่อใช้การเชื่อมต่อหลายช่องขณะดึงอีเมล อย่างไรก็ตาม การใช้โหมดนี้ไม่ได้หมายความว่าจะต้องเพิ่มประสิทธิภาพ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีตั้งค่าการเชื่อมต่อกับเซิร์ฟเวอร์ POP3, กำหนดค่าไคลเอนท์ให้รองรับการเชื่อมต่อพร้อมกันสูงสุด 5 ช่องและเปิดใช้โหมดหลายช่องเพื่อดึงข้อมูลเกี่ยวกับข้อความที่อยู่บนเซิร์ฟเวอร์:

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

ดึงข้อความจากเซิร์ฟเวอร์และบันทึกลงดิสก์

บันทึกข้อความลงดิสก์โดยไม่แปลง

หากต้องการดาวน์โหลดข้อความอีเมลจากเซิร์ฟเวอร์ POP3 โดยไม่ทำการแปลง ใช้ฟังก์ชัน SaveMessage ของคลาส Pop3Client ฟังก์ชัน SaveMessage จะไม่ทำการแปลงข้อความอีเมลจึงเร็วกว่าเมธอด FetchMessage ตัวอย่างโค้ดต่อไปนี้แสดงวิธีบันทึกข้อความตามหมายเลขลำดับ ในกรณีนี้คือหมายเลข 1 วิธี SaveMessage จะบันทึกข้อความในรูปแบบ EML ดั้งเดิมโดยไม่ทำการแปลง

แปลงข้อความก่อนบันทึก

ใช้เมธอด ‘fetch_message’ ของอ็อบเจกต์คลไคลเอนท์ที่สร้างขึ้นโดยใช้ Pop3Client คลาสเพื่อดึงข้อความที่มีหมายเลขลำดับเฉพาะ ตัวอย่างโค้ดด้านล่างแสดงวิธีดึงข้อความที่ระบุและบันทึกโดยใช้หัวเรื่องเป็นชื่อไฟล์โดยเรียกเมธอด ‘save’ ของอ็อบเจกต์ 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)

การกรองข้อความตามผู้ส่ง, ผู้รับ หรือวันที่

คลาส Pop3Client ซึ่งอธิบายไว้ในหัวข้อ Connecting to a POP3 Server มีเมธอด list_messages() ที่ดึงข้อความทั้งหมดจากกล่องจดหมาย เพื่อรับเฉพาะข้อความที่ตรงตามเงื่อนไขบางอย่าง ให้ใช้เมธอด ListMessages() ที่มีการอับโหลดและรับอากิวเมนต์เป็น MailQuery คลาส MailQuery มีคุณสมบัติต่าง ๆ สำหรับระบุเงื่อนไขการค้นหา เช่น วันที่, หัวเรื่อง, ผู้ส่ง, ผู้รับ ฯลฯ คลาส MailQueryBuilder ใช้เพื่อสร้างนิพจน์การค้นหา โดยตั้งค่าเงื่อนไขและข้อจำกัดทั้งหมดแล้วเติมค่าให้ MailQuery ด้วยคิวรีที่สร้างโดย MailQueryBuilder อ็อบเจกต์ของคลาส MailQuery จะถูกใช้โดย Pop3Client เพื่อสกัดข้อมูลที่กรองจากเซิร์ฟเวอร์ บทความนี้แสดงวิธีกรองข้อความอีเมลจากกล่องจดหมาย ตัวอย่างแรกอธิบายการกรองข้อความตามวันที่และหัวเรื่อง เราแสดงวิธีกรองตามเกณฑ์อื่น ๆ และวิธีสร้างคิวรีที่ซับซ้อนยิ่งขึ้น นอกจากนี้ยังแสดงการใช้ฟิลเตอร์วันที่และเวลาเพื่อดึงอีเมลเฉพาะจากกล่องจดหมาย และแสดงวิธีการกรองที่แยกแยะตัวพิมพ์ใหญ่‑เล็ก

การกรองข้อความจากกล่องจดหมาย

เพื่อกรองข้อความจากกล่องจดหมาย:

เชื่อมต่อและเข้าสู่ระบบกับเซิร์ฟเวอร์ POP3
สร้างอินสแตนซ์ของ MailQuery และตั้งค่าคุณสมบัติที่ต้องการ.
เรียกเมธอด Pop3Client.list_messages(MailQuery query) และส่ง MailQuery เป็นพารามิเตอร์เพื่อรับเฉพาะข้อความที่ผ่านการกรอง

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเชื่อมต่อกับกล่องจดหมาย POP3 และรับข้อความที่มาถึงในวันนี้และมีคำ "newsletter" อยู่ในหัวเรื่อง

ดึงข้อความที่ตรงตามเกณฑ์เฉพาะ

Aspose.Email ยังทำให้สามารถสร้างเงื่อนไขการค้นหาที่ซับซ้อนสำหรับการสอบถามและกรองข้อความอีเมล เพื่อวัตถุประสงค์นี้ใช้ MailQueryBuilder คลาสและคุณสมบัติของมัน เกณฑ์การดึงข้อมูลดังต่อไปนี้:

ดึงข้อความตามวันที่จัดส่ง
ดึงข้อความในช่วง
ดึงข้อความจากผู้ส่งเฉพาะ
ดึงข้อความจากโดเมนเฉพาะ
ดึงข้อความไปยังผู้รับเฉพาะ

วันที่วันนี้

เพื่อดึงข้อความตามวันที่จัดส่ง ใช้คุณสมบัติ ‘internal_date’ ตามตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae
from datetime import datetime

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

ช่วงวันที่

เพื่อดึงข้อความในช่วงวันที่ ใช้คุณสมบัติ ‘internal_date’ เดียวกันและระบุช่วงวันที่ตามตัวอย่างโค้ดด้านล่าง:

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

ผู้ส่งเฉพาะ

เพื่อดึงข้อความจากผู้ส่งเฉพาะ ใช้คุณสมบัติ ‘from_address’ ตามตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

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

โดเมนเฉพาะ

เพื่อดึงข้อความจากโดเมนเฉพาะ ใช้คุณสมบัติ ‘from_address’ ตามตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

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

ผู้รับเฉพาะ

เพื่อดึงข้อความไปยังผู้รับเฉพาะ ใช้คุณสมบัติ ’to’ ตามตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

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

การสร้างคิวรีซับซ้อน

บางครั้งจำเป็นต้องทำให้หลายคิวรีสำเร็จ Aspose.Email ทำให้เป็นไปได้โดยการรวมคิวรีในหลายคำสั่ง สร้าง MailQueryBuilder อ็อบเจกต์และใช้คุณสมบัติของมันเพื่อสร้างคิวรีเฉพาะ

การรวมคิวรีด้วย AND

โค้ดสแนปต่อไปนี้แสดงวิธีรวมคิวรีด้วย 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")

การรวมคิวรีด้วย OR

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรวมคิวรีด้วย OR

import aspose.email as ae

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

การใช้ตัวกรองที่คำนึงถึงตัวพิมพ์ใหญ่-เล็ก

API ยังให้ความสามารถในการกรองอีเมลจากกล่องจดหมายตามเกณฑ์ที่แยกแยะตัวพิมพ์ใหญ่‑เล็ก วิธีต่อไปนี้ของ StringComparisonField คลาสให้ความสามารถในการค้นหาอีเมลโดยระบุแฟลกแยกแยะตัวพิมพ์ใหญ่‑เล็ก

Method Aspose.Email.StringComparisonField.contains(value, ignore_case) Method Aspose.Email.StringComparisonField.equals(value, ignore_case) Method Aspose.Email.StringComparisonField.not_contains(value, ignore_case) Method Aspose.Email.StringComparisonField.not_equals(value, ignore_case)

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีนำความสามารถนี้ไปใช้ในโครงการของคุณ:

import aspose.email as ae

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

Python-Net: การดึงอีเมลจากเซิร์ฟเวอร์ POP3 ใน Python

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

รับข้อมูลกล่องจดหมายและจำนวนข้อความ

Aspose.Email API อนุญาตให้คุณทำการดำเนินการต่าง ๆ กับข้อความบนเซิร์ฟเวอร์รวมถึงการรับข้อมูลเกี่ยวกับกล่องจดหมาย เช่น จำนวนข้อความและขนาดกล่องจดหมายโดยใช้ get_mailbox_size() และ get_mailbox_info() เมธอด.

นี้ get_mailbox_size() เมธอดคืนขนาดของกล่องจดหมายเป็นไบต์
นี้ get_mailbox_info() เมธอดจะคืนค่าอ็อบเจกต์ประเภท Pop3MailBoxInfo.

ยังสามารถรับจำนวนข้อความโดยใช้ message_count คุณสมบัติและขนาดโดยใช้คุณสมบัติ `occupied_size``. ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการรับข้อมูลเกี่ยวกับกล่องจดหมาย. แสดงวิธีการ:

สร้าง Pop3Client.
เชื่อมต่อกับเซิร์ฟเวอร์ POP3
รับขนาดของกล่องจดหมาย
รับข้อมูลกล่องจดหมาย
รับจำนวนข้อความในกล่องจดหมาย
รับขนาดที่ใช้

รับจำนวนข้อความเท่านั้น

ตัวอย่างโค้ดด้านบนแสดงวิธีการรับสถิติของกล่องจดหมาย เช่น ขนาดหรือพื้นที่ที่ใช้ร่วมกับจำนวนข้อความทั้งหมดในกล่องจดหมาย ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีดึงจำนวนข้อความอีเมลในกล่องจดหมายโดยตรง วิธีนี้ง่ายและเร็วกว่า หากคุณต้องการเพียงจำนวนข้อความเท่านั้น

ดึงส่วนหัวของอีเมลเท่านั้น

Aspose.Email อนุญาตให้นักพัฒนาสามารถเข้าถึง metadata ของอีเมลโดยไม่ต้องดาวน์โหลดเนื้อหาข้อความเต็ม ในหลายสถานการณ์ การตรวจสอบเฉพาะส่วนหัวของอีเมล เช่น ผู้ส่ง, หัวเรื่อง, และวันที่รับ - ช่วยพิจารณาว่าข้อความนั้นคุ้มค่าที่จะดึงหรือไม่ วิธีนี้ช่วยลดภาระของเซิร์ฟเวอร์และปรับปรุงประสิทธิภาพ โดยเฉพาะเมื่อทำงานกับกล่องจดหมายขนาดใหญ่ผ่านการเชื่อมต่อ POP3

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการเชื่อมต่อกับเซิร์ฟเวอร์ POP3 และดึงเฉพาะส่วนหัวของข้อความที่ระบุโดยใช้หมายเลขลำดับ การดำเนินการที่เบานี้ช่วยให้คุณตัดสินใจได้อย่างมั่นใจว่าจะดาวน์โหลดหรือเพิกเฉยต่ออีเมลใด

ดาวน์โหลดข้อความอีเมลจากเซิร์ฟเวอร์

Aspose.Email Pop3Client คลาสนี้ให้ความสามารถในการดึงข้อความอีเมลจากเซิร์ฟเวอร์ POP3 และแปลงเป็นอินสแตนซ์ของ MailMessage ซึ่งทำได้ผ่านคุณสมบัติและเมธอดของ MailMessage คลาสที่ช่วยในการจัดการเนื้อหาอีเมล โดยการใช้ fetch_message เมธอดของ Pop3Client class, you can get a MailMessage อินสแตนซ์โดยตรงจากเซิร์ฟเวอร์ POP3 ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการดึงข้อความอีเมลทั้งหมดจากเซิร์ฟเวอร์:

ดึงข้อมูลสรุปของข้อความโดยใช้ ID เอกลักษณ์

คลายเอนท์ POP3 Client ของ API ช่วยให้คุณดึงข้อมูลสรุปของข้อความจากเซิร์ฟเวอร์โดยใช้ ID ที่เป็นเอกลักษณ์ของแต่ละข้อความ ฟีเจอร์นี้ให้การเข้าถึงข้อมูลสำคัญของข้อความได้อย่างรวดเร็วโดยไม่ต้องดาวน์โหลดเนื้อหาทั้งหมดก่อน ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการเข้าถึงข้อมูลสรุปของข้อความโดยใช้ Aspose.Email Python API:

แสดงรายการข้อความโดยใช้การเชื่อมต่อหลายช่อง

สำหรับการทำงานที่มีภาระหนัก Aspose.Email มีให้ use_multi_connection คุณสมบัติของ Pop3Client คลาสเพื่อใช้การเชื่อมต่อหลายช่องขณะดึงอีเมล ควรทราบว่าการเปิดใช้งานโหมดนี้ไม่ได้รับประกันว่าจะเพิ่มประสิทธิภาพเสมอ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีตั้งค่าการเชื่อมต่อกับเซิร์ฟเวอร์ POP3, กำหนดค่าไคลเอนท์ให้รองรับการเชื่อมต่อพร้อมกันสูงสุด 5 ช่อง และเปิดใช้งานโหมดหลายช่องเพื่อดึงข้อมูลเกี่ยวกับข้อความที่เก็บบนเซิร์ฟเวอร์:

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: การดึงอีเมลจากเซิร์ฟเวอร์ POP3 ใน Python

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

บันทึกอีเมลลงดิสก์โดยไม่ทำการแปลง

เพื่อดาวน์โหลดข้อความอีเมลจากเซิร์ฟเวอร์ POP3 โดยไม่ทำการแปลง คุณสามารถใช้ save_message เมธอดของ Aspose.Email Pop3Client คลาส ตัวอย่างโค้ดต่อไปนี้แสดงวิธีบันทึกข้อความโดยใช้หมายเลขลำดับ ในกรณีนี้คือหมายเลข 1. The save_message เมธอดเก็บรูปแบบ EML ดั้งเดิมโดยไม่ทำการแปลง:

แปลงข้อความก่อนบันทึก

คุณสามารถดึงข้อความอีเมลเฉพาะโดยใช้ fetch_message เมธอดของ Pop3Client คลาส ระบุหมายเลขลำดับที่ต้องการสำหรับอ็อบเจกต์ไคลเอนท์ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงข้อความเฉพาะและบันทึกโดยใช้หัวเรื่องเป็นชื่อไฟล์โดยเรียก save เมธอดบนอ็อบเจกต์ 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)

กรองอีเมลจากเซิร์ฟเวอร์ตามเกณฑ์

Aspose.Email Pop3Client class ให้ list_messages() เมธอดที่ดึงข้อความทั้งหมดจากกล่องจดหมาย เพื่อดึงเฉพาะข้อความที่ตรงกับเงื่อนไขบางอย่าง ให้ใช้เมธอดโอเวอร์โหลด list_messages(query) เมธอดที่รับ MailQuery เป็นอาร์กิวเมนต์. MailQuery คลาสนี้ให้คุณสมบัติต่าง ๆ สำหรับระบุเงื่อนไขการค้นหา เช่น วันที่, หัวเรื่อง, ผู้ส่ง, ผู้รับ เป็นต้น

เพื่อสร้างนิพจน์การค้นหา ให้ใช้ MailQueryBuilder คลาส ขั้นแรกกำหนดเงื่อนไขและข้อจำกัดทั้งหมดที่จำเป็น แล้วเติมวัตถุ MailQuery ด้วยคิวรีที่สร้างโดย MailQueryBuilder. Pop3Client ใช้วัตถุ MailQuery นี้เพื่อดึงข้อมูลที่กรองจากเซิร์ฟเวอร์

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีกรองและดึงอีเมลจากบัญชี Gmail ตามเกณฑ์ต่าง ๆ รวมถึงหัวเรื่อง, วันที่ภายใน, ผู้ส่ง, และผู้รับ นอกจากนี้ยังแสดงการกรองแยกแยะตัวพิมพ์ใหญ่‑เล็กและวิธีสร้างคิวรีที่ซับซ้อนอย่างมีประสิทธิภาพ

สร้างการเชื่อมต่อกับเซิร์ฟเวอร์ Gmail POP3 ด้วย Pop3Client คลาสที่มีที่อยู่เซิร์ฟเวอร์, พอร์ต, ชื่อผู้ใช้, และรหัสผ่านที่ระบุ ตัวเลือกความปลอดภัยตั้งค่าเป็น AUTO เพื่อการเชื่อมต่อที่ปลอดภัย
สร้างอินสแตนซ์ของ MailQueryBuilder เพื่อสร้างเกณฑ์การค้นหาสำหรับการกรองอีเมล
การกรองตาม หัวเรื่อง:
- อีเมลที่มีคำ "Newsletter" ในหัวเรื่องถูกระบุเป็นเงื่อนไขฟิลเตอร์
การกรองโดย วันที่ภายใน:
- กำหนดฟิลเตอร์สำหรับอีเมลที่ได้รับในปัจจุบัน
- เพิ่มฟิลเตอร์เพิ่มเติมเพื่อดึงอีเมลที่ได้รับในสัปดาห์ที่ผ่านมา
การกรองโดย ผู้ส่ง:
- ฟิลเตอร์ถูกนำไปใช้เพื่อค้นหาอีเมลจากที่อยู่อีเมลเฉพาะ (saqib.razzaq@127.0.0.1) และรวมอีเมลจากโดเมนเฉพาะ (SpecificHost.com)
การกรองโดย ผู้รับ:
- ระบุฟิลเตอร์เพื่อค้นหาอีเมลที่ส่งถึงผู้รับเฉพาะ
รวมคิวรี ด้วยโอเปอเรเตอร์ OR เพื่อค้นหาอีเมลที่ตรงกับหัวเรื่องที่กำหนดหรือส่งจากที่อยู่อีเมลเฉพาะ
การกรองแยกแยะตัวพิมพ์ใหญ่‑เล็ก:
- ระบุฟิลเตอร์แยกแยะตัวพิมพ์ใหญ่‑เล็กสำหรับหัวเรื่องที่มีคำ "Newsletter" (แสดงด้วยพารามิเตอร์ True)
รายการข้อความ:
- เมธอด list_messages() ถูกเรียกพร้อมคิวรีที่สร้างขึ้นเพื่อดึงข้อความที่กรองจากกล่องจดหมาย
สุดท้าย พิมพ์จำนวนของข้อความที่กรองแล้ว

กรองอีเมลตามวันที่

เพื่อดึงข้อความตามวันที่ส่ง ใช้ internal_date คุณสมบัติตามที่แสดงในตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae
from datetime import datetime

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

กรองอีเมลตามช่วงวันที่

เพื่อดึงข้อความภายในช่วงวันที่ ใช้เดียวกัน internal_date คุณสมบัติที่ระบุช่วงวันที่ตามที่แสดงในตัวอย่างโค้ดด้านล่าง:

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

กรองอีเมลตามผู้ส่ง

เพื่อดึงข้อความจากผู้ส่งเฉพาะ ใช้ from_address คุณสมบัติตามที่แสดงในตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

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

กรองอีเมลตามโดเมน

เพื่อดึงข้อความจากโดเมนเฉพาะ ใช้ from_address คุณสมบัติตามที่แสดงในตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

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

กรองอีเมลตามผู้รับ

เพื่อดึงข้อความไปยังผู้รับเฉพาะ ใช้ to คุณสมบัติตามที่แสดงในตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

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

สร้างคำค้นหาซับซ้อน

บางครั้งจำเป็นต้องตอบสนองมากกว่าหนึ่งคำค้นหา Aspose.Email ทำให้สามารถรวมคำค้นหาในหลายคำสั่งได้ สร้าง MailQueryBuilder อ็อบเจกต์และใช้คุณสมบัติของมันเพื่อสร้างคิวรีเฉพาะ

รวมคิวรีด้วย AND

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรวมคิวรีด้วยโอเปอเรเตอร์ 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")

รวมคิวรีด้วย OR

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรวมคิวรีด้วยโอเปอเรเตอร์ OR:

import aspose.email as ae

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

ใช้ฟิลเตอร์แยกแยะตัวพิมพ์ใหญ่‑เล็ก

API ยังให้ความสามารถในการกรองอีเมลจากกล่องจดหมายตามเกณฑ์ที่แยกแยะตัวพิมพ์ใหญ่‑เล็ก วิธีต่อไปนี้ของ StringComparisonField คลาสให้ความสามารถในการค้นหาอีเมลโดยระบุแฟล็กแยกแยะตัวพิมพ์ใหญ่‑เล็ก:

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีนำความสามารถนี้ไปใช้ในโครงการของคุณ:

import aspose.email as ae

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

Python-Net: เปิดการบันทึกกิจกรรมของเซิร์ฟเวอร์ POP3 ใน Python

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

การบันทึกกิจกรรมช่วยให้คุณตรวจสอบและบันทึกการกระทำที่ทำโดยคลายเอ็นท์ Pop3 ขณะเชื่อมต่อและโต้ตอบกับเซิร์ฟเวอร์ POP3 การเปิดใช้งานฟีเจอร์นี้ช่วยในการแก้ไขปัญหา ปรับปรุงการตรวจสอบความปลอดภัย และสนับสนุนการปฏิบัติตามนโยบายการเก็บรักษาข้อมูลและความเป็นส่วนตัว.

ตัวอย่างด้านล่างแสดงวิธีเปิดการบันทึกกิจกรรมโดยใช้ Aspose.Email Pop3Client คลาส:

สร้างอินสแตนซ์ของ Pop3Client, ระบุโฮสต์, พอร์ต, ชื่อผู้ใช้และรหัสผ่าน พร้อมตัวเลือกความปลอดภัย.
ตั้งค่าพาธสำหรับไฟล์บันทึกโดยใช้ log_file_name คุณสมบัติ.
โดยเลือกปรับการตั้งค่าการบันทึกโดยกำหนด use_date_in_log_file_name คุณสมบัติหากจำเป็น.

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