Quartz 5

3. Http Status Codes

7 min read

হাসিব, তোমার প্রোভাইড করা লেকচার ট্রান্সক্রিপ্টটি আমি খুব গভীরভাবে অ্যানালাইজ করেছি। এই লেকচারে মূলত HTTP Response Status Codes, HttpContext, এবং ASP.NET Core-এ কীভাবে কোডের মাধ্যমে কাস্টম স্ট্যাটাস কোড ও রেসপন্স বডি পাঠানো যায়, তা বিস্তারিত আলোচনা করা হয়েছে।

ভবিষ্যতে দ্রুত রিভিশন দেওয়ার জন্য নিচে প্রথমে একটি কুইক সামারি এবং এরপর প্রতিটি বিষয়ের ইন-ডেপ্ত ব্রেকডাউন দেওয়া হলো।

📝 Quick Summary for Revision

  • Status Codes: এগুলো হলো সার্ভার থেকে ব্রাউজারে পাঠানো ৩ ডিজিটের নিউমেরিক সিগন্যাল, যা রিকোয়েস্টের ফলাফল বা অবস্থা নির্দেশ করে।

  • Core Status Codes to Remember:

  • 101 Switching Protocols: প্রোটোকল পরিবর্তন (যেমন HTTP থেকে HTTPS বা WebSockets)।

  • 200 OK: রিকোয়েস্ট সফলভাবে সম্পন্ন হয়েছে (পজিটিভ রেসপন্স)।

  • 302 Found: সাময়িক রিডাইরেকশন (One URL to another)।

  • 304 Not Modified: ব্রাউজার ক্যাশ (Cache) থেকে ফাইল লোড করা (সার্ভার থেকে নতুন করে ডেটা ডাউনলোড হয় না)।

  • 400 Bad Request: ক্লায়েন্টের পাঠানো ডেটা ভুল বা ইনকমপ্লিট।

  • 401 Unauthorized: লগইন বা অথেনটিকেশন ফেইলুর (ভুল ইউজারনেম/পাসওয়ার্ড/OTP)।

  • 404 Not Found: ইউজার এমন ইউআরএল হিট করেছে যা সার্ভারে অস্তিত্ব নেই।

  • 500 Internal Server Error: সার্ভার-সাইডে কোডে কোনো রানটাইম এক্সেপশন বা ক্র্যাশ হলে।

  • HttpContext: রিকোয়েস্ট আসার পর ফ্রেমওয়ার্ক অটোমেটিকভাবে এই অবজেক্টটি তৈরি করে। এর ভেতরে Request, Response সহ সব মেটাডেটা থাকে।

  • app.Run(): এটি একটি ইনলাইন মিডলওয়্যার (Middleware) টার্মিনাল যা রিকোয়েস্ট হ্যান্ডেল করতে ল্যাম্বডা এক্সপ্রেশন (async context => {}) রিসিভ করে।

  • Async/Await: WriteAsync() মেথডটি অ্যাসিনক্রোনাস হওয়ায় এর আগে await এবং ল্যাম্বডা ফাংশনের আগে async কিউওয়ার্ড ব্যবহার করা বাধ্যতামূলক।

🧠 Comprehensive Breakdown

এখানে লেকচারের প্রতিটি কনসেপ্ট বিস্তারিতভাবে ব্যাখ্যা করা হলো এবং এর পেছনের “Why” (কেন এবং কীভাবে কাজ করে) যুক্তিগুলো তুলে ধরা হলো।

1. Understanding Core HTTP Status Codes [Priority: 10/10]

