Documentation – Работа с POP3 клиент

Python-Net: Свързване към POP3 сървър в Python

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

Свързване към POP3 сървър, използвайки базова идентификация

Aspose.Email за Python API предоставя Pop3Client клас, който позволява на приложенията да управляват пощенски кутии чрез протокола Post Office Version 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) е сигурен метод за извличане на имейли от пощенски сървър. Той подобрява традиционния POP3 протокол, като добавя слой за удостоверяване, който защитава данните за потребителя.

Вместо да изпраща вашето потребителско име и парола в чист текст, APOP използва хеширана стойност по време на процеса на удостоверяване. При влизане клиентът създава хеш, използвайки таен ключ (паролата на потребителя) и предизвикателна стойност (уникален низ, генериран от сървъра).

Свързване към POP3 сървър чрез прокси

Прокси сървърите действат като посредници между вашия имейл клиент и пощенския сървър при комуникация с външния свят. Вместо директно да се свързвате със сървъра, вашите имейл заявки преминават през прокси, което предоставя няколко предимства, включително маскиране на вашия IP адрес и достъп до ограничено съдържание. Използването на прокси сървъри може да повиши поверителността и сигурността, особено при достъп до имейл в публични мрежи.

Aspose.Email предоставя подкрепа за използване на прокси сървъри, конкретно версии 4, 4a и 5 на SOCKS прокси протокола. Тази възможност позволява на разработчиците да създават приложения, които могат ефективно да комуникират с пощенски сървъри чрез прокси. Нейната Pop3Client клас позволява на приложенията да достъпват и манипулират съобщения, използвайки протокола Post Office Version 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 прокси

Съществуват различни типове прокси, включително HTTP прокси, SOCKS прокси и други, като всеки служи за различни цели и предоставя различни нива на функционалност. Конкретните стъпки и конфигурации могат да варират в зависимост от използвания тип прокси. Следният примерен код демонстрира как да се настрои Pop3Client с допълнителна конфигурация на HTTP прокси и извличане на информация за пощенската кутия:

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 (механизъм за удостоверяване предизвикателство-отговор с MD5) се използва често в имейл протоколи като POP3 и IMAP, където сигурното удостоверяване е важно. Той осигурява по-високо ниво на сигурност в сравнение с предаване на пароли в чист текст. Aspose.Email за .NET позволява на потребителите да се удостоверяват сигурно и да достъпват имейл сървъри, поддържащи този метод за удостоверяване.

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

Конфигуриране на таймаут за пощенски операции

Aspose.Email предоставя свойството ’timeout’ на Pop3Client клас за получаване или задаване на таймаут за пощенски операции, с цел предотвратяване на зависане или блокиране, справяне с мрежови или сървърни проблеми, подобряване на реактивността и осигуряване на ефективно управление на ресурсите. Следният примерен код показва как да внедрите свойството в проект:

import aspose.email as ae

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

Използване на криптографски протоколи с POP3 клиент

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 клиент с конфигурации за шифроване 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 за .NET предоставя пълен контрол върху управлението на съобщения на POP3 сървър. С помощта на Pop3Client клас, разработчиците могат да се свържат с пощенска кутия и програмно да изпълняват множество задачи върху съобщенията от сървъра, включително изтриване на конкретни съобщения или всички тях. Това е особено полезно в сървърни приложения за обработка на поща, където е необходимо почистване на имейлите след извличане или въз основа на персонализирана логика.

Тази статия обяснява как да изтривате съобщения, използвайки POP3 клиента на Aspose.Email в различни сценарии.

Изтриване на имейл по индекс

Следният кодов фрагмент показва как да изтриете всички съобщения в пощенска кутия едно по едно, според техния индекс. Индексът никога не трябва да бъде <=0 в Pop3Client.DeleteMessage.

Изтриване на всички имейли

Също така е възможно да се извика 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 сървъра се загуби непосредствено след операцията по изтриване, тогава 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 сървър в Python

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

Aspose.Email предоставя validate_credentials() метод на Pop3Client клас за проверка на данните за вход (потребителско име и парола) на потребителя за POP3 имейл сървър. Този метод осигурява валидност на данните, позволявайки успешна автентикация и достъп до пощенската кутия чрез протокола POP3. Ако данните са неправилни, методът връща ‘False’ или повдига изключение, указвайки провал на автентикацията.

Следният кодов откъс демонстрира как да се валидират данните за достъп до POP3 сървър, използвайки 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: Полезни функции - 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 сървъра

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

Aspose.Email предоставя Pop3Client клас, който ви позволява да извлечете поддържаните разширения на POP3 сървър, като IDLE, UNSELECT, QUOTA и други. Познаването на наличните разширения е от решаващо значение за определяне дали могат да се използват специфични функционалности. get_capabilities() методът връща типовете поддържани разширения като масив от низове.

Следният примерен код демонстрира как да извлечете разширенията на сървъра, използвайки Pop3Client за Gmail сървъра:

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

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 позволява на разработчиците да достъпват метаданните на имейл без да изтеглят цялото съдържание на съобщението. В множество сценарии е полезно да се преглеждат само заглавните части на имейл - като подател, тема и дата на получаване - за да се определи дали съобщението си заслужава да се извлече. Този подход намалява натоварването на сървъра и подобрява производителността, особено при работа с големи пощенски кутии през POP3 връзка.

