معرفی و برنامه‌های نمونه

سناریوهای استفاده از Aspose.Email Mail

این مقاله چندین استفاده ممکن از Aspose.Email برای جاوا را پیشنهاد می‌کند و به‌ویژه بر ویژگی‌های برنامه‌نویسی ایمیل این مؤلفه تمرکز دارد.

نرم‌افزار خبرنامه

API Aspose.Email Mail می‌تواند برای ایجاد یک برنامه خبرنامه قوی استفاده شود. با استفاده از پشتیبانی Aspose.Email برای افزودن اشیای جاسازی‌شده (مانند تصویرها، صداها و غیره) می‌توان خبرنامه‌های HTML غنی با تصاویر (و دیگر اشیای جاسازی‌شده) ساخت. با استفاده از ویژگی ایمیل انبوه در API Aspose.Email Mail، امکان ارسال ایمیل‌های انبوه عظیم در بازه زمانی محدود نیز وجود دارد. Aspose.Email Mail همچنین ویژگی ادغام ایمیل مبتنی بر قالب را فراهم می‌کند که می‌تواند برای ایجاد قالب خبرنامه استفاده شود. این قالب می‌تواند برای انجام ادغام ایمیل جهت ارسال خبرنامه انبوه به کار رود. وظایف دیگر بسیاری نیز وجود دارد که Aspose.Email Mail می‌تواند در یک برنامه بازاریابی ایمیلی انجام دهد.

ابزارهای دیگر بازاریابی

مشابه برنامه‌های خبرنامه، انواع دیگری از نرم‌افزارها می‌توانند با استفاده از Aspose.Email Mail ساخته شوند. از آن برای ساخت بازاریابی ایمیلی، ایمیل‌ارسالی انبوه و کمپین‌های الکترونیکی و موارد دیگر استفاده کنید.

برنامه‌های تجاری

Aspose.Email Mail می‌تواند در تقریباً تمام انواع برنامه‌های تجاری برای انجام وظایف کمکی استفاده شود:

  • هشدارهای ایمیلی: هشدارهای ایمیلی را برای اطلاع‌رسانی به کاربران درباره فعالیت‌ها ارسال کنید.
  • درخواست‌های جلسه: درخواست‌های جلسات تجاری را با استفاده از پشتیبانی iCalendar در Aspose.Email Mail ارسال کنید.
  • گزارش‌های برنامه‌ریزی‌شده ایمیلی: گزارش‌ها جزء اساسی اکثر برنامه‌های تجاری هستند. بسیاری از گزارش‌های تجاری به‌صورت دوره‌ای تولید می‌شوند. از Aspose.Email Mail برای ایمیل‌ کردن گزارش‌های برنامه‌ریزی‌شده استفاده کنید.

کلاینت‌های ایمیل

Aspose.Email Mail می‌تواند در کلاینت‌های ایمیل برای ارسال ایمیل‌های معمولی نیز استفاده شود. این کتابخانه از پیوست‌ها، اشیای جاسازی‌شده، رویدادهای iCalendar، ادغام ایمیل، ارسال ایمیل‌های انبوه و غیره پشتیبانی می‌کند، بنابراین Aspose.Email Mail بهترین گزینه برای ایجاد برنامه‌های کلاینت ایمیل است.

Aspose.Email Mail برنامه نمونه

برای نشان دادن نحوه استفاده از Aspose.Email Mail، یک برنامه ایجاد خواهیم کرد که نحوه ساخت یک پیام ایمیل را با استفاده از کلاس MailMessage و سپس آن را با استفاده از کلاس SmtpClient ارسال کنید.

Mail : مراحل برنامه نمونه

