Quartz 5

14. Custom Model Binders

7 min read

হ্যালো! একজন ট্রেইনার হিসেবে তোমার দেওয়া লেকচার ট্রান্সক্রিপ্টটি আমি খুব গভীরভাবে অ্যানালাইজ করেছি। এই লেকচারটি মূলত ASP.NET Core এর একটি অ্যাডভান্সড টপিক— Custom Model Binder নিয়ে।

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

📝 Quick Summary for Revision

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

  • The “Why”: যখন ডিফল্ট Model Binding দিয়ে কাজ হয় না (যেমন: FirstName ও LastName মিলে একটি PersonName তৈরি করা, অথবা স্ট্রিংকে Enum-এ কনভার্ট করা), তখন Custom Model Binder ব্যবহার করতে হয়।
  • The Interface: একটি ক্লাসকে Custom Model Binder বানাতে হলে اسے অবশ্যই IModelBinder ইন্টারফেস ইমপ্লিমেন্ট করতে হবে।
  • The Core Method: IModelBinder ইন্টারফেসটি একটিমাত্র মেথড ইমপ্লিমেন্ট করতে বাধ্য করে, যার নাম BindModelAsync।
  • Extracting Data: রিকোয়েস্ট থেকে ডেটা পড়ার জন্য bindingContext.ValueProvider এর GetValue() মেথড ব্যবহার করা হয়।
  • Returning the Object: ম্যানুয়ালি Model-এর অবজেক্ট তৈরি করে তাতে ডেটা বসানোর পর, bindingContext.Result = ModelBindingResult.Success(object) এর মাধ্যমে রেজাল্ট রিটার্ন করতে হয়।
  • Application: Controller-এর Action Method-এ প্যারামিটারের আগে [ModelBinder(BinderType = typeof(YourCustomBinder))] ব্যবহার করে ফ্রেমওয়ার্ককে বলে দিতে হয় যে ডিফল্টের বদলে এই Custom Binder-টি ব্যবহার করতে হবে।
  • Validation: Custom Model Binding এর পরও তোমার মডেলের সব Validation (যেমন [Required], Custom Validators) আগের মতোই নিখুঁতভাবে কাজ করবে।

🧠 Comprehensive Breakdown

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

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

The Context: সাধারণত ASP.NET Core-এ যখন কোনো Request আসে, তখন ডিফল্ট Model Binding অটোমেটিকভাবে HTML Form বা JSON এর নামগুলোর সাথে Model-এর Property-গুলোর নাম মিলিয়ে ডেটা বসিয়ে দেয়। কিন্তু রিয়েল-ওয়ার্ল্ড প্রোজেক্টে মাঝে মাঝে আমাদের Complex Logic অ্যাপ্লাই করতে হয়।

Examples from Lecture:

  1. ইউজার ফর্ম থেকে FirstName এবং LastName পাঠিয়েছে, কিন্তু তোমার ডাটাবেজ মডেলে শুধু একটি প্রোপার্টি আছে— PersonName। তোমাকে এই দুটি স্ট্রিং যুক্ত (Concatenate) করে মডেলে বসাতে হবে।
  2. ইউজার Year, Month, Date আলাদা পাঠিয়েছে, কিন্তু তোমার মডেলে সেটি একটি DateTime অবজেক্ট হিসেবে সেভ করতে হবে।
  3. একটি কমা দিয়ে আলাদা করা স্ট্রিং (যেমন: abcStreet, pqrCity) থেকে ভ্যালু স্প্লিট করে মডেলের Street এবং City প্রোপার্টিতে বসাতে হবে।

এই ধরনের ম্যানুয়াল কন্ট্রোল বা ডেটা ম্যানিপুলেশনের জন্যই Custom Model Binder প্রয়োজন হয়। তবে ইন্সট্রাক্টর একটি ওয়ার্নিং দিয়েছেন— এটি রিয়েল-ওয়ার্ল্ড প্রোজেক্টে খুব রেয়ারলি (Rarely) ব্যবহার হয়। যখন তোমার চরম লেভেলের কন্ট্রোল লাগবে, ঠিক তখনই এটি ব্যবহার করবে।

2. Creating the Custom Model Binder Class [Priority: 10/10]

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

