Quartz 5

18. FromBody

4 min read

হ্যালো হাসিব! তোমার দেওয়া লেকচার ট্রান্সক্রিপ্টটি আমি খুব মনোযোগ দিয়ে অ্যানালাইজ করেছি। এই লেকচারটিতে ASP.NET Core-এর অত্যন্ত গুরুত্বপূর্ণ একটি টপিক— Request Body Model Binding এবং [FromBody] Attribute নিয়ে আলোচনা করা হয়েছে, যা মূলত মডার্ন REST API ডেভেলপমেন্টের মূল ভিত্তি।

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

📝 Quick Summary for Revision

  • The Context: HTML Form থেকে আসা ডেটা (form-data বা x-www-form-urlencoded) ডিফল্টভাবে Model Binding হ্যান্ডেল করতে পারে। কিন্তু API-তে যখন JSON বা XML ডেটা আসে, তখন বিশেষ মেকানিজম দরকার হয়।
  • Content Types: application/json, application/xml বা text/csv এর মতো Content Type-গুলো রিসিভ করার জন্য Request Body Model Binding ব্যবহার করা হয়।
  • The [FromBody] Attribute: Action Method-এর প্যারামিটারে Model-এর নামের আগে [FromBody] ব্যবহার করলে ফ্রেমওয়ার্ক বুঝতে পারে যে ডেটাটি রিকোয়েস্টের Body থেকে (JSON/XML ফরম্যাটে) আসবে।
  • Input Formatters: [FromBody] মূলত ASP.NET Core-এর “Input Formatters”-কে ট্রিগার করে। JSON Input Formatter অটোমেটিকভাবে JSON স্ট্রিংকে C# Object-এ কনভার্ট (Parse) করে দেয়।
  • Postman Testing: JSON ডেটা টেস্ট করার জন্য Postman-এ Body -> raw -> JSON সিলেক্ট করে Key-Value পেয়ার (ডাবল কোটেশনের ভেতরে) পাঠাতে হয়।

🧠 Comprehensive Breakdown

এখানে লেকচারের প্রতিটি কনসেপ্ট, কেন ব্যবহার করব (Why), এবং কিভাবে কোড করব—সবকিছু বিস্তারিতভাবে দেওয়া হলো।

1. Form Fields vs Request Body (পার্থক্য কী?) [Priority: 8/10]

Why do we need this distinction? আগের লেকচারগুলোতে আমরা দেখেছি যে HTML Form সাবমিট করলে ডেটা form-data বা form-urlencoded ফরম্যাটে আসে। ফ্রেমওয়ার্ক এগুলোকে “Form Fields” হিসেবে ট্রিট করে এবং ডিফল্ট Model Binding সহজেই এগুলোকে রিসিভ করতে পারে। কিন্তু মডার্ন ক্লায়েন্ট অ্যাপ্লিকেশন (যেমন: React, Angular, বা Mobile Apps) সার্ভারে ডেটা পাঠানোর সময় সাধারণত JSON (JavaScript Object Notation) ব্যবহার করে। এই application/json ডেটা ডিফল্ট Model Binding সরাসরি পড়তে পারে না। এর জন্য আমাদের Request Body থেকে ডেটা এক্সট্র্যাক্ট করতে হয়।

2. The Problem: Unbound JSON Data [Priority: 9/10]

ধরে নাও তোমার একটি Controller আছে যেখানে তুমি Person অবজেক্ট রিসিভ করতে চাও।

[HttpPost("register")]
// Without [FromBody], this will fail to read JSON!
public IActionResult Register(Person person)
{
    return Ok(person);
}

তুমি যদি Postman থেকে JSON ডেটা পাঠাও, তাহলে তুমি দেখবে person অবজেক্টের ভেতরের সব প্রোপার্টি null হয়ে আছে। কারণ: ফ্রেমওয়ার্ক ডিফল্টভাবে Query String বা Form Fields-এ ডেটা খুঁজছে। সে জানেই না যে রিকোয়েস্টের বডিতে থাকা JSON স্ট্রিংটিকে পার্স (Parse) করতে হবে।

3. The Solution: [FromBody] and Input Formatters [Priority: 10/10]

