Documentation – کار با مشتری IMAP

Java: اتصال به سرور IMAP

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

این ImapClient کلاس به برنامه‌ها اجازه می‌دهد صندوق‌های ایمیل IMAP را با استفاده از پروتکل IMAP مدیریت کنند. ImapClient کلاس برای اتصال به سرورهای ایمیل IMAP و مدیریت ایمیل‌ها در پوشه‌های ایمیل IMAP استفاده می‌شود. برای اتصال به سرور IMAP

یک نمونه از ImapClient کلاس.
نام میزبان، نام کاربری و گذرواژه را در سازنده ImapClient.

زمانی که ImapClient نمونه ایجاد می‌شود، فراخوانی بعدی هر عمل با این نمونه به سرور متصل می‌شود. کد زیر نشان می‌دهد چگونه با استفاده از مراحل فوق به سرور IMAP متصل شویم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

اتصال به سرور IMAP با SSL فعال

اتصال به سرور IMAP نحوهٔ اتصال به سرور IMAP را در چهار گام ساده توضیح دادیم:

یک نمونه از ImapClient کلاس.
نام میزبان، نام کاربری و گذرواژه را مشخص کنید.
پورت را مشخص کنید.
مشخص کنید گزینه‌های امنیتی.

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

تنظیم گزینه‌های امنیتی به SSLImplicit.

کد زیر نشان می‌دهد چگونه

نام کاربری، گذرواژه و پورت را تنظیم کنید.
تنظیم گزینه امنیتی.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of the ImapClient class
ImapClient client = new ImapClient("imap.domain.com", 993, "user@domain.com", "pwd");

// Set the security mode to implicit
client.setSecurityOptions(SecurityOptions.SSLImplicit);

اتصال به سرور از طریق پروکسی

سرورهای پروکسی معمولاً برای ارتباط با دنیای بیرون استفاده می‌شوند. در این شرایط، کلاینت‌های ایمیل بدون تعیین آدرس پروکسی نمی‌توانند از اینترنت ارتباط برقرار کنند. Aspose.Email پشتیبانی از نسخه‌های 4، 4a و 5 پروتکل پروکسی SOCKS را فراهم می‌کند. این مقاله نمونهٔ عملی دسترسی به صندوق پست با استفاده از سرور پروکسی ایمیل را ارائه می‌دهد. برای دسترسی به صندوق پست از طریق سرور پروکسی:

راه‌اندازی SocksProxy با اطلاعات مورد نیاز: آدرس پروکسی، پورت و نسخه SOCKS.
راه‌اندازی ImapClient با آدرس میزبان، نام کاربری، گذرواژه و هر تنظیمات دیگر.
تنظیم کلاینت SocksProxy ویژگی به SocksProxy شیء‌ای که در بالا ایجاد شده است.

کد زیر نشان می‌دهد چگونه صندوق پست را از طریق سرور پروکسی بازیابی کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP and set SecurityOptions
ImapClient client = new ImapClient("imap.domain.com", "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);

String proxyAddress = "192.168.203.142"; // proxy address
int proxyPort = 1080; // proxy port
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);

// Set the proxy
client.setProxy(proxy);

try {
    client.selectFolder("Inbox");
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

اتصال به سرور از طریق پروکسی 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);
final ImapClient client = new ImapClient("imap.domain.com", "username", "password");
try {
    client.setProxy(proxy);
    client.selectFolder("Inbox");
} finally {
    if (client != null)
        client.dispose();
}

سفارشی‌سازی مکانیزم احراز هویت

دریافت فهرست مکانیزم‌های احراز هویتی که توسط سرور IMAP پشتیبانی می‌شوند با استفاده از getSupportedAuthentication متد از ImapClient کلاس. این متد به کلاینت اجازه می‌دهد تا تعیین کند کدام روش‌های احراز هویت برای برقراری اتصال امن با سرور موجود هستند. سپس، با استفاده از setAllowedAuthentication روشی که فهرست (یا تنظیم) انواع احراز هویت مجاز توسط کاربر را برمی‌گرداند، مکانیزم احراز هویت مناسب‌ترین برای ارتباط کلاینت‑سرور را انتخاب می‌کند. این امکان را می‌دهد تا روش احراز هویت مشتری ایمیل را به‌صورت صریح تنظیم کنید.

نمونه کد زیر نشان می‌دهد چگونه احراز هویت مشتری ایمیل را سفارشی کنید:

imapClient.setAllowedAuthentication(ImapKnownAuthenticationType.Plain);

اتصال به سرور در حالت فقط‑خواندنی

این ImapClient کلاس یک ReadOnly ویژگی که هنگامی که به true تنظیم شود، نشان می‌دهد که هیچ تغییری در وضعیت دائمی صندوق پست اعمال نشود. نمونه کد زیر استفاده از ImapClient.ReadOnly ویژگی. تعداد پیام‌های نخوانده را میگیرد، سپس یک پیام را واکشی می‌کند و دوباره تعداد پیام‌های نخوانده را در حالت فقط‑خواندنی میگیرد. تعداد پیام‌های نخوانده همان‌جا می‌ماند که نشان می‌دهد وضعیت دائمی صندوق پست تغییر نکرده است.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapQueryBuilder imapQueryBuilder = new ImapQueryBuilder();
imapQueryBuilder.hasNoFlags(ImapMessageFlags.isRead()); /* get unread messages. */
MailQuery query = imapQueryBuilder.getQuery();

imapClient.setReadOnly(true);
imapClient.selectFolder("Inbox");
ImapMessageInfoCollection messageInfoCol = imapClient.listMessages(query);
System.out.println("Initial Unread Count: " + messageInfoCol.size());
if (messageInfoCol.size() > 0) {
    imapClient.fetchMessage(messageInfoCol.get_Item(0).getSequenceNumber());

    messageInfoCol = imapClient.listMessages(query);
    // This count will be equal to the initial count
    System.out.println("Updated Unread Count: " + messageInfoCol.size());
} else {
    System.out.println("No unread messages found");
}

استفاده از احراز هویت CRAM-MD5 برای اتصال به یک سرور

برای اطمینان از احراز هویت و ارتباط ایمن با سرور IMAP، می‌توانید استفاده از CRAM-MD5 را به عنوان روش احراز هویت مجاز برای کلاینت IMAP مشخص و اعمال کنید. کد زیر نشان می‌دهد چگونه نوع احراز هویت مجاز را برای ImapClient:

imapClient.setAllowedAuthentication(ImapKnownAuthenticationType.CramMD5);

اعتبارسنجی اعتبارهای سرور ایمیل بدون ارسال ایمیل

گاهی لازم است اعتبارسنجی اعتبارها بدون ارسال ایمیل انجام شود. Aspose.Email فراهم می‌کند validateCredentials() متد برای انجام این عملیات. اگر اعتبارسنجی موفق باشد، کد داخل شرط if اجرا می‌شود که معمولاً برای انجام اقدامات بیشتر یا دریافت داده‌ها از سرور IMAP استفاده می‌شود. قطعه کد زیر اعتبار اعتبارنامه‌ها را بدون ارسال ایمیل نشان می‌دهد:

try (ImapClient imapClient = new ImapClient(
        server.ImapUrl, server.ImapPort, "username", "password", SecurityOptions.Auto)) {
    imapClient.setTimeout(4000);

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

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

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

try (ImapClient imapClient = new ImapClient("host", 993, "username", "password", SecurityOptions.SSLImplicit))
{
    imapClient.setTimeout(60000); // 60 seconds

    // some code...
}

چگونه زمان‌سنجی خوشامدگویی را محدود کنیم

کلاینت IMAP ممکن است از حالت خودکار برای برقراری اتصال استفاده کند. در این حالت، کلاینت IMAP تمام پارامترهای ممکن اتصال را تا زمانی که اتصال برقرار شود بررسی می‌کند. سرور IMAP در صورت اتصال صحیح یک رشتهٔ خوشامدگویی به کلاینت ارسال می‌کند. سرورها می‌توانند اتصال SSL/TLS را به صورت ضمنی یا صریح (START TLS) آغاز کنند. اگر حالت اتصال نامتناسب باشد (به عنوان مثال، سرور منتظر اتصال SSL ضمنی است اما کلاینت سعی می‌کند یک اتصال غیرامن یا SSL صریح برقرار کند)، سرور رشتهٔ خوشامدگویی را ارسال نخواهد کرد و کاربر مدت طولانی تا زمان‌گذاری منتظر می‌ماند تا به رشتهٔ خوشامدگویی برسد و کلاینت به گزینهٔ اتصال بعدی می‌رود. برای جلوگیری از این مشکل، ویژگی GreetingTimeout معرفی شده است. این ویژگی به شما امکان تنظیم زمان‌سنجی برای رشتهٔ خوشامدگویی را می‌دهد و زمان برقراری اتصال خودکار را کاهش می‌دهد.

ImapClient imapClient = new ImapClient();
imapClient.setGreetingTimeout(4000);

Java: کار با پیام‌ها از سرور IMAP

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

فهرست‌برداری شناسه‌های پیام MIME از سرور

ImapMessageInfo MIME را فراهم می‌کند MessageId برای شناسایی پیام بدون استخراج کامل پیام. کد زیر نشان می‌دهد چگونه شناسهٔ پیام MIME را لیست کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient client = new ImapClient();
client.setHost("domain.com");
client.setUsername("username");
client.setPassword("password");

try {
    ImapMessageInfoCollection messageInfoCol = client.listMessages("Inbox");
    for (ImapMessageInfo info : messageInfoCol) {
        // Display MIME Message ID
        System.out.println("Message Id = " + info.getMessageId());
    }
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

لیست کردن پیام‌ها از سرور

Aspose.Email یک نسخهٔ overload شدهٔ ۲ عضوی از listMessages() برای بازیابی تعداد مشخصی پیام بر پایهٔ یک پرس‌وجو. کد زیر نشان می‌دهد چگونه پیام‌ها را لیست کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

// Select the inbox folder and Get the message info collection
ImapQueryBuilder builder = new ImapQueryBuilder();
MailQuery query = builder
        .or(builder.or(builder.or(builder.or(builder.getSubject().contains(" (1) "), builder.getSubject().contains(" (2) ")), builder.getSubject().contains(" (3) ")),
                builder.getSubject().contains(" (4) ")), builder.getSubject().contains(" (5) "));
ImapMessageInfoCollection messageInfoCol4 = client.listMessages(query, 4);
System.out.println((messageInfoCol4.size() == 4) ? "Success" : "Failure");

لیست کردن پیام‌ها از سرور به صورت بازگشتی

پروتکل IMAP از لیست کردن پیام‌ها به صورت بازگشتی از یک پوشهٔ صندوق پست پشتیبانی می‌کند. این امکان فهرست کردن پیام‌ها از زیرپوشه‌های یک پوشه را نیز فراهم می‌سازد. کد زیر نشان می‌دهد چگونه پیام‌ها را به صورت بازگشتی لیست کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an imapclient with host, user and password
ImapClient client = new ImapClient();
client.setHost("domain.com");
client.setUsername("username");
client.setPassword("password");
client.selectFolder("InBox");
ImapMessageInfoCollection msgsColl = client.listMessages(true);
System.out.println("Total Messages: " + msgsColl.size());

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

ImapClient ارائه می‌دهد یک UseMultiConnection ویژگی که می‌تواند برای ایجاد چندین اتصال برای عملیات سنگین استفاده شود. همچنین می‌توانید با استفاده از ImapClient.ConnectionsQuantity. کد زیر استفاده از حالت چند‑اتصال برای لیست کردن پیام‌ها را نشان می‌دهد و عملکرد آن را با حالت اتصال تک مقایسه می‌کند.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

imapClient.selectFolder("Inbox");
imapClient.setConnectionsQuantity(5);
imapClient.setUseMultiConnection(MultiConnectionMode.Enable);
long multiConnectionModeStartTime = System.currentTimeMillis();
ImapMessageInfoCollection messageInfoCol1 = imapClient.listMessages(true);
long multiConnectionModeTimeSpan = System.currentTimeMillis() - multiConnectionModeStartTime;

imapClient.setUseMultiConnection(MultiConnectionMode.Disable);
long singleConnectionModeStartTime = System.currentTimeMillis();
ImapMessageInfoCollection messageInfoCol2 = imapClient.listMessages(true);
long singleConnectionModeTimeSpan = System.currentTimeMillis() - singleConnectionModeStartTime;

double performanceRelation = singleConnectionModeTimeSpan / multiConnectionModeTimeSpan;
System.out.println("Performance Relation: " + performanceRelation);

لطفاً توجه داشته باشید که استفاده از حالت چنداتصال تضمین‌کننده‌ی افزایش عملکرد نیست.

دریافت پیام‌ها به ترتیب نزولی

Aspose.Email ارائه می‌دهد ImapClient.listMessagesByPage متد که پیام‌ها را با پشتیبانی از صفحه‌بندی فهرست می‌کند. برخی بارگذاری‌های ImapClient.listMessagesByPage پذیرش PageSettings به عنوان پارامتر. PageSettings یک AscendingSorting ویژگی که زمانی که به false تنظیم شود، ایمیل‌ها را به ترتیب نزولی بر می‌گرداند.

کد مثال زیر نحوه استفاده از AscendingSorting ویژگی PageSettings کلاس برای تغییر ترتیب ایمیل‌ها.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

PageSettings pageSettings = new PageSettings();
pageSettings.setAscendingSorting(false);
ImapPageInfo pageInfo = imapClient.listMessagesByPage(5, pageSettings);
ImapMessageInfoCollection messages = pageInfo.getItems();

for (ImapMessageInfo message : messages) {
    System.out.println(message.getSubject() + " -> " + message.getDate().toString());
}

دریافت پیام‌ها از سرور و ذخیره بر روی دیسک

این ImapClient کلاس می‌تواند پیام‌ها را از یک سرور IMAP دریافت کرده و آن‌ها را در قالب EML بر روی دیسک محلی ذخیره کند. مراحل زیر برای ذخیره پیام‌ها بر روی دیسک ضروری است:

یک نمونه از ImapClient کلاس.
در ImapClient، نام میزبان، پورت، نام کاربری و گذرواژه را مشخص کنید constructor.
پوشه را با استفاده از selectFolder() متد.
متد را فراخوانی کنید listMessages متد برای دریافت ImapMessageInfoCollection شیء.
درون ImapMessageInfoCollection مجموعه، فراخوانی کنید saveMessage() متد که مسیر خروجی و نام فایل را تعیین می‌کند.

کد زیر نشان می‌دهد چگونه پیام‌های ایمیل را از یک سرور دریافت و ذخیره کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Select the inbox folder and Get the message info collection
client.selectFolder(ImapFolderInfo.IN_BOX);
ImapMessageInfoCollection list = client.listMessages();

// Download each message
for (int i = 0; i < list.size(); i++) {
    // Save the EML file locally
    client.saveMessage(list.get_Item(i).getUniqueId(), dataDir + list.get_Item(i).getUniqueId() + ".eml");
}

ذخیرهٔ پیام‌ها در قالب MSG

در مثال بالا, ایمیل‌ها در قالب EML ذخیره می‌شوند. برای ذخیره ایمیل‌ها در قالب MSG، ImapClient.fetchMessage() متد باید فراخوانی شود. پیام را در یک نمونه از MailMessage کلاس. MailMessage.save() متد می‌تواند سپس برای ذخیره پیام به فرمت MSG فراخوانی شود. کد زیر نشان می‌دهد چگونه پیام‌ها را در قالب MSG ذخیره کنید.

// 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 = "data/";

// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

// Select the inbox folder and Get the message info collection
client.selectFolder(ImapFolderInfo.IN_BOX);
ImapMessageInfoCollection list = client.listMessages();

// Download each message
for (int i = 0; i < list.size(); i++) {
    // Save the message in MSG format
    MailMessage message = client.fetchMessage(list.get_Item(i).getUniqueId());
    message.save(dataDir + list.get_Item(i).getUniqueId() + "_out.msg", SaveOptions.getDefaultMsgUnicode());
}

گروه‌بندی بازیابی پیام‌ها

ImapClient ارائه می‌دهد یک fetchMessages متدی که یک iterable از شماره‌های توالی یا شناسهٔ یکتا می‌پذیرد و فهرستی از MailMessage. قطعه کد زیر استفاده از fetchMessages متد برای بازیابی پیام‌ها بر اساس شماره توالی و شناسهٔ یکتا.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapMessageInfoCollection messageInfoCol = imapClient.listMessages();
System.out.println("ListMessages Count: " + messageInfoCol.size());

List<Integer> sequenceNumberAr = new ArrayList<Integer>();
List<String> uniqueIdAr = new ArrayList<String>();
for (ImapMessageInfo mi : messageInfoCol) {
    sequenceNumberAr.add(mi.getSequenceNumber());
    uniqueIdAr.add(mi.getUniqueId());
}

for (MailMessage m : imapClient.fetchMessagesBySequences(sequenceNumberAr)) {
    System.out.println("FetchMessages-sequenceNumberAr : " + m.getSubject());
}

for (MailMessage m : imapClient.fetchMessagesByUids(uniqueIdAr)) {
    System.out.println("FetchMessages-uniqueIdAr : " + m.getSubject());
}

رشته‌بندی ایمیل/سازماندهی ایمیل‌ها به‌صورت گفتگوها

Aspose.Email امکان گروه‌بندی تمام پیام‌های فوروارد، پاسخ و پاسخ به همه‌جا که به همان گفتگو مربوط هستند را به‌صورت سلسله‌مراتبی فراهم می‌کند. در اصل، پروتکل IMAP ممکن است از قابلیت THREAD تعریف‌شده در RFC-5256 پشتیبانی کند. علاوه بر این، افزونه دیگری از IMAP توسط جی‌میل ارائه شده که به عنوان X-GM-EXT-1 توصیف می‌شود.

ویژگی‌های رشته‌بندی ایمیل زیر برای استفاده در دسترس هستند:

getMessageThreads متد - رشته‌های پیام را دریافت می‌کند توسط ImapClient.
boolean getGmExt1Supported - اطلاعاتی دربارهٔ اینکه آیا افزونه Gmail X-GM-EXT-1 پشتیبانی می‌شود را دریافت می‌کند.
boolean getThreadSupported - اطلاعاتی دربارهٔ اینکه آیا افزونه THREAD پشتیبانی می‌شود را دریافت می‌کند.
String[] getThreadAlgorithms - الگوریتم‌های THREAD پشتیبانی‌شده را دریافت می‌کند.

نمونه‌های کد زیر نحوه استفاده از این ویژگی‌ها برای دریافت رشته‌های ایمیل از جی‌میل را نشان می‌دهند:

  ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password", SecurityOptions.SSLImplicit);

try {

    client.selectFolder(ImapFolderInfo.IN_BOX);

   // get a list of messages that we'll group by conversation

   ImapMessageInfoCollection messages = client.listMessages();

   // make sure the IMAP server supports X-GM-EXT-1 extension

   if (client.getGmExt1Supported()) {

       // gets unique conversationId for our example

       Set<String> conversationIds = new HashSet<String>();

       for (ImapMessageInfo messageInfo : messages) {

           if (messageInfo.getConversationId() != null)

                conversationIds.add(messageInfo.getConversationId());

       }

       for (String conversationId : conversationIds) {

           // create the necessary search conditions for a thread

           XGMThreadSearchConditions conditions = new XGMThreadSearchConditions();

            conditions.setConversationId(conversationId);

            conditions.setUseUId(true);

           // get results

           List<MessageThreadResult> conversation = client.getMessageThreads(conditions);

           // print the email conversation in hierarchically manner

           printConversaton("", conversation, messages);

            System.out.println("--------------------");

       }

   }

} finally {

    client.dispose();

}

/**

 * <p>

 * Prints the email conversation in hierarchically manner

 * </p>

 */

public static void printConversaton(String indent, Iterable<MessageThreadResult> conversation,

    Iterable<ImapMessageInfo> messages) {

   for (MessageThreadResult thread : conversation) {

       for (ImapMessageInfo messageInfo : messages) {

           if (thread.getUniqueId().equals(messageInfo.getUniqueId())) {

                System.out.println(indent + " (" + thread.getUniqueId() + ") " + messageInfo.getSubject());

               break;

           }

       }

       if (thread.getChildMessages().size() != 0) {

            printConversaton(indent += "-", thread.getChildMessages(), messages);

       }

   }

}

کد کمی تغییر می‌کند اگر سرور IMAP از قابلیت THREAD پشتیبانی کند:

بررسی کنید آیا سرور IMAP از افزونه THREAD پشتیبانی می‌کند:

 if (client.getThreadSupported())

شرایط جستجوی مناسب برای یک رشته (thread) را ایجاد کنید:

 ThreadSearchConditions conditions = new ThreadSearchConditions();

conditions.setAlgorithm(client.getThreadAlgorithms()[0]);

conditions.setUseUId(true);

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

در سناریوهایی که سرور ایمیل تعداد زیادی پیام در صندوق‌پست دارد، معمولاً تمایل به فهرست یا دریافت پیام‌ها با پشتیبانی از صفحه‌بندی وجود دارد. API Aspose.Email ImapClient به شما امکان می‌دهد پیام‌ها را از سرور با پشتیبانی از صفحه‌بندی بازیابی کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// This example shows the paging support of ImapClient for listing messages from the server
// Available in Aspose.Email for Java and onwards
final ImapClient client = new ImapClient("host.domain.com", 993, "username", "password");
try {
    try {
        int messagesNum = 12;
        int itemsPerPage = 5;
        MailMessage message = null;
        // Create some test messages and append these to server's inbox
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35157 - " + UUID.randomUUID(),
                    "EMAILNET-35157 Move paging parameters to separate class");
            client.appendMessage(ImapFolderInfo.IN_BOX, message);
        }

        // List messages from inbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection totalMessageInfoCol = client.listMessages();
        // Verify the number of messages added
        System.out.println(totalMessageInfoCol.size());

        ////////////////// RETREIVE THE MESSAGES USING PAGING SUPPORT////////////////////////////////////

        List<ImapPageInfo> pages = new ArrayList<ImapPageInfo>();
        PageSettings pageSettings = new PageSettings();
        ImapPageInfo pageInfo = client.listMessagesByPage(itemsPerPage, 0, pageSettings);
        System.out.println(pageInfo.getTotalCount());
        pages.add(pageInfo);
        while (!pageInfo.getLastPage()) {
            pageInfo = client.listMessagesByPage(itemsPerPage, pageInfo.getNextPage().getPageOffset(), pageSettings);
            pages.add(pageInfo);
        }
        int retrievedItems = 0;

        // foreach to while statements conversion
        for (ImapPageInfo folderCol : pages) {
            retrievedItems += folderCol.getItems().size();
        }
        System.out.println(retrievedItems);
    } finally {
    }
} finally {
    if (client != null)
        client.dispose();
}

