/
/
/
/
Wrapper محلی اختیاری یک الگوی توسعه برای قرار دادن منطق تکمیلی در اطراف Provider است. این الگو زمانی استفاده می‌شود که نیاز باشد قبل یا بعد از اجرای Provider، پردازش‌های خاصی انجام شود، بدون اینکه منطق اصلی Provider تغییر کند.
محتوای پیشرفته / فنی
Wrapper یک قابلیت عمومی جدید برای GraphBPMS نیست و نباید به‌عنوان جایگزین Provider یا API رسمی معرفی شود. استفاده از آن باید بر اساس نیاز واقعی پروژه و معماری سیستم انجام شود.
Wrapper محلی چیست؟
Wrapper محلی یک لایه میانی است که بین مصرف‌کننده و Provider قرار می‌گیرد و امکان اضافه کردن منطق تکمیلی را فراهم می‌کند.
در این مدل، Provider مسئول اصلی دریافت داده یا اجرای عملیات باقی می‌ماند و Wrapper فقط مسئول مدیریت رفتارهای جانبی یا پردازش‌های مورد نیاز پروژه است.
جایگاه Wrapper در معماری
Consumer
↓
Local Wrapper
↓
Provider
↓
Data Source
موارد استفاده از Wrapper
Wrapper می‌تواند برای سناریوهایی استفاده شود که نیاز به پردازش تکمیلی قبل یا بعد از اجرای Provider وجود دارد.
| سناریو | توضیح |
|---|---|
| پردازش ورودی | تغییر یا آماده‌سازی Parameterها قبل از ارسال به Provider |
| پردازش خروجی | تغییر یا آماده‌سازی Result قبل از استفاده مصرف‌کننده |
| مدیریت خطا | ثبت یا مدیریت رفتار خطا در سطح پروژه |
| ترکیب چند عملیات | هماهنگ کردن چند مرحله اجرایی در یک مسیر مشخص |
Wrapper در برابر تغییر مستقیم Provider
| رویکرد | نتیجه |
|---|---|
| تغییر مستقیم Provider | ممکن است روی تمام مصرف‌کنندگان Provider اثر بگذارد. |
| استفاده از Wrapper | منطق اختصاصی پروژه جدا از Provider اصلی نگهداری می‌شود. |
Best Practice
اگر تغییر مورد نیاز فقط برای یک سناریو یا مصرف‌کننده خاص است، استفاده از Wrapper می‌تواند از ایجاد وابستگی مستقیم به Provider اصلی جلوگیری کند.
محدودیت‌های Wrapper
- Wrapper نباید جایگزین Provider اصلی شود.
- نباید منطق پیچیده و غیرمرتبط با Provider در آن قرار گیرد.
- نباید به‌عنوان API رسمی GraphBPMS معرفی شود.
- باید مستندات و نگهداری آن مستقل و مشخص باشد.
نکات اجرایی
- هدف استفاده از Wrapper قبل از پیاده‌سازی مشخص شود.
- مرز مسئولیت Provider و Wrapper مشخص باشد.
- تغییرات Wrapper روی سناریوهای مصرف‌کننده تست شود.
- مستندات مربوط به رفتار Wrapper به‌روز نگه داشته شود.
Warning
Wrapper محلی یک الگوی پیاده‌سازی اختیاری است و نباید بدون نیاز واقعی باعث افزایش پیچیدگی معماری شود.