এই সমস্যার সমাধান হলো [FromBody] Attribute। এটি ফ্রেমওয়ার্ককে স্পষ্ট ইনস্ট্রাকশন দেয় যে— “অন্য কোথাও ডেটা খুঁজবে না, সরাসরি Request Body-তে যাও এবং সেখান থেকে ডেটা পার্স করো।”

[HttpPost("register")]
// [FromBody] tells the framework to use Input Formatters
public IActionResult Register([FromBody] Person person)
{
    return Ok(person);
}

Behind the Scenes (How it works): যখনই তুমি [FromBody] ব্যবহার করো, ASP.NET Core তার ইন্টারনাল Input Formatters-কে কল করে। প্রজেক্টে ডিফল্টভাবেই JSON Input Formatter অ্যাড করা থাকে। এটি Request Body-তে থাকা JSON স্ট্রিংটিকে পড়ে এবং সেটিকে C#-এর Person অবজেক্টে ডেসিরিয়ালাইজ (Deserialize) করে দেয়।

4. Testing with Postman [Priority: 6/10]

JSON ডেটা পাঠানোর জন্য Postman-এ নিচের কনফিগারেশনটি ব্যবহার করতে হয়:

  1. POST রিকোয়েস্ট সিলেক্ট করো।
  2. Body ট্যাবে যাও।
  3. raw রেডিও বাটনটি সিলেক্ট করো।
  4. ড্রপডাউন থেকে JSON সিলেক্ট করো।

JSON Format Example:

{
  "personName": "Hasib",
  "email": "hasib@example.com",
  "phone": "01700000000"
}

(💡 VS Code Shortcut: VS Code (Linux)-এ JSON ডেটা বা কোড সুন্দরভাবে ফরম্যাট (Format Document) করার জন্য Ctrl + Shift + I ব্যবহার করতে পারো।)

🚀 Best Practices & .NET 10 Updates

যেহেতু তুমি .NET ইকোসিস্টেম নিয়ে কাজ করছো, ইন্ডাস্ট্রির লেটেস্ট স্ট্যান্ডার্ড এবং .NET 10-এর ফিচারগুলো জানা তোমার জন্য অত্যন্ত জরুরি। বর্তমান মডার্ন API ডেভেলপমেন্টে [FromBody] ম্যানুয়ালি লেখার চল অনেক কমে গেছে!

1. Modern Controllers with [ApiController] (Best Practice) Controller-এর ওপর যদি [ApiController] Attribute লাগানো থাকে, তবে ASP.NET Core অটোমেটিকভাবে বুঝতে পারে যে এটি একটি মডার্ন REST API। এই ক্ষেত্রে, কমপ্লেক্স টাইপের (Complex Types) জন্য ফ্রেমওয়ার্ক নিজেই [FromBody] ইনফার (Infer) করে নেয়। তোমাকে ম্যানুয়ালি লিখতে হবে না!

[ApiController] // <-- MAGIC HAPPENS HERE
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
    [HttpPost("register")]
    // NO NEED to write [FromBody] anymore! The framework handles it automatically.
    public IActionResult Register(Person person) 
    {
        return Ok(person);
    }
}

**2. .NET 10 & Minimal APIs using record** .NET 10-এ Minimal APIs ব্যবহার করাটা এখন সবচেয়ে বেশি পপুলার। Minimal API-তেও JSON বডি রিসিভ করার জন্য কোনো Attribute লেখার দরকার পড়ে না। ডেটা ট্রান্সফারের জন্য (DTO) record ব্যবহার করাটা বেস্ট প্র্যাকটিস।

// Using C# Record for Data Transfer Object
public record PersonDto(string PersonName, string Email, string Phone);
 
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
// Minimal API automatically binds JSON body to the complex type (PersonDto)
app.MapPost("/api/register", (PersonDto requestBody) =>
{
    // The JSON input is already parsed into 'requestBody' perfectly!
    return Results.Ok(new { Message = "Registration Successful", Data = requestBody });
});
 
app.Run();

পরবর্তী লেকচারে তুমি XML Input Formatter নিয়ে জানবে, তবে বর্তমান ইন্ডাস্ট্রিতে API ডেভেলপমেন্টের ক্ষেত্রে ৯৯% সময়ই JSON ব্যবহার করা হয়। এই টপিক নিয়ে কোনো প্রশ্ন থাকলে নির্দ্বিধায় করতে পারো!

Graph View

Backlinks