Documentation – اطلاعات پروتکل

Java: پروتکل ساده انتقال ایمیل (SMTP)

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

پروتکل ساده انتقال ایمیل (SMTP) برای انتقال پیام‌های ایمیل در اینترنت استفاده می‌شود. پورت پیش‌فرض برای SMTP عدد ۲۵ است. در پیام ایمیل یک یا چند گیرنده، موضوع، متن و سایر اشیای کدگذاری‌شده را مشخص می‌کنیم. سپس پیام به یک سرور SMTP از راه دور منتقل می‌شود. کلاینت با استفاده از آدرس IP یا نام دامنه و پورت ۲۵ به سرور SMTP از راه دور متصل می‌شود. احراز هویت با نام کاربری و رمز عبور انجام می‌گیرد. سرور SMTP می‌تواند اتصال‌های ناشناس را نیز بپذیرد که نیازی به احراز هویت ندارند. سپس سرور پیام را از طرف کلاینت به گیرندگان تحویل می‌دهد.

Java: پروتکل افزونه‌های چندمنظوره ایمیل اینترنتی (MIME)

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

Multipurpose Internet Mail Extensions (MIME) یک استاندارد اینترنتی است که فرمت ایمیل را برای پشتیبانی از موارد زیر گسترش می‌دهد:

متن در مجموعه کاراکتری غیر از US-ASCII؛
پیوست‌های غیرمتنی؛
بدنه‌های پیام چند بخشی؛ و
اطلاعات هدر در مجموعه کاراکتری غیر-ASCII.

SMTP فقط از کاراکترهای ۷ بیتی ASCII پشتیبانی می‌کند که عملاً به این معناست که تنها تعداد کوچکی از زبان‌ها پشتیبانی می‌شوند. زبان‌های مبتنی بر الفبای لاتین در SMTP به‌خوبی کار می‌کنند؛ اما زبان‌های دیگر هنگام تحویل ایمیل به‌درستی نمایش داده نمی‌شوند. با این حال، MIME پشتیبانی از کاراکترهای ASCII را در SMTP گسترش می‌دهد تا ایمیل‌های استفاده‌کننده از مجموعه کاراکتری دیگر، تصاویر و صداها بتوانند ارسال و نمایش یابند. به‌طور کلی، تمام کلاینت‌های ایمیل و سرورهای SMTP پیام‌های با فرمت MIME را به‌درستی تفسیر می‌کنند.

درک سرصفحه‌های MIME

سرصفحه‌های MIME شامل اطلاعاتی دربارهٔ پروتکل هستند.

MIME-Version

این نشان می‌دهد که پیام با فرمت MIME است. به صورت زیر ظاهر می‌شود:

MIME-Version: 1.0

Content-Type

این نشان‌دهندهٔ نوع محتوای پیام است که به صورت یک جفت نوع و زیرنوع ارائه می‌شود: به عنوان مثال text/plain، text/html. نوع محتوای multipart می‌تواند شامل متن، HTML، پیوست‌ها، تصاویر، صوت، ویدئو و غیره باشد.

Content-Type: multipart

Content-Transfer-Encoding

نشان می‌دهد آیا یک طرح رمزگذاری باینری‑به‑متن بر روی رمزگذاری تعیین‌شده توسط content-type استفاده شده است یا خیر. اگر استفاده شده باشد، نوع آن را بیان می‌کند. می‌توانیم در اینجا نوع کدگذاری ۷‑بیتی، ۸‑بیتی یا باینری را مشخص کنیم.

کلمه‌رمزگذاری‌شده

هدایل پیام‌های SMTP معمولاً از کاراکترهای ASCII استفاده می‌کنند. کاراکترهای غیر-ASCII باید از syntax کلمه رمزگذاری شده MIME به جای رشتهٔ متنی استفاده کنند. قالب به صورت زیر است:

"=? charset ? encoding ? encoded text ?=".

پیام‌های چندبخشی

یک پیام چندبخشی MIME شامل یک مرز (boundary) در هدر content-type است. این مرز که نباید در هیچ‌یک از بخش‌ها ظاهر شود، بین بخش‌ها و در ابتدا و انتهای بدنه پیام قرار می‌گیرد، به‌صورت زیر:

MIME-version: 1.0


 Content-type: multipart/mixed; boundary="frontier"

This is a multi-part message in MIME format.

--frontier

Content-type: text/plain

This is the body of the message.

--frontier

Content-type: application/octet-stream

Content-transfer-encoding: base64

PGh0bWw+CiAgPGhlYWQ+CiAgPC9oZWFkPgogIDxib2R5PgogICAgPHA+VGhpcyBpcyB0aGUg

Ym9keSBvZiB0aGUgbWVzc2FnZS48L3A+CiAgPC9ib2R5Pgo8L2h0bWw+Cg==

--frontier--

