Documentation – راهنمای توسعه‌دهنده

Java: ارسال ایمیل از طریق MailGun و SendGrid در جاوا

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

Sending Messages using MailGun and SendGrid

Aspose.Email یک API یکپارچه برای ارسال پیام‌های ایمیل با استفاده از سرویس‌های MailGun یا SendGrid فراهم می‌کند. این API به شما امکان می‌دهد یک کلاینت را مقداردهی اولیه کنید، پیام ایمیل را آماده کنید و ارسال کنید.

اولاً، مهم است که گزینه‌ها را بسته به سرویسی که برای ارسال پیام‌ها استفاده می‌شود، تنظیم کنید. با DeliveryServiceOptions class، پارامترهای DeliveryServiceClient را تنظیم کنید. کد نمونه زیر نشان می‌دهد چگونه گزینه‌های سرویس‌ها را پیکربندی کنید.

MailGun client options:

String domain = "YOUR_MAILGUN_DOMEN";
String privApiKey = "YOUR_MAILGUN_PRIVATE_API_KEY";
MailgunClientOptions opt = new MailgunClientOptions();
opt.setDomain(domain);
opt.setApiKey(privApiKey);

SendGrid client options:

String privApiKey = "YOUR_SENDGRID_PRIVATE_API_KEY";
SendGridClientOptions opt = new SendGridClientOptions();
opt.setApiKey(privApiKey);

سپس، نمونهٔ کلاینت مورد نیاز را با استفاده از builder فراخوانی کنید.

IDeliveryServiceClient client = DeliveryServiceClientFactory.get(opt);

در نهایت، یک پیام ایمیل را آماده و ارسال کنید.

MailMessage eml = new MailMessage("fromAddress", "toAddress", "subject", "body");

DeliveryServiceResponse resp = client.send(eml);

if (!resp.isSuccessful()) {
    for (String error : resp.getErrorMessages()) {
        System.out.println(error);
    }
}

Java: کار با پیام‌های MIME

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

Java: کار با قرارها (Appointments)

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

بارگذاری و ذخیره یک قرار ملاقات در قالب ICS

این Appointment کلاس در Aspose.Email برای Java می‌تواند برای بارگذاری یک قرار ملاقات در قالب ICS و همچنین برای ایجاد یک قرار ملاقات جدید و ذخیره آن بر روی دیسک در قالب ICS استفاده شود. در این مقاله ابتدا یک قرار ملاقات ایجاد کرده و آن را در قالب ICS بر روی دیسک ذخیره می‌کنیم و سپس آن را بارگذاری می‌کنیم.

بارگذاری یک قرار ملاقات در قالب ICS

برای بارگذاری یک قرار ملاقات در قالب ICS، مراحل زیر مورد نیاز است:

یک نمونه از Appointment کلاس.
متد را فراخوانی کنید Load() متد با ارائه مسیر فایل ICS.
هر خصوصیتی را بخوانید تا هر اطلاعاتی را از قرار (فایل ICS) به دست آورید.

قطعه‌های کد زیر نشان می‌دهند چگونه یک قرار (Appointment) را در فرمت ICS بارگذاری کنید.

ایجاد یک قرار ملاقات و ذخیره بر روی دیسک در قالب ICS

مراحل زیر برای ایجاد یک قرار ملاقات و ذخیره آن در قالب ICS مورد نیاز است.

یک نمونه از Appointment کلاس و آن را با این سازنده مقداردهی اولیه کنید.
آرگومان‌های زیر را در سازنده بالا بگذرانید
1. شرکت‌کنندگان
2. توضیح
3. تاریخ پایان
4. مکان
5. تنظیم‌کننده
6. تاریخ شروع
7. خلاصه
8. تاریخ ایجاد
9. تاریخ آخرین تغییر
متد را فراخوانی کنید Save() متد و نام فایل و فرمت را در آرگومان‌ها مشخص کنید.

قرار ملاقات می‌تواند در Microsoft Outlook یا هر برنامه‌ای که می‌تواند فایل ICS را بارگذاری کند، باز شود. اگر فایل در Microsoft Outlook باز شود، به طور خودکار قرار ملاقات را در تقویم Outlook اضافه می‌کند.

قطعات کد زیر نشان می‌دهند که چگونه یک قرار ملاقات را ایجاد و در قالب ICS بر روی دیسک ذخیره کنید.

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

Aspose.Email امکان ذخیره مستقیم قرار ملاقات‌ها در فایل‌های .msg را فراهم می‌کند. کلاس‌های عمومی زیر برای سفارشی‌سازی فرآیند ذخیره‌سازی قرار ملاقات‌ها در دسترس هستند:

AppointmentMsgSaveOptions کلاس با گزینه‌های اضافی برای ذخیره قرار ملاقات‌ها در قالب msg.
AppointmentIcsSaveOptions کلاس با گزینه‌های اضافی برای ذخیره قرار ملاقات در قالب ics. این کلاس برای جایگزینی IcsSaveOptions منسوخ شده اضافه شد.

نمونه کد زیر نشان می‌دهد که چگونه یک قرار ملاقات را از یک فایل بارگذاری کنید و سپس آن را در دو فرمت متفاوت ذخیره کنید: .ics و .msg.

Appointment appointment = Appointment.load("fileName");
appointment.save("fileName.ics", new AppointmentIcsSaveOptions());
appointment.save("fileName.msg", new AppointmentMsgSaveOptions());

ایجاد یک قرار ملاقات با محتوای HTML

استفاده از هدر X-ALT-DESC در فرمت iCalendar (RFC 5545) یک روش رایج است. این یک ویژگی گسترش‌یافته است که توصیف خواندنی انسانی جایگزینی برای یک مورد یا رویداد تقویم فراهم می‌کند. این هدر اغلب برای گنجاندن یک نمایش متنی ساده یا HTML از توصیف رویداد استفاده می‌شود، که می‌تواند برای سازگاری با نرم‌افزارهای تقویم قدیمی یا فراهم کردن نسخه ساده‌سازی‌شده‌ی توصیف مفید باشد. در مواردی که توصیف اصلی توسط برنامه تقویم دریافت‌کننده پشتیبانی یا به‌درستی نمایش داده نمی‌شود، هدر X-ALT-DESC برای ارائه توصیف جایگزین رویداد به کار می‌رود. این امکان به فرستنده می‌دهد تا نمایان‌سازی‌های مختلفی از توصیف رویداد را بگنجاند تا سازگاری و دسترسی بهتر در میان نرم‌افزارها و پلتفرم‌های تقویم مختلف تضمین شود. برای ایجاد یک قرار ملاقات با محتوای HTML، تنظیم کنید HtmlDescription ویژگی را به ’true’ تنظیم کنید. نمونه کد زیر را امتحان کنید که نشان می‌دهد چگونه یک شیء قرار ملاقات را با جزئیات و تنظیمات خاص ایجاد و تعریف کنید، شامل تاریخ، زمان، مکان، تنظیم‌کننده، شرکت‌کنندگان، و توصیف قالب‌بندی‌شده:

Date startDate = new Date();
Appointment appointment = new Appointment("Bygget 83",
        startDate, // start date
        addHours(startDate, 1), // end date
        new MailAddress("TintinStrom@from.com", "Tintin Strom"), // organizer
        MailAddressCollection.to_MailAddressCollection(
                new MailAddress("AinaMartensson@to.com", "Aina Martensson"))); // attendee
appointment.setHtmlDescription("<html>\n"
        + "     <style type=\"\"text/css\"\">\n"
        + "      .text {\n"
        + "             font-family:'Comic Sans MS';\n"
        + "             font-size:16px;\n"
        + "            }\n"
        + "     </style>\n"
        + "    <body>\n"
        + "     <p class=\"\"text\"\">Hi, I'm happy to invite you to our party.</p>\n"
        + "    </body>\n"
        + "    </html>");

ایجاد درخواست قرار ملاقات پیش‌نویس

برای ذخیره یک قرار ملاقات در حالت پیش‌نویس، Method ویژگی Appointment کلاس باید به Publish تنظیم شود. نمونه کد زیر استفاده از این ویژگی را به عنوان مثال نشان می‌دهد.

ایجاد پیش‌نویس قرار ملاقات از متن

افزودن و حذف پیوست‌ها از آیتم‌های تقویم

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

ایجاد و افزودن پیوست‌ها به یک Appointment شیء کلاس.
دریافت اطلاعات پیوست‌ها از یک قرار ملاقات.
استخراج پیوست‌ها از یک قرار ملاقات.

قالب‌بندی قرار ملاقات‌ها

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

نمونه برنامه‌نویسی - قالب‌بندی متن

نمونه برنامه‌نویسی - قالب‌بندی HTML

خواندن چندین رویداد از فایل ICS

نوشتن چندین رویداد در فایل ICS

تنظیم وضعیت شرکت‌کنندگان برای شرکت‌کنندگان قرار ملاقات

API Aspose.Email برای .NET به شما امکان می‌دهد وضعیت شرکت‌کنندگان قرار ملاقات را هنگام تنظیم پیام پاسخ تعیین کنید. این کار ویژگی PARTSTAT را به فایل ICS اضافه می‌کند.

سفارشی‌سازی شناسه محصول برای iCalendar

API Aspose.Email برای Java امکان دریافت یا تنظیم شناسه محصولی که شیء iCalendar را ایجاد کرده است، فراهم می‌کند.

