Documentation – مقالات فنی

Java: تفاوت بین پیوست‌های Inline و معمولی

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

پیام‌های ایمیل ممکن است شامل تصاویر Inline همچنین پیوست‌ها باشند. با استفاده از MailMessage، پیوست‌های Inline می‌توانند استخراج شوند از LinkedResourceCollection مجموعه بارگذاری می‌شود، در حالی که پیوست‌های معمولی می‌توانند با استفاده از یک پیام استخراج شوند AttachmentCollection مجموعه. با این حال، این متفاوت است زمانی که پیام با استفاده از MapiMessage، زیرا تمام تصاویر inline و پیوست‌های معمولی در یک مکان برای کاربر قابل دسترسی هستند MapiAttachmentCollection. به همین دلیل، روشی که بتواند بین یک پیوست inline و یک پیوست معمولی تمایز قائل شود وقتی که MapiMessage در صورت نیاز استفاده می‌شود.

این مقاله توضیح می‌دهد چگونه پیوست‌های inline را از پیوست‌های معمولی با استفاده از MapiMessage. هنگام تصمیم‌گیری، نوع بدنهٔ MapiMessage به شکل زیر در نظر گرفته می‌شود:

بدنه متن ساده: پیام‌های ایمیل با نوع بدنه متن ساده نیازی به بررسی ندارند، زیرا تمام پیوست‌های این پیام‌ها همیشه پیوست‌های معمولی هستند.
بدنه HTML: برای پیام‌هایی با بدنه HTML، پیوست فقط باید شامل ویژگی PR_ATTACH_FLAGS (0x37140003) باشد، اما مقدار آن باید برای پیوست‌های inline برابر 0x00000004 باشد. اگر این شرط برقرار باشد، سپس وابسته به برچسب‌های PR_ATTACH_CONTENT_LOCATION و PR_ATTACH_CONTENT_ID برای تعیین نوع پیوست است. با این حال، در صورت عدم وجود برچسب MAPI PR_ATTACH_FLAGS، پیوست با ویژگی PR_ATTACH_DISPOSITION (0x3716001F یا 0x3716001E) بررسی می‌شود تا نوع پیوست مشخص شود.
بدنه RTF: اگر بدنه RTF باشد، تمام پیوست‌های OLE به‌عنوان پیوست‌های Inline درنظر گرفته می‌شوند. مقدار PR_ATTACH_METHOD برای تمام پیوست‌های OLE برابر با 0x00000006 است.

نمونه کد زیر به‌صورت برنامه‌نویسی نشان می‌دهد چگونه بین پیوست‌های Inline و معمولی تفکیک کنید. تابع isInlineAttachment یک پیوست و یک MapiMessage را به‌عنوان پارامترهای ورودی دریافت می‌کند و در صورتی که پیوست یک پیوست Inline باشد مقدار true را برمی‌گرداند.

public static boolean isInlineAttachment(MapiAttachment att, MapiMessage msg) {
    if (msg.getBodyType() == BodyContentType.PlainText)
        // ignore indications for plain text messages
        return false;
    else if (msg.getBodyType() == BodyContentType.Html) {
        // check the PidTagAttachFlags property
        Long attachFlagsValue = att.getPropertyLong(MapiPropertyTag.PR_ATTACH_FLAGS);
        if (attachFlagsValue != null && (attachFlagsValue > 3 || attachFlagsValue < 1)) {
            // check PidTagAttachContentId property
            String contentId = att.getProperties().containsKey(MapiPropertyTag.PR_ATTACH_CONTENT_ID)
                    ? att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_ID)
                    : att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_ID_W);
            if (contentId != null && !contentId.isEmpty() && msg.getBodyHtml().contains("cid:" + contentId)) {
                return true;
            }
            // check PidTagAttachContentLocation property
            String contentLocation = att.getProperties().containsKey(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION)
                    ? att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION)
                    : att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION_W);
            if (contentLocation != null && !contentLocation.isEmpty() && msg.getBodyHtml().contains(contentLocation)) {
                return true;
            }
        }
        return "inline".equals(att.getPropertyString(0x3716001F)) || "inline".equals(att.getPropertyString(0x3716001E));
    } else if (msg.getBodyType() == BodyContentType.Rtf) {
        // If the body is RTF, then all OLE attachments are inline attachments.
        // OLE attachments have 0x00000006 for the value of the PidTagAttachMethod property
        Long attachMethod = att.getPropertyLong(MapiPropertyTag.PR_ATTACH_METHOD);
        return attachMethod != null && attachMethod == 0x00000006;
    } else {
        throw new ArgumentOutOfRangeException();
    }
}

این قطعه کد از تابع isInlineAttachment() برای ارزیابی پیوست‌ها استفاده می‌کند.

جاوا

String fileName = ("Sample.msg");
MapiMessage message = MapiMessage.fromFile(fileName);
MapiAttachmentCollection attachments = message.getAttachments();
for (int i = 0; i < attachments.size(); i++) {
    MapiAttachment attachment = (MapiAttachment) attachments.get(i);
    if (isInlineAttachment(attachment, message)) {
        System.out.println(attachment.getLongFileName() + " is inline attachment");
    } else {
        System.out.println(attachment.getLongFileName() + " is regular attachment");
    }
}

Java: شناسایی و استخراج پیوست‌های توکار از فایل MSG با قالب RTF

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

پیام‌های ایمیل با بدنه قالب RTF ممکن است شامل پیوست‌های Inline باشند که یا به‌صورت یک شیء کامل یا به‌صورت یک آیکون توکار می‌شوند. برای تمایز بین این دو نوع پیوست، ابتدا باید برخی از ویژگی‌های پیوست بررسی شوند. پس از برآورده کردن معیارهای خاص بر مبنای ویژگی‌های پیوست، می‌توان پیوست را با استخراج آن از ObjectData ذخیره کرد.

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

جاوا


   static void ExtractInlineAttachments()

  {

        MapiMessage message = MapiMessage.fromFile("Test.msg");

    MapiAttachmentCollection attachments = message.getAttachments();

    for (Object untypedAttachment : attachments)

    {

          MapiAttachment attachment = (MapiAttachment) untypedAttachment;

          if(IsAttachmentInline(attachment))

          {

                try

                {

                      SaveAttachment(attachment, UUID.randomUUID().toString());

                }

                catch (IOException | FileNotFoundException e)

                {

                      // TODO Auto-generated catch block

                          e.printStackTrace();

                    }

              }

        }

  }

  static boolean IsAttachmentInline(MapiAttachment attachment)

  {

        MapiObjectProperty objectData = attachment.getObjectData();

        if (objectData == null)

              return false;

        for (Object prop : attachment.getObjectData().getProperties().getValues())

        {

              MapiProperty property = (MapiProperty)prop;

              if ("\u0003ObjInfo".equals(property.getName()))

              {

                    byte[] data = property.getData();

                    int odtPersist1 = data[1] << 8 | data[0];

                    return (odtPersist1 & 0x40) == 0;

              }

        }

        return false;

  }

  static void SaveAttachment(MapiAttachment attachment, String fileName) throws IOException, FileNotFoundException

  {

        for (Object prop : attachment.getObjectData().getProperties().getValues())

        {

              MapiProperty property = (MapiProperty)prop;

              if ("Package".equals(property.getName()))

          {

                FileOutputStream fs;

                try

                {

                      fs = new FileOutputStream(fileName);

                      fs.write(property.getData(), 0, property.getData().length);

                }

                catch (java.io.IOException e)

                {

                      // TODO Auto-generated catch block

                          e.printStackTrace();

                    }

              }

        }

  }

Java: ذخیره یک MSG به صورت PDF

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

این مقاله نشان می‌دهد چگونه یک پیام ایمیل را با استفاده از Aspose.Email به PDF تبدیل کنید. Aspose.Email برای جاوا ویژگی‌های Microsoft Outlook را پشتیبانی می‌کند و نمی‌تواند تبدیل مستقیم به PDF انجام دهد. برای غلبه بر این، نمونه‌های این مقاله از Aspose.Email برای تبدیل پیام ایمیل به جریان MHTML استفاده می‌کنند و سپس از Aspose.Words برای جاوا برای بارگذاری جریان MHTML و ذخیره آن به عنوان PDF استفاده می‌شود.

یک پیام ایمیل می‌تواند حاوی پیوست‌ها نیز باشد. از آنجا که هر پیوست می‌تواند نوع رسانه متفاوتی داشته باشد، Aspose.Email این پیوست‌ها را هنگام تبدیل به MHTML نادیده می‌گیرد؛ یعنی فقط تصاویر درون‌متنی در پیام بخشی از MHTML خواهند بود و هر پیوست معمولی نادیده گرفته می‌شود.

تبدیل پیام ایمیل به PDF