دریافت پوشه‌ها و خواندن پیام‌ها به‌صورت بازگشتی

در این مقاله، بیشتر ImapClient این ویژگی‌ها برای ایجاد برنامه‌ای استفاده می‌شوند که تمامی پوشه‌ها و زیرپوشه‌ها را به صورت بازگشتی از یک سرور IMAP فهرست می‌کند. همچنین پیام‌های هر پوشه و زیرپوشه را در قالب MSG بر روی دیسک محلی ذخیره می‌کند. در دیسک، پوشه‌ها و پیام‌ها به همان ساختار سلسله‌مراتبی که در سرور IMAP وجود دارد، ساخته و ذخیره می‌شوند. کد زیر نشان می‌دهد چگونه اطلاعات پیام‌ها و زیرپوشه‌ها را به صورت بازگشتی دریافت کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() throws Exception {
    // Create an instance of the ImapClient class
    ImapClient client = new ImapClient();

    // Specify host, username, password, Port and SecurityOptions for your client
    client.setHost("imap.gmail.com");
    client.setUsername("your.username@gmail.com");
    client.setPassword("your.password");
    client.setPort(993);
    client.setSecurityOptions(SecurityOptions.Auto);
    try {
        // The root folder (which will be created on disk) consists of host and username
        String rootFolder = client.getHost() + "-" + client.getUsername();

        // Create the root folder and List all the folders from IMAP server
        new File(rootFolder).mkdirs();
        ImapFolderInfoCollection folderInfoCollection = client.listFolders();
        for (ImapFolderInfo folderInfo : folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listMessagesInFolder(folderInfo, rootFolder, client);
        }
        // Disconnect to the remote IMAP server
        client.dispose();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex);
    }

    System.out.println("Downloaded messages recursively from IMAP server.");
}

