Quartz 5

10. Http Get vs Post - 02

7 min read

হাসিব, তোমার প্রোভাইড করা লেকচার ট্রান্সক্রিপ্টটি আমি পুঙ্খানুপুঙ্খভাবে অ্যানালাইজ করেছি। এই লেকচারে মূলত ASP.NET Core-এর পাইপলাইনে একদম লো-লেভেল বা রডন (Raw) উপায়ে কীভাবে Request Body রিড করতে হয়, এবং বডির ভেতরের Query String-কে কীভাবে QueryHelpers ও StringValues ব্যবহার করে পার্স করতে হয়, তা বিস্তারিত আলোচনা করা হয়েছে।

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

📝 Quick Summary for Revision

  • context.Request.Body: এটি একটি Stream টাইপ (যেমন: File Stream)। তাই রিকোয়েস্ট বডির ডেটা সরাসরি string হিসেবে পাওয়া যায় না।
  • StreamReader: বডির এই Stream ডেটাকে প্লেইন টেক্সট বা স্ট্রিংয়ে কনভার্ট করার জন্য System.IO.StreamReader এবং এর ReadToEndAsync() মেথড ব্যবহার করতে হয়।
  • QueryHelpers.ParseQuery: রিকোয়েস্ট বডিতে যদি Query String ফরম্যাটে ডেটা আসে, তবে সেটিকে Dictionary-তে রূপান্তর (Parsing) করার জন্য এই স্ট্যাটিকটি ব্যবহার করা হয়।
  • StringValues: এটি .NET-এর একটি স্পেশাল টাইপ যা একই Key-র বিপরীতে একক বা একাধিক (Duplicate) ভ্যালু ধারণ করতে পারে (যেমন: age=20&age=30)।
  • The Industry Reality: এটি ফ্রেমওয়ার্কের একদম আন্ডার-দ্য-হুড (Under-the-hood) বা রডন মেকানিজম, যা ইন্টারভিউ এবং বেসিক শক্ত করার জন্য জানা জরুরি। তবে রিয়েল-ওয়ার্ল্ড প্রজেক্টে এই কাজের জন্য Model Binding ব্যবহার করা হয়।

🧠 Comprehensive Breakdown

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

1. Why context.Request.Body is a Stream? (importance: 10/10)

What and Why: যখন কোনো ক্লায়েন্ট (যেমন Postman) সার্ভারে POST রিকোয়েস্ট পাঠায়, তখন রিকোয়েস্টের বডিতে ডেটা থাকে। কোডে এই ডেটা রিড করার প্রোপার্টি হলো context.Request.Body। কিন্তু তুমি যদি এর ওপর হোভার করো বা ডেটা টাইপ চেক করো, দেখবে এটি কোনো সাধারণ string বা টেক্সট নয়; এটি হলো একটি Stream।

লজিক: সার্ভারে যেকোনো সময় বিশাল বড় ফাইল, ইমেজ বা মেগাবাইট ট্রাফিকের ডেটা আসতে পারে। ফ্রেমওয়ার্ক যদি শুরুতেই পুরো ডেটাকে স্ট্রিং বানিয়ে মেমোরিতে রেখে দেয়, তবে সার্ভার ক্র্যাশ করতে পারে। তাই ডেটাকে স্ট্রিম (টুকরো টুকরো বাইট) হিসেবে রিসিভ করা হয়। ফাইল রিড করার মতোই এই বডি স্ট্রিম রিড করার জন্য আমাদের StreamReader ব্যবহার করতে হয়।

// Creating a StreamReader based on the Request Body Stream
using (System.IO.StreamReader reader = new System.IO.StreamReader(context.Request.Body))
{
    // Asynchronously read the entire stream into a plain string
    string body = await reader.ReadToEndAsync();
}

এখানে ReadToEndAsync() একটি Asynchronous মেথড হওয়ায় এর আগে await ব্যবহার করা হয়েছে, যেন বডি রিড হওয়া পর্যন্ত থ্রেডটি অপেক্ষা করে এবং পরবর্তী লাইনে ডেটা সঠিকভাবে পাওয়া যায়।

2. Query String inside Request Body (POST Request) (importance: 8/10)

What and Why: আমরা সাধারণত জানি কুয়েরি স্ট্রিং (?id=1&name=Scott) থাকে GET রিকোয়েস্টের URL-এ। কিন্তু টেকনিক্যালি, আমরা চাইলে POST রিকোয়েস্টের বডির ভেতরেও হুবহু এই কুয়েরি স্ট্রিং ফরম্যাটে ডেটা পাঠাতে পারি (যাকে x-www-form-urlencoded এর রডন রূপ বলা যায়)।

পার্থক্য: GET-এর সময় ডেটা URL-এর সাথে লিক হয়ে যায়, কিন্তু POST-এ ডেটা URL-এ দৃশ্যমান থাকে না, এটি Request Body-র ভেতরে সুরক্ষিতভাবে সার্ভারে যায়। জোড়াগুলোকে আলাদা করতে কোনো স্পেস ছাড়া অ্যাম্পারস্যান্ড (&) ব্যবহার করা হয় (যেমন: firstName=Scott&age=25)।

