15. Model Binder Providers

হ্যালো! একজন ট্রেইনার হিসেবে তোমার দেওয়া লেকচার ট্রান্সক্রিপ্টটি আমি খুব গভীরভাবে অ্যানালাইজ করেছি। আগের লেকচারে আমরা Custom Model Binder তৈরি করা শিখেছিলাম। আর এই লেকচারে আমরা শিখব কীভাবে সেই Custom Model Binder-কে পুরো প্রজেক্ট জুড়ে Globally অ্যাপ্লাই করতে হয়, যার জন্য Custom Model Binder Provider ব্যবহার করা হয়।

চলো প্রথমে একটি কুইক সামারি দেখে নিই, তারপর ধাপে ধাপে পুরো বিষয়টা বিস্তারিতভাবে বুঝবো।

---

📝 Quick Summary for Revision

ভবিষ্যতে দ্রুত রিভিশন দেওয়ার জন্য লেকচারের মূল পয়েন্টগুলো নিচে লিস্ট করা হলো:

• The Problem: প্রতিটি Action Method-এ বারবার [ModelBinder] Attribute লেখাটা বিরক্তিকর এবং Large Projects-এর ক্ষেত্রে মেইনটেইন করা কঠিন।
• The Solution: একটি ModelBinderProvider তৈরি করে Custom Model Binder-কে গ্লোবালি ডিক্লেয়ার করা।
• The Interface: Provider তৈরি করার জন্য IModelBinderProvider ইন্টারফেস ইমপ্লিমেন্ট করতে হয়।
• The Logic: GetBinder মেথডের ভেতরে চেক করতে হয় যে Model-এর টাইপটি আমাদের কাঙ্ক্ষিত টাইপ (যেমন: Person) কি না। যদি হয়, তবে আমাদের Custom Binder রিটার্ন করতে হয়।
• Global Registration: Program.cs ফাইলে AddControllers অপশনের ভেতরে options.ModelBinderProviders.Insert(0, new PersonBinderProvider()); লিখে একে রেজিস্টার করতে হয়।
• Why Index 0? ডিফল্ট Model Binder-গুলোর আগে যেন আমাদের Custom Binder প্রায়োরিটি পায়, সেজন্য একে 0 নম্বর ইনডেক্সে রাখতে হয়।

---

🧠 Comprehensive Breakdown

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

1. Why do we need a Custom Model Binder Provider? [Priority: 8/10]

কেন এটি প্রয়োজন? আগের লেকচারে আমরা দেখেছিলাম, Custom Model Binder ব্যবহার করতে হলে Controller-এর Action Method-এর প্যারামিটারে নিচের মতো করে Attribute বসাতে হয়:

public IActionResult Register([ModelBinder(BinderType = typeof(PersonModelBinder))] Person person)
 

ছোট প্রোজেক্টের জন্য এটি ঠিক আছে। কিন্তু ধরো, তোমার প্রোজেক্টে এমন ৫০টি Action Method আছে যেখানে Person মডেল রিসিভ করা হয়। তোমাকে ৫০ জায়গাতেই এই Attribute ম্যানুয়ালি লিখতে হবে! এটি DRY (Don’t Repeat Yourself) প্রিন্সিপাল ব্রেক করে।

এই সমস্যার সমাধান হলো Custom Model Binder Provider। এটি একবার কনফিগার করলে, পুরো প্রজেক্টে যেখানেই Person টাইপের ডেটা আসবে, ফ্রেমওয়ার্ক অটোমেটিকভাবে তোমার Custom Model Binder কল করবে। কোনো Attribute লেখার দরকার হবে না।

2. Creating the Binder Provider Class (IModelBinderProvider) [Priority: 10/10]

প্রথমে CustomModelBinders ফোল্ডারে PersonBinderProvider.cs নামে একটি ক্লাস তৈরি করতে হবে এবং একে IModelBinderProvider ইন্টারফেস থেকে ইনহেরিট করতে হবে।