کد زیر نشان می‌دهد که چگونه پیام ایمیل را با استفاده از Aspose.Email به همراه Aspose.Words برای جاوا به PDF تبدیل کنید. این کار شامل مراحل زیر است:

بارگذاری پیام ایمیل با استفاده از MailMessage
ذخیره پیام ایمیل به MemoryStream به صورت MHTML
بارگذاری جریان با استفاده از Aspose.Words
ذخیره پیام به عنوان PDF

پیام ایمیل منبع به شرح زیر قابل مشاهده است:

|| | :- | |Figure: Source MSG File |

|| | :- | |Figure: Converted PDF File | Java


 static void EmailToPdf(String emailPath) throws Exception

{

       FileInputStream fstream=new FileInputStream(emailPath);

       MailMessage eml = MailMessage.load(fstream);

       //Save the Message to output stream in MHTML format

       ByteArrayOutputStream emlStream = new ByteArrayOutputStream();

       eml.save(emlStream, SaveOptions.getDefaultMhtml());

       //Load the stream in Word document

       LoadOptions lo = new LoadOptions();

       lo.setLoadFormat(LoadFormat.MHTML);

       Document doc = new Document(new ByteArrayInputStream(emlStream.toByteArray()), lo);

       //Save to disc

       doc.save("About Aspose.Pdf", SaveFormat.PDF);

       //or Save to stream

       ByteArrayOutputStream foStream = new ByteArrayOutputStream();

       doc.save(foStream, SaveFormat.PDF);

}

Java: استخر اتصال بازنگری شد

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

با انتشار Aspose.Email 19.3، استخر اتصال بازنگری شد. جدید EmailClient کلاسی معرفی شده است که در نهایت جایگزین CredentialsByHostClient کلاس. EmailClient کلاس یک ConnectionAsgmtMode ویژگی که حالت تخصیص اتصال را در محیط چندرشته‌ای تعریف می‌کند. EmailClient.ConnectionAsgmtMode با استفاده از ConnectionAsgmtType قابل شمارش.

انواع اتصال

سه نوع اتصال زیر وجود دارد:

اتصال اصلی: این اتصال همراه با کلاینت ایمیل ساخته و حذف می‌شود. نمی‌تواند به‌صورت دستی ساخته یا حذف شود.
اتصال پیش‌فرض: کاربر می‌تواند اتصالات پیش‌فرض برای رشته‌ها با CreateConnection متد. اگر اتصال پیش‌فرض وجود داشته باشد، تمام متدهای کلاینت ایمیل که در یک رشته اجرا می‌شوند، به‌صورت ضمنی از این اتصال استفاده می‌کنند. فقط یک اتصال پیش‌فرض می‌تواند برای هر رشته وجود داشته باشد. می‌تواند به‌صورت دستی یا خودکار ایجاد شود. این بسته به ویژگی EmailClient.ConnectionAsgmtMode است. این اتصالات می‌توانند به‌صورت دستی با EmailClient.CreateConnection(createAsDefaultConnection = true) متد. اگر اتصال پیش‌فرض استفاده نشود (بسته به حالت تخصیص اتصال)، اتصال اصلی به‌صورت ضمنی به جای آن استفاده می‌شود.
اتصالات مستقل: این‌ها اتصالی هستند که به رشته‌ها لینک نمی‌شوند. می‌توانند به‌صورت دستی ایجاد شوند و باید به‌صورت صریح به‌عنوان پارامتر متد استفاده شوند. این اتصالات می‌توانند به‌صورت دستی با EmailClient.CreateConnection() متد یا EmailClient.CreateConnection(createAsDefaultConnection = false) متد.

انواع تخصیص اتصال

برای تنظیم EmailClient.ConnectionAsgmtMode ویژگی، ConnectionAsgmtType قابل شمارش استفاده می‌شود. انواع تخصیص ارائه شده توسط ConnectionAsgmtType در زیر فهرست شده‌اند.

ConnectionAsgmtType.UseMainOrDefault این حالت به‌طور پیش‌فرض در کلاینت‌های ایمیل استفاده می‌شود. کلاینت ایمیل برای تمام عملیات از چندین رشته از اتصال اصلی استفاده می‌کند اگر اتصال پیش‌فرض ایجاد نشده باشد، یا اگر یک اتصال به‌عنوان پارامتر متد به صراحت پاس داده نشود. اتصال اصلی اتصالی است که همزمان با یک کلاینت ایمیل ساخته می‌شود. کاربر می‌تواند اتصالات پیش‌فرض برای رشته‌ها با CreateConnection متد. اگر اتصال پیش‌فرض برای یک رشته ایجاد شود، به‌صورت ضمنی برای تمام متدهای کلاینت ایمیل که در این رشته فراخوانی می‌شوند، استفاده می‌شود. اگر اتصال پیش‌فرض برای یک رشته ایجاد نشده باشد، اتصال اصلی برای تمام متدهای کلاینت ایمیل که در این رشته فراخوانی می‌شوند، استفاده می‌شود. کاربر همچنین می‌تواند اتصالاتی که به رشته‌ها لینک نشده‌اند (اتصالات پیش‌فرض نیستند) را با استفاده از CreateConnection متد. اگر کاربر بخواهد از اتصالات دیگر (نه اصلی و نه پیش‌فرض) استفاده کند، باید این اتصال را به‌صورت صریح به‌عنوان پارامتر متدی که می‌خواهد استفاده کند، پاس بدهد. کاربر می‌تواند به‌طور اضافی هر تعداد اتصال ایجاد کند. اتصال پیش‌فرض فقط می‌تواند برای هر رشته یک‌بار وجود داشته باشد. لطفاً توجه داشته باشید که اتصالات پیش‌فرض اگر کاربر از اشیاء Thread برای برنامه‌نویسی چندوظیفه‌ای استفاده کند درست کار می‌کنند. اگر کاربر از ConnectionPool یا از اشیاء Task برای برنامه‌نویسی چندوظیفه‌ای استفاده کند، این حالت ممکن است منجر به رفتار نادرست برنامه شود. برای جلوگیری از این مشکل، کاربر باید در پایان اجرای کد (اگر از آن استفاده می‌کند) اتصال پیش‌فرض را به‌صورت دستی آزاد کند.
ConnectionAsgmtType.UseMain کلاینت ایمیل برای تمام عملیات از چندین رشته از اتصال اصلی استفاده می‌کند. اتصال اصلی اتصالی است که همزمان با ایجاد کلاینت ایمیل ساخته می‌شود. کاربر نمی‌تواند اتصالات پیش‌فرض ایجاد کند. کاربر می‌تواند اتصالاتی که به رشته‌ها لینک نشده‌اند (اتصالات پیش‌فرض نیستند) را با استفاده از CreateConnection متد. اگر کاربر بخواهد از اتصالات دیگر (نه اصلی و نه پیش‌فرض) استفاده کند، باید این اتصال را به‌صورت صریح به‌عنوان پارامتر متدی که می‌خواهد استفاده کند، پاس بدهد.
ConnectionAsgmtType.UseDefault کلاینت ایمیل به‌صورت ضمنی فقط به اتصالات پیش‌فرض برای تمام عملیات از چندین رشته استفاده می‌کند. اتصال اصلی در این حالت استفاده نمی‌شود. اگر اتصال پیش‌فرض برای برخی رشته‌ها ایجاد نشده باشد (در اولین فراخوانی متد کلاینت ایمیل)، کلاینت ایمیل به‌صورت ضمنی برای آن رشته قبل از اجرای اولین عملیات، اتصال پیش‌فرض ایجاد می‌کند. کاربر نمی‌تواند با استفاده از CreateConnectionمتد زیرا به‌طور خودکار ایجاد می‌شوند. وقتی اتصال پیش‌فرض برای یک رشته ایجاد می‌شود، به‌صورت ضمنی برای تمام متدهای کلاینت ایمیل که در این رشته فراخوانی می‌شوند، استفاده می‌شود. کاربر همچنین می‌تواند اتصالاتی که به رشته‌ها لینک نشده‌اند (اتصالات پیش‌فرض نیستند) را با استفاده از CreateConnectionمتد. اگر کاربر بخواهد از اتصالات دیگر (نه اصلی و نه پیش‌فرض) استفاده کند، باید این اتصال را به‌صورت صریح به‌عنوان پارامتر متدی که می‌خواهد استفاده کند، پاس بدهد. کاربر می‌تواند به‌طور اضافی هر تعداد اتصال ایجاد کند. فقط یک اتصال پیش‌فرض می‌تواند برای هر رشته استفاده شود. لطفاً توجه داشته باشید که اتصالات پیش‌فرض اگر کاربر از اشیاء Thread برای برنامه‌نویسی چندوظیفه‌ای استفاده کند درست کار می‌کنند. اگر کاربر از ConnectionPool یا از اشیاء Task برای برنامه‌نویسی چندوظیفه‌ای استفاده کند، این حالت ممکن است منجر به رفتار نادرست برنامه شود. برای جلوگیری از این مشکل، کاربر باید در پایان اجرای کد به‌صورت دستی اتصال پیش‌فرض را آزاد کند.