What and Why: সার্ভার যখন ব্রাউজারের রিকোয়েস্ট প্রসেস করে, তখন সে শুধু ডেটা পাঠায় না, বরং একটি ৩ ডিজিটের স্ট্যাটাস কোড পাঠায়। ব্রাউজার এই কোড দেখেই সবার আগে বোঝে যে রিকোয়েস্টের অবস্থা কী। লেকচারে আলোচিত প্রধান কোডগুলো নিচে দেওয়া হলো:

  • 101 Switching Protocols: যখন ক্লায়েন্ট এবং সার্ভার প্রোটোকল সুইচ করতে সম্মত হয় (যেমন প্লেইন HTTP থেকে সিকিউর HTTPS অথবা রিয়েল-টাইম যোগাযোগের জন্য WebSockets-এ রূপান্তর)।
  • 200 OK: এটি সবচেয়ে কমন এবং ডিফল্ট স্ট্যাটাস কোড। এর মানে প্রসেসটি সফলভাবে সম্পন্ন হয়েছে। এটি Kestrel server জেনারেট করে ব্রাউজারে পাঠায়।
  • 302 Found (Redirection): যখন কোনো রিকোয়েস্টকে এক ইউআরএল থেকে অন্য ইউআরএল-এ রিডাইরেক্ট করা হয়। যেমন: ইউজার হিট করলো /view-courses, কিন্তু সার্ভার তাকে পাঠিয়ে দিল /courses-view পাথে।
  • 304 Not Modified (Caching): এটি মূলত ইমেজ, সিএসএস বা স্ট্যাটিক ফাইলের ক্ষেত্রে ঘটে। ব্রাউজার যদি ফাইলটি আগেই ডাউনলোড করে তার টেম্পোরারি মেমোরি বা ক্যাশ (Cache)-এ রেখে দেয়, তবে সার্ভার নতুন করে ফাইলটি না পাঠিয়ে 304 কোড দেয়। এর ফলে ব্যান্ডউইথ বাঁচে এবং পেজ দ্রুত লোড হয়। তবে সার্ভারে ফাইলটি মডিফাই বা পরিবর্তন করা হলে আবার 200 OK দিয়ে নতুন ফাইল পাঠানো হয়।
  • 400 Bad Request: ক্লায়েন্ট বা ইউজার যদি ভুল ডেটা পাঠায়। যেমন: Udemy-তে একটি কোর্সের পেজ ওপেন করতে রিকোয়েস্ট পাঠানো হলো কিন্তু Course ID দেওয়া হলো না বা ইনভ্যালিড দেওয়া হলো।
  • 401 Unauthorized: ইউজার যখন ভুল পাসওয়ার্ড, ইমেইল বা ভুল OTP দিয়ে লগইন করার চেষ্টা করে, তখন সিকিউরিটি চেক ফেইল করলে এই কোড দেওয়া হয়।
  • 404 Not Found: ইউজার যদি এমন কোনো ইউআরএল (URL) ব্রাউজারে লেখে যা তোমার অ্যাপ্লিকেশনের রাউটিং কোডে ডিফাইন করা নেই।
  • 500 Internal Server Error: তোমার C# কোডে যদি কোনো রানটাইম এক্সেপশন (যেমন: NullReferenceException বা জিরো দিয়ে ভাগ করা) ঘটে এবং কোডটি ক্র্যাশ করে, তবে সার্ভার এই কোডটি ব্রাউজারকে দেখায়।

2. The Concept of HttpContext [Priority: 10/10]

What and Why: যখনই কোনো ব্রাউজার Kestrel Server-এর কাছে একটি HTTP রিকোয়েস্ট পাঠায়, Kestrel সেটি রিসিভ করে ASP.NET Core পাইপলাইনে পুশ করে। ফ্রেমওয়ার্ক তখন অটোমেটিকভাবে HttpContext নামের একটি অত্যন্ত শক্তিশালী অবজেক্ট তৈরি করে। এই HttpContext অবজেক্টটিকে একটি “কন্টেইনার” বলা চলে, যার মধ্যে বর্তমান রিকোয়েস্টের সমস্ত খুটিনাটি (Request অবজেক্ট), সার্ভার কী ফেরত পাঠাবে (Response অবজেক্ট) এবং ইউজারের ইনফরমেশন থাকে। কোডের মাধ্যমে রেসপন্স কন্ট্রোল করতে আমাদের এই অবজেক্টটি ব্যবহার করতে হয়।

