مفهوم
تابع سرور و وبهوک؛ اتصال بیرونی را درست تعریف کن
تابع سرور منطق را خارج از مرورگر اجرا میکند؛ وبهوک، پیام یک رویداد بین سرویسهاست. برای اتصال پروژه، داده، دسترسی و رفتار خطا و تکرار را مشخص کن؛ وجود نمونهٔ تابع، تضمین سرویس وبهوک آماده نیست.
در این راهنما
#تابع سرور و وبهوک یکی نیستند
تابع سرور منطق را بیرون از مرورگر اجرا میکند. وبهوک پیام رویداد بین سرویسهاست. وجود یک الگوی تابع به معنی وجود سرویس آمادهٔ وبهوک خروجی با تضمین تلاش مجدد نیست.
#اتصال را مشخص تعریف کن
- چه رویدادی باعث ارسال میشود؟
- چه دادهای اجازهٔ خروج دارد؟
- راز و امضا کجا بررسی میشود؟
- موفقیت، شکست و تکرار همان رویداد چگونه تشخیص داده میشود؟
#قبل از دادهٔ واقعی
با محیط آزمایشی سرویس مقصد و شناسهٔ رویداد ساختگی شروع کن. پاسخ نامعتبر و قطع ارتباط را هم بررسی کن. تلاش مجدد نباید یک پرداخت یا رکورد را دوبار بسازد.
#از تعریف اتصال تا پیادهسازی
بعد از مشخصشدن قرارداد، مسیر اجرایی قابلیت موجود در پروژه را بررسی کن. برای هر اتصال، ورودی، محل نگهداری راز، محدودیت اجرا و رفتار خطا باید روشن باشد. وجود نمونهٔ تابع، فعالبودن همهٔ سرویسها یا تلاش مجدد خودکار را ثابت نمیکند.
#نمونه: ارسال درخواست مشاوره به سرویس دیگر
این سناریو آموزشی است، نه اتصال آماده: پس از ثبت موفق درخواست آزمایشی، فقط شناسه و موضوع مجاز به سرویس مقصد فرستاده شود. شناسهٔ رویداد کمک میکند دریافت دوباره همان رویداد، رکورد تازه نسازد. اول موفقیت و خطای مقصد را در محیط آزمایش بررسی کن.
| حالت | انتظار طراحی |
|---|---|
| دریافت معتبر | یک اثر مشخص و قابل پیگیری ثبت شود |
| دریافت تکراری | اثر قبلی دوباره ایجاد نشود |
| پاسخ نامعلوم | وضعیت نامعلوم ثبت شود؛ موفقیت قطعی نمایش داده نشود |
| امضای نامعتبر | رویداد پذیرفته نشود و دادهٔ خصوصی برنگردد |
#اگر به نتیجه نرسیدی
| نشانه | اقدام بعدی |
|---|---|
| رویداد دوبار پردازش میشود | شناسهٔ یکتای رویداد و جلوگیری از اثر تکراری را در قرارداد اتصال بررسی کن. |
| مقصد پاسخ نمیدهد | وضعیت ارسال را ثبت کن؛ تلاش مجدد خودکار را بدون قرارداد مشخص فرض نکن. |
قدم بعد