/// Recursive method to get messages from folders and sub-folders
private static void listMessagesInFolder(ImapFolderInfo folderInfo, String rootFolder, ImapClient client) {
    // Create the folder in disk (same name as on IMAP server)
    String currentFolder = "data/";
    new File(currentFolder).mkdirs();

    // Read the messages from the current folder, if it is selectable
    if (folderInfo.getSelectable()) {
        // Send status command to get folder info
        ImapFolderInfo folderInfoStatus = client.getFolderInfo(folderInfo.getName());
        System.out.println(folderInfoStatus.getName() + " folder selected. New messages: " + folderInfoStatus.getNewMessageCount() + ", Total messages: "
                + folderInfoStatus.getTotalMessageCount());

        // Select the current folder and List messages
        client.selectFolder(folderInfo.getName());
        ImapMessageInfoCollection msgInfoColl = client.listMessages();
        System.out.println("Listing messages....");
        for (ImapMessageInfo msgInfo : msgInfoColl) {
            // Get subject and other properties of the message
            System.out.println("Subject: " + msgInfo.getSubject());
            System.out.println("Read: " + msgInfo.isRead() + ", Recent: " + msgInfo.getRecent() + ", Answered: " + msgInfo.getAnswered());

            // Get rid of characters like ? and :, which should not be included in a file name and Save the message in MSG format
            String fileName = msgInfo.getSubject().replace(":", " ").replace("?", " ");
            MailMessage msg = client.fetchMessage(msgInfo.getSequenceNumber());
            msg.save(currentFolder + "\\" + fileName + "-" + msgInfo.getSequenceNumber() + ".msg", SaveOptions.getDefaultMsgUnicode());
        }
        System.out.println("============================\n");
    } else {
        System.out.println(folderInfo.getName() + " is not selectable.");
    }

    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ImapFolderInfoCollection folderInfoCollection = client.listFolders(folderInfo.getName());
        for (ImapFolderInfo subfolderInfo : folderInfoCollection) {
            listMessagesInFolder(subfolderInfo, rootFolder, client);
        }
    } catch (java.lang.RuntimeException e) {
    }
}

دریافت UID یا شماره ترتیب پیام

API عمومی Aspose.Email ویژگی‌های زیر را برای دریافت اطلاعات شناسایی پیام مانند UID یا شماره ترتیب که ممکن است هنگام پردازش پیام‌های دریافت شده از سرور نیاز باشد، فراهم می‌کند:

MailboxInfo کلاس - نمایانگر اطلاعات شناسایی یک پیام در صندوق پستی.

getSequenceNumber() متد - شماره ترتیبی (sequence number) یک پیام را دریافت می‌کند.
getUniqueId() متد - شناسه یکتا (unique id) یک پیام را دریافت می‌کند.

MailMessage کلاس - یک پیام ایمیل را نمایندگی می‌کند و امکان دسترسی به ویژگی‌های پیام مانند موضوع، بدنه، فرستنده و آدرس‌های گیرندگان و غیره را فراهم می‌کند.

getItemId متد - اطلاعات شناسایی درباره یک پیام در صندوق‌پست را نشان می‌دهد.

نمونه کد زیر نشان می‌دهد که چگونه جزئیات پیام‌ها را از پوشه "INBOX" در یک سرور IMAP با استفاده از ImapClient کلاس:

try (ImapClient client = new ImapClient(imapHost, port, emailAddress, password, securityOption)) {
    ImapMessageInfoCollection msgs = client.listMessages("INBOX");
    List<Integer> seqIds = new ArrayList<>();
    for (ImapMessageInfo msg : msgs) {
        seqIds.add(msg.getSequenceNumber());
    }
    Iterable<MailMessage> msgsViaFetch = client.fetchMessagesBySequences(seqIds);
    for (MailMessage thisMsg : msgsViaFetch) {
        System.out.println("Message ID: " + thisMsg.getItemId().getUniqueId()
                + " SequenceNumber: " + thisMsg.getItemId().getSequenceNumber()
                + " Subject: " + thisMsg.getSubject());
    }
}

بازیابی پارامترهای اضافی به عنوان اطلاعات خلاصه

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("host.domain.com", "username", "password");
try {
    MailMessage message = new MailMessage("from@domain.com", "to@doman.com", "EMAILNET-38466 - " + UUID.randomUUID().toString(),
            "EMAILNET-38466 Add extra parameters for UID FETCH command");

    // append the message to the server
    String uid = client.appendMessage(message);

    // wait for the message to be appended
    Thread.sleep(5000);

    // Define properties to be fetched from server along with the message
    List<String> messageExtraFields = Arrays.asList("X-GM-MSGID", "X-GM-THRID");

    // retreive the message summary information using it's UID
    ImapMessageInfo messageInfoUID = client.listMessage(uid, messageExtraFields);

    // retreive the message summary information using it's sequence number
    ImapMessageInfo messageInfoSeqNum = client.listMessage(1, messageExtraFields);

    // List messages in general from the server based on the defined properties
    ImapMessageInfoCollection messageInfoCol = client.listMessages(messageExtraFields);

    ImapMessageInfo messageInfoFromList = messageInfoCol.get_Item(0);

    // verify that the parameters are fetched in the summary information
    for (String paramName : messageExtraFields) {
        System.out.println(messageInfoFromList.getExtraParameters().containsKey(paramName));
        System.out.println(messageInfoUID.getExtraParameters().containsKey(paramName));
        System.out.println(messageInfoSeqNum.getExtraParameters().containsKey(paramName));
    }
} finally {
    if (client != null)
        client.dispose();
}

دریافت اطلاعات هدر List-Unsubscribe

هدر List-Unsubscribe شامل URL برای لغو اشتراک از لیست‌های ایمیل مانند تبلیغات، خبرنامه‌ها و غیره است. برای دریافت هدر List-Unsubscribe، از listUnsubscribe ویژگی ImapMessageInfo کلاس. مثال زیر نحوه استفاده از آن را نشان می‌دهد listUnsubscribe ویژگی برای دریافت هدر List-Unsubscribe.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapMessageInfoCollection messageInfoCol = imapClient.listMessages();
for (ImapMessageInfo imapMessageInfo : messageInfoCol) {
    System.out.println("ListUnsubscribe Header: " + imapMessageInfo.getListUnsubscribe());
}

Java: کار با پرچم‌های پیام در سرور

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

تغییر پرچم‌های پیام

می‌توانید پرچم‌های پیام را با استفاده از changeMessageFlags() متد. این متد دو پارامتر می‌گیرد.

شماره توالی پیام یا شناسه یکتا.
MessageFlag.

پرچم‌های زیر می‌توانند تنظیم شوند:

تنظیم پرچم‌های پیام

کد نمونه زیر نشان می‌دهد چگونه پرچم‌های پیام را در یک سرور IMAP با Aspose.Email تغییر دهید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Mark the message as read
client.changeMessageFlags(1, ImapMessageFlags.isRead());

حذف پرچم‌های پیام

پرچم‌های پیام همچنین می‌توانند با استفاده از removeMessageFlags() متد. استفاده مشابه آنچه برای changeMessageFlags() متد. این متد یک شماره توالی یا شناسه یکتای پیام را می‌گیرد و MessageFlag. کد نمونه زیر نشان می‌دهد چگونه پرچم‌های پیام را حذف کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Remove the message flag
client.removeMessageFlags(1, ImapMessageFlags.isRead());

تنظیم پرچم‌های سفارشی

همچنین می‌توانید با استفاده از پرچم‌های سفارشی به یک پیام تنظیم کنید ImapClient از API. ImapClient AddMessageFlags قابلیت تنظیم پرچم‌های سفارشی بر روی پیام‌ها را فراهم می‌کند.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create a message
MailMessage message = new MailMessage("user@domain1.com", "user@domain2.com", "subject", "message");

// Append the message to mailbox
String uid = client.appendMessage(ImapFolderInfo.IN_BOX, message);

// Add custom flags to the added messge
client.addMessageFlags(uid, com.aspose.email.ImapMessageFlags.op_BitwiseOr(ImapMessageFlags.keyword("custom1"), ImapMessageFlags.keyword("custom1_0")));