The Visual Studio Shortcut: ক্লাসটিকে Custom Binder বানাতে হলে IModelBinder ইন্টারফেস লিখতে হবে। এরপর এই ইন্টারফেসের ওপর Right Click -> Quick Actions -> Implement Interface সিলেক্ট করলে (অথবা Ctrl + . চাপলে) অটোমেটিকভাবে BindModelAsync মেথডটি তৈরি হয়ে যাবে।

using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc.ModelBinding;
 
namespace YourProject.CustomModelBinders
{
    public class PersonModelBinder : IModelBinder
    {
        // This is the core method where the magic happens
        public Task BindModelAsync(ModelBindingContext bindingContext)
        {
            // We will write the logic here
        }
    }
}

3. Extracting Data using ValueProvider [Priority: 10/10]

এখন আমাদের রিকোয়েস্ট থেকে ডেটা এক্সট্র্যাক্ট করতে হবে। এর জন্য bindingContext.ValueProvider ব্যবহার করা হয়।

আমরা প্রথমে একটি Person মডেলের অবজেক্ট বানাবো। এরপর FirstName এবং LastName নিয়ে সেটিকে PersonName-এ যুক্ত করব।

public Task BindModelAsync(ModelBindingContext bindingContext)
{
    // 1. Manually create the model object
    Person person = new Person();
 
    // 2. Extract FirstName using ValueProvider
    var firstNameResult = bindingContext.ValueProvider.GetValue("FirstName");
    
    // Check if the value actually exists in the request
    if (firstNameResult.Length > 0)
    {
        // FirstValue gets the first matching value (useful if there are duplicate keys like array submissions)
        person.PersonName = firstNameResult.FirstValue;
    }
 
    // 3. Extract LastName and concatenate
    var lastNameResult = bindingContext.ValueProvider.GetValue("LastName");
    if (lastNameResult.Length > 0)
    {
        // Appending a space and the last name to the existing PersonName
        person.PersonName += " " + lastNameResult.FirstValue;
    }
 
    // ... (Code continues below)
}

4. Casting Data Types for other Properties [Priority: 7/10]

স্ট্রিং ছাড়াও অন্যান্য ডেটা টাইপের (যেমন: double, DateTime) ক্ষেত্রে ValueProvider থেকে স্ট্রিং ভ্যালু পাওয়ার পর সেটিকে ম্যানুয়ালি কাস্ট (Cast) বা কনভার্ট করে নিতে হয়।

    // Extracting Email
    var emailResult = bindingContext.ValueProvider.GetValue("Email");
    if (emailResult.Length > 0)
    {
        person.Email = emailResult.FirstValue;
    }
 
    // Extracting Price (Needs Conversion to Double)
    var priceResult = bindingContext.ValueProvider.GetValue("Price");
    if (priceResult.Length > 0)
    {
        person.Price = Convert.ToDouble(priceResult.FirstValue);
    }

5. Returning the Result [Priority: 9/10]

সব প্রোপার্টিতে ভ্যালু বসানো হয়ে গেলে, আমাদের ফ্রেমওয়ার্ককে জানাতে হবে যে Model Binding সফল হয়েছে এবং এই নাও তোমার তৈরি করা অবজেক্ট।

যেহেতু মেথডের রিটার্ন টাইপ Task, তাই শেষে Task.CompletedTask রিটার্ন করতে হয়।

    // Attach the created person object to the binding context result
    bindingContext.Result = ModelBindingResult.Success(person);
 
    // Return completed task
    return Task.CompletedTask;
} // End of BindModelAsync method

6. Applying the Custom Binder in the Controller [Priority: 10/10]

ক্লাস তো বানানো হলো, কিন্তু ডিফল্ট Model Binding-এর বদলে ফ্রেমওয়ার্ক এই নতুন ক্লাসটি ব্যবহার করবে কিভাবে? এর জন্য Action Method-এ প্যারামিটারের আগে [ModelBinder] Attribute ব্যবহার করে ক্লাসের টাইপটি (BinderType) বলে দিতে হবে।

using Microsoft.AspNetCore.Mvc;
using YourProject.Models;
using YourProject.CustomModelBinders; // Import the namespace
 
public class HomeController : Controller
{
    [HttpPost("register")]
    // Forcing ASP.NET Core to use OUR PersonModelBinder instead of the default one
    public IActionResult Register([ModelBinder(BinderType = typeof(PersonModelBinder))] Person person)
    {
        return Ok(person);
    }
}

7. The Execution Flow & Model Validations [Priority: 8/10]

