اندازهی قلم متن
تخمین مدت زمان مطالعهی مطلب:
چهار دقیقه
در بخش اول آشنایی با Feature Toggle، با مفهوم Feature Toggle آشنا شدیم و در بخش پایانی مقاله، به معرفی یکی از کتابخانههای نوشته شده توسط مایکروسافت پرداختیم.
فرض کنید یک قابلیت را تحت عنوان Chat پیاده سازی کرده و با توجه به تکنولوژیهایی که استفاده کردهاید، فقط با مرورگر کروم سازگار هست و شما باید این قابلیت را فقط برای کاربرانی که مروگر کروم دارند، فعال نمایید؛ در غیر اینصورت غیرفعال و در دسترس کاربران نباشد. برای این منظور فرض میکنیم کنترلر زیر مسئول تمام کارهای مربوط به قابلیت چت میباشد :
همانطور که در کد بالا قابل مشاهده میباشد ، کنترلر با یک Attribute مزین شدهاست که از Attributeهای توکار کتابخانه میباشد. با استفاده از این ویژگی میتوانیم یک کنترلر و یا اکشن متد را کلا از دسترس خارج کنیم (اگر مقدار این قابلیت در appsetting.json غیرفعال باشد).
برای حالتیکه نیاز هست اسم چندین قابلیت را به FeatureGate بدهیم، میتوانیم تعیین کنیم که آیا همهی قابلیتها باید فعال باشند تا کنترلر/ اکشن در دسترس باشد یا خیر؟ برای این منظور یک Enum توکار، به اسم RequirementType به همراه این کتابخانه وجود دارد که کار آن And/OR است:
همانطور که از توضیحات آن قابل تشخیص است، در زمان استفاده از FeatureGate میتوانیم با استفاده از این enum مشخص کنیم که اگر فقط یکی از قابلیتها فعال بود، کنترلر/اکشن موردنظر فعال و در دسترس باشد، در غیر اینصورت از دسترس خارج شود و تمامی درخواستها را با خطای 404 پاسخ دهد.
لازم به ذکر هست اینجا هم میتوان با مقداردهی خصویت requirement با یکی از مقدارهای Any و یا All، مشخص نماییم به صورت And اجرا شود یا خیر.
و سپس نیاز هست تا این هندلر را به صورت زیر ثبت نماییم :
در این مقاله به صورت کاربردیتر به استفاده از کتابخانهی مورد استفاده میپردازیم. برای ادامه نیاز هست بستهی زیر را که مخصوص برنامههای مبتنی بر ASP.NET CORE است نصب نمایید :
Install-package Microsoft.FeatureManagement.AspNetCore
[FeatureGate("chat")] public class ChatController : Controller { public IActionResult Index() { // do sth } }
اگر درخواستی به کنترلر Chat ارسال شود و قابلیت چت در فایل appsetting.json غیرفعال باشد (طبق روشهایی که در مقاله قبل توضیح داده شد) کاربر با خطای 404 مواجه خواهد شد.
میتوان به FeatuteGate اسم چندین قابلیت را داد و اگر همهی آنها فعال باشند، کنترلر/اکشن در دسترس خواهد بود؛ در غیر اینصورت خطای 404 دریافت میشود.
[FeatureGate("feature1", "feature2")] public class ChatController : Controller { public IActionResult Index() { // do sth } }
"FeatureManagement": { "feature1": true, "feature2": false },
public enum RequirementType { // // Summary: // The enabled state will be attained if any feature in the set is enabled. Any = 0, // // Summary: // The enabled state will be attained if all features in the set are enabled. All = 1 }
نمونهای از استفاده از این enum به صورت زیر است:
[FeatureGate(RequirementType.Any,"feature1", "feature2","feature3")] public class ChatController : Controller { public IActionResult Index() { // do sth } }
تگ <feature>
تا اینجا موفق شدیم یک کنترلر و یا اکشن متد را غیرفعال و از دسترس خارج نماییم. فرض کنید قابلیت چت بنا بر تنظیمات انجام شده، غیرفعال میباشد، منتها در منوی سایت همچنان لینک آن در حال نمایش است و کاربران میتوانند لینک را کیک کنند (و در نتیجه با خطای 404 مواجه میشوند). برای غیر فعال کردن المانهایی (تگ) مربوط به یک قابلیت، میتوانیم از tag helper مربوطه به صورت زیر استفاده نماییم :
@addTagHelper *, Microsoft.FeatureManagement.AspNetCore // put this line in _ViewImports <feature name="feature1,feature2,feature3"> <li> <a asp-area="" asp-controller="Chat" asp-action="index">Stay in contact</a> </li> </feature>
نوشتن Handler سفارشی
همانطور که در بالا هم بیان شد، اگر یک قابلیت به هر دلیلی غیرفعال باشد، کاربران با خطای 404 مواجه خواهند شد. اگر نیاز داشتید کاربر را به صفحهی دیگری هدایت کنید و یا Status Code بهتری را برگردانید، میتوانید اینکار را با پیاده سازی یک هندلر سفارشی که اینترفیس IDisabledFeaturesHandler را پیاده سازی میکند، انجام دهید. در زیر یک نمونه پیاده سازی شده را مشاهده میکنید:
public class RedirectDisabledFeatureHandler : IDisabledFeaturesHandler { public Task HandleDisabledFeatures(IEnumerable<string> features, ActionExecutingContext context) { context.Result = new RedirectResult("url"); return Task.CompletedTask; } }
public void ConfigureServices(IServiceCollection services) { services.AddFeatureManagement().UseDisabledFeaturesHandler(new RedirectDisabledFeatureHandler()); ; }