// Retreive the messages for checking the presence of custom flag
client.selectFolder(ImapFolderInfo.IN_BOX);

ImapMessageInfoCollection messageInfos = client.listMessages();
for (ImapMessageInfo inf : messageInfos) {
    ImapMessageFlags[] flags = inf.getFlags().split();

    if (inf.containsKeyword("custom1"))
        System.out.println("Keyword found");
}

Java: کار با پیوست‌های پیام با استفاده از IMAP

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

فهرست کردن پیوست‌های پیام با استفاده از کلاینت IMAP

برای دریافت اطلاعات دربارهٔ پیوست‌ها مانند نام و اندازه بدون بارگیری دادهٔ پیوست، از ویژگی‌های API زیر استفاده کنید:

ImapAttachmentInfo - نمایانگر اطلاعات یک پیوست است.
ImapAttachmentInfoCollection - نمایانگر مجموعه‌ای از ImapAttachmentInfo است.
listAttachments(int sequenceNumber) - اطلاعاتی برای هر پیوست در یک پیام دریافت می‌کند.

نمونه کد زیر نشان می‌دهد چگونه از کلاینت IMAP برای بازیابی اطلاعات دربارهٔ پیام‌های ایمیل و پیوست‌های آنها از سرور استفاده کنید و سپس جزئیات پیوست هر پیام را نمایش دهید. این امکان دسترسی و پردازش پیوست‌های پیام‌های ایمیل با استفاده از پروتکل IMAP را فراهم می‌کند.

ImapMessageInfoCollection messageInfoCollection = imapClient.listMessages();

for (ImapMessageInfo message : messageInfoCollection) {
    ImapAttachmentInfoCollection attachmentInfoCollection =
            imapClient.listAttachments(message.getSequenceNumber());

    for (ImapAttachmentInfo attachmentInfo : attachmentInfoCollection) {
        System.out.println(
                "Attachment: " + attachmentInfo.getName() + " (size: " + attachmentInfo.getSize() + ")");
    }
}

Java: فیلتر کردن پیام‌ها از سرور با استفاده از کلاینت IMAP

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

این ImapClient کلاس فراهم می‌کند listMessages() متد تمام پیام‌های یک صندوق‌پست را دریافت می‌کند. برای دریافت تنها پیام‌هایی که با شرطی مطابقت دارند، از نسخهٔ بارگذاری‌شدهٔ listMessages() متدی که می‌گیرد MailQuery به‌عنوان آرگومان. این MailQuery کلاس ویژگی‌های متنوعی برای تعیین شرایط فراهم می‌کند، برای مثال، تاریخ، موضوع، فرستنده، گیرنده و غیره. مثال اول نشان می‌دهد چگونه پیام‌ها را بر پایهٔ تاریخ و موضوع فیلتر کنیم. همچنین نشان می‌دهیم چطور بر اساس معیارهای دیگر فیلتر کنیم و پرس‌وجوهای پیچیده‌تری بسازیم. API همچنین امکان اعمال معیارهای جستجوی حساس به حروف بزرگ/کوچک برای تطبیق دقیق فیلترها را فراهم می‌کند. API همچنین اجازه مشخص کردن رمزگذاری رشتهٔ جستجو برای فیلتر کردن پیام‌ها از صندوق پست را می‌دهد.

فیلتر کردن پیام‌ها از صندوق‌پست

اتصال و ورود به سرور IMAP
یک نمونه از MailQuery و ویژگی‌ها را تنظیم کنید
متد را فراخوانی کنید ImapClient.listMessages(MailQuery query) متد و پاس دهید MailQuery با پارامترها فقط پیام‌های فیلترشده را دریافت کنید.

کد زیر نشان می‌دهد چگونه به صندوق پست IMAP وصل شویم و پیام‌هایی که امروز رسیده‌اند و کلمه «newsletter» در موضوع دارند، دریافت کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
final String host = "host";
final int port = 143;
final String username = "user@host.com";
final String password = "password";
ImapClient client = new ImapClient(host, port, username, password);
client.selectFolder("Inbox");
// Set conditions, Subject contains "Newsletter", Emails that arrived today
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Newsletter");
builder.getInternalDate().on(new Date());
// Build the query and Get list of messages
MailQuery query = builder.getQuery();
ImapMessageInfoCollection messages = client.listMessages(query);
System.out.println("Imap: " + messages.size() + " message(s) found.");
// Disconnect from IMAP
client.dispose();

دریافت پیام‌هایی که معیارهای خاص را برآورده می‌کنند

نمونه‌های کد فوق فیلتر پیام‌ها بر پایهٔ موضوع ایمیل و تاریخ. می‌توانیم از ویژگی‌های دیگر برای تنظیم شرایط پشتیبانی‌شده نیز استفاده کنیم. در زیر برخی مثال‌های تنظیم شرایط با استفاده از 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());
~~
### **Date Range*
The following code snippet shows you how to filter emails on the date range.

~~~Java
// 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 cal = Calendar.getInstance();
builder.getInternalDate().before(cal.getTime());
cal.add(Calendar.DATE, -7);
builder.getInternalDate().since(cal.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 cal = Calendar.getInstance();
builder.getInternalDate().before(cal.getTime());
cal.add(Calendar.DATE, -7);
builder.getInternalDate().since(cal.getTime());

ترکیب پرس‌وجوها با OR

MailQueryBuilder ارائه می‌دهد or() متد که دو 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"));

فیلتر کردن بر پایه InternalDate

پیام‌ها می‌توانند بر پایه InternalDate از سرور استخراج شوند، اما گاهی سرور تمام پیام‌ها را همان‌طور که در صندوق ورودی دیده می‌شوند بر نمی‌گرداند. دلیل آن می‌تواند منطقه زمانی سرور باشد چون ممکن است برای همه سرورها مثل جیمیل. Aspose دستورات مانند 008 SEARCH ON 4-May-2014 را بر اساس پروتکل IMAP اما نتیجه ممکن است به دلیل تنظیمات منطقه زمانی سرور متفاوت باشد. یک عضو جدید در ImapMessageInfo به عنوان InternalDate که به فیلتر کردن پیام‌ها کمک بیشتری می‌کند. کد زیر استفاده از InternalDate برای فیلتر کردن پیام‌ها.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
final String host = "host";
final int port = 143;
final String username = "user@host.com";
final String password = "password";
ImapClient client = new ImapClient(host, port, username, password);
client.selectFolder("Inbox");

// Set conditions, Subject contains "Newsletter", Emails that arrived today
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Newsletter");
builder.getInternalDate().on(new Date());

// Build the query and Get list of messages
MailQuery query = builder.getQuery();
ImapMessageInfoCollection messages = client.listMessages(query);
for (ImapMessageInfo info : messages) {
    System.out.println("Internal Date: " + info.getInternalDate());
}

// Disconnect from IMAP
client.dispose();

فیلتر ایمیل‌های حساس به حروف بزرگ/کوچک

کد زیر نشان می‌دهد چگونه از فیلتر ایمیل‌های حساس به حروف بزرگ و کوچک استفاده کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set conditions, Subject contains "Newsletter", Emails that arrived today
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Newsletter", true);
builder.getInternalDate().on(new Date());
MailQuery query = builder.getQuery();

مشخص کردن رمزگذاری برای سازندهٔ پرس‌وجو

API‌های ImapQueryBuilder سازنده می‌تواند برای تعیین رمزگذاری رشتهٔ جستجو استفاده شود. این کار همچنین می‌تواند با استفاده از DefaultEncoding ویژگی MailQueryBuilder. کد زیر نشان می‌دهد چگونه رمزگذاری را برای سازندهٔ پرس‌وجو مشخص کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set conditions
ImapQueryBuilder builder = new ImapQueryBuilder(Charset.forName("utf-8"));
builder.getSubject().contains("ğüşıöç", true);
MailQuery query = builder.getQuery();

فیلتر کردن پیام‌ها با پشتیبانی از صفحه‌بندی

این ImapClient قابلیت جستجوی پیام‌ها از صندوق پست و فهرست‌کردن آن‌ها با پشتیبانی از صفحه‌بندی را فراهم می‌کند. کد زیر نشان می‌دهد چگونه پیام‌ها را با پشتیبانی از صفحه‌بندی فیلتر کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
/// <summary>
/// This example shows how to search for messages using ImapClient of the API with paging support
/// Introduced in Aspose.Email for .NET 6.4.0
/// </summary>
final ImapClient client = new ImapClient("host.domain.com", 84, "username", "password");
try {
    try {
        // Append some test messages
        int messagesNum = 12;
        int itemsPerPage = 5;
        MailMessage message = null;
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35128 - " + UUID.randomUUID(), "111111111111111");
            client.appendMessage(ImapFolderInfo.IN_BOX, message);
        }
        String body = "2222222222222";
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35128 - " + UUID.randomUUID(), body);
            client.appendMessage(ImapFolderInfo.IN_BOX, message);
        }

        client.selectFolder("Inbox");
        ImapQueryBuilder iqb = new ImapQueryBuilder();
        iqb.getBody().contains(body);
        MailQuery query = iqb.getQuery();

        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection totalMessageInfoCol = client.listMessages(query);
        System.out.println(totalMessageInfoCol.size());

        //////////////////////////////////////////////////////

        List<ImapPageInfo> pages = new ArrayList<ImapPageInfo>();

        PageSettings ps = new PageSettings();
        ps.setFolderName(ImapFolderInfo.IN_BOX);
        PageInfo pi = new PageInfo(itemsPerPage);
        ImapPageInfo pageInfo = client.listMessagesByPage(query, pi, ps);

        pages.add(pageInfo);
        while (!pageInfo.getLastPage()) {
            pageInfo = client.listMessagesByPage(query, pageInfo.getNextPage(), ps);
            pages.add(pageInfo);
        }
        int retrievedItems = 0;
        // foreach to while statements conversion
        for (ImapPageInfo folderCol : pages) {
            retrievedItems += folderCol.getItems().size();
        }
    } finally {
    }
} finally {
    if (client != null)
        client.dispose();
}

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapQueryBuilder queryBuilder = new ImapQueryBuilder();

