C# ఎక్సెప్షన్ హ్యాండ్లింగ్ (try, catch, finally, when, Custom Exceptions & IDisposable)

Console.WriteLine("1. లావాదేవీ ప్రారంభమైంది.");

try
{
    Console.WriteLine("2. సర్వర్‌తో కనెక్ట్ అవుతున్నాం...");
    int totalAmount = 5000;
    int divisor = 0; // ప్రమాదం!
    int sharePerPerson = totalAmount / divisor;
    Console.WriteLine($"3. ఒక్కొక్కరికి వాటా: ₹{sharePerPerson}"); // ఇది ఎప్పటికీ రన్ కాదు!
}
catch (DivideByZeroException ex)
{
    Console.WriteLine($"⚠️ [ఎర్రర్ పట్టుబడింది]: సున్నా మంది వ్యక్తులకు నిధులను పంచలేము! ({ex.Message})");
}
finally
{
    // ఎర్రర్ వచ్చినా సరే ఇది ఖచ్చితంగా రన్ అవుతుంది!
    Console.WriteLine("4. 🧹 [Finally క్లీనప్]: సర్వర్ కనెక్షన్ సురక్షితంగా మూసివేయబడింది.");
}

Console.WriteLine("5. అప్లికేషన్ క్రాష్ అవ్వకుండా ముందుకు సాగుతోంది!");

try
{
    string[] userInputs = { "100", "0", "యాభై" };
    int num1 = int.Parse(userInputs[0]);
    int num2 = int.Parse(userInputs[2]); // FormatException ఇక్కడ వస్తుంది!
    int result = num1 / num2;
}
catch (IndexOutOfRangeException ex)
{
    Console.WriteLine($"❌ అర్రే పరిమితి దాటిపోయింది: {ex.Message}");
}
catch (DivideByZeroException ex)
{
    Console.WriteLine($"❌ సున్నాతో భాగించకూడదు: {ex.Message}");
}
catch (FormatException ex)
{
    Console.WriteLine($"❌ నంబర్ ఫార్మాట్ తప్పుగా ఉంది: {ex.Message}");
}
catch (Exception ex) // అల్టిమేట్ సేఫ్టీ నెట్ - అందరికంటే చివర్లోనే ఉండాలి!
{
    Console.WriteLine($"❌ ఇతర తెలియని లోపం సంభవించింది: {ex.Message}");
}

public class ServerException : Exception
{
    public int StatusCode { get; }
    public ServerException(int code, string msg) : base(msg) => StatusCode = code;
}

try
{
    // 404 ఎర్రర్ అనుకరిస్తున్నాం
    throw new ServerException(404, "అభ్యర్థించిన రిసోర్స్ సర్వర్‌లో దొరకలేదు");
}
catch (ServerException ex) when (ex.StatusCode == 404)
{
    Console.WriteLine($"🔍 [404 Not Found]: పేజీ దొరకలేదు, హోమ్‌పేజీకి దారి మళ్లిస్తున్నాం.");
}
catch (ServerException ex) when (ex.StatusCode == 500)
{
    Console.WriteLine($"🔥 [500 Server Error]: సర్వర్ క్రాష్ అయ్యింది, డెవలపర్ అలర్ట్ పంపుతున్నాం.");
}
catch (ServerException ex)
{
    Console.WriteLine($"⚠️ ఇతర సర్వర్ ఎర్రర్: కోడ్ {ex.StatusCode}");
}

void ProcessOrder()
{
    try
    {
        ExecuteDatabaseQuery(); // లైన్ 85 లో SQL ఎర్రర్ వచ్చింది అనుకుందాం
    }
    catch (Exception ex)
    {
        LogToAuditFile(ex.Message);

        // ❌ throw ex; // చెడ్డది! లైన్ 85 పోయి, ఈ క్యాచ్ బ్లాక్ లైనే కొత్త ఎర్రర్ గా రికార్డ్ అవుతుంది!
        throw; // ✅ అద్భుతమైనది! లైన్ 85 లోని ఒరిజినల్ రూట్ కాజ్ కాల్ స్టాక్‌ను కాపాడుతుంది!
    }
}

