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 کلاس.
آدرس میزبان، نام کاربری و رمز عبور را مشخص کنید.

فرآیند اتصال به سرور POP3 با پشتیبانی SSL مشابه است اما نیاز دارد چند ویژگی دیگر تنظیم شوند:

SecurityOptions
پورت

برای اتصال به سرور POP3 با پشتیبانی SSL، از Pop3Client کلاس و تنظیم SecurityOptions و ویژگی‌های Port. قطعه کد زیر نشان می‌دهد چگونه به سرور POP3 با پشتیبانی SSL متصل شوید.

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

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

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

اتصال به سرور 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);

نحوه تنظیم زمان انتظار برای عملیات ایمیل

هر عملیات ایمیل بسته به عوامل متعددی (تاخیرهای شبکه، حجم داده، عملکرد سرور و غیره) مدتی طول می‌کشد. می‌توانید زمان انتظار (Timeout) را برای تمام عملیات ایمیل تنظیم کنید. مثال کد زیر نشان می‌دهد چگونه با استفاده از زمان انتظار ویژگی. نکته: نباید مقادیر بزرگ تنظیم کنید تا از انتظار طولانی در برنامه جلوگیری کنید.

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. این 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 و غیره را دریافت کنید. این به شناسایی در دسترس بودن یک افزونه قبل از استفاده از کلاینت برای آن عملکرد خاص کمک می‌کند. 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();
}

بازیابی اطلاعات خلاصهٔ پیام با استفاده از شناسهٔ یکتا

کلاینت POP3 API می‌تواند اطلاعات خلاصهٔ پیام را از سرور با استفاده از شناسهٔ یکتا (unique 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());
}

فهرست‌کردن پیام‌ها با چند‌اتصال

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 متدی که یک iterable از شماره‌های توالی یا شناسهٔ یکتا می‌پذیرد و فهرستی از 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. این 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 همچنین قابلیت فیلتر کردن ایمیل‌ها از صندوق‌پست بر اساس معیار حساس به حروف کوچک و بزرگ را فراهم می‌کند. متدهای زیر امکان جستجوی ایمیل‌ها با پرچم حساس به حروف را ارائه می‌دهند.

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

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

Java: کار با 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);