queryBuilder.hasFlags(ImapMessageFlags.keyword("custom1"));

queryBuilder.hasNoFlags(ImapMessageFlags.keyword("custom2"));

فیلتر کردن پیام‌ها با استفاده از جستجوی سفارشی

به عنوان مثال، استاندارد RFC 3501 اجازه جستجوی پیام بر پایه وجود پیوست‌ها را نمی‌دهد. ولی Gmail ارائه می‌دهد افزونه‌های IMAP که امکان انجام چنین جستجویی را فراهم می‌کند. Aspose.Email ارائه می‌دهد customSearch متد از ImapQueryBuilder کلاسی برای ساخت پرس‌وجوی متناظر.

نمونه کد زیر نشان می‌دهد چگونه فهرستی از پیام‌های ایمیل حاوی پیوست را از سرور با استفاده از پروتکل IMAP و معیار جستجوی سفارشی بازیابی کنیم:

ImapQueryBuilder builder = new ImapQueryBuilder();
builder.customSearch("X-GM-RAW \"has:attachment\"");
MailQuery query = builder.getQuery();
messageInfoCol = client.listMessages(query);

Java: حذف پیام‌ها از سرور

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

حذف پیام‌ها

این ImapClient کلاس می‌تواند پیام‌ها را از یک سرور IMAP حذف کند. ImapClient کلاس deleteMessage() تابعی که برای حذف پیام‌ها استفاده می‌شود. این تابع شماره توالی پیام یا شناسه یکتا را به‌عنوان پارامتر می‌گیرد. ImapClient فراهم می‌کند deleteMessage و deleteMessages روش‌هایی برای حذف پیام‌ها به‌صورت تک‌تک یا به‌صورت چندگانه. کد نمونه زیر نشان می‌دهد چطور یک پیام ایمیل با شناسه پیام ۱ را از یک سرور IMAP حذف کنید.

try (ImapClient client = new ImapClient("host", "username", "password")) {
    client.setSecurityOptions(SecurityOptions.SSLImplicit);

    // Append test message
    client.selectFolder(ImapFolderInfo.IN_BOX);

    MailMessage eml = new MailMessage("from@from.com", "to@to.com");
    eml.setSubject("Message to delete");
    eml.setBody("Hey! This Message will be deleted!");
    String emlId = client.appendMessage(eml);

    // Delete appended message
    client.deleteMessage(emlId);
    client.commitDeletes();
}

حذف چندین پیام

ایمیل‌های متعدد می‌توانند با استفاده از ImapClient از API Aspose.Email. deleteMessages متد گزینه‌های متعددی برای حذف چندین پیام از سرور با استفاده از شناسه‌های یکتا، شماره‌های توالی یا ImapMessageInfoCollection عناصر. کد نمونه زیر نشان می‌دهد چگونه چندین پیام را حذف کنید.

try (ImapClient client = new ImapClient("host", "username", "password")) {
    client.selectFolder(ImapFolderInfo.IN_BOX);

    // Append test messages
    List<MailMessage> emlList = new ArrayList<>();
    for (int i = 0; i < 3; i++) {
        MailMessage eml = new MailMessage("from@from.com", "to@to.com");
        eml.setSubject("Message to delete " + i);
        eml.setBody("Hey! This Message will be deleted!");

        emlList.add(eml);
    }

    AppendMessagesResult appendMessagesResult = client.appendMessages(emlList);
    List<String> uidList = new ArrayList<>();
    for (String uid : appendMessagesResult.getSucceeded().getValues()) {
        uidList.add(uid);
    }

    // Bulk Delete appended Messages
    client.deleteMessagesByUids(uidList, true);
    client.commitDeletes();
}

Java: کار با پوشه‌ها در سرور IMAP

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

دریافت اطلاعات پوشه‌ها

دریافت اطلاعات دربارهٔ پوشه‌ها از یک سرور IMAP با Aspose.Email بسیار آسان است. فراخوانی کنید listFolders() متد از ImapClient کلاس. یک شیء از ImapFolderInfoCollection نوع. در این مجموعه تکرار کنید و اطلاعات دربارهٔ هر پوشه را در یک حلقه دریافت کنید. این متد بارگذاری شده است. می‌توانید نام پوشه‌ای را به‌عنوان پارامتر پاس کنید تا فهرست زیرپوشه‌ها را دریافت کنید. کد زیر نشان می‌دهد چگونه اطلاعات پوشه را از یک سرور IMAP با استفاده از متد Aspose.Email توضیح داده‌شده دریافت کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get all folders in the currently subscribed folder
ImapFolderInfoCollection folderInfoColl = client.listFolders();

// Iterate through the collection to get folder info one by one
for (ImapFolderInfo folderInfo : (Iterable<ImapFolderInfo>) folderInfoColl) {
    // Folder name and get New messages in the folder
    System.out.println("Folder name is " + folderInfo.getName());
    ImapFolderInfo folderExtInfo = client.getFolderInfo(folderInfo.getName());
    System.out.println("New message count: " + folderExtInfo.getNewMessageCount());
    System.out.println("Is it readonly? " + folderExtInfo.getReadOnly());
    System.out.println("Total number of messages " + folderExtInfo.getTotalMessageCount());
}

حذف و تغییر نام پوشه‌ها

یک پوشه در سرور IMAP می‌تواند با یک خط و با Aspose.Email حذف یا تغییر نام داده شود:

این deleteFolder() متد نام پوشه را به‌عنوان پارامتر می‌پذیرد.
برای renameFolder() متد، باید نام پوشهٔ فعلی و نام پوشهٔ جدید را پاس کنید. کد زیر نشان می‌دهد چگونه یک پوشه را از سرور IMAP حذف کنید و چگونه یک پوشه را تغییر نام دهید. هر عملیات با یک خط کد انجام می‌شود.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Delete a folder and Rename a folder
client.deleteFolder("foldername");
client.renameFolder("foldername", "newfoldername");

اضافه کردن پیام جدید در یک پوشه

می‌توانید یک پیام جدید را به پوشه با استفاده از MailMessage و ImapClient کلاس‌ها. ابتدا یک MailMessage شیء با ارائه مقادیر موضوع، دریافت‌کننده و فرستنده. سپس به یک پوشه مشترک شوید و پیام را به آن اضافه کنید. کد زیر نشان می‌دهد چگونه یک پیام جدید به یک پوشه اضافه کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create a message
MailMessage msg = new MailMessage("user@domain1.com", "user@domain2.com", "subject", "message");

