‫مدیریت استثنا در دات نت: از آرمان‌گرایی تا واقع‌گرایی در کدنویسی

public enum FileReadResult
{
    Success,
    FileNotFound,
    AccessDenied,
    UnknownError
}

public class FileReaderResult
{
    public FileReadResult Result { get; set; }
    public string? Content { get; set; }
}

public FileReaderResult ReadFile(string filePath)
{
    if (string.IsNullOrEmpty(filePath))
    {
        return new FileReaderResult
        {
            Result = FileReadResult.UnknownError,
            Content = null
        };
    }

    if (!File.Exists(filePath))
    {
        return new FileReaderResult
        {
            Result = FileReadResult.FileNotFound,
            Content = null
        };
    }

    try
    {
        // File.ReadAllText خود می‌تواند استثنا پرتاب کند
        string content = File.ReadAllText(filePath);
        return new FileReaderResult
        {
            Result = FileReadResult.Success,
            Content = content
        };
    }
    catch (UnauthorizedAccessException)
    {
        return new FileReaderResult
        {
            Result = FileReadResult.AccessDenied,
            Content = null
        };
    }
    catch (Exception) // گرفتن یک استثنای عمومی برای سایر خطاهای احتمالی از File.ReadAllText
    {
        return new FileReaderResult
        {
            Result = FileReadResult.UnknownError,
            Content = null
        };
    }
}

// نحوه استفاده
var result = ReadFile("data.txt");
if (result.Result == FileReadResult.Success)
{
    Console.WriteLine(result.Content);
}
else
{
    switch (result.Result)
    {
        case FileReadResult.FileNotFound:
            Console.WriteLine("فایل پیدا نشد.");
            break;
        case FileReadResult.AccessDenied:
            Console.WriteLine("دسترسی مجاز نیست.");
            break;
        default:
            Console.WriteLine("یک خطای ناشناخته رخ داد.");
            break;
    }
}

• افزایش پیچیدگی: این کد حجم زیادی کد تکراری و اضافی (Boilerplate) ایجاد می‌کند. برای مدیریت خطاها بدون استثنا، مجبور به تعریف یک enum به نام FileReadResult و یک کلاس سفارشی به نام FileReaderResult شدیم.
• مدیریت مستعد خطا: فراخواننده متد (ReadFile) باید هر بار به صراحت نتیجه را بررسی کرده و هر مورد خطا را مدیریت کند. این امر کد را پیچیده‌تر کرده و احتمال نادیده گرفتن مدیریت برخی خطاها را افزایش می‌دهد که می‌تواند منجر به باگ‌های پنهان شود.
• کاهش خوانایی: به دلیل تمام بررسی‌های اضافی و مدیریت دستی نتایج، دنبال کردن منطق برنامه دشوارتر می‌شود.
• بلوک try/catch همچنان حاضر است: در این سناریو، همچنان مجبور به استفاده از try/catch هستیم، زیرا در حال فراخوانی یک مؤلفه (مانند File.ReadAllText) هستیم که تحت کنترل ما نیست و از استثناها استفاده می‌کند. بنابراین، این رویکرد در نهایت بدترین بخش‌های هر دو استراتژی را در یک ساختار پیچیده ترکیب می‌کند.

public void SaveFile(string path, string content)
{
    try
    {
        File.WriteAllText(path, content);
    }
    catch (IOException ex) // مانند System.IO.DirectoryNotFoundException یا System.IO.PathTooLongException
    {
        // بهترین کار، بسته‌بندی استثنای اصلی در یک استثنای سطح بالاتر و خاص برنامه است
        throw new ApplicationException("عملیات ذخیره فایل با شکست مواجه شد.", ex);
    }
}

public void ProcessLargeDataSet(DataSet data)
{
    try
    {
        // منطق پردازش داده‌های حجیم
    }
    catch (OutOfMemoryException ex)
    {
        // مدیریت وضعیت بحرانی کمبود حافظه
        throw new ApplicationException("سیستم هنگام پردازش داده‌ها با کمبود حافظه مواجه شد.", ex);
    }
}

