فصل 2 از 8 درس 20 از 22

مبانی و الگوهای سازنده

Singleton برای Logging

بخشی از آموزش جامع Design Patterns در C# و .NET

محتوای درس Singleton برای Logging

در این درس یک جنبه مهم از طراحی شیءگرا را با نگاه کاربردی بررسی می‌کنیم.

هدف یادگیری

  • بتوانید مفهوم «Singleton برای Logging» را با زبان خودتان توضیح دهید.
  • بتوانید مسئله‌ای را که این تکنیک حل می‌کند از روی کد تشخیص دهید.
  • بتوانید تشخیص دهید چه زمانی استفاده از آن اشتباه یا اضافه‌کاری است.

مسئله اصلی چیست؟

تضمین یک نمونه مشترک و نقطه دسترسی کنترل‌شده مسئله اصلی معمولاً زمانی شروع می‌شود که یک تصمیم طراحی در چند نقطه از سیستم تکرار می‌شود و هر تغییر، چند فایل و چند کلاس را درگیر می‌کند.

مدل ذهنی ساده

سناریوی ذهنی این درس: Registry یا Cache درون‌فرایندی محدود. به جای اینکه Client همه جزئیات را بداند، یک مرز طراحی ایجاد می‌کنیم تا بخش متغیر پشت یک قرارداد یا ساختار مشخص قرار بگیرد.

پیاده‌سازی نمونه در C#

نمونه کد آموزشی

نمونه کد این درس در بخش کد درس قرار داده شده است.

کد قبل از Refactoring چه بویی می‌دهد؟

  • if/switch بزرگ که با هر نوع جدید رشد می‌کند.
  • ساخت مستقیم وابستگی‌ها با new در لایه Business/Application.
  • تکرار منطق cross-cutting مثل Logging، Retry یا Validation.

مراحل Refactoring

1. نقطه تغییر را مشخص کنید و دقیقاً بگویید کدام تصمیم ناپایدار است.

2. یک قرارداد کوچک و معنادار برای بخش متغیر تعریف کنید.

3. Concrete implementationها را پشت قرارداد منتقل کنید.

4. Client را فقط به قرارداد وابسته کنید.

5. با تست، رفتار قبل و بعد را یکسان نگه دارید و سپس پیچیدگی اضافی را حذف کنید.

چه زمانی استفاده کنیم؟

فقط وقتی واقعاً یک نمونه سراسری لازم است؛ در ASP.NET Core معمولاً Lifetime کانتینر بهتر است. اگر تنها یک پیاده‌سازی ساده دارید و احتمال تغییر واقعی کم است، Pattern ممکن است صرفاً تعداد فایل‌ها را زیاد کند.

نکته تخصصی این درس

در ASP.NET Core برای Logging از ILogger<T> و DI استفاده کنید؛ ساخت Logger Singleton دستی معمولاً ضد الگوی framework است.

خطاهای رایج

  • نگه‌داشتن state قابل تغییر سراسری.
  • استفاده به‌عنوان جایگزین DI/Configuration.
  • نادیده گرفتن thread-safety و lifecycle.

Best Practice

  • قرارداد را کوچک و بر اساس نیاز Client طراحی کنید.
  • نام کلاس‌ها را بر اساس نقش دامنه/کاربرد انتخاب کنید، نه صرفاً نام Pattern.
  • قبل از اضافه کردن abstraction یک تغییر واقعی یا تست‌پذیری لازم را نشان دهید.
  • برای سناریوهای async، cancellation و exception handling را بخشی از قرارداد در نظر بگیرید.

تمرین

  • یک نمونه کوچک از Singleton برای Logging برای سامانه فروش آنلاین طراحی کنید.
  • کد خود را طوری بازنویسی کنید که یک implementation جدید بدون تغییر Client اضافه شود.
  • یک حالت پیدا کنید که استفاده از این Pattern overengineering باشد و دلیلش را بنویسید.

جمع‌بندی

مهم‌ترین نکته این درس این است که «Singleton برای Logging» یک اسم برای کلاس‌بندی کد نیست؛ یک راه شناخته‌شده برای مدیریت یک نوع مشخص از تغییر است. اگر مسئله وجود دارد، Pattern کمک می‌کند نقطه تغییر محدود و قابل تست شود؛ اگر مسئله وجود ندارد، ساده‌ترین طراحی معمولاً بهتر است.

درس بعدی

درس 23 از 89 در آموزش جامع Design Patterns در C# و .NET

نمونه کد

public sealed class AppRegistry
{
 private static readonly Lazy<AppRegistry> _instance = new(() => new AppRegistry());
 public static AppRegistry Instance => _instance.Value;
 private AppRegistry() { }
}

خروجی مورد انتظار

خروجی این درس شامل اجرای نمونه مرتبط با «Singleton برای Logging» و درک کاربرد آن در سناریوهای واقعی C# و .NET است.