// Subscribe to the Inbox folder and Append the newly created message
client.selectFolder(ImapFolderInfo.IN_BOX);
client.subscribeFolder(client.getCurrentFolder().getName());
client.appendMessage(client.getCurrentFolder().getName(), msg);

اضافه کردن چندین پیام با پشتیبانی از MultiConnection

می‌توانید چندین پیام را با استفاده از appendMessages متد ارائه‌شده توسط ImapClient کلاس. appendMessages متد لیستی از MailMessage و اگر پوشه به‌عنوان پارامتر ارائه نشود، به پوشهٔ جاری اضافه می‌کند. ImapClient همچنین حالت MultiConnection را برای عملیات سنگین پشتیبانی می‌کند. کد زیر نشان می‌دهد چگونه با استفاده از حالت MultiConnection چندین پیام را اضافه کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

List<MailMessage> messages = new ArrayList<MailMessage>();
for (int i = 0; i < 20; i++) {
    MailMessage message = new MailMessage("<EMAIL ADDRESS>", "<EMAIL ADDRESS>", "Test Message - " + UUID.randomUUID().toString(), "IMAP Group Append with MultiConnection");
    messages.add(message);
}

imapClient.setConnectionsQuantity(5);
imapClient.setUseMultiConnection(MultiConnectionMode.Enable);
imapClient.appendMessages(messages);

لطفاً توجه داشته باشید که استفاده از حالت چنداتصال تضمین‌کننده‌ی افزایش عملکرد نیست.

جابجایی پیام‌ها به پوشهٔ دیگر صندوق‌پست

Aspose.Email برای Java امکان جابجایی یک پیام از یک پوشه صندوق‌پست به پوشهٔ دیگر را با استفاده از ImapClient API. این moveMessage متد از شناسهٔ یکتا پیام و نام پوشهٔ مقصد برای جابجایی پیام به پوشه هدف استفاده می‌کند. قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را به پوشهٔ دیگری از صندوق‌پست منتقل کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// This example shows how to move a message from one folder of a mailbox to another one using the ImapClient API of Aspose.Email for Java
// Available from Aspose.Email for Java onwards
// -------------- Available API Overload Members --------------
// void ImapClient.moveMessage(IConnection iConnection, int sequenceNumber, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(IConnection iConnection, String uniqueId, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(int sequenceNumber, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(String uniqueId, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(IConnection iConnection, int sequenceNumber, String folderName)
// void ImapClient.moveMessage(IConnection iConnection, String uniqueId, String folderName)
// void ImapClient.moveMessage(int sequenceNumber, String folderName)
// void ImapClient.moveMessage(String uniqueId, String folderName)

final ImapClient client = new ImapClient("host.domain.com", 993, "username", "password");
try {
    String folderName = "EMAILNET-35151";
    if (!client.existFolder(folderName))
        client.createFolder(folderName);
    try {
        MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35151 - " + UUID.randomUUID(),
                "EMAILNET-35151 ImapClient: Provide option to Move Message");
        client.selectFolder(ImapFolderInfo.IN_BOX);
        // Append the new message to Inbox folder
        String uniqueId = client.appendMessage(ImapFolderInfo.IN_BOX, message);
        ImapMessageInfoCollection messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
        // Now move the message to the folder EMAILNET-35151
        client.moveMessage(uniqueId, folderName);
        client.commitDeletes();
        // Verify that the message was moved to the new folder
        client.selectFolder(folderName);
        messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
        // Verify that the message was moved from the Inbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
    } finally {
        try {
            client.deleteFolder(folderName);
        } catch (java.lang.RuntimeException e) {
        }
    }
} finally {
    if (client != null)
        client.dispose();
}

کپی پیام‌ها به پوشه دیگر صندوق‌پست