لطفاً مراحل زیر را برای ایجاد برنامه با استفاده از Aspose.Email دنبال کنید.

  1. برنامه خود را طراحی کنید: یک رابط کاربری ایجاد کنید که سه فیلد From، To و Message را دریافت کند.
  2. دوبار کلیک کنید روی دکمه Send در نمای طرح و کد خود را در ویرایشگر بنویسید.
  3. یک نمونه از کلاس MailMessage ایجاد کنید و از ویژگی‌های آن برای ساختن یک پیام ایمیل استفاده کنید. (نمونه‌های کلاس MailMessage برای ساختن پیام‌های ایمیلی استفاده می‌شوند که برای تحویل به سرور SMTP از طریق کلاس SmtpClient ارسال می‌شوند).
  4. یک نمونه از کلاس SmtpClient ایجاد کنید و از ویژگی‌های آن برای ارسال یک پیام ایمیل استفاده کنید.
  5. برنامه خود را تست کنید.
  6. آدرس‌ها را در فیلدهای From و To وارد کنید.
  7. یک پیام را در فیلد Message Body تایپ کنید.
  8. Send را کلیک کنید.

مراحل فوق در زیر توضیح داده شده‌اند؛ دابل‌کلیک کنید روی دکمه Send در نمای طرح و کد زیر را اضافه کنید:

// Declare message as MailMessage instance
MailMessage message = new MailMessage();
// Specify From, To, Subject and Body
message.setFrom(new MailAddress("#From"));
message.setTo(MailAddressCollection.to_MailAddressCollection("#To"));
message.setSubject("#Subject");
message.setBody("#Body");

// Send email using SmtpClient, Create an instance of the SmtpClient Class and Specify the mailing host server, Username, Password and Port
SmtpClient client = new SmtpClient();

// Specify the mailing host server, Username, Password and Port
client.setHost("mail.server.com");
client.setUsername("username");
client.setPassword("password");
client.setPort(25);
client.send(message);

// Notify the user that a message has been sent
System.out.println("Message Sent");

هنگام اتصال به سروری که SSL فعال است، باید ویژگی‌های شیء SMTPClient زیر را تنظیم کنیم

// Set the port to 587. This is the SSL port of Gmail SMTP server, set the security mode to explicit
client.setPort(587);
client.setSecurityOptions(SecurityOptions.SSLExplicit);

نتیجه‌گیری

Aspose.Email Mail یک مؤلفه بسیار قدرتمند است که به توسعه‌دهندگان امکان انجام تقریباً تمام وظایف ایمیلی را می‌دهد، از جمله ارسال ایمیل‌های انبوه چندنخی، استفاده از ادغام ایمیل (mail merge)، افزودن پیوست‌ها، جاسازی تصاویر و صداها در پیام‌های ایمیل، افزودن رویدادهای iCalendar به ایمیل‌ها، دریافت ایمیل‌ها و موارد بیشتر.

Aspose.Email Pop3

Aspose.Email Pop3 پروتکل پست الکترونیک نسخه 3 (POP3) را بر روی جاوا پیاده‌سازی می‌کند. این امکان را به توسعه‌دهندگان جاوا می‌دهد تا ویژگی‌های جستجو و دریافت ایمیل را به برنامه‌های جاوای خود اضافه کنند بدون آن‌که به جزئیات پروتکل و پیچیدگی برنامه‌نویسی ایمیل و شبکه دخالت کنند. Aspose.Email Pop3 از تمام دستورات تعریف‌شده در پروتکل استاندارد POP3 پشتیبانی می‌کند و رابط‌های کاربرپسند همراه با یک مدل شیء فشرده و شهودی ارائه می‌دهد. این کتابخانه به‌طور قابل توجهی منحنی یادگیری معمول برای توسعه‌دهندگان جاوا را کاهش می‌دهد.

Pop3 : ویژگی‌های اصلی

به عنوان بخشی از Aspose.Email، Aspose.Email Pop3 به‌طور خاص برای جاوا طراحی شده و با کد جاوا مدیریت‌شده نوشته شده است. این به شما امکان می‌دهد:

  • اتصال و ورود به سرورهای POP3.
  • پشتیبانی از APOP.
  • پرس و جوی پیام‌ها.
  • دریافت پیام‌ها.
  • پشتیبانی کامل از سبک برنامه‌نویسی Async.
  • پشتیبانی از SSL.

سناریوهای Aspose.Email Pop3

Aspose.Email Pop3 می‌تواند توسط توسعه‌دهندگان در سناریوهای مختلف استفاده شود. در اینجا دو نمونه را به‌اشتراک می‌گذاریم.