লেকচারের একদম শেষে একটি খুব দারুণ পয়েন্ট ক্লিয়ার করা হয়েছে। Custom Model Binder ব্যবহার করলে কি তোমার আগের ক্লাসে লেখা Model Validations (যেমন [Required], Custom Attributes) নষ্ট হয়ে যাবে?

উত্তর: না! ফ্রেমওয়ার্কের Execution Flow হলো: Routing ➡️ Custom Model Binding (Creates the Object) ➡️ Model Validation (Checks the created Object) ➡️ Action Method

যেহেতু অবজেক্টটি তৈরি হওয়ার পর Validation কাজ করে, তাই তোমার কোনো Validation Logic পরিবর্তন করার প্রয়োজন নেই। সব আগের মতোই নিখুঁতভাবে কাজ করবে।

🚀 Best Practices & .NET 10 Updates

যেহেতু তুমি .NET ইকোসিস্টেম নিয়ে কাজ করছো, ইন্ডাস্ট্রির লেটেস্ট স্ট্যান্ডার্ডগুলো জেনে রাখা অত্যন্ত জরুরি:

1. Best Practice: Avoid Custom Model Binders (Use DTOs instead) লেকচারার নিজেই বলেছেন, এটি খুব রেয়ারলি ব্যবহার করা উচিত। ইন্ডাস্ট্রিতে FirstName এবং LastName যুক্ত করার মতো কাজের জন্য Custom Model Binder লেখাটা একটি Anti-Pattern। এর বদলে DTO (Data Transfer Object) প্যাটার্ন ব্যবহার করা হয়। রিকোয়েস্ট থেকে সরাসরি একটি RegistrationDto (যাতে FirstName ও LastName আলাদা থাকে) রিসিভ করা হয়, এবং Controller বা Service Layer-এ সেগুলোকে ম্যানুয়ালি যুক্ত করে মেইন ডাটাবেজ Model-এ ম্যাপ করা হয় (যেমন AutoMapper বা Mapster ব্যবহার করে)। এটি অনেক বেশি ক্লিন এবং মেইনটেইন করা সহজ।

2. Null Safety (TryParse instead of Convert) আমাদের কোডে Convert.ToDouble() ব্যবহার করা হয়েছে। রিয়েল-ওয়ার্ল্ডে ইউজার যদি Price-এর জায়গায় “ABC” লিখে পাঠায়, তাহলে Convert মেথডটি অ্যাপ্লিকেশন ক্র্যাশ (Exception) করাবে। তাই সবসময় double.TryParse() বা DateTime.TryParse() ব্যবহার করা উচিত।

**3. Modern .NET 10 Approach: TryParse in Models & AsParameters** .NET 8 থেকে .NET 10 এ Minimal APIs এবং Controller-এ Custom Binding এর জন্য নতুন ফিচার এসেছে। এখন আর এতো বড় IModelBinder ক্লাস না লিখে, সরাসরি Model ক্লাসের ভেতরেই একটি TryParse মেথড বা BindAsync স্ট্যাটিক মেথড লিখে দিলে ফ্রেমওয়ার্ক অটোমেটিক্যালি সেটিকে Custom Binder হিসেবে চিনে নেয়!

.NET 10 Modern Code Example:

// No need to create a separate CustomBinder class!
public class Person
{
    public string PersonName { get; set; }
 
    // ASP.NET Core 10 automatically looks for this static BindAsync method!
    public static async ValueTask<Person?> BindAsync(HttpContext context, ParameterInfo parameter)
    {
        var form = await context.Request.ReadFormAsync();
        
        var firstName = form["FirstName"].ToString();
        var lastName = form["LastName"].ToString();
 
        return new Person 
        { 
            PersonName = $"{firstName} {lastName}".Trim() 
        };
    }
}
 
// In your Minimal API or Controller:
// It automatically calls BindAsync internally! No [ModelBinder] attribute needed.
app.MapPost("/register", (Person person) => 
{
    return Results.Ok(person);
});

এই লেকচারটি ইন্টারভিউ এবং ফ্রেমওয়ার্ক কিভাবে কাজ করে তার “Under the hood” মেকানিজম বোঝার জন্য দুর্দান্ত। তবে প্রোডাকশনে আধুনিক পদ্ধতি (DTO বা BindAsync) ব্যবহার করাই উত্তম।

Graph View

Backlinks