3. Parsing Query String to Dictionary via QueryHelpers (importance: 9/10)

What and Why: StreamReader দিয়ে বডি রিড করার পর আমরা যে ডেটা পাই তা মূলত একটি প্লেইন স্ট্রিং: "firstName=Scott&age=25"। এখন কোডের ভেতর থেকে শুধুমাত্র firstName-এর ভ্যালু আলাদা করা সাধারণ স্ট্রিং মেথড (যেমন IndexOf, Substring) দিয়ে করা অত্যন্ত জটিল এবং বাগ-প্রোন (Error-prone)।

এই সমস্যার সমাধানের জন্য ASP.NET Core-এ একটি বিল্ট-ইন ক্লাস আছে— QueryHelpers (নেমস্পেস: Microsoft.AspNetCore.WebUtilities)। এর স্ট্যাটিক মেথড ParseQuery() এই প্লেইন স্ট্রিংটিকে একটি ডিকশনারি অবজেক্টে কনভার্ট করে দেয়, যার ফলে Key-র নাম ধরে ভ্যালু বের করা পানির মতো সহজ হয়ে যায়।

4. Deep Dive into StringValues Type (importance: 9/10)

What and Why: QueryHelpers.ParseQuery মেথডটি যে ডিকশনারি রিটার্ন করে, তার স্ট্রাকচার কিন্তু Dictionary<string, string> নয়! এর স্ট্রাকচার হলো: Dictionary<string, Microsoft.Extensions.Primitives.StringValues>

লজিক: HTTP প্রোটোকলের নিয়ম অনুযায়ী, কুয়েরি স্ট্রিং-এ একই Key একাধিকবার থাকতে পারে (Duplicate Keys)। যেমন ইউজার বডিতে পাঠালো: age=20&age=30। এখন ডিকশনারির কি (Key) তো ডুপ্লিকেট হতে পারে না। তাই .NET-এ StringValues টাইপটি আনা হয়েছে। এটি এমন একটি বিশেষ অবজেক্ট যা একক ভ্যালুও রিড করতে পারে, আবার একই নামের একাধিক ভ্যালু আসলে সেগুলোকে একটি ইন্টারনাল কালেকশন বা অ্যারে হিসেবেও ধরে রাখতে পারে।

  • যদি তুমি একটি ভ্যালু চাও, তবে ইনডেক্স [0] দিয়ে রিড করবে।
  • যদি একাধিক ভ্যালু আসে, তবে foreach লুপ চালিয়ে সব ভ্যালু রিড করতে পারবে।
// Reading via dictionary checking
if (queryDict.ContainsKey("firstName"))
{
    // Extracts the StringValues object and accesses index 0
    string firstName = queryDict["firstName"][0]; 
}

💻 Low-Level Full Code Implementation

লেকচারে যেভাবে StreamReader, QueryHelpers, এবং কন্ডিশনাল চেকিং ব্যবহার করে কাস্টম পোস্ট রিকোয়েস্ট বডি পার্স করা হয়েছে, তার সম্পূর্ণ স্ট্রাকচার্ড কোড নিচে দেওয়া হলো:

// Program.cs
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.WebUtilities; // Required for QueryHelpers
using Microsoft.Extensions.Primitives;   // Required for StringValues
using System.IO;
 
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
app.Run(async (HttpContext context) =>
{
    context.Response.Headers.ContentType = "text/html";
 
    // 1. Only process if it is a POST request
    if (HttpMethods.IsPost(context.Request.Method))
    {
        // 2. Read the raw request body stream using StreamReader
        using (StreamReader reader = new StreamReader(context.Request.Body))
        {
            string body = await reader.ReadToEndAsync();
 
            // 3. Parse the raw query string into a StringValues Dictionary
            Dictionary<string, StringValues> queryDictionary = QueryHelpers.ParseQuery(body);
 
            // 4. Checking if our target key exists
            if (queryDictionary.ContainsKey("firstName"))
            {
                // Accessing the first value using index 0
                string firstName = queryDictionary["firstName"][0]!;
 
                // 5. Writing response back to Postman
                await context.Response.WriteAsync($"<h3>Successfully parsed via low-level API!</h3><p>First Name: {firstName}</p>");
                return;
            }
        }
    }
 
    context.Response.StatusCode = StatusCodes.Status400BadRequest;
    await context.Response.WriteAsync("<p>Please make a POST request with 'firstName' in the body via Postman.</p>");
});
 
app.Run();

🔍 VS Code Shortcuts for Debugging

