8. Status Code Result

হ্যালো! একজন সফটওয়্যার ইঞ্জিনিয়ারিং ট্রেইনার হিসেবে আমি আপনার দেওয়া লেকচার ট্রান্সক্রিপ্টটি খুব মনোযোগ দিয়ে বিশ্লেষণ করেছি। আজকের লেকচারের মূল বিষয় হলো ASP.NET Core-এ Status Code Results এর ব্যবহার এবং কীভাবে এর মাধ্যমে কোড আরও ক্লিন ও প্রফেশনাল করা যায়।

চলুন, পুরো লেকচারটি খুব সুন্দর এবং গোছানোভাবে ধাপে ধাপে বুঝে নেওয়া যাক।

---

📋 লেকচার আউটলাইন এবং প্রায়োরিটি (Lecture Outline & Priorities)

নিচে লেকচারের মূল টপিকগুলোর একটি আউটলাইন এবং সেগুলোর গুরুত্ব (Importance Level) দেওয়া হলো:

1. The Problem with Manual Status Codes [Priority: 8/10]

• কেন গুরুত্বপূর্ণ: আমরা কেন নতুন পদ্ধতি শিখছি, তার পেছনের কারণ (Why) বুঝতে এটি সাহায্য করে।

2. Introduction to Status Code Results [Priority: 10/10]

• কেন গুরুত্বপূর্ণ: Response বডির সাথে একসাথে সঠিক HTTP Status Code পাঠানোর আধুনিক ও শর্টকাট উপায় এটি।

3. BadRequest (400) [Priority: 10/10]

• কেন গুরুত্বপূর্ণ: ইউজারের ইনপুট ভ্যালিডেশন ফেইল করলে (Validation Errors) এটি ব্যবহার করা স্ট্যান্ডার্ড প্র্যাকটিস।

4. NotFound (404) [Priority: 10/10]

• কেন গুরুত্বপূর্ণ: Database-এ কাঙ্ক্ষিত ডাটা না পাওয়া গেলে ক্লায়েন্টকে সঠিক মেসেজ দেওয়ার জন্য এটি অপরিহার্য।

5. Unauthorized (401) [Priority: 9/10]

• কেন গুরুত্বপূর্ণ: ইউজার লগ-ইন না থাকলে বা Authenticated না থাকলে সিস্টেমকে সুরক্ষিত রাখতে এটি ব্যবহৃত হয়।

6. Custom Status Code Method (StatusCode()) [Priority: 8/10]

• কেন গুরুত্বপূর্ণ: কমন Status Code-এর বাইরে অন্য যেকোনো Code (যেমন 500) পাঠানোর জন্য এটি দরকারি।

7. ObjectResult vs Result Classes [Priority: 7/10]

• কেন গুরুত্বপূর্ণ: Error মেসেজ দিলে এবং না দিলে ফ্রেমওয়ার্ক কীভাবে আলাদা Class-এর Object তৈরি করে, সেই আন্ডারলায়িং মেকানিজম বুঝতে।

---

🚀 বিস্তারিত ব্রেকডাউন (Comprehensive Breakdown)

এবার লেকচারের প্রতিটি বিষয় আমরা কোড এবং “Why” (কেন ব্যবহার করব) সহ বিস্তারিত জানব।

১. পূর্ববর্তী কোডের সমস্যা (The Problem in Previous Code)

আগের লেকচারগুলোতে, যখন আমরা কোনো Error রিকোয়েস্ট হ্যান্ডেল করতাম, তখন আমাদের দুটি আলাদা লাইন লিখতে হতো:

1. Response.StatusCode = 400; (Status Code সেট করার জন্য)
2. return Content("Book ID is not supplied"); (Response Body সেট করার জন্য)

Why (কেন এটি সমস্যা): প্রতিটি if কন্ডিশনের ভেতর বারবার এই দুটি লাইন লেখাটা বিরক্তিকর (Repetitive) এবং কোডকে অযথাই বড় করে ফেলে।

