6. Introduction to Model Validations

এখানে তোমার দেওয়া লেকচার ট্রান্সক্রিপ্টটির একটি বিস্তারিত এবং সহজবোধ্য বিশ্লেষণ দেওয়া হলো।

📝 Quick Summary for Revision

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

• The Problem: Action Method-এর ভেতরে if statement দিয়ে প্রতিটি ফিল্ড ম্যানুয়ালি ভ্যালিডেট করাটা Repetitive এবং Lengthy। এটি DRY (Don’t Repeat Yourself) Principle ব্রেক করে।
• The Solution: Model Validation ব্যবহার করা। এর মাধ্যমে Model Class-এর Property-র ঠিক ওপরে Attribute (যেমন: [Required]) বসিয়ে রুলস সেট করা যায়।
• Project Setup: একটি ASP.NET Core Empty প্রজেক্ট তৈরি করে Routing, Controllers এবং Static Files কনফিগার করা হয়েছে।
• Model & Controller: Person নামে একটি Model Class এবং HomeController তৈরি করা হয়েছে ডেটা রিসিভ করার জন্য।
• Data Annotations: [Required] Attribute-টি System.ComponentModel.DataAnnotations Namespace থেকে আসে, যা নিশ্চিত করে Property যেন Null বা Empty না হয়।
• Execution Flow: একটি Request আসলে প্রথমে Model Binding কাজ করে, এরপর Model Validation এক্সিকিউট হয় এবং সবশেষে Action Method রান করে।

---

🧠 Comprehensive Breakdown

এখানে লেকচারের প্রতিটি কনসেপ্ট বিস্তারিতভাবে ব্যাখ্যা করা হলো।

The Problem: Manual Validation in Action Methods [Priority: 10/10]

Why do we need Model Validation? লেকচারের শুরুতেই একটি সমস্যার কথা বলা হয়েছে। ধরি, আমাদের একটি BookId আছে। এখন এটি Null কি না, 0 এর সমান বা ছোট কি না, অথবা 1000 এর চেয়ে বড় কি না—এই তিনটি রুল চেক করার জন্য Action Method-এর ভেতরে তিনটি আলাদা if statement লিখতে হবে।

Real-world প্রজেক্টে একটি Registration Form-এ অনেক ফিল্ড থাকে (Name, Email, Phone, Password)। প্রতিটি ফিল্ডের জন্য যদি আমরা এভাবে if statement লিখে Validation করি এবং Error হিসেবে BadRequest রিটার্ন করি, তবে কোডটি অত্যন্ত Lengthy এবং Repetitive হয়ে যাবে। এই সমস্যা সমাধানের জন্যই Model Validations-এর কনসেপ্টটি এসেছে।

The Solution: Model Validation Attributes [Priority: 10/10]

Model Validation-এর মাধ্যমে আমরা Action Method-এর ভেতরে ভ্যালিডেশন লজিক না লিখে, সরাসরি Model Class-এর Property-র ওপরে Attribute হিসেবে রুলগুলো বসিয়ে দিই। যেমন, কোনো ফিল্ড যদি বাধ্যতামূলক হয়, তবে আমরা [Required] Attribute ব্যবহার করি। এতে কোড অনেক বেশি Readable এবং Clean হয়।

Project Setup (ASP.NET Core Empty) [Priority: 5/10]

নতুন একটি ASP.NET Core Empty প্রজেক্ট (ModelValidationsExample) তৈরি করে Routing এবং Controllers এনাবল করার জন্য Program.cs এ নিচের কোডগুলো অ্যাড করা হয়। (কেন? কারণ Empty টেমপ্লেটে বাই-ডিফল্ট Controller কাজ করে না, Dependency Injection-এ Controller সার্ভিস অ্যাড করতে হয়।)

// Program.cs 
var builder = WebApplication.CreateBuilder(args);
 
// Add controllers as services for Dependency Injection
builder.Services.AddControllers();
 
var app = builder.Build();
 