خودکارسازی ایمیل تجاری

Aspose.Email Pop3 می‌تواند برای جستجو در صندوق‌های ورودی ایمیل و دریافت پیام‌های ایمیل استفاده شود. این کتابخانه به‌خوبی با مؤلفه ارسال ایمیل، Aspose.Email Mail، کار می‌کند. Aspose.Email به طور کامل از خودکارسازی ایمیل پشتیبانی می‌کند. پیام‌های ایمیل را با Aspose.Email Mail ارسال کنید و پیام‌ها را با Aspose.Email Pop3 دریافت کنید. پیام‌های ایمیل دانلود شده می‌توانند توسط Aspose.Email Mime تجزیه شوند.

کلاینت‌های ایمیل

Aspose.Email Pop3 می‌تواند در برنامه‌های کلاینت ایمیل برای دریافت ایمیل‌ها استفاده شود.

Pop3 : برنامه نمونه

در اینجا نحوه استفاده را نشان خواهیم داد Aspose.Email Pop3. این کلاس ویژگی‌های متعددی دارد اما ما تمرکز می‌کنیم بر نحوه اتصال به سرور POP3 و دریافت پیام‌ها. مثال نشان می‌دهد چگونه یک برنامه ایجاد شود و همچنین نمونه‌های کدی که برنامه را به کار می‌اندازند. مراحل زیر را برای ایجاد یک برنامه نمونه با استفاده از Aspose.Email Pop3 دنبال کنید.

  1. یک نمونه از Pop3Client ایجاد کنید.
  2. نام میزبان POP3، نام کاربری و رمز عبور را در این نمونه تنظیم کنید.
  3. یک نمونه MailMessage ایجاد کنید و اولین ایمیل حساب کاربری خود را با فراخوانی تابع fetchMessage() به آن دریافت کنید. این کار اولین پیام را از حساب ایمیل شما به نمونه MailMessage منتقل می‌کند.
  4. از ویژگی‌های From، Subject و HtmlBody نمونه MailMessage استفاده کنید تا فرستنده، موضوع و محتوای پیام را ببینید.

مراحل فوق در مثال‌های کد زیر نمایش داده شده است.

// Create a POP3 client
Pop3Client client = new Pop3Client();

// Basic settings (required)
client.setHost("pop3.youdomain.com");
client.setUsername("username");
client.setPassword("psw");

try {
    // Retrieve first message in MailMessage format directly
    MailMessage msg;
    msg = client.fetchMessage(1);
    System.out.println(msg.getFrom().toString());
    System.out.println(msg.getSubject());
    System.out.println(msg.getHtmlBody());
} catch (Exception ex) {
    System.err.println(ex);
}

برای سرورهای فعال‌شده با SSL، باید ویژگی‌های زیر شی Pop3Client را تغییر دهیم:

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

Aspose.Email Imap

Aspose.Email Imap پروتکل دسترسی به پیام اینترنتی (IMAP) را بر روی Java پیاده‌سازی می‌کند. Aspose.Email Imap به توسعه‌دهندگان Java امکان می‌دهد قابلیت‌های IMAP را به برنامه‌های Java خود سریعاً اضافه کنند، بدون نیاز به درک جزئیات پروتکل. این مؤلفه از دریافت و بارگذاری پیام‌ها، بررسی وضعیت جدید/خوانده‌شده/خوانده‌نشده پیام‌ها و غیره پشتیبانی می‌کند.

Imap : ویژگی‌های اصلی

Aspose.Email Imap به شما امکان می‌دهد:

  • پیام‌های ایمیل را دریافت کنید.
  • بارگذاری پیام‌های ایمیل.
  • لیست پیام‌های ایمیل در پوشه‌های مختلف.
  • بررسی وضعیت پیام‌های ایمیل.
  • کار با MailMessage.
  • کار با پشتیبانی SSL.

استفاده از Aspose.Email Imap