২. সমাধান: Status Code Results (The Solution)

ASP.NET Core এই সমস্যা সমাধানের জন্য Status Code Results নিয়ে এসেছে। এর মাধ্যমে আমরা এক লাইনেই Status Code এবং Response Body রিটার্ন করতে পারি। আমাদের ম্যানুয়ালি Response.StatusCode সেট করার কোনো প্রয়োজন নেই।

ম্যানুয়াল অবজেক্ট তৈরি বনাম শর্টকাট মেথড:

• Manual: return new BadRequestResult();
• Shortcut: return BadRequest(); (এটি ControllerBase ক্লাসের একটি বিল্ট-ইন মেথড যা রিয়েল-ওয়ার্ল্ড প্রজেক্টে ব্যবহৃত হয়)।

৩. বিভিন্ন Status Code Result এর ব্যবহার

লেকচারে মূলত ৩টি প্রধান Status Code Result দেখানো হয়েছে:

ক. BadRequest (HTTP 400)

• কখন ব্যবহার করবেন: যখন ইউজারের দেওয়া ইনপুট ভুল হয় বা Validation ফেইল করে (যেমন, Book ID না দেওয়া বা Negative ভ্যালু দেওয়া)।
• কোড ইমপ্লিমেন্টেশন:

if (bookId <= 0)
{
    // 400 Status Code এবং সাথে Error Message পাঠাবে
    return BadRequest("Book ID cannot be less than or equal to zero."); 
}
 

খ. NotFound (HTTP 404)

• কখন ব্যবহার করবেন: যখন ইউজার এমন কোনো ডাটা খোঁজে যা সার্ভারে বা Database-এ নেই। (যেমন, ডাটাবেসে ১০টি বই আছে, কিন্তু ইউজার ১১ নম্বর বইয়ের জন্য রিকোয়েস্ট করেছে)।
• কোড ইমপ্লিমেন্টেশন:

    if (bookId > 1000) // ধরুন 1000 এর বেশি কোনো বই নেই
    {
        // 404 Status Code পাঠাবে
        return NotFound("Book ID cannot be greater than 1000.");
    }

গ. Unauthorized (HTTP 401)

• কখন ব্যবহার করবেন: যখন কোনো সুরক্ষিত লিংকে ঢোকার জন্য ইউজারের Logged-In থাকা বাধ্যতামূলক, কিন্তু ইউজার লগ-ইন করা নেই (Not Authenticated)।
• কোড ইমপ্লিমেন্টেশন:

    if (!isLoggedIn)
    {
        // 401 Status Code পাঠাবে
        return Unauthorized("User must be authenticated.");
    }

৪. Custom Status Code (StatusCode Method)

যদি আপনার এমন কোনো Status Code রিটার্ন করতে হয়, যার জন্য বিল্ট-ইন শর্টকাট মেথড নেই (যেমন 500 Internal Server Error), তখন আপনি StatusCode() মেথড ব্যবহার করতে পারেন।

• কোড ইমপ্লিমেন্টেশন:

    // শুধু Status Code পাঠানো
    return StatusCode(500); 
    
    // Status Code এর সাথে Message পাঠানো
    return StatusCode(500, "Something went wrong on the server.");

৫. Result বনাম ObjectResult (পর্দার আড়ালের মেকানিজম)

লেকচারে ট্রেইনার একটি সূক্ষ্ম বিষয়ের পার্থক্য বুঝিয়েছেন:

• আপনি যদি শুধু return NotFound(); লেখেন, তবে এটি NotFoundResult ক্লাসের একটি অবজেক্ট রিটার্ন করে। এর কোনো Response Body থাকে না।
• কিন্তু আপনি যদি মেসেজসহ return NotFound("Error Msg"); লেখেন, তবে এটি NotFoundObjectResult ক্লাসের একটি অবজেক্ট রিটার্ন করে, যা মেসেজটিকে Response Body হিসেবে ক্লায়েন্টকে দেয়।