app.UseStaticFiles();
app.UseRouting();
app.MapControllers(); // Map route paths to Controller actions
 
app.Run();
 

Creating the Model Class [Priority: 8/10]

প্রজেক্টে Models ফোল্ডার তৈরি করে সেখানে Person.cs নামে একটি Model Class তৈরি করা হয়েছে। এখানে Form Data রিসিভ করার জন্য কিছু Properties ডিক্লেয়ার করা হয়েছে।

• Phone (?): Phone property-র শেষে ? দেওয়া হয়েছে, যার মানে এটি Nullable (অর্থাৎ ইউজার চাইলে এটি ফাঁকা রাখতে পারে)।
• ToString() Override: System.Object ক্লাসের ToString() মেথডটিকে Override করা হয়েছে, যেন Action Method থেকে খুব সহজেই Person অবজেক্টের সব ডেটা String হিসেবে রিটার্ন করা যায়।

using System;
 
namespace ModelValidationsExample.Models
{
    public class Person
    {
        public string? PersonName { get; set; }
        public string? Email { get; set; }
        public string? Phone { get; set; } // Nullable
        public string? Password { get; set; }
        public string? ConfirmPassword { get; set; }
        public double? Price { get; set; }
 
        // Overriding ToString to print all properties easily
        public override string ToString()
        {
            return $"Name: {PersonName}, Email: {Email}, Phone: {Phone}, Password: {Password}, ConfirmPassword: {ConfirmPassword}, Price: {Price}";
        }
    }
}
 

💡 Shortcuts:

• Visual Studio: নতুন ক্লাস বা আইটেম অ্যাড করার শর্টকাট হলো Ctrl + Shift + A।

• VS Code: এক্সপ্লোরার প্যানেলে গিয়ে সরাসরি New File আইকনে ক্লিক করতে হয়। অথবা C# Dev Kit এক্সটেনশন ব্যবহার করলে Command Palette (Ctrl + Shift + P) ওপেন করে C#: New Class টাইপ করে ক্লাস জেনারেট করা যায়।

Creating the Controller and Action Method [Priority: 8/10]

এরপর Controllers ফোল্ডারে HomeController তৈরি করা হয়েছে।

• Model Binding: Action Method-এর প্যারামিটার হিসেবে Person অবজেক্ট রিসিভ করা হয়েছে। Developer হিসেবে তোমাকে ম্যানুয়ালি Request থেকে ডেটা নিয়ে অবজেক্ট বানাতে হবে না। Model Binding মেকানিজম অটোমেটিকভাবে Form Data, Route Data বা Query String থেকে ডেটা নিয়ে Person অবজেক্ট তৈরি করে দেবে।

using Microsoft.AspNetCore.Mvc;
using ModelValidationsExample.Models;
 
namespace ModelValidationsExample.Controllers
{
    public class HomeController : Controller
    {
        [Route("register")]
        public IActionResult Index(Person person)
        {
            // By default, calling the object inside Content() calls its ToString() method
            return Content(person.ToString()); 
        }
    }
}
 

Testing with Postman [Priority: 7/10]

অ্যাপ্লিকেশন রান করার পর Postman-এ গিয়ে http://localhost:5166/register URL-এ একটি POST Request পাঠানো হয়। Request Body-তে form-data বা x-www-form-urlencoded সিলেক্ট করে Person-এর ভ্যালুগুলো দেওয়া হয়। Model Binding সফলভাবে ডেটাগুলো রিসিভ করে এবং Response হিসেবে ToString() এর আউটপুট দেখায়।

Implementing Data Annotations ([Required]) [Priority: 10/10]

এই লেকচারের মূল ফোকাস হলো Validation অ্যাপ্লাই করা। আমরা চাই PersonName যেন খালি না থাকে। এর জন্য System.ComponentModel.DataAnnotations Namespace ইমপোর্ট করে PersonName Property-র ওপর [Required] Attribute বসাতে হবে।

using System.ComponentModel.DataAnnotations;
 