try
{
    // లో-లెవల్ ఆపరేషన్ విఫలమైంది అనుకుందాం
    throw new System.IO.FileNotFoundException("బ్యాంక్ కాన్ఫిగరేషన్ ఫైల్ కనబడలేదు!");
}
catch (Exception ioEx)
{
    // ioEx ని రెండవ పారామీటర్‌గా పంపి ర్యాప్ చేస్తున్నాం!
    throw new ApplicationException("బ్యాంకింగ్ సర్వీస్ ప్రారంభం కాలేదు", ioEx);
}

public class InsufficientFundsException : Exception
{
    public decimal CurrentBalance { get; }
    public decimal RequestedAmount { get; }
    public decimal DeficitAmount => RequestedAmount - CurrentBalance;

    public InsufficientFundsException() : base("ఖాతాలో సరిపడా నిధులు లేవు.") { }

    public InsufficientFundsException(string message) : base(message) { }

    public InsufficientFundsException(string message, Exception inner) : base(message, inner) { }

    // డొమైన్ స్పెసిఫిక్ రిచ్ కన్‌స్ట్రక్టర్
    public InsufficientFundsException(decimal balance, decimal requested) 
        : base($"నిధులు సరిపోవు! (ప్రస్తుత బ్యాలెన్స్: ₹{balance:N2}, అభ్యర్థించినది: ₹{requested:N2})")
    {
        CurrentBalance = balance;
        RequestedAmount = requested;
    }
}

public class SecureFileLogger : IDisposable
{
    public string FileName { get; }

    public SecureFileLogger(string name)
    {
        FileName = name;
        Console.WriteLine($"📂 ఫైల్ ఓపెన్ చేయబడింది: {FileName}");
    }

    public void WriteLog(string msg) => Console.WriteLine($"   [LOG] {msg}");

    // IDisposable కాంట్రాక్ట్
    public void Dispose()
    {
        Console.WriteLine($"🔒 ఫైల్ సురక్షితంగా క్లోజ్ చేయబడింది (Disposed): {FileName}");
    }
}

// 🌟 మోడ్రన్ C# 8+ 'using declaration' - కర్లీ బ్రేసెస్ అవసరం లేదు!
void TestLogging()
{
    using var logger = new SecureFileLogger("audit_2026.log");
    logger.WriteLog("యూజర్ లాగిన్ విజయవంతం");
    logger.WriteLog("చెల్లింపు ప్రారంభమైంది");
    // మెథడ్ ముగియగానే (లేదా ఎర్రర్ వచ్చినా) Dispose() ఆటోమేటిక్‌గా రన్ అవుతుంది!
}

TestLogging();

using System;

Console.OutputEncoding = System.Text.Encoding.UTF8;

Console.WriteLine("=================================================");
Console.WriteLine("🏧 మన ఏటీఎం - ఎంటర్‌ప్రైజ్ క్యాష్ డిస్పెన్సర్ ఇంజిన్ v1.0");
Console.WriteLine("=================================================\n");

// 1. డొమైన్ కస్టమ్ ఎక్సెప్షన్లు
public class InsufficientCashException(decimal balance, decimal requested) 
    : Exception($"ఖాతాలో నిధులు సరిపోవు! (బ్యాలెన్స్: ₹{balance:N2}, అభ్యర్థన: ₹{requested:N2})")
{
    public decimal Deficit => requested - balance;
}

public class DailyLimitExceededException(decimal limit, decimal requested)
    : Exception($"రోజువారీ ఏటీఎం విత్‌డ్రా పరిమితి ₹{limit:N2} దాటిపోయింది! (అభ్యర్థన: ₹{requested:N2})");

public class CardBlockedException(string cardNo, string reason)
    : Exception($"భద్రతా కారణాల వల్ల కార్డ్ {cardNo} బ్లాక్ చేయబడింది: {reason}");

// 2. IDisposable రీసోర్స్ సెషన్
public class AtmHardwareSession : IDisposable
{
    public string SessionId { get; } = "ATM-SESS-" + Guid.NewGuid().ToString().Substring(0, 6).ToUpper();

    public AtmHardwareSession()
    {
        Console.WriteLine($"🔌 [హార్డ్‌వేర్]: క్యాష్ డిస్పెన్సర్ షట్టర్ మరియు సెన్సార్లు ఆన్ అయ్యాయి ({SessionId})");
    }

