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

Java: Свързване към POP3 сървър

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

Този Pop3Client класът позволява на приложенията да управляват пощенски кутии, използвайки Post Office Protocol, версия 3 (POP3). За да се свържете със сървър, използвайте Pop3Client клас. Този Pop3Client класът е основната точка за разработчиците, които искат да добавят POP3 управление към своите .NET приложения. Тази статия обяснява как да се използва. За да се свържете с POP3 сървър:

Създайте инстанция на Pop3Client клас.
Задайте хоста, потребителското име и паролата в Pop3Client екземпляр.

Следният кодов пример показва как да се свържете с 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.");

Свързване със SSL сървър

Свързване с POP3 сървър описва как да се свържете с POP3 сървър в три прости стъпки:

Създайте инстанция на Pop3Client клас.
Задайте хоста, потребителското име и паролата.

Процесът за свързване със SSL‑поддържан POP3 сървър е подобен, но изисква да зададете още няколко свойства:

SecurityOptions
Порт

За да се свържете със SSL‑поддържан POP3 сървър, използвайте Pop3Client клас и задайте SecurityOptions и свойства Port. Следният кодов пример показва как да се свържете със SSL‑поддържан 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 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.");

Свързване с APOP сървър

POP означава Post Office Protocol. APOP означава Authenticated Post Office Protocol. APOP е разширена версия на настройката на POP3 сървър, която криптира вашето потребителско име и парола и използва механизъм за автентикация, проектиран да защити паролата на вашия POP3 акаунт при проверка на имейл. APOP автентикацията не изисква паролата на акаунта да бъде изпратена като чист текст към POP3 сървъра.

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

Прокси сървърите са много чести за комуникация с външния свят. В такива случаи се използват прокси адреси, за да имейл клиентите имат достъп до пощенски кутии през Интернет. Aspose.Email поддържа версии 4, 4a и 5 на SOCKS прокси протокола. Тази статия предоставя работен пример за извличане на имейл чрез прокси пощенски сървър. За извличане на имейл чрез прокси сървър:

Инициализиране Прокси с необходимата информация, а именно адрес на прокси, порт и SOCKS версия.
Инициализиране Pop3Client с адреса на хоста, потребителско име, парола и други настройки.
Задайте свойството 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();

Свързване към сървър чрез 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();
}

Персонализиране на механизъм за автентикация

Получете списъка с механизми за автентикация, поддържани от POP3 сървъра, като използвате getSupportedAuthentication метод на Pop3Client клас. Този метод позволява на клиента да определи кои методи за автентикация са достъпни за установяване на сигурна връзка със сървъра. След това, използвайки setAllowedAuthentication метод, който получава (или задава) изброяване на типове автентикация, разрешени от потребителя, изберете най‑подходящия механизъм за автентикация за комуникацията клиент‑сървър. Това ви позволява изрично да зададете метода на автентикация за имейл клиента.

Следният пример с код показва как да персонализирате автентикацията на имейл клиент:

pop3Client.setAllowedAuthentication(Pop3KnownAuthenticationType.Plain);

Поддръжка на OAuth 2.0 протокол за упълномощаване

OAuth 2.0 предоставя упълномощаване

Pop3Client поддържа OAuth 2.0, предоставяйки специфични начини за упълномощаване за приложения. Следните конструктори се използват за инициализиране на POP3Client чрез 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*/

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

Понякога е необходимо да се проверят идентификационните данни без изпращане на имейл. Aspose.Email предоставя validateCredentials() метод за изпълнение на тази операция. Ако валидирането е успешно, кодът вътре в if израза се изпълнява, обикновено се използва за извършване на допълнителни действия или извличане на данни от IMAP сървъра. Следният кодов фрагмент демонстрира валидирането на идентификационни данни без изпращане на имейл:

try (Pop3Client pop3Client = new Pop3Client(
        server.Pop3Url, server.Pop3Port, "userName", "password", SecurityOptions.Auto)) {
    pop3Client.setTimeout(4000);

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

Използване на CRAM-MD5 автентикация за свързване към сървър

За да осигурите сигурна автентикация и комуникация с POP3 сървъра, можете да зададете и наложите използването на CRAM-MD5 като разрешен метод за автентикация за POP3 клиента. Следният кодов пример показва как да конфигурирате разрешения тип автентикация за Pop3Client:

popClient.setAllowedAuthentication(Pop3KnownAuthenticationType.CramMD5);

Как да зададете време за изчакване за пощенски операции

Всяка пощенска операция отнема време в зависимост от много фактори (мрежови закъснения, размер на данните, производителност на сървъра и др.). Можете да зададете време за изчакване за всички пощенски операции. Примерният код по-долу ви показва как да направите това, като използвате Време за изчакване свойство. Забележка: не трябва да задавате големи стойности, за да избегнете дълги изчаквания във вашето приложение.

try (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.setTimeout(60000); // 60 seconds

    // some code...
}

Java: Изтриване на съобщения от POP3 сървър

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

Aspose.Email е мощен компонент, който позволява извършване на персонализирани операции след определени действия. Aspose.Email генерира множество събития, при които потребителите могат да изпълняват операции. Тази функция предоставя на потребителите повече контрол върху приложението им. Например, потребителите могат да извършват желаните действия, когато:

Всички масови имейли са изпратени.
Съобщението се изпраща.
Имейлът е напълно изпратен.
Когато получателят бъде отхвърлен от SMTP сървъра.

POP3 пощенските кутии се намират на POP3 сървър. Имейлите в тези кутии могат да бъдат извлечени към вашия компютър чрез Pop3Client. The Pop3Client класът използва POP3 протокол за копиране на съобщенията от вашата POP3 пощенска кутия към вашия компютър. След като пощата е извлечена, не е необходимо да сте свързани към интернет, докато я четете, тъй като можете да я прочетете на компютъра. Ако не се нуждаете или не искате копие от някои съобщения, съхранявани на POP3 сървъра, тогава ги изтривате. Този раздел показва как да изтривате имейли, използвайки Pop3Client клас.

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

Следният кодов пример изтрива всички писма в пощенска кутия едно по едно, въз основа на техния индекс. Индексът никога не трябва да бъде <=0 в 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());
}

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

Може също да извикаме Pop3Client.deleteMessages за изтриване на всички съобщения. Следният кодов пример показва как да изтриете всички имейли.

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

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

Ако връзката към POP3 сървъра се прекъсне веднага след операции по изтриване, вече не можете да извикате Pop3Client.cancelDeletes() за да направите желаното.

Отмяна на изтривания

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

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

// Cancel deletes
client.undeleteMessages();

Java: Изброяване на разширения на сървъра с Pop3Client

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

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

Извличане на разширения на сървъра

Следният пример с код демонстрира извличане на разширения на сървъра с Pop3Client за 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: Работа със съобщения от сървъра

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

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

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

Този getMailBoxSize метод, който връща размера на пощенската кутия в байтове.
Този getMailBoxInfo метод, който връща обект от тип Pop3MailBoxInfo.

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

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

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

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

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

// 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 позволява на разработчиците да работят с имейли по много различни начини. Например, те могат да извлекат информация за заглавните части преди да решат дали да изтеглят имейл. Или могат да извлекат имейли от сървър и да ги запазят без парсиране (по-бързо) или след парсиране (по-бавно). Тази статия показва как да извличате и конвертирате имейли.

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

Заглавните части на имейла могат да ни дадат информация за имейл съобщението, която можем да използваме, за да решим дали да извлечем цялото имейл съобщение или не. Обикновено заглавната информация съдържа изпращач, тема, дата на получаване и т.н. (Заглавните части на имейлите са подробно описани в Персонализиране на имейл заглавия. Тази тема е специално за изпращане на имейл с SMTP, но информацията за съдържанието на заглавните части на имейла остава валидна за POP3 имейли). Следващите примери показват как да се извлекат заглавните части на имейли от 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 {
    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();
}

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

Този Pop3Client класовият компонент предоставя възможност за извличане на имейл съобщения от POP3 сървъра и тяхното парсиране в MailMessage екземпляр с помощта на MailMessage компоненти. The MailMessage класът съдържа няколко свойства и методи за манипулиране на имейл съдържание. Чрез използване на fetchMessage метод на Pop3Client клас, можете да получите MailMessage инстанция директно от POP3 сървъра. Следният кодов пример показва как да извлечете пълен имейл от 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();
}

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

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

// 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());
}

Изброяване на съобщения с MultiConnection

Pop3Client предоставя UseMultiConnection свойство, което може да се използва за създаване на множество връзки за тежки операции. Също така можете да зададете броя на връзките, които да се използват по време на режим с множество връзки, като използвате Pop3Client.ConnectionsQuantity. Следният кодов пример демонстрира използването на режим с множество връзки за изброяване на съобщения и сравнява неговата производителност с режима с единична връзка.

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

Моля, имайте предвид, че използването на режим с множество връзки не гарантира увеличение на производителността.

Извличане на съобщения от сървъра и запазване на диск

Записване на съобщението на диск без парсиране

Ако искате да изтеглите имейл съобщения от POP3 сървъра без да ги парсирате, използвайте Pop3Client клас saveMessage функцията. saveMessage функцията не парсира имейл съобщението, затова е по-бърза от fetchMessage функция. Следният кодов откъс показва как да запазите съобщение по неговия последователен номер, в този случай, номер 1. saveMessage методът запазва съобщението в оригиналния EML формат без да го парсира.