Java: پشتیبانی از تنظیم Locale برای ریسمان جاری

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

Aspose.Email امکان تنظیم Locale برای ریسمان جاری را فراهم می‌کند. Aspose.Email یک کلاس ارائه می‌دهد CurrentThreadSettings که ارائه می‌دهد setLocale متدی برای این منظور. قطعه کد زیر استفاده از CurrentThreadSettings کلاسی برای تنظیم Locale فعلی. قطعه کد ابتدا Locale را به مقدار نامعتبر تنظیم می‌کند و سپس از CurrentThreadSettings.setLocale متدی برای تنظیم Locale برای ریسمان جاری.

Locale defaultLocale = Locale.getDefault();
try {
    // set incorrect default Locale
    Locale.setDefault(new Locale("en", "RU"));
    // set Current Thread Locale
    CurrentThreadSettings.setLocale("en-US");
    // or
    // CurrentThreadSettings.setLocale(new Locale("en", "US"));

    PersonalStorage.create(dataDir + "test.pst", FileFormatVersion.Unicode);
} finally {
    Locale.setDefault(defaultLocale);
}

Java: جزئیات مهم iCalendar RFC 2445

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

درباره مدل شیء Aspose iCalendar

Aspose.Email شامل تمام کلاس‌های فراهم‌شده توسط Aspose می‌باشد iCalendar component RecurrencePattern و RecurrenceRule کلاس‌های مرکزی Aspose iCalendar، و پیاده‌سازی‌های ملموس از عناصر متناظر RFC 2445 را ارائه دهید.

این RecurrencePattern کلاس نمایانگر کل الگوی تکرار است. می‌توانید یک الگوی تکرار جدید را از ابتدا با استفاده از سازنده پیش‌فرض ایجاد کنید یا الگوی موجود را در CalendarRecurrence. این RecurrenceRule کلاس نمایانگر بخش RRULE یا EXRULE از یک الگوی تکرار است. RecurrenceRule تعداد زیادی از ویژگی‌ها را که مستقیماً به معادل‌های آن‌ها در استاندارد iCalendar نقشه می‌شوند، ارائه می‌دهد. برای مثال، ByMonth به BYMONTH در iCalendar نقشه می‌شود و غیره. با بررسی یا تنظیم مقادیر RecurrenceRule خاصیت‌هایی که می‌توانید یک قانون تکرار را تجزیه و تحلیل یا اصلاح کنید. برای اطلاعات بیشتر و نمونه‌های کد، ببینید RecurrencePattern و RecurrenceRule در مستندات API.

جزئیات مهم iCalendar RFC 2445

این بخش شامل موضوعات زیر است:

قالب‌های تاریخ و زمان.
DATE.
DATE‑TIME با زمان محلی.
DATE‑TIME با زمان UTC.
DATE‑TIME با زمان محلی و منطقه زمانی.
BYWEEKNO سازگاری با ISO 8601 را فراهم می‌کند

قالب‌های تاریخ و زمان

تاریخ‌ها یا تاریخ‌ها همراه با زمان‌های مرتبط می‌توانند در عناصر DTSTART، UNTIL، EXDATE و RDATE هنگام تعیین الگوی تکرار استفاده شوند. iCalendar نوع مقدار DATE را برای شناسایی مقادیری که شامل یک تاریخ تقویمی هستند تعریف می‌کند و همچنین نوع مقدار DATE‑TIME را برای شناسایی مقادیری که تاریخ دقیق و زمان روز را مشخص می‌کنند، تعریف می‌نماید. مقادیر DATE‑TIME می‌توانند در سه قالب مشخص شوند، با:

زمان محلی.
زمان UTC.
زمان محلی و منطقه زمانی.

DATE

بر اساس استاندارد iCalendar، مقادیر DATE باید قالب yyyyMMdd را دنبال کنند. مثال زیر تاریخ ۱۴ ژوئیه ۱۹۹۷ را نشان می‌دهد: 19970714

DATE‑TIME با زمان محلی

فرم تاریخ با زمان محلی صرفاً یک مقدار تاریخ‑زمان است که نشانگر UTC را ندارد و به منطقه زمانی ارجاع نمی‌دهد. به عنوان مثال، رشته زیر تاریخ ۱۸ ژانویه ۱۹۹۸ ساعت ۲۳:۰۰ (۱۱ شب) را نشان می‌دهد: DTSTART:19980118T230000. مقادیر تاریخ‑زمان از این نوع به‌عنوان «شناور» شناخته می‌شوند و به‌هیچ منطقه زمانی خاصی متصل نیستند. آنها برای نمایاندن همان مقدار ساعت، دقیقه و ثانیه صرف نظر از منطقه زمانی که در حال حاضر مشاهد می‌شود، استفاده می‌شوند.

DATE‑TIME با زمان UTC

تاریخ با زمان UTC یا زمان مطلق توسط حرف بزرگ لاتین Z به‌عنوان پسوند که نشانگر UTC است، به مقدار زمان افزوده می‌شود. برای مثال، رشته زیر تاریخ ۱۹ ژانویه ۱۹۹۸ ساعت ۰۷:۰۰ UTC را نشان می‌دهد: DTSTART:19980119T070000Z لطفاً توجه داشته باشید که Aspose iCalendar پسوند Z فرمت UTC را نادیده می‌گیرد و زمان را به‌عنوان زمان محلی درنظر می‌گیرد. استاندارد RFC2445 می‌گوید که بخش زمانی مشخص‌شده در قانون UNTIL یک الگوی تکرار باید به فرمت UTC باشد. این یک بیان بسیار عجیب است و در واقع، مثال‌هایی در استاندارد وجود دارد که به‌درستی محاسبه نشده‌اند. Aspose iCalendar در قانون UNTIL زمان را در هر فرمتی می‌پذیرد.

DATE‑TIME با زمان محلی و منطقه زمانی

برای ارجاع به منطقه زمانی، DATE‑TIME با ویژگی TZID اصلاح می‌شود. برای مثال، رشته زیر ساعت ۲ صبح در نیویورک در تاریخ ۱۹ ژانویه ۱۹۹۸ را نشان می‌دهد: DTSTART;TZID=US-Eastern:19980119T020000. لطفاً توجه داشته باشید که Aspose iCalendar در حال حاضر پارامتر TZID را نادیده می‌گیرد و زمان را به‌عنوان زمان محلی درنظر می‌گیرد.

BYWEEKNO سازگاری با ISO 8601 را فراهم می‌کند

از BYWEEKNO فقط زمانی استفاده کنید که با ISO 8601 نیاز است. شماره‌های هفته بر اساس ISO 8601 بسیار متفاوت از شماره‌های هفته به معنای معمول هستند. بر وفقان ISO 8601، شماره هفته یک سال تقویمی اولین هفته‌ای است که حداقل چهار روز دارد. این قانون الگوریتم را برای برنامه‌هایی که نیاز به سازگاری با ISO 8601 دارند خاص می‌کند و تقریباً برای کاربردهای دیگر غیرقابل استفاده می‌شود. ISO 8601 توسط برخی برنامه‌های بانکی و مالی اروپایی پشتیبانی می‌شود. همچنین در تلویزیون برای رزرو تبلیغات استفاده می‌شود. قانون BYWEEKNO یک فهرست عددی جدا شده با کاما را که هفتۀ‌های سال را شناسایی می‌کند، مشخص می‌نماید. مقادیر معتبر ۱ تا ۵۳ و ۱ تا ۵۳ هستند. این با هفتۀ‌ها مطابق شماره‌گذاری هفته تعریف شده در ISO 8600 مطابقت دارد. BYWEEKNO فقط برای قوانین YEARLY معتبر است.

Java: تجزیه فایل‌های پیام Microsoft Outlook

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

با Aspose.Email می‌توانید پیام‌های Microsoft Outlook را تنها در چند خط کد تجزیه کنید. این مقاله نشان می‌دهد چگونه. Aspose.Email کلاس‌هایی برای انجام بسیاری از وظایف برنامه‌نویسی با پیام‌های Outlook دارد. مثال کد زیر نشان می‌دهد چگونه می‌توان:

بارگذاری یک پیام ایمیل.
دریافت موضوع ایمیل.
دریافت نام فرستنده.
دریافت بدنه کامل پیام.
بررسی وجود پیوست‌ها.
دریافت نام فایل‌های هر پیوست و ذخیره آنها.

کد نمونه زیر نشان می‌دهد چگونه فایل‌های پیام Microsoft Outlook را تجزیه کنید.

// The path to the File directory and Load Microsoft Outlook email message file
String dataDir = "data/";
MapiMessage msg = MapiMessage.fromFile(dataDir + "message3.msg");