Aspose.Email Imap پروتکل دسترسی به پیام اینترنتی (IMAP) را بر روی Java پیاده‌سازی می‌کند. با آن، توسعه‌دهندگان می‌توانند به‌راحتی ایمیل‌های سرور IMAP را پرس‌وجو و مدیریت کنند و پوشه‌های ایمیل را ایجاد، حذف یا تغییر نام دهند. با استفاده از Aspose.Email Imap، توسعه‌دهندگان می‌توانند از مزایای پروتکل IMAP با APIهای آسان استفاده بهره‌برداری کنند. آنها می‌توانند از هر کامپیوتری به ایمیل‌ها دسترسی داشته باشند چون ایمیل‌ها روی سرور ذخیره می‌شوند. با استفاده از Aspose.Email Imap، توسعه‌دهندگان می‌توانند برنامه‌های وب یا دسکتاپی بسازند که ایمیل‌ها را از سرورهای IMAP دریافت و دستکاری می‌کنند. Aspose پروتکل IMAP را بر اساس احراز هویت اینترنتی و استانداردهای RFC پیاده‌سازی کرده است. بنابراین Aspose.Email Imap یک پیاده‌سازی امن و کامل از پروتکل IMAP با یک مدل شیء و رابط‌های آسان برای درک است.

Imap : برنامه نمونه

این مقاله توضیح می‌دهد چگونه از Aspose.Email Imap. یک برنامه کوچک ایجاد می‌کنیم که تعداد پیام‌های ایمیل در حساب IMAP شما را به‌دست می‌آورد. برای ساخت برنامه نمونه با استفاده از Aspose.Email Imap، مراحل زیر را دنبال کنید.

  1. یک نمونه از ImapClient با ارائه نام سرور IMAP، نام کاربری و رمز عبور ایجاد کنید.
  2. متد selectFolder() شی ImapClient را صدا بزنید تا پوشه‌ای که می‌خواهید تعداد پیام‌های آن را بشمارید، انتخاب کنید.
  3. حال خاصیت CurrentFolder.TotalMessageCount شی ImapClient را فراخوانی کنید تا تعداد پیام‌های ایمیل را به‌دست آورید.

Imap : مثال‌های کد

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

// Creates an instance of the class ImapClient by specified the host, username and password
ImapClient client = new ImapClient("localhost", "username", "password");

try {
    client.selectFolder(ImapFolderInfo.IN_BOX);
    String strTemp;
    strTemp = "You have " + client.getCurrentFolder().getTotalMessageCount() + " messages in your account.";
    // Gets number of messages in the folder, Disconnects to imap server.
    System.out.println(strTemp);
} catch (Exception ex) {
    System.err.println(ex);
}

برای سرورهای ایمیل که SSL فعال است، ویژگی‌های زیر را در شی ImapClient تنظیم کنید:

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

Aspose.Email Exchange

Aspose.Email Exchange به توسعه‌دهندگان امکان می‌دهد ایمیل‌ها را روی Microsoft Exchange Server مدیریت کنند. با استفاده از این مؤلفه می‌توانید بدون نیاز به درک جزئیات پروتکل زیرین، به صندوق‌پست سرور Exchange متصل شوید، پیام‌ها را فهرست کنید و ایمیل‌ها را دانلود کنید. این مؤلفه از فهرست‌کردن پیام‌ها، ارسال ایمیل‌ها، دانلود پیام‌ها و ذخیره‌سازی به قالب eml یا msg بر روی دیسک محلی و غیره پشتیبانی می‌کند.

Exchange : ویژگی‌های اصلی

Aspose.Email Exchange به شما اجازه می‌دهد:

  • اتصال به سرورهای Microsoft Exchange.
  • لیست پیام‌های ایمیل در صندوق‌های ایمیل Exchange.
  • لیست پیام‌های ایمیل از پوشه‌های مختلف، برای مثال Inbox، Sent، Deleted یا Drafts.
  • حذف پیام‌ها در هر پوشه‌ای از سرورهای Exchange.

استفاده از Aspose.Email Exchange

با Aspose.Email Exchange، توسعه‌دهندگان می‌توانند به صندوق‌پست‌های سرور Exchange از برنامه‌های Java خود دسترسی داشته باشند. این ابزار API ساده‌ای برای مدیریت ایمیل‌ها در سرورهای Exchange فراهم می‌کند. توسعه‌دهندگان می‌توانند برنامه‌های کنسول، دسکتاپ یا وبی ایجاد کنند که ایمیل‌های موجود در صندوق‌پست‌های Exchange را مدیریت می‌نمایند.