// 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 ");

Парсиране на съобщението преди запазване

Следният кодов откъс използва Pop3Client fetchMessage метод за извличане на съобщение от POP3 сървър по неговия последователен номер, след което съхранява съобщението на диск, използвайки темата като име на файла.

// 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();
}

Групово извличане на съобщения

Pop3Client предоставя fetchMessages метод, който приема итерируем обект от последователни номера или уникален идентификатор и връща списък от MailMessage. Следният кодов откъс демонстрира използването на fetchMessages метод за извличане на съобщения по последователни номера и уникален идентификатор.

// 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());
}

Филтриране на съобщения по изпращач, получател или дата

Този Pop3Client клас, описан в Свързване с POP3 сървър, предоставя listMessages метод, който получава всички съобщения от пощенска кутия. За да получите само съобщения, отговарящи на някои условия, използвайте претоварения listMessages метод, който приема MailQuery като аргумент. MailQuery класът предоставя различни свойства за задаване на условията на заявката, например дата, тема, изпращач, получател и т.н. MailQueryBuilder класът се използва за изграждане на израза за търсене. Първо се задават всички условия и ограничения и след това MailQuery се попълва с заявката, разработена от MailQueryBuilder. The MailQuery класов обект се използва от Pop3Client за извличане на филтрирана информация от сървъра. Тази статия показва как да филтрирате имейл съобщения от пощенска кутия. Първият пример илюстрира как да се филтрират съобщения по дата и тема. Също показваме как да филтрираме по други критерии и как да изградим по-сложни заявки. Тя също демонстрира прилагане на филтър за дата и час за извличане на конкретни имейли от пощенската кутия. Освен това се показва как да се приложи филтриране, чувствително към регистъра.

Филтриране на съобщения от пощенската кутия

За филтриране на съобщения от пощенска кутия:

Свържете се и влезте в POP3 сървър.
Създайте инстанция на MailQuery и задайте желаните свойства.
Извикайте Pop3Client.listMessages(MailQuery query) метод и предайте MailQuery в параметри, за да се получат само филтрираните съобщения.

Следният кодов откъс показва как да се свържете с POP3 пощенска кутия и да получите съобщения, които са дошли днес и имат думата „newsletter“ в темата.

// 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.");

Получаване на съобщения, отговарящи на конкретни критерии

Кодовите примери по-горе филтрира съобщенията според темата и датата на имейла. Можем да използваме други свойства, за да зададем други поддържани условия също. По-долу са някои примери за задаване на условия, използвайки MailQuery.

Следващите кодови откъси показват как да филтрирате имейли по други критерии:

Намерете имейли, доставени днес.
Намерете имейли, получени в диапазон.
Намерете имейли от конкретен изпращач.
Намерете имейли, изпратени от конкретен домейн.
Намерете имейли, изпратени до конкретен получател.

Днешна дата

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

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

Диапазон от дати

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

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

Конкретен изпращач

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

// 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");

Конкретен домейн

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

// 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");

Конкретен получател

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

// 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");

Съставяне на сложни заявки

Ако различни MailQueryBuilder свойствата се задават в отделни изрази, след което всички условия ще бъдат изпълнени. Например, ако искаме да получим съобщения между даден диапазон от дати и от конкретен хост, трябва да напишем три израза.

Комбиниране на заявки с AND

Следният кодов откъс показва как да комбинирате заявки с 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());

Комбиниране на заявки с OR

MailQueryBuilder предоставя или метод, който приема две MailQuery екземпляри като параметри. Той получава съобщенията, които отговарят на едно от двете зададени условия. Следният кодов откъс показва как да филтрирате съобщения, които имат „test“ в темата или „noreply@host.com“ като изпращач. Следният кодов откъс показва как да комбинирате заявки с 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"));

Прилагане на филтри, чувствителни към регистъра

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

Метод StringComparisonField.contains(String value, boolean ignoreCase)
Метод StringComparisonField.equals(String value, boolean ignoreCase)
Метод StringComparisonField.notContains(String boolean, bool ignoreCase)
Метод 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: Работа с Pop3Client асинхронно

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

Работа с Pop3Client асинхронно

Съобщения могат да се извличат от пощенски кутии асинхронно, като се използва Aspose.Email Pop3Client. Тази статия показва как да се извлекат съобщения от пощенска кутия асинхронно. Тя също така показва как да се изброят съобщения, като се предоставят критерии за търсене, използвайки MailQuery.

Асинхронно извличане на съобщения

// 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());
}

Списък със съобщения асинхронно с MailQuery

Този MailQuery класът може да се използва за задаване на критерии за търсене при извличане на списък със съобщения асинхронно, както е показано в следния пример с код.

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