هر بخش شامل هدر محتوا و بدنه خودش است.

زیرنوع‌های چندبخشی

استاندارد MIME زیرنوع‌های مختلف پیام‌های چندبخشی را تعریف می‌کند. زیرنوع در هدر "Content-Type" پیام کلی مشخص می‌شود.

در زیر فهرستی از پرکاربردترین زیرنوع‌ها آمده است.

Mixed: multipart/mixed برای ارسال فایل‌هایی با هدرهای "Content-Type" متفاوت به‌صورت درون‌متنی استفاده می‌شود. اگر تصاویر یا فایل‌های دیگری که به‌راحتی قابل خواندن هستند ارسال شود، اکثر کلاینت‌های ایمیل آن‌ها را به‌صورت درون‌متنی نمایش می‌دهند.
Message: یک بخش پیام شامل یک ایمیل است.
Digest: digest روشی ساده برای ارسال چندین پیام متنی است. نوع محتوای پیش‌فرض برای هر بخش "message/rfc822" می‌باشد.
Alternative: زیرنوع alternative نشان می‌دهد که هر بخش یک نسخه "جایگزین" از همان محتوا (یا مشابه آن) است که هر کدام در قالب متفاوتی که توسط هدر "Content-Type" تعیین شده‌اند، قرار دارند.

معمولاً multipart/alternative برای ایمیل‌های دو بخشی استفاده می‌شود: یک بخش متن ساده (text/plain) و یک بخش HTML (text/html). بخش متن ساده سازگاری با نسخه‌های قبلی را فراهم می‌کند، در حالی که بخش HTML امکان استفاده از قالب‌بندی و پیوندهای فراونی را می‌دهد. بیشتر کلاینت‌های ایمیل گزینه‌ای برای ترجیح متن ساده نسبت به HTML دارند؛ این نمونه‌ای است از اینکه چگونه عوامل محلی می‌توانند بر انتخاب «بهترین» بخش پیام توسط برنامه تأثیر بگذارند.

برای اطلاعات بیشتر، از این پیوندها به آرشیوهای RFC استفاده کنید.

Java: iCalendar RFC 2445

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

RFC iCalendar 2445 مجموعه‌ای از عناصر تقویمی و زمان‌بندی سازگار را توصیف می‌کند که به برنامه‌های زمان‌بندی گروهی، مدیریت اطلاعات شخصی و تقویم‌ها اجازه می‌دهد تا اطلاعات را در قالبی مشترک تبادل کنند.

Aspose.Email عناصر مرتبط با زمان‌بندی را از RFC پیاده‌سازی می‌کند زیرا کاربرد وسیعی دارند. نسخه‌های آینده ممکن است عناصر دیگر RFC 2445 را بسته به تقاضا پیاده‌سازی کنند.

این مقاله عناصری از RFC که به Aspose.Email مرتبط هستند را توصیف می‌کند. توصیه می‌کنیم برای تصویر کامل به استاندارد iCalendar در http://www.faqs.org/rfcs/rfc2445.html مراجعه کنید.

الگوهای تکرار در دنیای واقعی

یک الگوی تکرار قوانین زمان وقوع رویداد را توصیف می‌کند. برای محاسبهٔ تاریخ‌ها و زمان‌های وقوع بر اساس یک الگوی تکرار، یک موتور الگوی تکرار مانند Aspose iCalendar لازم است. ما در بسیاری از موقعیت‌ها با برنامه‌ها یا الگوهای تکرار مواجه می‌شویم، به‌عنوان مثال:

ده جلسه تیمی، هر دوشنبه ساعت ۱۰ صبح.
پرداخت حقوق را در آخرین روز کاری هر ماه پردازش کنید.
دمأ بیمار را هر روز به مدت دو هفته بررسی کنید.
دوشنبه، چهارشنبه و جمعه به باشگاه بروید.
پشتیبان‌گیری هر ۴ ساعت یک‌بار در روزهای کاری اجرا شود.
تولید گزارش فروش در …
به‌روزرسانی آمار وب‌سایت هر … تقریباً هر رویدادی که به‌صورت دوره‌ای رخ می‌دهد می‌تواند به‌صورت الگوی تکرار نمایش داده شود. به‌عنوان مثال، کد زیر یک آرایه شامل ده بار تکرار مثال جلسه تیم قبلی را برمی‌گرداند:

CalendarRecurrence recurrencePattern = new CalendarRecurrence("DTSTART:20040301T100000\nRRULE:FREQ=WEEKLY;COUNT=10;BYDAY=MO");
DateCollection expectedDates = recurrencePattern.generateOccurrences();
System.out.println("expectedDates.Count = " + expectedDates.size());
for (int i = 0; i < expectedDates.size(); i++) {
    System.out.println("DateTime = " + sdf.format(expectedDates.getItem(i)));
}

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