برنامه نمونه Aspose.Email Exchange

این مقاله نشان می‌دهد چگونه از Aspose.Email Exchange. یک برنامه دسکتاپ ساده ایجاد می‌کنیم که به صندوق‌پست سرور Exchange متصل می‌شود، فهرست پیام‌ها در پوشه Inbox را دریافت می‌کند و آنها را در فرم ویندوز نمایش می‌دهد.

Exchange : مراحل برنامه نمونه

برای اجرای موفقیت‌آمیز برنامه، نیاز به اطلاعات‌اعتباری صحیح برای دسترسی به سرور Exchange دارید. در اینجا، اطلاعات اعتبار شامل URI سرور Exchange، نام کاربری، رمز عبور و دامنه را از فرم ویندوز دریافت می‌کنیم. این یک نمونه بسیار ساده است، بنابراین ویژگی‌های پیام — موضوع، فرستنده و گیرنده — به‌سادگی در لیست‌باکس نمایش داده می‌شوند.

Exchange : مثال‌های کد

کد زیر را به هندلر کلیک دکمه List Messages اضافه کنید.

// Clear the items in the listbox
lstMessages.clear();

// Create instance of IEWSClient class by giving credentials and Call ListMessages method to list messages info from Inbox
IEWSClient client = EWSClient.getEWSClient("mailboxURI", "Username", "Password", "Domain");
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : msgCollection) {
    String strMsgInfo = "Subject: " + msgInfo.getSubject() + " == From: " + msgInfo.getFrom().toString() + " == To: " + msgInfo.getTo().toString();
    lstMessages.add(strMsgInfo);
}

Exchange : خروجی

این اسکرین‌شات پیام‌های دریافت‌شده از سرور Exchange را نشان می‌دهد. متد listMessages() اطلاعات پایه‌ای مانند موضوع، فرستنده، گیرنده و شناسه پیام را برمی‌گرداند. برای دریافت کامل پیام، متد IEWSClient.fetchMessage() را صدا بزنید. (استفاده از IEWSClient.fetchMessage() در مقاله توضیح داده شده است کار با صندوق ایمیل Exchange و پیام‌ها.)

Aspose.Email Mime

پسوندهای چندمنظوره ایمیل اینترنتی (MIME) استاندارد اینترنتی است که فرمت ایمیل را برای پشتیبانی از متن در مجموعه کاراکتری غیر از US‑ASCII، پیوست‌های غیرمتنی، بدنه‌های چندبخشی پیام و اطلاعات سرصفحه در مجموعه کاراکترهای غیرASCII گسترش می‌دهد. Aspose.Email Mime پروتکل MIMI را بر روی Java پیاده‌سازی می‌کند. این ابزار مانند یک مترجم عمل می‌کند؛ زیرا می‌تواند ایمیل را از فایل (.eml و غیره) یا از حافظه (رشته) بخواند. سپس فایل یا رشته ایمیل را به بخش‌های معنادار تجزیه می‌کند. اگر می‌خواهید بدون درگیر شدن با جزئیات پروتکل MIME یک فایل ایمیل را پردازش کنید، برای مثال برای استخراج پیوست از یک ایمیل، از Aspose.Email Mime استفاده کنید.

ویژگی‌های اصلی

Aspose.Email Mime به‌طور کامل با Aspose.Email Pop3 و Aspose.Email Mail کار می‌کند.

  • Aspose.Email Pop3 پیام‌های ایمیل را از صندوق پست مشخص دریافت می‌کند.
  • Aspose.Email Mail پیام‌های ایمیل را به صندوق پست مشخص‌ شده ارسال می‌کند.
  • Aspose.Email Mime نقطه اتصال دو مورد فوق است و پیام‌های ایمیل را تجزیه می‌کند.
پشتیبانی از چندریسه در کلاینت‌های ایمیل لغو درخواست‌های جلسه با تقویم