৬. IActionResult এর ভূমিকা

আগের লেকচারের মতো এখানেও মনে করিয়ে দেওয়া হয়েছে যে, BadRequest(), NotFound(), Unauthorized()—এগুলো আলাদা আলাদা রেজাল্ট দিলেও, আপনার Action Method-এর Return Type IActionResult রাখলেই হবে। কারণ এই সবগুলো Class-ই IActionResult Interface থেকে ইনহেরিট (Inherit) করা।

---

⭐ Best Practices & Modern Context (আধুনিক গাইডলাইন)

লেকচারে শেখানো কনসেপ্টগুলো আধুনিক .NET (যেমন .NET 6, 7, বা 8) এর জন্যও সম্পূর্ণ বৈধ। তবে রিয়েল-ওয়ার্ল্ড বা প্রোডাকশন গ্রেড API বানানোর সময় আমরা কিছু অতিরিক্ত স্ট্যান্ডার্ড ফলো করি:

১. ম্যানুয়াল Status Code অ্যাসাইনমেন্ট পরিহার করা: কখনোই Response.StatusCode = 400; ব্যবহার করবেন না। সবসময় লেকচারে শেখানো Helper Method গুলো (যেমন BadRequest(), NotFound()) ব্যবহার করবেন। এটি ইন্ডাস্ট্রি স্ট্যান্ডার্ড।

২. Plain String এর বদলে ProblemDetails ব্যবহার করা: লেকচারে BadRequest("Error Message") এর মাধ্যমে সরাসরি String পাঠানো হয়েছে। কিন্তু আধুনিক API ডিজাইনে (RESTful standards) Error মেসেজ পাঠানোর জন্য Plain String ব্যবহার করা হয় না। এর বদলে একটি স্ট্রাকচারড JSON ফরম্যাট ব্যবহার করা হয়, যাকে Problem Details (RFC 7807 স্ট্যান্ডার্ড) বলে।

Modern API Example (.NET 6+):

[ApiController] // ApiController অ্যাট্রিবিউট ব্যবহার করলে অনেক কিছু অটোমেটিক কাজ করে
[Route("api/[controller]")]
public class BooksController : ControllerBase
{
    [HttpGet("{id}")]
    public IActionResult GetBook(int id)
    {
        if (id <= 0)
        {
            // আধুনিক নিয়মে String এর বদলে Validation Problem Details পাঠানো ভালো
            return BadRequest(new { Message = "Invalid Book ID.", ErrorCode = "INVALID_ID" });
        }
 
        var book = GetBookFromDatabase(id); // ডামি ফাংশন
        
        if (book == null)
        {
            // ডাটাবেসে না পেলে NotFound
            return NotFound(new { Message = $"Book with ID {id} not found." });
        }
 
        return Ok(book); // 200 OK এর জন্য Ok() মেথড ব্যবহৃত হয়
    }
}
 

৩. [ApiController] এর ম্যাজিক: আপনি যদি আপনার Controller ক্লাসের ওপরে [ApiController] অ্যাট্রিবিউট ব্যবহার করেন, তবে অনেক ম্যানুয়াল Validation আপনাকে লিখতে হবে না। কেউ ভুল ডাটা পাঠালে .NET ফ্রেমওয়ার্ক স্বয়ংক্রিয়ভাবেই ইউজারের কাছে 400 BadRequest পাঠিয়ে দেবে (আপনার কোনো Code লেখার আগেই)।

আশা করি এই ব্রেকডাউনটি পুরো লেকচারটি বুঝতে আপনার জন্য অনেক সহায়ক হবে। কোনো কনসেপ্ট নিয়ে কনফিউশন থাকলে নির্দ্বিধায় প্রশ্ন করতে পারেন!