3. Writing Code with app.Run() and Lambda Expressions [Priority: 9/10]

What and Why: লেকচারার বলেছেন, app.MapGet() মেথডে সরাসরি লজিক্যাল কোড বা কাস্টম স্ট্যাটাস কোড সেট করা কঠিন (এটি শুধু ভ্যালু রিটার্ন করতে পারে)। তাই রিকোয়েস্ট আসার পর কাস্টম কোড এক্সিকিউট করার জন্য app.Run() মেথড ব্যবহার করা হয়েছে।

app.Run() একটি মিডলওয়্যার মেথড যা প্যারামিটার হিসেবে একটি ল্যাম্বডা এক্সপ্রেশন (lambda expression) নেয়। এই ল্যাম্বডাতে আমরা ইনপুট হিসেবে context (যা মূলত HttpContext টাইপ) পাই।

// Setting up the application pipeline
app.Run(async (HttpContext context) =>
{
    // Accessing the response object inside context to set status code
    context.Response.StatusCode = 400; 
 
    // Writing the body text
    await context.Response.WriteAsync("Hello World");
});

নোট: লেকচারার উল্লেখ করেছেন যে আমাদের ম্যানুয়ালি স্ট্যাটাস ডেসক্রিপশন (যেমন “Bad Request”) কোডে লিখতে হয় না। আমরা শুধু 400 অ্যাসাইন করে দিলেই Kestrel সার্ভার রেসপন্স পাঠানোর সময় অটোমেটিকভাবে ডেসক্রিপশন যুক্ত করে দেয়।

4. Asynchronous Programming (async & await) [Priority: 8/10]

What and Why: রেসপন্স বডিতে ডেটা লেখার মেথডটি হলো WriteAsync()। এর নামের শেষে Async সাফিক্স থাকার মানে হলো এটি একটি অ্যাসিনক্রোনাস মেথড (Asynchronous Method)।

  • await এর ভূমিকা: await কিউওয়ার্ডটি ফ্রেমওয়ার্ককে বলে, যতক্ষণ না এই মেথডের কাজ (ব্রাউজারে ডেটা পাঠানো) সম্পূর্ণ হচ্ছে, ততক্ষণ এর পরের লাইনের কোডগুলো এক্সিকিউট করার জন্য অপেক্ষা করো। এটি থ্রেড ব্লকিং রোধ করে অ্যাপ্লিকেশনের পারফরম্যান্স বাড়ায়।
  • async এর ভূমিকা: সি-শার্পের নিয়ম অনুযায়ী, কোনো মেথড বা ল্যাম্বডা ফাংশনের ভেতরে যদি অন্তত একবারও await কিউওয়ার্ড ব্যবহার করা হয়, তবে সেই ফাংশনের সিগনেচারের শুরুতে অবশ্যই async কিউওয়ার্ড যুক্ত করতে হবে।

5. Conditional Status Codes Implementation [Priority: 9/10]

রিয়েল-ওয়ার্ল্ড প্রজেক্টে আমরা সবসময় ফিক্সড স্ট্যাটাস কোড পাঠাই না। লজিক বা কন্ডিশনের ওপর ভিত্তি করে কোড ডাইনামিক করা হয়। লেকচারে দেখানো ডেমো কন্ডিশনাল কোডটি নিচে দেওয়া হলো:

// Program.cs
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
app.Run(async (context) =>
{
    // Dummy condition for demonstration
    bool isDataValid = true; 
 
    if (isDataValid)
    {
        // If data is correct, send positive response
        context.Response.StatusCode = 200; 
        await context.Response.WriteAsync("Process completed successfully!");
    }
    else
    {
        // If data is incorrect/missing, send bad request
        context.Response.StatusCode = 400; 
        await context.Response.WriteAsync("Invalid request data supplied.");
    }
});
 
app.Run();

6. Debugging via Browser Network Tab [Priority: 8/10]