چگونگی دور زدن اعتبارسنجی آدرس هنگام تلاش برای بارگذاری قرار ملاقات‌ها

API Aspose.Email برای Java امکان دور زدن خطای اعتبارسنجی ایمیل را با تنظیم IgnoreSmtpAddressCheck گزینه در AppointmentLoadOptions شیء و عبور آن به فراخوانی load.

AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);

Java: کار با آیتم‌های Outlook

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

Java: کار با فایل‌های ذخیره‌سازی Outlook

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

Java: کار با کلاینت SMTP

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

Java: کار با کلاینت POP3

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

Java: کار با مشتری IMAP

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

Java: کار با کلاینت Exchange EWS

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

Java: کار با Microsoft Graph Client

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

Java: کار با Exchange WebDav Client

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

Java: برنامه‌نویسی با Gmail

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

Java: برنامه‌نویسی با Thunderbird

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

خواندن پیام‌ها از MBOX

Mozilla Thunderbird یک کلاینت ایمیل منبع باز و چندسکویی است که توسط بنیاد Mozilla توسعه یافته است. ایمیل‌ها را در ساختار فایل خود ذخیره می‌کند و شاخص‌های پیام‌ها و زیرپوشه‌ها را از طریق فرمت‌های فایل مالکیتی مدیریت می‌نماید. Aspose.Email می‌تواند با ساختارهای ذخیره‌سازی ایمیل Thunderbird کار کند. The MboxrdStorageReader کلاس به توسعه‌دهندگان امکان خواندن پیام‌ها از فایل ذخیره‌سازی ایمیل Mozilla Thunderbird را می‌دهد. این مقاله نشان می‌دهد چگونه پیام‌ها را از ذخیره‌سازی ایمیل Thunderbird بخوانید:

فایل ذخیره‌سازی Thunderbird را در FileStream باز کنید.
یک نمونه از MboxrdStorageReader کلاس و جریان فوق را به سازنده پاس دهید.
فراخوانی کنید ReadNextMessage() برای دریافت اولین پیام استفاده کنید.
از همان ReadNextMessage() در یک حلقه while برای خواندن تمام پیام‌ها.
تمام جریان‌ها را ببندید.

قطعه کد زیر نشان می‌دهد چگونه تمام پیام‌ها را از ذخیره‌سازی ایمیل Thunderbird بخوانید.

//Getting Marker information while reading messages from Mbox storage file
try (FileInputStream stream = new FileInputStream(dataDir + "Outlook.pst")) {
    MboxLoadOptions lo = new MboxLoadOptions();
    lo.setLeaveOpen(false);
    try (MboxrdStorageReader reader = new MboxrdStorageReader(stream, lo)) {
        MailMessage msg;
        String[] fromMarker = {null};
        while ((msg = reader.readNextMessage(/* out */fromMarker)) != null) {
            System.out.println(fromMarker[0]);
        }
    }
}

پیکربندی گزینه‌های بارگذاری هنگام خواندن پیام‌ها از MBOX

API Aspose.Email امکان انجام اعمال زیر بر پیام‌ها را هنگام خواندن آن‌ها از فایل MBOX فراهم می‌کند:

تبدیل پیام‌ها از MBOX به PST با حفظ پیوست‌های TNEF

EmlLoadOptions emlLoadOptions = new EmlLoadOptions();
emlLoadOptions.setPreserveTnefAttachments(true);
MailStorageConverter.setMboxMessageOptions(emlLoadOptions);
// Convert messages from mbox to pst preserving tnef attachments.
PersonalStorage storage = MailStorageConverter.mboxToPst("Input.mbox", "Output.pst");

MailStorageConverter.MboxMessageOptions() ویژگی - هنگام تجزیهٔ ذخیره‌سازی Mbox گزینه‌های بارگذاری ایمیل را دریافت یا تنظیم می‌کند.

خواندن پیام‌ها با حفظ پیوست‌های TNEF

MboxrdStorageReader reader = new MboxrdStorageReader("Input.mbox", new MboxLoadOptions());
// Read messages preserving tnef attachments.
EmlLoadOptions emlLoadOptions = new EmlLoadOptions();
emlLoadOptions.setPreserveTnefAttachments(true);
MailMessage eml = reader.readNextMessage(emlLoadOptions);

MboxrdStorageReader.readNextMessage(EmlLoadOptions options) متد - پارامتر EmlLoadOptions گزینه‌ها را هنگام خواندن پیام از ذخیره‌سازی Mbox مشخص می‌کند.

فهرست‌گذاری پیام‌ها با حفظ پیوست‌های TNEF