    public void DispenseCurrencyNotes(decimal amount)
    {
        Console.WriteLine($"💵 [క్యాష్ షట్టర్ ఓపెన్]: ₹{amount:N2} కరెన్సీ నోట్లు బయటకు వచ్చాయి. దయచేసి నగదును తీసుకోండి.");
    }

    public void Dispose()
    {
        Console.WriteLine($"🔒 [హార్డ్‌వేర్]: క్యాష్ డిస్పెన్సర్ షట్టర్ సురక్షితంగా లాక్ చేయబడింది. సెషన్ ముగిసింది ({SessionId}).\n");
    }
}

// 3. ప్రధాన ఏటీఎం కంట్రోలర్
public class AtmController
{
    private decimal _accountBalance = 35000.00m;
    private const decimal DailyWithdrawLimit = 20000.00m;
    private bool _isCardActive = true;

    public void ProcessWithdrawal(string cardNo, decimal amount)
    {
        Console.WriteLine($"-------------------------------------------------");
        Console.WriteLine($"💳 కార్డ్ #{cardNo} ద్వారా నగదు విత్‌డ్రా అభ్యర్థన: ₹{amount:N2}");

        // using డిక్లరేషన్: ఎర్రర్ వచ్చినా హార్డ్‌వేర్ షట్టర్ 100% సేఫ్‌గా క్లోజ్ అవుతుంది!
        using var session = new AtmHardwareSession();

        try
        {
            if (!_isCardActive)
            {
                throw new CardBlockedException(cardNo, "3 సార్లు తప్పుడు పిన్ ఎంటర్ చేయబడింది");
            }
            if (amount <= 0 || amount % 100 != 0)
            {
                throw new ArgumentException("విత్‌డ్రా మొత్తం ₹100 గుణిజాల్లో మాత్రమే ఉండాలి!");
            }
            if (amount > DailyWithdrawLimit)
            {
                throw new DailyLimitExceededException(DailyWithdrawLimit, amount);
            }
            if (amount > _accountBalance)
            {
                throw new InsufficientCashException(_accountBalance, amount);
            }

            // లావాదేవీ విజయవంతం
            _accountBalance -= amount;
            session.DispenseCurrencyNotes(amount);
            Console.WriteLine($"✅ లావాదేవీ విజయవంతం! మిగిలిన ఖాతా బ్యాలెన్స్: ₹{_accountBalance:N2}");
        }
        catch (InsufficientCashException ex)
        {
            Console.WriteLine($"❌ [నిధుల లోపం]: {ex.Message} (లోటు మొత్తం: ₹{ex.Deficit:N2})");
        }
        catch (DailyLimitExceededException ex)
        {
            Console.WriteLine($"⚠️ [పరిమితి హెచ్చరిక]: {ex.Message}");
        }
        catch (CardBlockedException ex)
        {
            Console.WriteLine($"🚨 [సెక్యూరిటీ అలర్ట్]: {ex.Message}");
        }
        catch (ArgumentException ex)
        {
            Console.WriteLine($"❌ [చెల్లని ఇన్‌పుట్]: {ex.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"🔥 [అనూహ్య లోపం]: సిస్టమ్ తాత్కాలికంగా పనిచేయడం లేదు. {ex.Message}");
        }
    }
}

// డ్రైవర్ కోడ్: వివిధ ఎక్సెప్షన్ దృశ్యాల సిమ్యులేషన్
AtmController atm = new AtmController();

// దృశ్యం 1: చెల్లుబాటు అయ్యే విత్‌డ్రా
atm.ProcessWithdrawal("4591-XXXX-1234", 5000m);

// దృశ్యం 2: ₹100 గుణిజం కాని మొత్తం
atm.ProcessWithdrawal("4591-XXXX-1234", 1250m);

// దృశ్యం 3: రోజువారీ పరిమితి దాటిన మొత్తం
atm.ProcessWithdrawal("4591-XXXX-1234", 25000m);

// దృశ్యం 4: బ్యాలెన్స్ కంటే ఎక్కువ మొత్తం
atm.ProcessWithdrawal("4591-XXXX-1234", 32000m);

Console.WriteLine("=================================================");