লেকচারে ভিজ্যুয়াল স্টুডিওর মার্জিনে ক্লিক করে ব্রেকপয়েন্ট (Breakpoint) বসানো এবং F10 (Step over) চেপে ডিবাগ করার কথা বলা হয়েছে। তুমি যেহেতু VS Code ব্যবহার করছো, তোমার জন্য গাইডলাইন নিচে দেওয়া হলো:

  • Setting Breakpoint: VS Code-এ কোড লাইনের একদম বাম পাশে (লাইন নাম্বারের পাশে) মাউস নিয়ে ক্লিক করলে একটি লাল ডট (●) পড়বে। এটিই ব্রেকপয়েন্ট।
  • Start Debugging: প্রজেক্ট ডিবাগ মোডে রান করার শর্টকাট হলো F5।
  • Step Over (F10 in VS): VS Code-এ কোডের এক লাইন থেকে পরবর্তী লাইনে যাওয়ার (Step Over) শর্টকাট হলো F10।
  • Step Into (F11 in VS): কোনো মেথডের ভেতরে ঢোকার জন্য শর্টকাট হলো F11।
  • Postman Note: ক্রোম ব্রাউজার সরাসরি ফন্ট-এন্ড পেজ ছাড়া POST রিকোয়েস্ট পাঠাতে পারে না। তাই বডিতে raw সিলেক্ট করে firstName=Scott&age=20&age=30 ডেটা লিখে টেস্ট করার জন্য পোস্টম্যান ব্যবহার করা বাধ্যতামূলক।

🚀 Best Practices & .NET 10 Updates

Best Practices with Examples

  1. Do Not Read the Body Stream Manually in Production: লেকচারার নিজেই বলেছেন, এটি ফ্রেমওয়ার্কের রডন বা একদম বেসিক মেকানিজম (ইন্টারভিউ ক্র্যাক করার জন্য দারুণ)। কিন্তু প্রোডাকশন প্রজেক্টে এভাবে ম্যানুয়ালি স্ট্রিম রিড করা উচিত নয়। কারণ রিকোয়েস্ট বডি স্ট্রিমটি বাই-ডিফল্ট Forward-Only (একবার রিড করলে স্ট্রিম খালি হয়ে যায়, পরবর্তীতে ফ্রেমওয়ার্কের অন্য কোথাও আর ডেটা পাওয়া যায় না)। প্রোডাকশনে সবসময় Model Binding ব্যবহার করা উচিত।
  2. Always use using block for StreamReaders: StreamReader মেমোরির Unmanaged Resource ব্যবহার করে। তাই কোড ডাইনামিকালি ডিসপোজ করার জন্য সবসময় using স্টেটমেন্টের ভেতরে রাখা বাধ্যতামূলক (যেটি আমি উপরের কোডে দেখিয়েছি)।

Modern .NET 10 / C# 13 Approaches

বর্তমানে .NET 10 এবং C# 13-এ আমরা এই ধরনের রিকোয়েস্ট বডি পার্সিংয়ের জন্য কোনো StreamReader বা QueryHelpers ম্যানুয়ালি লিখি না। আমরা Minimal APIs এবং C# 13-এর Record Types ব্যবহার করি। ফ্রেমওয়ার্ক নিজে থেকেই আন্ডার-দ্য-হুড অত্যন্ত হাই-স্পিডে আধুনিক HTTP/3 প্রোটোকল মেনে বডির ডেটা পার্স করে অবজেক্টে রূপান্তর করে দেয়।

.NET 10 Modern Code Example:

// Program.cs (.NET 10 Standard Minimal API)
using Microsoft.AspNetCore.Mvc;
 
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
// .NET 10 automatically maps form-urlencoded or JSON body directly to our record!
// No StreamReaders, no QueryHelpers, no manual dictionary checks.
app.MapPost("/register", ([FromForm] PersonRequest request) =>
{
    // If the client sends duplicate age keys (e.g., age=20&age=30), 
    // it automatically maps to the array/list inside the DTO!
    string primaryName = request.FirstName;
    
    return Results.Ok(new { 
        Message = "Parsed safely in .NET 10", 
        Name = primaryName, 
        Ages = request.Age 
    });
});
 
app.Run();
 
// C# 13 Record representing the incoming request structure cleanly
// It natively supports multiple values for a key using arrays/collections
public record PersonRequest(string FirstName, int[] Age);

Why this is better: .NET 10-এর এই আর্কিটেকচারে কোড ১০০% ক্লিন এবং টাইপ-সেফ। ইউজার যদি age-এর জায়গায় ভুল ডেটা পাঠায়, তবে আধুনিক ফ্রেমওয়ার্ক মেমোরি লিক বা রানটাইমে এক্সেপশন না খাইয়ে নিজে থেকেই ক্লায়েন্টকে একটি স্ট্যান্ডার্ড 400 Bad Request রেসপন্স রিটার্ন করে দেয়, যা তোমার অ্যাপ্লিকেশনের সিকিউরিটি ও পারফরম্যান্স বহুগুণ বাড়িয়ে দেয়।

Graph View

Backlinks