namespace ModelValidationsExample.Models
{
    public class Person
    {
        [Required] // Validation Attribute
        public string? PersonName { get; set; }
        
        // ... other properties
    }
}
 

The Execution Pipeline: লেকচারের শেষে একটি অত্যন্ত গুরুত্বপূর্ণ বিষয় ক্লিয়ার করা হয়েছে। একটি রিকোয়েস্ট আসার পর ব্যাকএন্ডে কী ঘটে?

1. Request Submitted: ইউজার Postman বা ব্রাউজার থেকে ডেটা পাঠায়।
2. Model Binding Executes: ASP.NET Core ফ্রেমওয়ার্ক ডেটাগুলো কালেক্ট করে Person অবজেক্ট তৈরি করে।
3. Model Validation Takes Place: Model Binding শেষ হওয়ার পর Validation শুরু হয়। এটি চেক করে Model-এ কোনো Attribute (যেমন: [Required]) আছে কি না। যদি কোনো রুল ব্রেক হয়, তবে সেটি Validation Error হিসেবে ট্রিট হয়।
4. Action Method Executes: এরপর Action Method রান করে।

(নোট: লেকচারটিতে দেখানো হয়েছে যে PersonName Null পাঠানোর পরও Action Method ডেটা রিটার্ন করছে। কারণ Error হ্যান্ডেল করার লজিক পরবর্তী লেকচারে দেখানো হবে বলা হয়েছে।)

---

🚀 Best Practices & .NET 10 Updates

যেহেতু তুমি .NET ইকোসিস্টেম নিয়ে কাজ করছো, তাই লেকচারের পুরোনো প্যাটার্নের পাশাপাশি লেটেস্ট Best Practices এবং .NET 10 / C# 13-এর আপডেটগুলো জেনে রাখা অত্যন্ত জরুরি:

1. Validating the State (Best Practice for MVC/Controllers)

লেকচারে Validation Error হ্যান্ডেল করা হয়নি। Controller-এ Model Validation সফল হয়েছে কি না, তা চেক করার জন্য সবসময় ModelState.IsValid ব্যবহার করা উচিত।

[HttpPost]
[Route("register")]
public IActionResult Index(Person person)
{
    // Check if the model passes all validation rules (like [Required])
    if (!ModelState.IsValid)
    {
        // Return 400 Bad Request with the validation error details
        return BadRequest(ModelState); 
    }
    
    return Ok(person);
}
 

2. .NET 10 & C# 13 Updates: Minimal APIs and Primary Constructors

আধুনিক .NET ডেভেলপমেন্টে (বিশেষ করে .NET 8, 9 এবং 10 এ) ভারি MVC Controller-এর বদলে Minimal APIs ব্যাপকভাবে ব্যবহৃত হয়। আর C# 12/13 এর Primary Constructors ব্যবহার করে Model Class-কে আরও ছোট ও ক্লিন করা যায়।

নিচে .NET 10 এবং C# 13 ব্যবহার করে সম্পূর্ণ লেকচারের কাজটি মাত্র কয়েক লাইন কোডে করে দেখানো হলো:

using System.ComponentModel.DataAnnotations;
 
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
// C# 13 Primary Constructor + Data Annotations
public class Person
{
    [Required(ErrorMessage = "Name is strictly required!")]
    public string? PersonName { get; set; }
    public string? Email { get; set; }
    // ... other properties
}
 
// .NET 10 Minimal API Route with built-in Model Validation Filter
// Minimal APIs automatically validate the model and return 400 Bad Request if invalid!
app.MapPost("/register", (Person person) =>
{
    return Results.Ok($"Registration successful for: {person.PersonName}");
});
 
app.Run();
 

Why this is better: Minimal API-তে ModelState.IsValid ম্যানুয়ালি চেক করারও প্রয়োজন পড়ে না। 프েমওয়ার্ক নিজেই Validation Attribute চেক করে এবং ইনভ্যালিড হলে অটোমেটিকভাবে 400 BadRequest এবং Error Message রিটার্ন করে দেয়।