কোডটি রান করার পর ব্রাউজারে এটি ভেরিফাই করার প্রসেস:

  1. অ্যাপ্লিকেশনটি রান করে ক্রোম (Chrome) ব্রাউজারে ওপেন করো।
  2. কীবোর্ড থেকে Ctrl + Shift + I চেপে Developer Tools ওপেন করো (VS Code এনভায়রনমেন্টেও ব্রাউজার ডিবাগিং বা ডেভ-টুলস ওপেন করার ডিফল্ট শর্টকাট এটিই)।
  3. Network ট্যাবে ক্লিক করো এবং পেজটি Refresh করো।
  4. localhost রিকোয়েস্টে ক্লিক করলে Headers সেকশনে তুমি তোমার কোডে সেট করা কাস্টম স্ট্যাটাস কোড (যেমন: 400 Bad Request বা 500 Internal Server Error) দেখতে পাবে।

🚀 Best Practices & .NET 10 / C# 13 Updates

Best Practices with Examples

  1. Do Not Hardcode Status Codes: কোডে সরাসরি 400 বা 200 ম্যাজিক নাম্বার হিসেবে না লিখে Microsoft.AspNetCore.Http.StatusCodes বা System.Net.HttpStatusCode এনাম (Enum) ব্যবহার করা উচিত। এতে কোডের রিডাবিলিটি বাড়ে।
// Bad Practice
context.Response.StatusCode = 400;
 
// Good Practice (Clean and Readable)
context.Response.StatusCode = StatusCodes.Status400BadRequest;
  1. Avoid Global app.Run() for Business Logic: app.Run() মূলত পাইপলাইনের একদম শেষে টার্মিনাল মিডলওয়্যার হিসেবে ছোটখাটো টেস্টিং বা গ্লোবাল হ্যান্ডেলিংয়ের জন্য ঠিক আছে। কিন্তু বিজনেস লজিক বা এপিআই রাউটিংয়ের জন্য সবসময় Controllers অথবা Minimal APIs ব্যবহার করা উচিত।

.NET 10 / C# 13 Modern Approach

ট্রান্সক্রিপ্টে দেখানো মিডলওয়্যার বা app.Run() আর্কিটেকচারটি মূলত লো-লেভেল ফ্রেমওয়ার্ক পাইপলাইন বোঝার জন্য ভালো। কিন্তু আধুনিক .NET 10 এবং C# 13-এ আমরা রেসপন্স স্ট্যাটাস কোড এবং বডি এত জটিলভাবে হ্যান্ডেল করি না। আমরা Minimal APIs এবং বিল্ট-ইন Results বা TypedResults ক্লাসের স্ট্যাটিক মেথড ব্যবহার করি, যা আন্ডার-দ্য-হুড অত্যন্ত অপ্টিমাইজড উপায়ে আধুনিক HTTP/3 প্রোটোকল মেইনটেইন করে রেসপন্স জেনারেট করে।

.NET 10 Modern Code Example:

// Program.cs (.NET 10 Standard Minimal API)
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
// Handling successful response (200 OK) with clean lambda
app.MapGet("/success", () => Results.Ok("Process completed successfully!"));
 
// Handling bad request (400 BadRequest) conditionally using C# 13 lambda syntax
app.MapGet("/course/{id}", (int? id) =>
{
    if (id is null or <= 0)
    {
        // Automatically sets Status Code to 400 and returns the JSON/Text body safely
        return Results.BadRequest("Invalid Course ID supplied.");
    }
 
    return Results.Ok($"Displaying details for Course ID: {id}");
});
 
app.Run();

Why this is better: এখানে আমাদের ম্যানুয়ালি HttpContext রিড করতে হচ্ছে না, কোনো async/await এর ওভারহেড নেই এবং ফ্রেমওয়ার্ক নিজেই টাইপ-সেফ উপায়ে সঠিক স্ট্যাটাস কোড এবং ডেসক্রিপশন ব্রাউজারে ডেলিভার করে।

Graph View

Backlinks