EmlLoadOptions emlLoadOptions = new EmlLoadOptions();
emlLoadOptions.setPreserveTnefAttachments(true);
// Enumerate messages preserving tnef attachments.
for (MailMessage message : reader.enumerateMessages(emlLoadOptions)) {
    // do something
}

MboxrdStorageReader.enumerateMessages(EmlLoadOptions options) متد - هنگام خواندن پیام از ذخیره‌سازی Mbox، گزینه‌های EmlLoadOptions را مشخص می‌کند.

استخراج پیام‌ها از MBOX بر اساس شناسه‌ها

گاهی لازم است پیام‌های انتخاب‌شده را بر اساس شناسه‌ها استخراج کنید. برای مثال، برنامه شما شناسه‌ها را در پایگاه داده ذخیره می‌کند و در صورت نیاز پیام را استخراج می‌کند. این روش مؤثر برای جلوگیری از مرور کل ذخیره‌سازی هر بار به‌منظور یافتن پیام خاصی است. برای پیاده‌سازی این ویژگی برای فایل‌های MBOX، Aspose.Email متدها و کلاس‌های زیر را ارائه می‌دهد:

MboxMessageInfo کلاس با EntryId خاصیت - شناسه ورودی را برمی‌گرداند.
enumerateMessageInfo() متد از MboxStorageReader کلاس - enumerator را منتشر می‌کند که امکان تکرار پیام‌ها در ذخیره‌سازی را فراهم می‌کند.
extractMessage(String id) متد از MboxStorageReader کلاس - پیام را از MBOX دریافت می‌کند.

نمونه کد زیر نشان می‌دهد چگونه پیام‌ها را از MBOX با استفاده از شناسه‌ها استخراج کنید:

MboxStorageReader reader = MboxStorageReader.createReader("my.mbox", new MboxLoadOptions());

for (MboxMessageInfo msgInfo : reader.enumerateMessageInfo()) {
    MailMessage eml = reader.extractMessage(msgInfo.getEntryId(), new EmlLoadOptions());
}

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

فیلتر و جستجوی ایمیل‌ها در فایل‌های MBOX

Aspose.Email for Java امکان فیلتر یا جستجوی پیام‌ها درون فایل‌های MBOX با استفاده از یک کوئری را فراهم می‌کند. این امکان باعث می‌شود تنها پیام‌هایی که با معیارهای خاص مطابقت دارند بازیابی شوند. به این ترتیب می‌توانید عملکرد و قابلیت استفاده برنامه را هنگام کار با فایل‌های بزرگ MBOX بهبود بخشید.

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

enumerateMessages(MailQuery query) - یک مجموعه قابل تکرار از نمونه‌های MailMessage که با کوئری مشخص منطبق هستند را برمی‌گرداند.
enumerateMessageInfo(MailQuery query) - یک مجموعه قابل تکرار (enumerable) از نمونه‌های MboxMessageInfo که با کوئری مشخص منطبق هستند را برمی‌گرداند.

MboxStorageReader reader = MboxStorageReader.createReader("input.mbox", new MboxLoadOptions());
MailQueryBuilder mqb = new MailQueryBuilder();
mqb.getSubject().contains("Project Update");
mqb.getSentDate().before(new Date());

for (MailMessage message : reader.enumerateMessages(mqb.getQuery())) {
    System.out.println("Subject: " + message.getSubject());
}

بازیابی صفحه‌بندی‌شده پیام‌ها از فایل‌های MBOX

Aspose.Email for Java بازیابی صفحه‌بندی‌شده پیام‌ها از فایل‌های MBOX را پشتیبانی می‌کند. این ویژگی امکان پردازش مؤثر فایل‌های بزرگ MBOX را با بازیابی پیام‌ها به صورت دسته‌های کوچکتر فراهم می‌آورد، مصرف حافظه را کاهش داده و عملکرد را بهبود می‌بخشد.

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

enumerateMessages(int startIndex, int count) - تعداد مشخصی از نمونه‌های MailMessage را از یک اندیس معین بازیابی می‌کند.
enumerateMessageInfo(int startIndex, int count) - تعداد مشخصی از نمونه‌های MboxMessageInfo را از یک اندیس معین بازیابی می‌کند.

MboxStorageReader reader = MboxStorageReader.createReader("input.mbox", new MboxLoadOptions());
int startIndex = 0;
int count = 10; // Retrieve messages in batches of 10

for (MailMessage message : reader.enumerateMessages(startIndex, count)) {
    System.out.println("Subject: " + message.getSubject());
}

نوشتن پیام‌ها

این MboxrdStorageWriter کلاس امکان نوشتن پیام‌های جدید در فایل ذخیره‌سازی ایمیل Thunderbird را فراهم می‌کند. برای نوشتن پیام‌ها:

فایل ذخیره‌سازی Thunderbird را در FileStream باز کنید.
یک نمونه از MboxrdStorageWriter کلاس و جریان فوق را به سازنده پاس دهید.
یک پیام جدید را با استفاده از MailMessage کلاس.
متد را فراخوانی کنید WriteMessage() متد و مقدار فوق را منتقل کنید MailMessage نمونه‌ای برای افزودن پیام به ذخیره‌سازی Thunderbird.
تمام جریان‌ها را ببندید.

قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را به ذخیره‌سازی ایمیل Thunderbird می‌نویسید.

//Getting marker information while writing messages to Mbox storage file
try (FileOutputStream writeStream = new FileOutputStream(dataDir + "inbox")) {
    try (MboxrdStorageWriter writer = new MboxrdStorageWriter(writeStream, false)) {
        MailMessage msg = MailMessage.load(dataDir + "Message.msg");
        String[] fromMarker = {null};
        writer.writeMessage(msg, fromMarker);
        System.out.println(fromMarker[0]);
    }
}

دریافت تعداد کل پیام‌ها از فایل MBox

این MboxrdStorageReader کلاس قابلیت خواندن تعداد موارد موجود در یک فایل MBox را فراهم می‌کند. می‌توان از این ویژگی برای توسعه برنامه‌هایی استفاده کرد که پیشرفت فعالیت را هنگام پردازش چنین فایلی نشان می‌دهند.

MboxLoadOptions lo = new MboxLoadOptions();
try (MboxrdStorageReader reader = new MboxrdStorageReader("inbox.dat", lo)) {
    System.out.println("Total number of messages in Mbox file: " + reader.getTotalItemsCount());
}

دریافت اندازه پیام فعلی

FileInputStream stream = new FileInputStream(dataDir + "ExampleMbox.mbox");
MboxLoadOptions lo = new MboxLoadOptions();
try (MboxrdStorageReader reader = new MboxrdStorageReader(stream, lo)) {
    MailMessage msg = null;
    while ((msg = reader.readNextMessage()) != null) {
        //returns the number of bytes read
        long currentDataSize = reader.getCurrentDataSize();
        System.out.println("Bytes read: " + currentDataSize);
    }
}

تنظیم رمزگذاری متن ترجیحی هنگام بارگذاری فایل‌های Mbox

این setPreferredTextEncoding(Charset value) متد از MboxLoadOptions کلاس تنظیم یا دریافت رمزگذاری ترجیحی برای پیام‌ها را انجام می‌دهد. یک خواننده برای فایل Mbox با گزینه‌های بارگذاری مشخص ایجاد کنید و پیام‌های شما با محتوای رمزگذاری‌شده به‌درستی خوانده و پردازش می‌شوند. نمونه کد زیر نشان می‌دهد چگونه این ویژگی را در یک پروژه پیاده‌سازی کنید:

MboxLoadOptions lo = new MboxLoadOptions();
lo.setPreferredTextEncoding(Charset.forName("utf-8"));
MboxrdStorageReader reader = new MboxrdStorageReader("sample.mbox", lo);
MailMessage message = reader.readNextMessage();

تقسیم ذخیره‌سازی Mbox به بخش‌های کوچکتر

Aspose.Email کامپوننت‌های زیر را ارائه می‌دهد که برای کنترل بیشتر بر پردازش ذخیره‌سازی Mbox طراحی شده‌اند و به شما امکان می‌دهند فایل‌های بزرگ را به بخش‌های قابل مدیریت تقسیم کنید و اقدامات سفارشی را در طول فرآیند پیاده‌سازی کنید:

MboxStorageReader.SplitInto(long chunkSize, String outputPath) متد - به شما امکان می‌دهد تا ذخیره‌سازی Mbox را به بخش‌های کوچکتر تقسیم کنید، که مدیریت و پردازش فایل‌های بزرگ Mbox را آسان‌تر می‌کند.

MboxStorageReader.SplitInto(long chunkSize, String outputPath, String partFileNamePrefix) یک نسخه متفاوت از متد قبلی است که به شما امکان می‌دهد پیشوند سفارشی برای نام فایل‌های Mbox تقسیم‌شده تعیین کنید.

رویداد MboxStorageReader.setEmlCopyingEventHandler. این رویداد پیش از کپی شدن یک ایمیل به یک فایل Mbox جدید رخ می‌دهد. می‌توانید اقدامات را قبل از پردازش ایمیل‌ها سفارشی کنید.

رویداد MboxStorageReader.setEmlCopiedEventHandler. این رویداد پس از کپی شدن یک ایمیل به یک فایل Mbox جدید رخ می‌دهد. می‌توانید اقدامات پس از پردازش را بر روی ایمیل‌ها انجام دهید.