// Obtain subject of the email message, sender, body and Attachment count
System.out.println("Subject:" + msg.getSubject());
System.out.println("From:" + msg.getSenderName());
System.out.println("Body:" + msg.getBody());
System.out.println("Attachment Count:" + msg.getAttachments().size());

// Iterate through the attachments
for (MapiAttachment attachment : msg.getAttachments()) {
    // Access the attachment's file name and Save attachment
    System.out.println("Attachment:" + attachment.getFileName());
    attachment.save(dataDir + attachment.getLongFileName());
}

Java: دریافت اعلان‌ها برای پیام‌های ارسال شده با موفقیت و پیام‌های ناموفق

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

هنگامی که می‌خواهید اعلان تحویل را برای هر دو پیام ارسال‌شده با موفقیت و ناموفق دریافت کنید، می‌توانید از عملگر لوله (|) برای DeliveryNotificationOptions ویژگی MailMessage کلاس. قطعه کد زیر نشان می‌دهد چگونه اعلان‌ها برای پیام‌های ارسال‌شده با موفقیت و ناموفق را دریافت کنید.

// Create the message
MailMessage msg = new MailMessage();
msg.setFrom(MailAddress.to_MailAddress("sender@sender.com"));
msg.setTo(MailAddressCollection.to_MailAddressCollection("receiver@receiver.com"));
msg.setSubject("the subject of the message");

// Set delivery notifications for success and failed messages and Add the MIME headers
msg.setDeliveryNotificationOptions(DeliveryNotificationOptions.OnSuccess | DeliveryNotificationOptions.OnFailure);
msg.getHeaders().add("Read-Receipt-To", "sender@sender.com");
msg.getHeaders().add("Disposition-Notification-To", "sender@sender.com");

// Send the message
SmtpClient client = new SmtpClient("host", "username", "password");
client.send(msg);

Java: تشخیص پیام‌های ایمیل جدید در سرور POP3

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

با حساب‌های POP3 می‌توانید هنگام دانلود و خواندن پیام‌ها آنها را بر روی سرور باقی بگذارید. باقی گذاشتن ایمیل‌ها بر روی سرور به این معنی است که آنها برای برنامه‌ها و افراد دیگر در دسترس هستند، برای مثال کاربرانی که ایمیل خود را از چند دستگاه دسترسی دارند. یا ممکن است فقط پیام‌هایی را که معیار خاصی دارند، مثلاً پیام‌های با موضوع خاص، دانلود کنید. برای مدیریت ایمیل، می‌توانید؛

تمام پیام‌ها را از سرور ایمیل POP3 با استفاده از Aspose.Email بخوانید.
پیام‌ها را به پایگاه داده محلی خود دانلود کنید.

پیام‌ها حذف نمی‌شوند بلکه بر روی سرور باقی می‌مانند. وقتی برای اولین بار اجرا می‌شود، این فرآیند به خوبی کار می‌کند. تمام پیام‌های مورد نیاز به پایگاه داده دانلود می‌شوند. اما بار دوم که اجرا می‌شود، همان پیام‌ها دوباره دانلود می‌شوند زیرا هنوز بر روی سرور ایمیل حضور دارند. این منجر به رکوردهای تکراری می‌شود. برای حل این مشکل، از Pop3MessageInfo.UniqueID ویژگی برای بررسی این که آیا یک پیام قبلاً دانلود شده است یا خیر. شناسه منحصر به‌فرد پیام باید در پایگاه داده ذخیره شود: این کلید جستجو برای تشخیص پیام‌های جدید است.

تشخیص پیام‌های جدید

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

اتصال به سرور.
دریافت فهرست ایمیل‌ها.
اتصال به پایگاه داده.
دریافت فهرست ایمیل‌ها.
مقایسه فهرست‌ها.
ذخیره ایمیل‌های جدید در پایگاه داده.

فرآیند سرعت بیشتری دارد زمانی که:

دریافت تمام شناسه‌های منحصر به‌فرد پیام‌ها در جدول هش.
در حلقه for(…) به جای جستجو در پایگاه داده برای هر پیام ایمیل، جدول هش را جستجو کنید.

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

public static void run() {
    try {
        // Connect to the POP3 mail server and check messages.
        Pop3Client pop3Client = new Pop3Client("pop.domain.com", 993, "username", "password");

        // List all the messages
        Pop3MessageInfoCollection msgList = pop3Client.listMessages();
        for (Pop3MessageInfo msgInfo : msgList) {
            // Get the POP3 message's unique ID
            String strUniqueID = msgInfo.getUniqueId();

            // Search your local database or data store on the unique ID. If a match is found, that means it's already downloaded. Otherwise download and save it.
            if (searchPop3MsgInLocalDB(strUniqueID) == true) {
                // The message is already in the database. Nothing to do with this message. Go to next message.
            } else {
                // Save the message
                savePop3MsgInLocalDB(msgInfo);
            }
        }
    } catch (Exception ex) {
        System.err.println(ex);
    }

}

private static void savePop3MsgInLocalDB(Pop3MessageInfo msgInfo) {
    // Open the database connection according to your database. Use public properties (for example msgInfo.Subject) and store in database,
    // for example, " INSERT INTO POP3Mails (UniqueID, Subject) VALUES ('" + msgInfo.UniqueID + "' , '" + msgInfo.Subject + "') and Run the query to store in database.
}

private static boolean searchPop3MsgInLocalDB(String strUniqueID) {
    // Open the database connection according to your database. Use strUniqueID in the search query to find existing records,
    // for example, " SELECT COUNT(*) FROM POP3Mails WHERE UniqueID = '" + strUniqueID + "' Run the query, return true if count == 1. Return false if count == 0.
    return false;
}

Java: تنظیم رمزگذاری متن پیش‌فرض در پیام ایمیل

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

این مقاله معرفی می‌کند MailMessage.PreferredTextEncoding ویژگی و توضیح نحوه استفاده از آن. با استفاده از این ویژگی، می‌توانید رمزگذاری متن پیش‌فرض را برای ویژگی‌های زیر تنظیم کنید:

از: نام نمایش
به: نام نمایش
Subject
بدنه

تنظیم رمزگذاری متن پیش‌فرض

در نسخه‌های قبلی Aspose.Email، رمزگذاری متن برای ویژگی‌های from، to، subject و body به‌صورت جداگانه تنظیم می‌شد. برای بهبود قابلیت استفاده، ما ویژگی PreferredTextEncoding ویژگی‌ای که همه را به‌صورت یک‌باره تنظیم می‌کند. اکنون راحت‌تر است اطمینان حاصل کنید که تمام متن‌های موجود در ویژگی‌های فوق به‌درستی در پیام ایمیل رمزگذاری شده‌اند. کد نمونه زیر نشان می‌دهد چگونه یک کلمه فرانسه را به عنوان نام قابل نمایش برای آدرس‌های ایمیل، موضوع و متن استفاده کنید.

// Create an instance of MailMessage
String fileName = "data/";
MailMessage msg = new MailMessage();

// Set the default or preferred encoding. This encoding will be used as the default for the from/to email addresses, subject and body of message.
msg.setPreferredTextEncoding(Charset.forName("cp1252"));

// Set email addresses, subject and body
msg.setFrom(new MailAddress("dmo@domain.com", "démo"));
msg.getTo().addItem(new MailAddress("dmo@domain.com", "démo"));
msg.setSubject("démo");
msg.setHtmlBody("démo");
msg.save(fileName + "SetDefaultTextEncoding_out.msg", SaveOptions.getDefaultMsg());

Java: تبدیل فایل پیام Outlook (MSG) به تصویر TIFF

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

تبدیل فایل MSG Outlook به تصویر TIFF در Aspose.Email برای Java پشتیبانی نمی‌شود.

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

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

این مقاله نشان می‌دهد چگونه از یک سند Microsoft Word به‌عنوان محتوای ایمیل استفاده کنید و آن را به دریافت‌کنندگان ارسال کنید. سند نمونه یک فاکتور فروش از دیتابیس نمونه Northwind است که به فرمت Microsoft Word صادر شده است. Aspose.Email برای Java با پروتکل‌های شبکه و ویژگی‌های Microsoft Outlook کار می‌کند و نمی‌تواند اسناد Microsoft Word را پردازش کند. برای رفع این محدودیت، نمونه‌های این مقاله از Aspose.Words for Java برای بارگذاری سند Word و تبدیل آن به قالب MHTML. Aspose.Email برای Java از سند MHTML در متن ایمیل استفاده می‌کند.

استفاده از اسناد Microsoft Word به‌عنوان متن ایمیل

نمونه‌های برنامه‌نویسی زیر نشان می‌دهند چگونه یک سند Word را به‌عنوان متن ایمیل با استفاده از Aspose.Words برای Java و Aspose.Email برای Java ارسال کنید:

بارگذاری یک سند Microsoft Word با استفاده از Aspose.Word برای Java’s Document کلاس.
ذخیره آن در قالب MHTML.
بارگذاری سند MHTML با استفاده از Aspose.Email برای Java’s MailMessage کلاس برای تنظیم متن ایمیل.
تنظیم ویژگی‌های دیگر پیام با استفاده از MailMessage ویژگی‌ها و متدهای کلاس.
ارسال ایمیل با استفاده از Aspose.Email برای Java’s SMTPClient کلاس.

سند منبع، یک فاکتور فروش که از نمونه Microsoft Northwind به Microsoft Word استخراج شده است، در زیر قابل مشاهده است.

هنگامی که پیام در Microsoft Outlook ارسال و دریافت شود، شبیه پیام زیر به نظر می‌رسد.

قالب‌بندی HTML و تصاویر همان‌طور که در سند اصلی هستند، در هنگام مشاهده در Outlook یا یک کلاینت ایمیل وب مانند Gmail یا Hotmail حفظ می‌شوند. در زیر یک اسکرین‌شات از پیام هنگام باز شدن با Gmail در مرورگر Chrome نشان داده شده است.

قطعه کد زیر نشان می‌دهد چگونه از یک سند Microsoft Word به‌عنوان متن پیام استفاده کنید و ایمیل را با استفاده از SmtpClient نمونهٔ کلاس.

// The path to the File directory
String dataDir = "data/";

// Load a Word document from disk and save it to stream as MHTML
Document wordDocument = new Document(dataDir + "Test.doc");
ByteArrayOutputStream mhtmlStream = new ByteArrayOutputStream();
wordDocument.save(mhtmlStream, SaveFormat.MHTML);

// Load the MHTML in a MailMessage object
MailMessage message = MailMessage.load(new ByteArrayInputStream(mhtmlStream.toByteArray()), new MhtmlLoadOptions());
message.setSubject("Sending Invoice in Email");
message.setFrom(new MailAddress("sender@gmail.com"));
message.setTo(MailAddressCollection.to_MailAddressCollection("recipient@gmail.com"));

// Save the message in MSG format to disk
message.save(dataDir + "WordDocAsEmailBody_out.msg", SaveOptions.getDefaultMsgUnicode());

    // Send the email message
try (SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "sender@gmail.com", "pwd")) {
    client.setSecurityOptions(SecurityOptions.SSLExplicit);
    client.send(message);
}

Java: امکانات چاپ Aspose.Email

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

امکانات چاپ

قابلیت Printing Features در Aspose.Email برای جاوا پشتیبانی نمی‌شود.

Java: تولید رخدادها از الگوی تکرار

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

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

محاسبه رخداد بعدی یا n رخداد بعدی

برای دریافت رخداد "next" ، از متد GenerateOccurrences با پارامتر nNextOccurrences = 1 استفاده کنید. کد نمونه زیر نشان می‌دهد چگونه با استفاده از nNextOccurrences = 20، 20 رخداد تولید می‌شود. خروجی کد زیر به شرح زیر است:

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

CalendarRecurrence recurrencePattern = new CalendarRecurrence();

recurrencePattern.setStartDate(sdf.parse("1997-09-10 09:00:00"));
RecurrenceRule rule = recurrencePattern.getRRules().add();
rule.setFrequency(Frequency.Monthly);
rule.setCount(20);
rule.setInterval(18);
rule.getByMonthDay().add(new int[] { 10, 11, 12, 13, 14, 15 });
DateCollection expectedDates = recurrencePattern.generateOccurrences(20);
System.out.println("expectedDates.Count = " + expectedDates.size());
for (int i = 0; i < expectedDates.size(); i++) {
    System.out.println("DateTime = " + sdf.format(expectedDates.getItem(i)));
}

دریافت متن کاربرپسند برای یک تکرار

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

RecurrenceRule rule = recurrencePattern.getRRules().add();
rule.setFrequency(Frequency.Monthly);
rule.setCount(2);
rule.getByMonthDay().add(1);
rule.getByMonthDay().add(-1);
System.out.println(rule.getFriendlyText());

Java: دسترسی به سرویس‌های ایمیل با استفاده از OAuth

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

پشتیبانی از OAuth 2.0 به Aspose.Email اضافه شده است و می‌تواند برای دسترسی به سرورهای SMTP، POP3، IMAP و EWS استفاده شود. به طور کلی، تمام سرورهایی که توکن‌های حامل OAuth 2.0 را پشتیبانی می‌کنند می‌توانند با Aspose.Email استفاده شوند، اما کلاینت‌های ایمیل ما با سرورهای ایمیل گوگل و سرورهای Microsoft Office 365 آزمایش شده‌اند. دسترسی به سرور از طریق SmtpClient, Pop3Client, ImapClient و EWSClient با OAuth می‌تواند به دو روش پیاده‌سازی شود.

توکن دسترسی را مستقیماً به سازندهٔ کلاینت ایمیل ارائه کنید. در این حالت، کاربر باید بداند که طول عمر توکن‌های دسترسی محدود است. هنگامی که توکن منقضی شود، کلاینت ایمیل نمی‌تواند برای دسترسی به سرور استفاده شود.
ارائه یک پیاده‌سازی سفارشی از ارائه‌دهنده توکن بر پایه ITokenProvider رابط کاربری به سازندهٔ کلاینت ایمیل. در این حالت، کلاینت زمان انقضای توکن را بررسی می‌کند و درخواست می‌کند ITokenProvider برای دریافت توکن دسترسی جدید زمانی که توکن قبلی منقضی شده باشد. به این ترتیب، کلاینت به‌طور دوره‌ای توکن‌ها را تازه‌سازی می‌کند و می‌تواند برای زمان نامحدود با سرور کار کند. اکثر سرویس‌ها روش ساده‌ای برای تازه‌سازی توکن‌های دسترسی ارائه می‌دهند. برای مثال، استفاده از توکن‌های تازه‌سازی در سرویس‌های گوگل یا جریان احراز هویت ROPC در پلتفرم هویت مایکروسافت می‌تواند برای پیاده‌سازی ارائه‌دهنده توکن استفاده شود.

پیکربندی حساب بر روی سرور مناسب

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

برای Office 365
برای جیمیل

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

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

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.Auto)) {

}

دسترسی به سرویس‌های ایمیل با ارائه‌دهندگان توکن

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

ITokenProvider tokenProvider = TokenProvider.Google.getInstance(
        "ClientId",
        "ClientSecret",
        "RefreshToken");

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

پیاده‌سازی ITokenProvider سفارشی برای Office 365

می‌توانید از پیاده‌سازی ارائه‌دهنده توکن زیر برای دسترسی به سرویس‌های ایمیل Office 365 استفاده کنید.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> geToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

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

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
        "Tenant",
        "ClientId",
        "ClientSecret",
        "EMail",
        "Password",
        scopes);

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.office365.com",
        587,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "outlook.office365.com",
        993,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "outlook.office365.com",
        995,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

// Connecting to EWS server
final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
try (IEWSClient ewsClient = EWSClient.getEWSClient(mailboxUri, credentials)) {

}

Java: استفاده از OAuth برای دسترسی به سرویس‌های ایمیل

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

توکن دسترسی را مستقیماً به سازندهٔ کلاینت ایمیل ارائه کنید. در این حالت، کاربر باید بداند که طول عمر توکن‌های دسترسی محدود است. هنگامی که توکن منقضی شود، کلاینت ایمیل نمی‌تواند برای دسترسی به سرور استفاده شود.
ارائه یک پیاده‌سازی سفارشی از ارائه‌دهنده توکن بر پایه ITokenProvider رابط کاربری به سازندهٔ کلاینت ایمیل. در این حالت، کلاینت زمان انقضای توکن را بررسی می‌کند و درخواست می‌کند ITokenProvider برای دریافت توکن دسترسی جدید زمانی که توکن قبلی منقضی شده باشد. به این ترتیب، کلاینت به‌طور دوره‌ای توکن‌ها را تازه‌سازی می‌کند و می‌تواند برای زمان نامحدود با سرور کار کند. اکثر سرویس‌ها روش ساده‌ای برای تازه‌سازی توکن‌های دسترسی ارائه می‌دهند. برای مثال، استفاده از توکن‌های تازه‌سازی در سرویس‌های گوگل یا جریان احراز هویت ROPC در پلتفرم هویت مایکروسافت می‌تواند برای پیاده‌سازی ارائه‌دهنده توکن استفاده شود.

پیکربندی حساب بر روی سرور مناسب

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

برای Office 365
برای جیمیل

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

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

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.Auto)) {

}

دسترسی به سرویس‌های ایمیل با ارائه‌دهندگان توکن

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

ITokenProvider tokenProvider = TokenProvider.Google.getInstance(
        "ClientId",
        "ClientSecret",
        "RefreshToken");

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

پیاده‌سازی ITokenProvider سفارشی برای Office 365