public void CastObject(object obj)
{
    try
    {
        string str = (string)obj; // ممکن است InvalidCastException پرتاب کند
    }
    catch (InvalidCastException ex)
    {
        throw new ApplicationException("تبدیل شی به رشته با شکست مواجه شد.", ex);
    }
}

public string ReadFileNUE(string filePath) // نام متد برای تمایز تغییر داده شده است
{
    if (string.IsNullOrEmpty(filePath))
    {
        throw new ArgumentException("مسیر فایل نمی‌تواند تهی یا خالی باشد.", nameof(filePath));
    }

    // File.ReadAllText در صورت بروز خطا، استثناهای مربوطه را پرتاب می‌کند
    // مانند FileNotFoundException یا UnauthorizedAccessException
    return File.ReadAllText(filePath);
}

// نحوه استفاده
try
{
    string content = ReadFileNUE("data.txt");
    Console.WriteLine(content);
}
catch (FileNotFoundException) // استثنای خاص برای فایل پیدا نشده
{
    Console.WriteLine("فایل پیدا نشد.");
}
catch (UnauthorizedAccessException) // استثنای خاص برای عدم دسترسی
{
    Console.WriteLine("دسترسی مجاز نیست.");
}
catch (ArgumentException ex) // استثنای خاص برای آرگومان نامعتبر
{
    Console.WriteLine($"خطای آرگومان: {ex.Message}");
}
catch (Exception ex) // یک catch عمومی برای سایر خطاهای پیش‌بینی نشده
{
    // ثبت لاگ خطا مهم است
    // Log.Error(ex, "An unexpected error occurred while reading the file.");
    Console.WriteLine($"یک خطای غیرمنتظره رخ داد: {ex.Message}");
    // در برخی موارد، ممکن است بخواهید استثنا را دوباره پرتاب کنید یا یک استثنای جدید و خاص‌تر ایجاد کنید
    // throw; // یا throw new CustomApplicationException("...", ex);
}

• منطق ساده‌شده: کد بسیار روان‌تر است. به جای بازگرداندن انواع نتیجه پیچیده و بررسی کدهای خطا، منطق برنامه به طور طبیعی جریان می‌یابد. هنگامی که خطایی رخ می‌دهد، اجرای برنامه به طور خودکار به بلوک catch مناسب منتقل می‌شود.
• خوانایی بهبود یافته: کد تمیزتر خوانده می‌شود و بر عملیات اصلی (خواندن متن فایل با ReadAllText) تمرکز دارد. جزئیات مدیریت خطا به بخش مدیریت استثنا منتقل شده و منطق اصلی را مختصر نگه می‌دارد.
• تمرکز بر "مسیر خوشحال" (Happy Path): حالت عادی (خواندن فایل) به طور مستقیم مدیریت می‌شود و شرایط خطا به طور جداگانه اداره می‌شوند. این جداسازی مسئولیت‌ها (Separation of Concerns) باعث می‌شود کد راحت‌تر دنبال شود.

try
{
    // کدی که ممکن است استثنا پرتاب کند
}
catch (FileNotFoundException ex) // مدیریت یک استثنای خاص و شناخته شده
{
    // مدیریت خاص برای این نوع خطا
}
catch (HttpRequestException ex) // مدیریت خطای مربوط به درخواست HTTP
{
    // مدیریت خطای شبکه
    // Log(ex);
    // NotifyUser("عدم امکان برقراری ارتباط با سرور. لطفاً بعداً تلاش کنید.");
}
catch (Exception ex) // گرفتن استثناهای عمومی به عنوان آخرین راهکار
{
    // ثبت لاگ استثناهای غیرمنتظره
    // Log.Fatal(ex, "An unhandled exception occurred.");
    throw; // پرتاب مجدد استثنا برای جلوگیری از قورت دادن بی‌صدا
}