رویداد MboxStorageReader.setMboxFileCreatedEventHandler. این رویداد زمانی رخ می‌دهد که یک فایل Mbox جدید ایجاد می‌شود. می‌توانید این رویداد را برای واکنش به ایجاد فایل مدیریت کنید.

MboxStorageReader.setMboxFileFilledEventHandler Event این رویداد زمانی رخ می‌دهد که یک فایل Mbox جدید با ایمیل‌ها پر شود. می‌توانید به پر شدن فایل با ایمیل‌ها واکنش نشان دهید.

NewStorageEventHandler(Object sender, NewStorageEventArgs e) نمایانگر یک delegate برای مدیریت رویدادهایی است که پس از ایجاد یا پردازش یک فایل ذخیره‌سازی جدید رخ می‌دهند.

MimeItemCopyEventHandler(Object sender, MimeItemCopyEventArgs e) نمایانگر یک delegate برای مدیریت رویدادهای مرتبط با کپی موارد Mime است که معمولاً در سناریوهایی استفاده می‌شود که یک شیء MailMessage از یک ذخیره‌سازی به ذخیره‌سازی دیگر کپی می‌شود.

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

MimeItemCopyEventArgs نشان‌دهندهٔ آرگومان‌های رویداد مربوط به کپی یک شیء MailMessage از یک ذخیره‌سازی به ذخیره‌سازی دیگر است، چه قبل از شروع کپی و چه پس از اتمام آن.

نمونه کد زیر نشان می‌دهد چگونه با فایل‌های Mbox تعامل داشته باشید، رویدادهای مربوط به این فایل‌ها را مدیریت کنید، و عملیات‌هایی مانند تقسیم ذخیره‌سازی Mbox به قسمت‌های کوچکتر را انجام دهید در حالی که تعداد پیام‌ها و تعداد قسمت‌ها را ردیابی می‌کنید:

messageCount = 0;
partCount = 0;

// Create an instance of MboxrdStorageReader
MboxLoadOptions lo = new MboxLoadOptions();
lo.setLeaveOpen(false);
MboxrdStorageReader mbox = new MboxrdStorageReader("my.mbox", lo);

// Subscribe to events
mbox.setMboxFileCreatedEventHandler(new NewStorageEventHandler() {
    public void invoke(Object sender, NewStorageEventArgs e) {
        System.out.println("New Mbox file created: " + e.getFileName());
        partCount++;
    }
});

mbox.setMboxFileFilledEventHandler(new NewStorageEventHandler() {
    public void invoke(Object sender, NewStorageEventArgs e) {
        System.out.println("Mbox file filled with messages: " + e.getFileName());
    }
});

mbox.setEmlCopiedEventHandler(new MimeItemCopyEventHandler() {
    public void invoke(Object sender, MimeItemCopyEventArgs e) {
        System.out.println("Message added to new Mbox file. Subject: " + e.getItem().getSubject());
        messageCount++;
    }
});

// Split the Mbox storage into smaller parts
mbox.splitInto(10000000, testOutPath, "Prefix");

// Output the final messageCount and partCount
System.out.println("Total messages added: " + messageCount);
System.out.println("Total parts created: " + partCount);

Java: کار با Zimbra

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

About Zimbra

Zimbra یک مجموعه ایمیل، تقویم و همکاری است که برای ابر ساخته شده است. Zimbra شامل ایمیل کامل، مخاطبین، تقویم، به‌اشتراک‌گذاری فایل، وظایف و پیام‌رسانی/ویدئوکنفرانس است که همه از طریق Zimbra Web Client در هر دستگاهی قابل دسترسی هستند.

Read all messages from Zimbra TGZ storage

Aspose.Email ارائه می‌دهد TgzReader کلاس برای خواندن فایل‌های ذخیره‌سازی TGZ Zimbra. کد نمونه زیر استفاده از این را نشان می‌دهد TgzReader کلاس برای خواندن تمام پیام‌ها از فایل.

Save Messages and Directory Structure

همچنین می‌توانید تمام پیام‌ها را همراه با ساختار پوشه‌ها از فایل ذخیره‌سازی TGZ Zimbra ذخیره کنید. برای این کار، TgzReader کلاس یک متد فراهم می‌کند ExportTo که مسیر خروجی را به عنوان پارامتر می‌گیرد.

قطعه کد زیر استفاده از این را نشان می‌دهد TgzReader.ExportTo متد برای ذخیره تمام پیام‌ها از فایل ذخیره‌سازی TGZ Zimbra.

Export calendar and contact items from Zimbra backup files

Aspose.Email امکان استخراج تقویم و مخاطبین Zimbra به فرمت‌های iCalendar و VCard را فراهم می‌کند. نمونه کد زیر نشان می‌دهد چگونه این ویژگی را در پروژهٔ خود پیاده‌سازی کنیم:

try (TgzReader reader = new TgzReader("test2.tgz")) {
    //contacts files can be found in Contacts and Emailed Contacts subfolders
    //calendar files can be found in Calendar subfolder
    reader.exportTo("out");
}

Java: کار با IBM Notes

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

About IBM Notes

IBM Notes کلاینت و IBM Domino سرور یک پلتفرم نرم‌افزاری مشترک کار‑کلاینت‑سرور است. IBM Notes ویژگی‌های همکاری مانند ایمیل، تقویم، فهرست کارها، مدیریت مخاطبین و غیره را فراهم می‌کند. فایل پایگاه داده‌ای که توسط IBM Notes استفاده می‌شود با فرمت Notes Storage Facility (NSF) ذخیره می‌شود.

Read messages from NSF storage file

توجه داشته باشید، پیاده‌سازی NSF محدود است. به طور کلی ممکن است در موارد زیر با مشکلاتی مواجه شوید:

این فایل توسط Notes نسخه ۷ و بالاتر ایجاد شده است
از فشرده‌سازی LZ1 استفاده می‌شود

Aspose.Email ارائه می‌دهد NotesStorageFacility کلاس برای خواندن فایل‌های ذخیره‌سازی NSF. این NotesStorageFacility کلاس فراهم می‌کند EnumerateMessages متد که بر روی پیام‌های موجود در فایل ذخیره‌سازی NSF تکرار می‌کند. کد نمونه زیر استفاده از این را نشان می‌دهد NotesStorageFacility کلاس و EnumerateMessages متد برای خواندن پیام‌ها از فایل ذخیره‌سازی NSF.

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

Java: برنامه‌نویسی تأیید ایمیل

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

Using EmailValidator

EmailValidator پشتیبانی کامل برای اعتبارسنجی آدرس‌های ایمیل را فراهم می‌کند. با کمک EmailValidator class، انواع مختلفی از اعتبارسنجی می‌توانند انجام شوند، از جمله بررسی سینتکس ایمیل، بررسی دامنه ایمیل و بررسی حساب‌های کاربری با سرورهای ایمیل. این ValidationPolicy از enumeration برای تنظیم سطح سیاست اعتبارسنجی استفاده می‌شود:

SyntaxOnly فقط سینتکس آدرس ایمیل را اعتبارسنجی می‌کند.
SyntaxAndDomain سینتکس آدرس ایمیل را اعتبارسنجی می‌کند، سپس دامنه را اعتبارسنجی می‌نماید.

Basic Validation Functionality

استفاده کنید EmailValidator برای تأیید صحت آدرس‌های ایمیل.

Validating Emails

عملکرد اعتبارسنجی Aspose.Email می‌تواند برای اعتبارسنجی آدرس‌های ایمیل، نام‌های دامنه و سرورهای ایمیل استفاده شود. قطعه کد زیر نشان می‌دهد چگونه از آن استفاده کنید EmailValidator برای اعتبارسنجی یک آدرس ایمیل.

EmailValidator ev = new EmailValidator();
ValidationResult[] result = new ValidationResult[] { null };
ev.validate("user@domain.com", result);
if (result[0].getReturnCode() == ValidationResponseCode.ValidationSuccess)
{
    System.out.println("the email address is valid.");
}
else
{
    System.out.println("the mail address is invalid,for the " + result[0].getMessage());
}

Validate Email Messages

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

MIME Formats: eml, emlx, mht
MAPI Formats: msg, oft

Aspose.Email ابزارهای زیر را برای انجام این کار فراهم می‌کند:

MessageValidator.validate method - پیام‌ها را با استفاده از این متد اعتبارسنجی می‌کند؛ مسیر فایل یا جریان را به عنوان ورودی می‌گیرد.
MessageValidationResult class - نتایج فرآیند اعتبارسنجی پیام را محصور می‌کند. بینش‌هایی دربارهٔ موفقیت اعتبارسنجی، نوع قالب و هر خطای مواجه شده ارائه می‌دهد.
MessageValidationErrorType Enum - انواع مختلف خطاهای اعتبارسنجی را فهرست می‌کند.

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

MessageValidationResult result = MessageValidator.validate(fileName);

// Check if validation is successful
if (!result.isSuccess()) {
    System.out.println("Validation failed.");

    // Check the format type
    if (result.getFormatType() == FileFormatType.Mht) {
        System.out.println("Format type is Mht.");
    }

    // Check and display errors
    System.out.println("Number of errors: " + result.getErrors().size());

    for (MessageValidationError error : result.getErrors()) {
        System.out.println("Error Type: " + error.getErrorType());
        System.out.println("Description: " + error.getDescription());
    }
} else {
    System.out.println("Validation successful.");
}

Java: کار با ایمیل‌های AMP HTML

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