می‌توانید از پیاده‌سازی ارائه‌دهنده توکن زیر برای دسترسی به سرویس‌های ایمیل Office 365 استفاده کنید.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> geToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

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

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
        "Tenant",
        "ClientId",
        "ClientSecret",
        "EMail",
        "Password",
        scopes);

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.office365.com",
        587,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "outlook.office365.com",
        993,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "outlook.office365.com",
        995,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

// Connecting to EWS server
final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
try (IEWSClient ewsClient = EWSClient.getEWSClient(mailboxUri, credentials)) {

}

مجوزهای دسترسی به Office 365 از طریق IMAP، POP3 یا SMTP

ما نیاز داریم مجوزهای صحیح API را اعمال کنیم و موافقت مدیر را برای دسترسی به سرویس‌های ایمیل Office 365 اعطا کنیم:

در ویزارد مجوزهای API / افزودن یک مجوز، Microsoft Graph را انتخاب کنید و سپس مجوزهای Delegated را برای یافتن دامنه‌های مجوز زیر انتخاب کنید:

offline_access
IMAP.AccessAsUser.All
POP.AccessAsUser.All
SMTP.Send

مثال ارائه‌دهنده توکن:

ITokenProvider tokenProvider = new AzureROPCTokenProvider(OAuth.Tenant, OAuth.ClientId, OAuth.ClientSecret, User.EMail, User.Password,
        new String[] {
                "offline_access",
                "https://outlook.office.com/IMAP.AccessAsUser.All", // IMAP scope
                "https://outlook.office.com/POP.AccessAsUser.All",  // POP3 scope
                "https://outlook.office.com/SMTP.Send"              // SMTP scope
        });

Java: استخراج داده‌های اشیای توکار

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

گاهی داده‌های OLE Embedded به‌صورت پیوست "oleData.mso" توسط MapiAttachment و نیاز به استخراج دستی دارد. این فایل‌های oleData.mso فرمت Microsoft Computer Document File (MCDF) هستند و پشتیبانی از چنین فایل‌هایی فراتر از حوزه Aspose.Email است. با این حال، می‌توان از Aspose.Email به‌همراه کتابخانه‌های متن‌باز دیگر، مانند OpenMCDF، برای خواندن محتوای این فایل‌ها به منظور ذخیره بر روی دیسک استفاده کرد. Aspose.Email ارائه می‌دهد InlineAttachmentExtractor کلاسی برای شمارش بسته‌های MSO از داده‌های باینری oledata.mso که سپس می‌تواند برای استخراج محتوا توسط کتابخانه‌های خواندن فایل‌های مرکب استفاده شود.

اگر نوع بدنه پیام HTML (نه RTF) باشد و در پیام اشیای OLE وجود داشته باشد، ویژگی MapiPropertyTag.PR_ATTACH_DATA_OBJ غایب است. در این حالت، اطلاعات درباره اشیای OLE در oldedata.mso قرار دارد.

استخراج اشیای توکار

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

// The path to the File directory
String dataDir = "/data";

MapiMessage msg = MapiMessage.fromFile(dataDir + "double.msg");
for (MapiAttachment mapiAttachment : msg.getAttachments()) {
    if ("oledata.mso".equals(mapiAttachment.getLongFileName())) {
        IGenericDictionary<String, byte[]> oledata = InlineAttachmentExtractor.enumerateMsoPackage(new ByteArrayInputStream(mapiAttachment.getBinaryData()));

        for (String oleItem : oledata.getKeys()) {
            // Use binary data
            processBynaryData(oledata.get_Item(oleItem));
        }
    }
}

Java: ارسال درخواست جلسه با تکرار

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

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

تولید درخواست جلسه با تکرار

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

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String szUniqueId;

// Create a mail message
MailMessage msg1 = new MailMessage();
msg1.getTo().add("to@domain.com");
msg1.setFrom(new MailAddress("from@gmail.com"));

// Fill appointment object
Date startDate = sdf.parse("2013-12-01 17:00:00");
Date endDate = sdf.parse("2013-12-31 17:30:00");

// Create appointment object
Appointment agendaAppointment = new Appointment("same place", startDate, endDate, msg1.getFrom(), msg1.getTo());

// Create unique id as it will help to access this appointment later
szUniqueId = UUID.randomUUID().toString();
agendaAppointment.setUniqueId(szUniqueId);
agendaAppointment.setDescription("----------------");

// Create a weekly reccurence pattern object
WeeklyRecurrencePattern pattern1 = new WeeklyRecurrencePattern(14);

// Set weekly pattern properties like days: Mon, Tue and Thu
pattern1.setStartDays(new int[3]);
pattern1.getStartDays()[0] = CalendarDay.Monday;
pattern1.getStartDays()[1] = CalendarDay.Tuesday;
pattern1.getStartDays()[2] = CalendarDay.Thursday;
pattern1.setInterval(1);

// Set recurrence pattern for the appointment
agendaAppointment.setRecurrence(pattern1);

// Attach this appointment with mail
msg1.getAlternateViews().addItem(agendaAppointment.requestApointment());

// Create SmtpCleint
SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "your.email@gmail.com", "your.password");
client.setSecurityOptions(SecurityOptions.Auto);

// Send mail with appointment request
client.send(msg1);

// Return unique id for later usage
// return szUniqueId;

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

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

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Date startDate = sdf.parse("2013-12-12 17:00:00");
Date endDate = sdf.parse("2013-12-12 17:30:00");
Appointment appUpdate = new Appointment("Different Place", startDate, endDate, new MailAddress("newcustomeronnet@gmail.com"),
        MailAddressCollection.to_MailAddressCollection("kashif.iqbal@aspose.com"));
appUpdate.setUniqueId(szUniqueId);
WeeklyRecurrencePattern pattern3 = (WeeklyRecurrencePattern) appUpdate.getRecurrence();
appUpdate.setSummary("update meeting request summary");
appUpdate.setDescription("update");
MailMessage msgUpdate = new MailMessage("newcustomeronnet@gmail.com", "kashif.iqbal@aspose.com", "06 - test email - update meeting request", "test email");
msgUpdate.addAlternateView(appUpdate.updateAppointment());
SmtpClient smtp = new SmtpClient("server.domain.com", 587, "username", "password");
smtp.send(msgUpdate);

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

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

کلاینت‌های ایمیل مانند ImapClient و Pop3Client به کاربران اجازه می‌دهد تا در محیط چندریسه از آن‌ها استفاده کنند. کلاینت‌های ایمیل امکان داشتن یک یا چند اتصال با سرور را دارند. برای مدیریت مجموعه‌ای از اتصالات درون کلاینت‌ها از استخر اتصال استفاده می‌شود. تعداد اتصالاتی که می‌توانند همزمان ایجاد و استفاده شوند، توسط ویژگی CredentialsByHostClient.MaxConnectionsPerServer محدود می‌شود. این ویژگی می‌تواند به 1 یا مقدار بیشتری تنظیم شود. به طور پیش‌فرض این ویژگی برابر 10 است. یک صف دستورات برای اتصال پیاده‌سازی شده است تا از عملیات‌های چندریسه پشتیبانی کند. دستورات شامل ساده‌ترین عملیات‌های تعریف‌شده در پروتکل هستند، مانند Nooop، Authenticate و غیره. کاربر ممکن است تعداد دستورات بیشتری نسبت به تعداد اتصالات موجود شروع به اجرا کند، اما آن‌ها تنها زمانی اجرا می‌شوند که کلاینت بتواند برای عملیات اتصال ایجاد کند.

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

کلاینت‌های ایمیل رفتارهای زیر را دارند:

1. در صورتی که MaxConnectionsPerServer = 1 باشد، کلاینت یک اتصال ایجاد می‌کند، احراز هویت و مجوزدهی را انجام می‌دهد. این اتصال تا زمان از بین رفتن کلاینت در حالت کاری حفظ می‌شود. تمام عملیات‌ها از ریسمان‌های مختلف به یک صف دستورات که در اتصال اصلی قرار دارد هدایت می‌شوند.

2. در صورتی که MaxConnectionsPerServer > 1 باشد، کلاینت تعداد مورد نیاز اتصالات را ایجاد می‌کند و برای هر اتصال احراز هویت و مجوزدهی را انجام می‌دهد. یک اتصال به عنوان اتصال اصلی رزرو می‌شود. این اتصال تا زمانی که کلاینت از بین برود در حالت کاری حفظ می‌شود. سایر اتصالات بر حسب نیاز ایجاد و از بین می‌روند. حداکثر تعداد این اتصالات توسط ویژگی MaxConnectionsPerServer تعریف می‌شود، به طور مثال اگر MaxConnectionsPerServer = 2 باشد، یک اتصال به عنوان اصلی رزرو می‌شود و اتصال دوم به عنوان اضافه برای عملیات‌هایی که در ریسمان‌های دیگر اجرا می‌شوند استفاده می‌شود. به همین ترتیب اگر MaxConnectionsPerServer = 3 باشد، اولین اتصال به عنوان اصلی رزرو شده و دو اتصال دیگر به عنوان اضافه برای عملیات‌های اجرا شده در ریسمان‌های دیگر استفاده می‌شوند. در صورتی که درخواست بعدی برای اتصال از ریسمان جدیدی بیاید و تمام اتصالات در حال استفاده باشند، کلاینت تا کاهش تعداد اتصالات استفاده‌شده صبر می‌کند….