Следният примерен код демонстрира как да се свържете с POP3 сървър и да извлечете само заглавните части (headers) на конкретно съобщение, използвайки неговия последователен номер. Тази лека операция ви помага да вземете информирани решения за това кои имейли да изтеглите или да игнорирате.

Изтегляне на имейл съобщения от сървъра

Aspose.Email Pop3Client клас предоставя възможност за извличане на имейл съобщения от POP3 сървър и конвертирането им в MailMessage инстанции. Това е възможно чрез свойствата и методите на MailMessage клас, който улеснява манипулирането на съдържанието на имейла. Чрез използване на fetch_message метод на Pop3Client клас, можете да получите MailMessage инстанция директно от POP3 сървъра. Следният кодов фрагмент демонстрира как да се извлече цялото имейл съобщение от сървъра:

Извличане на обобщена информация за съобщение по уникален ID

POP3 клиентът на 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. 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 клас предоставя list_messages() метод, който получава всички съобщения от пощенска кутия. За да получите само съобщения, отговарящи на някои условия, използвайте претоварения list_messages(query) метод, който приема MailQuery като аргумент. MailQuery клас предоставя различни свойства за задаване на условията на заявката, например дата, тема, подател, получател и т.н.

За да изградите израза за търсене, използвайте MailQueryBuilder клас. Първо дефинирайте всички необходими условия и ограничения, след което попълнете MailQuery обекта със заявката, създадена от MailQueryBuilder. Pop3Client използва този MailQuery обект, за да извлече филтрираната информация от сървъра.

Следният примерен код демонстрира как да се филтрират и извличат имейли от Gmail акаунт въз основа на различни критерии, включително тема, вътрешна дата, подател и получател. Той също така показва чувствително към регистъра филтриране и демонстрира ефективно изграждане на сложни заявки.

Установете връзка с POP3 сървъра на Gmail, използвайки 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 клас предоставя възможност за търсене на имейли, задавайки флагове за чувствителност към регистъра:

Метод Aspose.Email.StringComparisonField.contains(value, ignore_case) Метод Aspose.Email.StringComparisonField.equals(value, ignore_case) Метод Aspose.Email.StringComparisonField.not_contains(value, ignore_case) Метод 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: Работа със съобщения от сървъра

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

Получаване на информация за пощенската кутия

Можем да получим информация за пощенската кутия, като броя на съобщенията и размера й, използвайки методите GetMailBoxSize() и GetMailBoxInfo().

Методът GetMailBoxSize() връща размера на пощенската кутия в байтове.
Методът GetMailBoxInfo() връща обект от тип Pop3MailBoxInfo.

Също така е възможно да се получи броят на съобщенията, използвайки свойството MessageCount, и размерът, използвайки свойството OccupiedSize. Следният примерен код показва как да се получи информация за пощенската кутия. Той показва как да:

Създайте Pop3Client.
Свържете се към POP3 сървър.
Получете размера на пощенската кутия.
Получете информация за пощенската кутия.
Получете броя на съобщенията в пощенската кутия.
Получете заетия размер.

Получаване на брой имейли в кутията

Следният кодов откъс показва как да броите имейл съобщенията в пощенска кутия.

Aspose.Email позволява на разработчиците да работят с имейли по много различни начини. Например, те могат да извлекат информация за заглавните части преди да решат дали да изтеглят имейл. Или могат да извлекат имейли от сървър и да ги запазят без парсиране (по-бързо) или след парсиране (по-бавно). Тази статия показва как да извличате и конвертирате имейли.

Извличане на информация за имейл заглавия

Заглавните части (headers) на имейл могат да ни дадат информация за имейл съобщението, която можем да използваме, за да решим дали да извлечем цялото съобщение или не. Обичайно, информацията в заглавните части включва подател, тема, дата на получаване и т.н. (Заглавните части на имейл са подробно описани в „Персонализиране на заглавните части на имейл“. Тази тема се отнася конкретно за изпращане на имейл чрез SMTP, но информацията за съдържанието на заглавните части е валидна и за POP3 имейли). Следните примери показват как да се извлекат заглавните части от POP3 сървър, използвайки последователния номер на съобщението.

Извличане на имейл съобщения

Компонентът Aspose.Email.Pop3 клас предоставя възможност за извличане на имейл съобщения от POP3 сървър и тяхното парсиране в MailMessage инстанция с помощта на компоненти от MailMessage. Класът MailMessage съдържа множество свойства и методи за манипулиране на съдържанието на имейл. Чрез използване на функцията FetchMessage от класа Pop3Client, можете да получите MailMessage инстанция директно от POP3 сървъра. Следният кодов фрагмент показва как да се извлече пълно имейл съобщение от POP3 сървъра.

Извличане на кратка информация за съобщение, използвайки уникално ID

POP3 клиентът на API‑то може да извлече обобщена информация за съобщението от сървъра, използвайки уникалния ID на съобщението. Това осигурява бърз достъп до кратка информация за съобщението, без първо да се изтегля цялото съобщение от сървъра. Следният кодов фрагмент показва как да се извлече обобщена информация за съобщението.

Изброяване на съобщения с 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, описан в „Свързване с POP3 сървър“, предоставя метода 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 клас предоставя възможност за търсене на имейли със зададени флагове за чувствителност към регистъра.

Следният кодов фрагмент показва как да внедрите тази възможност в проекта си:

import aspose.email as ae

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