درباره AMP

AMP (Accelerated Mobile Pages) یک چارچوب منبع باز توسط Google است که از HTML، CSS و JavaScript ساخته شده است. این چارچوب امکان ساخت ایمیل‌های سبک وزن با زمان بارگذاری سریع‌تر را فراهم می‌کند. AMP بسیاری از مؤلفه‌ها مانند کاروسل‌ها، فرم‌ها، تصاویر و غیره را ارائه می‌دهد. علاوه بر سرعت، ایمیل‌های AMP به‌صورت کاملاً تعاملی داخل کلاینت ایمیل رندر می‌شوند و کاربران می‌توانند مستقیماً در ایمیل‌ها تعامل داشته باشند؛ به‌عنوان مثال فرم را پر کنند یا به نظرسنجی پاسخ دهند بدون اینکه کلاینت ایمیل را ترک کنند.

کار با ایمیل‌های AMP HTML

Aspose.Email ارائه می‌دهد AmpMessage که نمایانگر یک ایمیل AMP است. Aspose.Email کلاس‌های متعددی را برای افزودن مؤلفه‌ها به ایمیل‌های AMP مانند AmpImage, AmpCarousel, AmpAccordion, AmpForm, و غیره. قطعه کد زیر نشان می‌دهد که چگونه ایمیل‌های AMP را با استفاده از API Aspose.Email ایجاد، ذخیره و به‌روز کنید.

Java: اطلاعات پروتکل

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

Java: مقالات فنی

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

Java: مهاجرت از Office Automation به Aspose

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

Java: مهاجرت از نسخه‌های قبلی Aspose.Email

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

Java: سازگاری با JDK 11

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

API Aspose.Email EWSClient کاملاً سازگار است و می‌تواند با JDK 11 استفاده شود. برای کار با JDK 11، نیاز به افزودن وابستگی‌های JAXB داریم. سایر APIهای Aspose.Email به‌طور معمول بدون هیچ وابستگی اضافی کار می‌کنند.

APIهای JAXB جزو APIهای Java EE محسوب می‌شوند و بنابراین دیگر در مسیر کلاس پیش‌فرض Java SE 9 گنجانده نمی‌شوند. در Java 11 این APIها کاملاً از JDK حذف شده‌اند.

وابستگی‌های JAXB زیر برای Maven باید به پروژه اضافه شوند:


 <dependency>

    <groupId>javax.xml.bind</groupId>

    <artifactId>jaxb-api</artifactId>

    <version>2.3.1</version>

</dependency>

<dependency>

    <groupId>com.sun.xml.bind</groupId>

    <artifactId>jaxb-impl</artifactId>

    <version>2.3.1</version>

</dependency>

<dependency>

    <groupId>com.sun.xml.bind</groupId>

    <artifactId>jaxb-core</artifactId>

    <version>2.3.0.1</version>

</dependency>

<dependency>

    <groupId>com.sun.xml.messaging.saaj</groupId>

    <artifactId>saaj-impl</artifactId>

    <version>1.5.0</version>

</dependency>

Java: سوالات متداول

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

Question

سلام! برای کد زیر:


ContentType ct = new ContentType();

ct.setMediaType("application/msword");

ct.setCharSet("ISO-2022-JP");

Attachment att = new Attachment("Test.doc", ct);

System.out.println(att.getContentType().getName());

att.getContentType().getName() نام سند پیوست شده را برمی‌گرداند. آیا این رفتار مورد انتظار است؟

Answer: بله، این رفتار مورد انتظار است. اگر getContentType().getName() به‌صورت صریح تنظیم نشود، مقدار نام فایل به عنوان نام استفاده می‌شود.

Question: چگونه می‌توانم داده‌های پیوست "oleData.mso" که به عنوان نتیجهٔ خواندن یک MapiMessage حاوی شیء OLE جاساز شده دریافت می‌کنم استخراج کنم؟

Answer: فایل‌هایی مانند "oleData.mso" به فرمت Microsoft Compound Document (MCDF) اشاره دارند و متأسفانه پشتیبانی از این فایل‌ها خارج از حوزه Aspose.Email است. با این حال، برخی کتابخانه‌های متن باز .NET وجود دارند، برای مثال OpenMCDF، که می‌توانند برای خواندن محتویات این فایل‌ها برای ذخیره بر روی دیسک استفاده شوند.

Question: آیا می‌توانیم در رشته‌های موازی و با استفاده از همان اشیا به فایل PST یکسان بنویسیم؟

Answer: خیر، ایمنی رشته‌ها در چنین حالتی تضمین نمی‌شود. نوشتن پیام‌ها باید در یک رشته انجام شود. با این حال، محصول باید به درستی با اشیای مختلف از رشته‌های مختلف کار کند.