مثال‌ها

کاربر می‌تواند عملیات‌ها را در ریسمان‌های مختلف به چند روش اجرا کند. این روش‌ها به دو نوع تقسیم می‌شوند:

1. کاربر از متدهای ناهمزمان (Begin/End) تعریف شده در کلاینت استفاده می‌کند. در این حالت کلاینت ایمیل وقتی نیاز باشد ریسمان‌های جدیدی راه‌اندازی می‌کند. در کلاینت یک صف وظایف پیاده‌سازی شده است (لطفاً آن را با صف دستورات در اتصال اشتباه نگیرید). یک وظیفه می‌تواند اجرا شود اگر اتصال در دسترس باشد. زمانی که تعداد اتصالات استفاده‌شده کمتر از مقدار محدودیت می‌شود، کلاینت یک اتصال جدید ایجاد می‌کند، ریسمان برای وظیفه فعلی می‌سازد و این وظیفه را اجرا می‌کند. مثال استفاده از عملیات‌های ناهمزمان:

// 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 messages = client.listMessages();
IAsyncResult res1 = client.beginFetchMessage(messages.get_Item(0).getUniqueId());
IAsyncResult res2 = client.beginFetchMessage(messages.get_Item(1).getUniqueId());
MailMessage msg1 = client.endFetchMessage(res1);
MailMessage msg2 = client.endFetchMessage(res2);

2. کاربر می‌تواند ریسمان‌ها را با استفاده از اشیائی مانند Thread، ExecutorService یا هر شیء دیگری که برای این منظور در نظر گرفته شده است، ایجاد کند. همچنین کاربر می‌تواند از ریسمان‌های ایجاد شده در کدهای شخص ثالث استفاده کند. در این حالت کلاینت دو مدل رفتار دارد

a. اگر کاربر ایجاد اتصالات اضافه برای عملیات در ریسمان را در نظر نگرفته باشد، تمام عملیات‌های این ریسمان به صف دستورات برای اتصال اصلی ارسال می‌شوند. یک مثال از عملیات‌ها در یک ریسمان اضافه بدون ایجاد اتصال جدید، تمام تراکنش‌ها از طریق اتصال اصلی انجام می‌شود:

/**
 * Creates an executor service with a fixed pool size, that will time 
 * out after a certain period of inactivity.
 * 
 * @param poolSize The core- and maximum pool size
 * @param keepAliveTime The keep alive time
 * @param timeUnit The time unit
 * @return The executor service
 */
private static ExecutorService createFixedTimeoutExecutorService(
    int poolSize, long keepAliveTime, TimeUnit timeUnit)
{
    ThreadPoolExecutor e = 
        new ThreadPoolExecutor(poolSize, poolSize,
            keepAliveTime, timeUnit, new LinkedBlockingQueue<Runnable>());
    e.allowCoreThreadTimeOut(true);
    return e;
}

final List<MailMessage> list = new ArrayList<MailMessage>();

ExecutorService executor = createFixedTimeoutExecutorService(1, 1000, TimeUnit.MILLISECONDS);

executor.execute(new Runnable() {
    public void run() {
        client.selectFolder("folderName");
        ImapMessageInfoCollection messageInfoCol = client.listMessages();
        for (ImapMessageInfo messageInfo : messageInfoCol) {
            list.add(client.fetchMessage(messageInfo.getUniqueId()));
        }
    }
});

b. وقتی کاربر متدی را اجرا می‌کند تا اتصال جدیدی برای ریسمان اضافه ایجاد کند، این ریسمان تا زمانی که مقدار سهمیه برای اتصالات جدید تغییر کند مسدود می‌شود تا اتصال جدید مجاز شود. سپس اتصال جدید ایجاد می‌شود. این اتصال به عنوان اتصال پیش‌فرض برای تمام عملیات‌ها در این ریسمان تنظیم می‌گردد. پس از اتمام تمام عملیات‌ها در این ریسمان، باید اتصال را از بین برد. برای ایجاد اتصالات جدید از متد CredentialsByHostClient.CreateConnection استفاده کنید. این متد شی‌ای را برمی‌گرداند که اینترفیس IDisposable را پیاده‌سازی می‌کند. برای آزادسازی اتصال باید متد Dispose فراخوانی شود. ایجاد و از بین بردن اتصال باید در داخل ریسمانی که عملیات‌های ایمیل در آن اجرا می‌شود انجام شود. تلاش برای ایجاد اتصال جدید در ریسمانی که کلاینت ایمیل در آن ساخته شده است منجر به خطا می‌شود، زیرا این ریسمان در این لحظه نمی‌تواند برای ایجاد اتصال جدید استفاده شود. همچنین ایجاد اتصال جدید زمانی ممکن نیست که MaxConnectionsPerServer = 1 باشد. یک مثال کد برای ایجاد اتصال جدید در ریسمان اضافه:

final List<MailMessage> list = new ArrayList<MailMessage>();

ExecutorService executor = createFixedTimeoutExecutorService(1, 1000, TimeUnit.MILLISECONDS);

executor.execute(new Runnable() {
    public void run() {
        IConnection connection = client.createConnection();
        try {
            client.selectFolder(connection, "FolderName");
            ImapMessageInfoCollection messageInfoCol = client.listMessages(connection);
            for (ImapMessageInfo messageInfo : messageInfoCol)
                list.add(client.fetchMessage(connection, messageInfo.getUniqueId()));
        } finally {
            connection.dispose();
        }
    }
});

پیشنهادات

شایان ذکر است که اگر کاربر تمام دستورات را به اتصال اصلی ارسال کند، ممکن است وضعیتی پیش آید که دستورات از ریسمان‌های متفاوت با هم مخلوط شوند. کاربر باید بفهمد که کدام دستورات به ترتیب خود وابسته هستند و برای همگام‌سازی این دستورات اقدامات لازم را انجام دهد. همچنین لازم است امکان اجرای دستورات در جلسات متفاوت (IMAP/POP3) در نظر گرفته شود. عملیات‌های پرهزینه زمانی، مانند FetchMessage، AppendMessage و Send. احتمالاً منطقی است که این عملیات‌ها را با ریسمان و اتصال جدید انجام داد. اما عملیات‌های سریع مانند Delete منطقی است که با اتصال اصلی انجام شوند. لطفاً توجه داشته باشید که مقداردهی اولیه اتصال جدید یک عملیات زمان‌بر است.

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

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

سناریوهای استفاده از 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 دنبال کنید.

برنامه خود را طراحی کنید: یک رابط کاربری ایجاد کنید که سه فیلد From، To و Message را دریافت کند.
دوبار کلیک کنید روی دکمه Send در نمای طرح و کد خود را در ویرایشگر بنویسید.
یک نمونه از کلاس MailMessage ایجاد کنید و از ویژگی‌های آن برای ساختن یک پیام ایمیل استفاده کنید. (نمونه‌های کلاس MailMessage برای ساختن پیام‌های ایمیلی استفاده می‌شوند که برای تحویل به سرور SMTP از طریق کلاس SmtpClient ارسال می‌شوند).
یک نمونه از کلاس SmtpClient ایجاد کنید و از ویژگی‌های آن برای ارسال یک پیام ایمیل استفاده کنید.
برنامه خود را تست کنید.
آدرس‌ها را در فیلدهای From و To وارد کنید.
یک پیام را در فیلد Message Body تایپ کنید.
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 دنبال کنید.

یک نمونه از Pop3Client ایجاد کنید.
نام میزبان POP3، نام کاربری و رمز عبور را در این نمونه تنظیم کنید.
یک نمونه MailMessage ایجاد کنید و اولین ایمیل حساب کاربری خود را با فراخوانی تابع fetchMessage() به آن دریافت کنید. این کار اولین پیام را از حساب ایمیل شما به نمونه MailMessage منتقل می‌کند.
از ویژگی‌های 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، مراحل زیر را دنبال کنید.

یک نمونه از ImapClient با ارائه نام سرور IMAP، نام کاربری و رمز عبور ایجاد کنید.
متد selectFolder() شی ImapClient را صدا بزنید تا پوشه‌ای که می‌خواهید تعداد پیام‌های آن را بشمارید، انتخاب کنید.
حال خاصیت 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 نقطه اتصال دو مورد فوق است و پیام‌های ایمیل را تجزیه می‌کند.

Java: لغو درخواست‌های جلسه با تقویم

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