(VS Code Shortcut: নতুন ক্লাস তৈরি করার জন্য ফোল্ডারের ওপর রাইট ক্লিক করে New File সিলেক্ট করতে পারো, অথবা C# Dev Kit থাকলে Command Palette Ctrl+Shift+P ওপেন করে C#: New Class ব্যবহার করতে পারো।)

using Microsoft.AspNetCore.Mvc.ModelBinding;
using Microsoft.AspNetCore.Mvc.ModelBinding.Binders;
using YourProject.Models; // For the Person class
 
namespace YourProject.CustomModelBinders
{
    // Implement the interface
    public class PersonBinderProvider : IModelBinderProvider
    {
        // This method will be generated automatically
        public IModelBinder? GetBinder(ModelBinderProviderContext context)
        {
            // We will write the logic here
        }
    }
}
 

3. Implementing the GetBinder Logic [Priority: 10/10]

GetBinder মেথডটি Model Binding প্রসেস শুরু হওয়ার ঠিক আগে কল হয়। এর কাজ হলো ফ্রেমওয়ার্ককে বলে দেওয়া যে, “এই রিকোয়েস্টের জন্য কোন Model Binder ব্যবহার করতে হবে?”

এখানে আমাদের চেক করতে হবে যে, ইউজার যেই ডেটা পাঠিয়েছে সেটি কি Person টাইপের কি না।

public IModelBinder? GetBinder(ModelBinderProviderContext context)
{
    // Check if the expected model type is "Person"
    if (context.Metadata.ModelType == typeof(Person))
    {
        // If yes, return our custom PersonModelBinder
        // We use BinderTypeModelBinder to wrap our custom binder class
        return new BinderTypeModelBinder(typeof(PersonModelBinder));
    }
 
    // If it's any other model (like Product, Order), return null.
    // Returning null tells the framework to use the Default Model Binding.
    return null;
}
 

Why this logic? আমরা চাই না যে প্রোজেক্টের সব ক্লাসের ওপর আমাদের PersonModelBinder কাজ করুক। আমরা শুধুমাত্র তখনি এটি ফায়ার করব যখন Model-এর টাইপ হবে Person।

4. Registering the Provider Globally in Program.cs [Priority: 10/10]

ক্লাস তো বানানো হলো, কিন্তু ফ্রেমওয়ার্ককে এটি চিনিয়ে দিতে হবে। এর জন্য Program.cs (বা লিগ্যাসি কোডে Startup.cs) ফাইলে গিয়ে AddControllers সার্ভিসের ভেতরে অপশন কনফিগার করতে হবে।

using YourProject.CustomModelBinders;
 
var builder = WebApplication.CreateBuilder(args);
 
// Registering Controllers with Options
builder.Services.AddControllers(options =>
{
    // Inserting our Custom Binder Provider at Index 0
    options.ModelBinderProviders.Insert(0, new PersonBinderProvider());
});
 
var app = builder.Build();
// ... rest of the pipeline
 

Why Insert(0) instead of Add()? এটি খুবই গুরুত্বপূর্ণ একটি কনসেপ্ট! ফ্রেমওয়ার্কের ভেতরে আগে থেকেই অনেকগুলো Default Model Binder Provider (যেমন JSON, Form Data এর জন্য) সাজানো থাকে। তুমি যদি options.ModelBinderProviders.Add(...) ব্যবহার করো, তবে তোমার Provider-টি লিস্টের একদম শেষে যুক্ত হবে। ফলে ডিফল্ট Provider-গুলো আগেই এক্সিকিউট হয়ে যাবে এবং তোমার কাস্টম লজিক পর্যন্ত ফ্রেমওয়ার্ক পৌঁছাবেই না। তাই Insert(0) ব্যবহার করে আমরা আমাদের Provider-টিকে লিস্টের একদম শুরুতে (First Place) বসিয়ে দিই, যেন ফ্রেমওয়ার্ক সবার আগে আমাদের কাস্টম লজিক চেক করে।

5. The Clean Action Method & Execution Flow [Priority: 7/10]

সবকিছু কনফিগার করার পর, এখন তোমার Controller-এর Action Method একদম ক্লিন হয়ে যাবে। আগের লেকচারের [ModelBinder] Attribute টি আর দরকার নেই।

[HttpPost("register")]
// No attributes needed here anymore! The Provider handles it globally.
public IActionResult Register(Person person) 
{
    return Ok(person);
}
 

Execution Flow: যখন কোনো রিকোয়েস্ট আসে, তখন নিচের ফ্লো-টি কাজ করে:

1. Routing: রিকোয়েস্টটি Register Action Method-এ আসবে।
2. Model Binder Provider: ফ্রেমওয়ার্ক দেখবে প্যারামিটারটি Person টাইপের। সে options.ModelBinderProviders এর লিস্ট চেক করবে। Index 0-তে থাকা আমাদের PersonBinderProvider বলবে, “হ্যাঁ, এই টাইপের জন্য আমার কাছে PersonModelBinder আছে।”
3. Custom Model Binder: তোমার লেখা PersonModelBinder এক্সিকিউট হবে (যেমন FirstName ও LastName যুক্ত করা)।
4. Model Validation: এরপর ডাটা অ্যানোটেশন বা Custom Validation চেক হবে।
5. Action Method: সবশেষে Controller-এ ডাটা পৌঁছাবে।

---

🚀 Best Practices & .NET 10 Updates

1. Avoid Over-engineering (Best Practice) লেকচারার অত্যন্ত চমৎকার একটি কথা বলেছেন— “In the real world projects, it is pretty rare to use the custom model binding”. সত্যি বলতে, এই Custom Model Binder এবং Provider গুলো .NET ফ্রেমওয়ার্কের একদম “Core Under-the-hood” কনসেপ্ট। এগুলোর মেইনটেন্যান্স অনেক জটিল। ইন্ডাস্ট্রি স্ট্যান্ডার্ড বেস্ট প্র্যাকটিস হলো DTO (Data Transfer Object) প্যাটার্ন ব্যবহার করা। Model Binder দিয়ে FirstName ও LastName যুক্ত করার বদলে, সরাসরি একটি PersonDto রিসিভ করে Controller বা Service Layer-এ সেগুলোকে যুক্ত করাটা অনেক বেশি ক্লিন এবং বোধগম্য।

2. Modern .NET 10 Equivalent (BindAsync in Models) .NET 10 এবং Minimal APIs-এর যুগে, গ্লোবালি ModelBinderProvider তৈরি করার প্রায় কোনো দরকারই পড়ে না। যদি তোমার কোনো নির্দিষ্ট ক্লাসের জন্য Custom Binding দরকারই হয়, তবে তুমি সরাসরি সেই Model ক্লাসের ভেতরে BindAsync নামে একটি স্ট্যাটিক মেথড লিখে দিতে পারো। ফ্রেমওয়ার্ক অটোমেটিকভাবে সেটিকে চিনে নেবে। Provider বানানোর কোনো দরকার নেই!

.NET 10 Modern Approach:

public class Person
{
    public string PersonName { get; set; }
 
    // ASP.NET Core 10 natively looks for this signature for Custom Binding
    public static ValueTask<Person?> BindAsync(HttpContext context)
    {
        // Custom logic to read request and build the Person object
        var firstName = context.Request.Form["FirstName"].ToString();
        var lastName = context.Request.Form["LastName"].ToString();
 
        var person = new Person 
        { 
            PersonName = $"{firstName} {lastName}" 
        };
        
        return ValueTask.FromResult<Person?>(person);
    }
}
 
// And in your Minimal API, it just magically works!
app.MapPost("/register", (Person person) => 
{
    return Results.Ok(person);
});
 

সংক্ষিপ্ত কথা: এই লেকচারটি ASP.NET Core এর ইন্টারনাল আর্কিটেকচার বোঝার জন্য অসাধারণ। তবে প্রোডাকশনে কোড করার সময় আধুনিক .NET 10 এর ফিচার (BindAsync) বা DTO প্যাটার্ন ব্যবহার করাই সবচেয়ে ভালো।