API Aspose.Email قابلیت کپی کردن یک پیام از یک پوشهٔ صندوق‌پست به پوشهٔ دیگری را فراهم می‌کند. این امکان را می‌دهد که یک پیام یا چندین پیام را با استفاده از copyMessage و copyMessages متدها. copyMessages متد قابلیت کپی کردن چندین پیام از پوشه منبع یک صندوق‌پست به پوشه مقصد را فراهم می‌کند. کد زیر نشان می‌دهد چگونه پیام‌ها را به یک پوشهٔ دیگر کپی کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("exchange.aspose.com", "username", "password");
try {
    // Create the destination folder
    String folderName = "EMAILNET-35242";
    if (!client.existFolder(folderName))
        client.createFolder(folderName);
    try {
        // Append a couple of messages to the server
        MailMessage message1 = new MailMessage("asposeemail.test3@aspose.com", "asposeemail.test3@aspose.com", "EMAILNET-35242 - " + UUID.randomUUID(),
                "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        String uniqueId1 = client.appendMessage(message1);

        MailMessage message2 = new MailMessage("asposeemail.test3@aspose.com", "asposeemail.test3@aspose.com", "EMAILNET-35242 - " + UUID.randomUUID(),
                "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        String uniqueId2 = client.appendMessage(message2);

        // Verify that the messages have been added to the mailbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection msgsColl = client.listMessages();
        for (ImapMessageInfo msgInfo : msgsColl)
            System.out.println(msgInfo.getSubject());

        // Copy multiple messages using the CopyMessages command and Verify that messages are copied to the destination folder
        client.copyMessagesByUids(Arrays.asList(uniqueId1, uniqueId2), folderName);

        client.selectFolder(folderName);
        msgsColl = client.listMessages();
        for (ImapMessageInfo msgInfo : msgsColl)
            System.out.println(msgInfo.getSubject());
    } finally {
        try {
            client.deleteFolder(folderName);
        } catch (java.lang.RuntimeException e) {
        }
    }
} finally {
    if (client != null)
        client.dispose();
}

کار با پوشه‌های صندوق‌پست استفاده ویژه

برخی از ذخیره‌سازی‌های پیام IMAP شامل صندوق‌پست‌های استفاده ویژه هستند، مانند صندوق‌های ذخیره پیش‌نویس یا پیام‌های ارسال‌شده. بسیاری از کلاینت‌های ایمیل به کاربران اجازه می‌دهند مکان پیش‌نویس یا پیام‌های ارسال‌شده را تعیین کنند، اما پیکربندی آن‌ها نیاز دارد که کاربر بداند کدام صندوق‌پست‌ها توسط سرور برای این موارد اختصاص یافته‌اند. Aspose.Email می‌تواند این صندوق‌پست‌های استفاده ویژه را با استفاده از ImapMailboxInfo کلاس برای آسان‌تر کار کردن با آن‌ها. نمونه کد زیر نشان می‌دهد چگونه با استفاده از ImapMailboxInfo کلاس.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();
System.out.println(mailboxInfo.getInbox());
System.out.println(mailboxInfo.getDraftMessages());
System.out.println(mailboxInfo.getJunkMessages());
System.out.println(mailboxInfo.getSentMessages());
System.out.println(mailboxInfo.getTrash());

Java: کار با ImapClient به صورت ناهمزمان

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

پیام‌ها می‌توانند به صورت ناهمزمان از صندوق پست با استفاده از Aspose.Email بازیابی شوند ImapClient. این مقاله بازیابی پیام‌ها از صندوق پست به صورت ناهمزمان را نشان می‌دهد. همچنین چگونگی فهرست کردن پیام‌ها با ارائه معیارهای جستجو با استفاده از MailQuery.

بازیابی پیام‌ها به صورت ناهمزمان

کد زیر نشان می‌دهد چگونه پیام‌ها را به صورت ناهمزمان بازیابی کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
try (ImapClient client = new ImapClient("host", "username", "password")) {
    client.selectFolder("Issues/SubFolder");
    ImapMessageInfoCollection messages = client.listMessages();
    IAsyncResult ar = client.beginFetchMessage(messages.get_Item(0).getSequenceNumber());
    MailMessage message = client.endFetchMessage(ar);
}

فهرست‌کردن پیام‌ها به‌صورت ناهمزمان با MailQuery

این MailQuery کلاسی که می‌توان برای تعیین معیارهای جستجو برای بازیابی یک فهرست مشخص از پیام‌ها به صورت ناهمزمان استفاده کرد، همان‌طور که در نمونه کد زیر نشان داده شده است.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Subject");
MailQuery query = builder.getQuery();
IAsyncResult asyncResult = client.beginListMessages(query);
ImapMessageInfoCollection messages = client.endListMessages(asyncResult);

Java: فهرست‌برداری افزونه‌های سرور IMAP

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

Aspose.Email ImapClient به شما اجازه می‌دهد افزونه‌های سروری که پشتیبانی می‌کند مانند IDLE، UNSELECT، QUOTA و غیره را دریافت کنید. این به شناسایی در دسترس بودن یک افزونه قبل از استفاده از کلاینت برای آن عملکرد خاص کمک می‌کند. getCapabilities() متد انواع افزونه‌های پشتیبانی‌شده را به‌صورت یک آرایهٔ رشته‌ای برمی‌گرداند. کد زیر نشان می‌دهد چگونه افزونه‌ها را بازیابی کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
ImapClient client = new ImapClient("imap.gmail.com", "username", "password");
String[] getCapabilities = client.getCapabilities();
for (String getCap : getCapabilities) {
    System.out.println(getCap);
}

Java: پشتیبانی از فرمان IMAP IDLE

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

API Aspose.Email ImapClient قابلیت برقراری اتصال به سرور و انتظار برای رسیدن یک پیام ایمیل را فراهم می‌کند. این امکان از پرس‌و‌جو مکرر سرور برای ایمیل‌های ورودی جلوگیری می‌کند. کد زیر نشان می‌دهد چگونه از فرمان IMAP Idle پشتیبانی شود.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
ImapClient client = new ImapClient("imap.domain.com", "username", "password");

client.startMonitoring(new ImapMonitoringEventHandler() {
    public void invoke(Object sender, ImapMonitoringEventArgs e) {
        System.out.println(e.getNewMessages().length);
        System.out.println(e.getDeletedMessages().length);
    }
});
client.stopMonitoring("Inbox");

Java: پشتیبانی از فرمان IMAP IDLE و افزونه‌ها

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

پشتیبانی از فرمان IMAP Idle

Aspose.Email API ImapClient قابلیت برقراری اتصال به سرور و انتظار برای رسیدن یک پیام ایمیل را فراهم می‌کند. این امکان از پرس‌و‌جو مکرر سرور برای ایمیل‌های ورودی جلوگیری می‌کند. کد زیر نشان می‌دهد چگونه از فرمان IMAP Idle پشتیبانی شود.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
ImapClient client = new ImapClient("imap.domain.com", "username", "password");

client.startMonitoring(new ImapMonitoringEventHandler() {
    public void invoke(Object sender, ImapMonitoringEventArgs e) {
        System.out.println(e.getNewMessages().length);
        System.out.println(e.getDeletedMessages().length);
    }
});
client.stopMonitoring("Inbox");

پشتیبانی از افزونه‌های IMAP

API Aspose.Email پشتیبانی از افزونه‌های IMAP را فراهم می‌کند. افزونه‌های IMAP زیر در حال حاضر توسط API پشتیبانی می‌شوند. این افزونه‌ها توسط همهٔ سرورها پشتیبانی نمی‌شوند.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password");
try {
    // Set SecurityOptions
    client.setSecurityOptions(SecurityOptions.Auto);
    System.out.println(client.getIdSupported());

    ImapIdentificationInfo serverIdentificationInfo1 = client.introduceClient();
    ImapIdentificationInfo serverIdentificationInfo2 = client.introduceClient(ImapIdentificationInfo.getDefaultValue());

    // Display ImapIdentificationInfo properties
    System.out.println(serverIdentificationInfo1.toString() + serverIdentificationInfo2.toString());
    System.out.println(serverIdentificationInfo1.getName());
    System.out.println(serverIdentificationInfo1.getVendor());
    System.out.println(serverIdentificationInfo1.getSupportUrl());
    System.out.println(serverIdentificationInfo1.getVersion());
} finally {
    if (client != null)
        client.dispose();
}

فرمان لیست گسترش‌یافته IMAP4

قطعه کد زیر نشان می‌دهد چگونه از فرمان لیست گسترش‌یافتهٔ IMAP4 استفاده کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password");
try {
    ImapFolderInfoCollection folderInfoCol = client.listFolders("*");
    System.out.println("Extended List Supported: " + client.getExtendedListSupported());
    for (ImapFolderInfo folderInfo : (Iterable<ImapFolderInfo>) folderInfoCol) {
        if (folderInfo.getName().equals("[Gmail]/All Mail"))
            System.out.println("Has Children: " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Bin"))
            System.out.println("Bin has children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Drafts"))
            System.out.println("Drafts has children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Important"))
            System.out.println("Important has Children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Sent Mail"))
            System.out.println("Sent Mail has Children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Spam"))
            System.out.println("Spam has Children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Starred"))
            System.out.println("Starred has Children? " + folderInfo.hasChildren());
    }
} finally {
    if (client != null)
        client.dispose();
}

Java: عملیات پشتیبان‌گیری و بازیابی IMAP

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

Aspose.Email برای Java قابلیت پشتیبان‌گیری و بازیابی پیام‌ها را فراهم می‌کند. برای این منظور، API روش‌های زیر را ارائه می‌دهد.

این مقاله نشان می‌دهد چگونه پیام‌ها را با استفاده از ImapClient کلاس.

پشتیبان‌گیری از پیام‌ها

برای پشتیبان‌گیری از پیام‌ها، از ImapClient.backup متد همان‌طور که در قطعه کد زیر نشان داده شده است.

// 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 = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();

ImapFolderInfo info = imapClient.getFolderInfo(mailboxInfo.getInbox().getName());
ImapFolderInfoCollection infos = new ImapFolderInfoCollection();
infos.addItem(info);

imapClient.backup(infos, dataDir + "\\ImapBackup.pst", com.aspose.email.BackupSettings.to_BackupSettings(BackupOptions.Recursive));

بازیابی پیام‌ها

برای پشتیبان‌گیری از پیام‌ها، از ImapClient.restore متد همان‌طور که در قطعه کد زیر نشان داده شده است.

// 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 = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

ImapRestoreSettings settings = new ImapRestoreSettings();
settings.setRecursive(true);
PersonalStorage pst = PersonalStorage.fromFile(dataDir + "\\ImapBackup.pst");
imapClient.restore(pst, settings);

عملیات پشتیبان‌گیری و بازیابی IMAP با MultiConnection

هنگامی که با تعداد زیادی پیام کار می‌کنید، عملیات پشتیبان‌گیری/بازیابی ممکن است زمان‌بر باشد. برای این منظور، API پشتیبانی از چندین اتصال را در طول عملیات پشتیبان‌گیری و بازیابی فراهم می‌کند. برای فعال‌سازی حالت MultiConnection، مقدار را تنظیم کنید ImapClient.UseMultiConnection ویژگی برای MultiConnectionMode.Enable. قطعه‌های کد زیر عملیات پشتیبان‌گیری و بازیابی را با حالت MultiConnection فعال شده نشان می‌دهند.

پشتیبان‌گیری از پیام‌ها با MultiConnection

قطعه‌های کد زیر عملیات پشتیبان‌گیری را با حالت MultiConnection فعال شده نشان می‌دهند.

// 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 = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

imapClient.setUseMultiConnection(MultiConnectionMode.Enable);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();

ImapFolderInfo info = imapClient.getFolderInfo(mailboxInfo.getInbox().getName());
ImapFolderInfoCollection infos = new ImapFolderInfoCollection();
infos.addItem(info);

imapClient.backup(infos, dataDir + "\\ImapBackup.pst", com.aspose.email.BackupSettings.to_BackupSettings(BackupOptions.Recursive));

بازیابی پیام‌ها با MultiConnection

قطعه‌های کد زیر عملیات بازیابی را با حالت MultiConnection فعال شده نشان می‌دهند.

// 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 = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

imapClient.setUseMultiConnection(MultiConnectionMode.Enable);

ImapRestoreSettings settings = new ImapRestoreSettings();
settings.setRecursive(true);
PersonalStorage pst = PersonalStorage.fromFile(dataDir + "\\Outlook.pst");
imapClient.restore(pst, settings);