می‌توانید با استفاده از شیء کلاس Appointment در Aspose.Email یک درخواست لغو جلسه ارسال کنید. برای لغو درخواست به اطلاعات اصلی درخواست جلسه نیاز دارید. مثال در این مقاله ابتدا یک درخواست جلسه ارسال می‌کند، اطلاعات را در پایگاه داده ذخیره می‌کند و سپس درخواست را بر پایه شناسه پیام لغو می‌کند.

ارسال درخواست‌های جلسه

قبل از اینکه بتوانیم لغو درخواست‌های جلسه، ما باید برخی را ارسال کنیم:

ابتدا یک نمونه از نوع SmtpClient برای ارسال پیام ایجاد کنید.
تمام اطلاعات شرکت‌کنندگان را در مجموعه MailAddressCollection ذخیره کنید.
یک نمونه از کلاس MailMessage و ویژگی‌های ضروری مانند From، To و Subject ایجاد کنید.
یک نمونه از نوع Appointment ایجاد کنید و اطلاعات مکان، زمان شروع، زمان پایان، سازمان‌دهندگان و شرکت‌کنندگان را تعیین کنید.
تمام اطلاعات را در یک پایگاه داده ذخیره کنید. کارهای مربوط به پایگاه داده در متد SaveIntoDB انجام می‌شود.

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

class Attendees {
    public String MessageId;
    public String EmailAddress;
    public String DisplayName;
}

class Message {
    public String MessageId;
    public String From;
    public String Subject;
    public String Body;
    public String AppLocation;
    public Date AppStartDate;
    public Date AppEndDate;
    public String AppSummary;
    public String AppDescription;
}

public void send(Attendees[] attendeesArr, String from, String appLocation, Date appStartDate, Date appEndDate) {
    try {
        // Create an instance of SMTPClient
        SmtpClient client = new SmtpClient("MailServer", "Username", "Password");
        // Get the attendees
        MailAddressCollection attendees = new MailAddressCollection();
        for (Attendees a : attendeesArr) {
            attendees.addItem(new MailAddress(a.EmailAddress, a.DisplayName));
        }

        // Create an instance of MailMessage for sending the invitation
        MailMessage msg = new MailMessage();

        // Set from address, attendees
        msg.setFrom(new MailAddress(from));
        msg.setTo(attendees);

        // Create am instance of Appointment
        Appointment app = new Appointment(appLocation, appStartDate, appEndDate, new MailAddress(from), attendees);
        app.setSummary("Monthly Meeting");
        app.setDescription("Please confirm your availability.");
        msg.addAlternateView(app.requestApointment());

        // Save the info to the database
        if (saveIntoDB(msg, app) == true) {
            // Save the message and Send the message with the meeting request
            msg.save(msg.getMessageId() + ".eml", SaveOptions.getDefaultEml());
            client.send(msg);
            System.out.println("message sent");
        }
    } catch (Exception ex) {
        System.err.println(ex);
    }
}

private boolean saveIntoDB(MailMessage msg, Appointment app) {
    // Save Message and Appointment information
    Message messageRow = new Message();
    messageRow.MessageId = msg.getMessageId();
    messageRow.From = msg.getFrom().getAddress();
    messageRow.Subject = msg.getSubject();
    messageRow.Body = msg.getBody();
    messageRow.AppLocation = app.getLocation();
    messageRow.AppStartDate = app.getStartDate();
    messageRow.AppEndDate = app.getEndDate();
    messageRow.AppSummary = app.getSummary();
    messageRow.AppDescription = app.getDescription();
    addToDB(messageRow);

    // Save attendee information
    for (MailAddress address : app.getAttendees()) {
        Attendees attendeesRow = new Attendees();
        attendeesRow.MessageId = msg.getMessageId();
        attendeesRow.EmailAddress = address.getAddress();
        attendeesRow.DisplayName = address.getDisplayName();
        addToDB(attendeesRow);
    }

    return true;
}

لغو درخواست جلسه

برای لغو درخواست جلسه، ابتدا شناسه پیام ایمیل را به دست آورید. از آنجا که این اطلاعات برای این مثال در پایگاه داده ذخیره شده است، می‌توانیم به راحتی دوباره آن را دریافت کنیم.

انتخاب پیام برای ارسال درخواست لغو.
Send Cancel Request را کلیک کنید تا درخواست ارسال شود.
پایگاه داده را برای دریافت اطلاعات شرکت‌کنندگان، پیام و تقویم پرس و جو می‌کند.
یک نمونه از کلاس Calendar و کلاس MailMessage با استفاده از اطلاعات بازیابی‌شده از پایگاه داده ایجاد کنید.
از متد Appointment.cancelAppointment() برای ارسال درخواست لغو استفاده کنید.
ایمیل را با استفاده از SMTP ارسال کنید.

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

public void cancel(String messageId) {
    // Get the message and calendar information from the database get the attendee information

    // Get the attendee information in reader
    Attendees[] attendeesRows = getAttendeesFromDB(messageId);

    // Create a MailAddressCollection from the attendees found in the database
    MailAddressCollection attendees = new MailAddressCollection();
    for (Attendees attendeesRow : attendeesRows) {
        attendees.addItem(new MailAddress(attendeesRow.EmailAddress, attendeesRow.DisplayName));
    }
    // Get message and calendar information
    Message messageRow = getMessageFromDB(messageId);

    // Create the Calendar object from the database information
    Appointment app = new Appointment(messageRow.AppLocation, messageRow.AppSummary, messageRow.AppDescription, messageRow.AppStartDate, messageRow.AppEndDate,
            new MailAddress(messageRow.From), attendees);

    // Create message and Set from and to addresses and Add the cancel meeting request
    MailMessage msg = new MailMessage();
    msg.setFrom(new MailAddress(messageRow.From));
    msg.setTo(attendees);
    msg.setSubject("Cencel meeting");
    msg.addAlternateView(app.cancelAppointment());
    SmtpClient smtp = new SmtpClient("smtp.gmail.com", 587, "user@gmail.com", "password");
    smtp.send(msg);
    System.out.println("cancellation request successfull");
}

Java: اولین برنامه با Aspose.Email Outlook

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

این بخش نشان می‌دهد چگونه از Aspose.Email Mapi استفاده کنیم. یک برنامه کوچک ایجاد می‌کنیم که فایل پیام اوتلوک (TestMessage.msg) را بارگذاری کرده و موضوع، آدرس‌های فرستنده و گیرنده، و محتوای متن را نمایش می‌دهد. برای ایجاد اولین برنامه خود با استفاده از Aspose.Email Outlook این مراحل را دنبال کنید.

یک نمونه از MapiMessage کلاس با ارائه مسیر فایل پیام.
از ویژگی‌های عمومی برای نمایش موضوع، فرستنده، گیرنده و متن استفاده کنید.

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

// Load the outlook message file
MapiMessage msg = MapiMessage.fromFile("outlookmessage.msg");

// Use the public properties
//read subject
System.out.print("Subject:" + msg.getSubject());

//sender name
System.out.print("From:" + msg.getSenderName());

//message body
System.out.print("Body:" + msg.getBody());

//Attachments
for(MapiAttachment att : msg.getAttachments())
{
    System.out.print("Attachment Name:"+att.getFileName());
    att.save(att.getFileName());
}

Java: چگونه استثناها را نادیده بگیرید

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

پشتیبانی از نادیده‌گیری استثنا

ExceptionManager کلاس قابلیت نادیده‌گیری استثناها را فراهم می‌کند:

نمونه‌های کد:

تنظیم یک کال‌بک برای مدیریت استثناها:

ExceptionManager.setIgnoreExceptionsHandler(new IgnoreExceptionsCallback() {
    //exception path: {Module}\{Method}\{Action}\{GUID}
    //example: MailMessage\Load\DecodeTnefAttachment\64149867-679e-4645-9af0-d46566cae598
    public boolean invoke(AsposeException ex, String path) {
        //Ignore all exceptions on MailMessage.Load
        return path.equals("MailMessage\\Load");
    }
});

یا از یک جایگزین استفاده کنید:

//Ignore all exceptions
ExceptionManager.setIgnoreAll(true);

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

ExceptionManager.setIgnoreExceptionsLogHandler(new IgnoreExceptionsLogCallback() {
    public void invoke(String message) {
        System.out.println("=== EXCEPTION IGNORED === " + message);
    }
});

به کاربر اطلاع داده می‌شود که می‌توان استثنا را با یک پیام خطا نادیده گرفت. برای مثال:

Exceptioin message:

AsposeArgumentException: properties should not be empty.
If you want to ignore an exception and want to proceed further then you can use:
ExceptionManager.getIgnoreList().add("MailMessage\\Load\\DecodeTnefAttachment\\64149867-679e-4645-9af0-d46566cae598")
Invalid TNEF Attachment will be interpreted as regular attachment.