Quartz 5

4. Model Class

5 min read

একজন Software Engineering Trainer হিসেবে আমি আপনার দেওয়া লেকচার ট্রান্সক্রিপ্টটি অত্যন্ত সূক্ষ্মভাবে বিশ্লেষণ করেছি। নিচে সম্পূর্ণ বিষয়ের একটি সহজবোধ্য সারসংক্ষেপ এবং বিস্তারিত আলোচনা দেওয়া হলো।

📝 Quick Revision Summary

  • Model Class: এটি একটি ক্লাস যা Request থেকে আসা ডেটার স্ট্রাকচার বা রূপরেখা নির্ধারণ করে।
  • Automatic Instantiation: Action Method-এ Model-কে Parameter হিসেবে দিলে Model Binding স্বয়ংক্রিয়ভাবে তার একটি Object তৈরি করে নেয়।
  • Property Mapping: Route Data বা Query String থেকে ডেটা নিয়ে Model-এর সংশ্লিষ্ট Property-তে স্বয়ংক্রিয়ভাবে ম্যাপ করা হয় (এটি Case-Insensitive)।
  • Validation: ডেটা না থাকলে Runtime Error হয় না, ভ্যালু null থাকে। তাই Developer-কে ম্যানুয়ালি Validation চেক করতে হয়।
  • [FromQuery] on Parameter: Action Method-এর প্যারামিটারে এটি ব্যবহার করলে পুরো Model Object-এর ডেটা শুধুমাত্র Query String থেকে রিসিভ হয়।
  • [FromQuery] on Property: Model Class-এর ভেতরের নির্দিষ্ট কোনো Property-তে এটি ব্যবহার করলে, শুধুমাত্র সেই Property-টি Query String থেকে ডেটা নেবে।

🔍 Comprehensive Breakdown

এখানে ট্রান্সক্রিপ্টের প্রতিটি বিষয় ধাপে ধাপে, কারণসহ (Why) এবং কোড ইমপ্লিমেন্টেশনসহ ব্যাখ্যা করা হলো:

১. Introduction to Model Classes (Priority: 9/10)

Why (কেন প্রয়োজন): আগের লেকচারগুলোতে আমরা দেখেছি একাধিক আলাদা আলাদা Parameter (int bookId, string otherName) ব্যবহার করে ডেটা রিসিভ করা হতো। কিন্তু যখন একটি ফর্মে ২০টি ফিল্ড থাকে, তখন ২০টি Parameter লেখা ক্লিন কোডের পরিপন্থী। Model Class ব্যবহার করে আমরা সমস্ত ডেটাকে একটি একক Object বা প্যাকেজে আবদ্ধ করতে পারি। এটি Request রিসিভ করা এবং Response পাঠানোর স্ট্রাকচার হিসেবে কাজ করে।

২. Creating a Model Class (Priority: 8/10)

কিভাবে করবেন: প্রজেক্টকে গোছানো রাখার জন্য সব Model Class-কে একটি আলাদা ফোল্ডারে রাখা ভালো প্র্যাকটিস। ১. প্রজেক্টে রাইট ক্লিক করে Models নামের একটি ফোল্ডার তৈরি করুন। ২. এর ভেতরে Book.cs নামের একটি C# Class তৈরি করুন।

Code Implementation:

namespace ProjectName.Models
{
    public class Book
    {
        public int? BookId { get; set; }
        public string Other { get; set; }
 
        // ToString() মেথডটি Override করা হয়েছে যাতে Object প্রিন্ট করলে ডেটাগুলো সুন্দরভাবে স্ট্রিং আকারে দেখায়।
        public override string ToString()
        {
            return $"Book ID: {BookId}, Other Name: {Other}";
        }
    }
}

৩. Model Binding with Complex Types (Priority: 10/10)

Why (এটি কীভাবে কাজ করে): যখন আপনি Controller-এর Action Method-এ এই Book ক্লাসটিকে Parameter হিসেবে পাস করবেন, তখন আপনাকে ম্যানুয়ালি new Book() লিখে Object তৈরি করতে হবে না। Model Binding স্বয়ংক্রিয়ভাবে (Automatically) Book ক্লাসের একটি Object তৈরি করবে এবং Request (Route Data বা Query String) থেকে আসা ডেটাগুলোকে এই Object-এর Property-গুলোর সাথে ম্যাপ করে দেবে। এটি সম্পূর্ণ Case-Insensitive।

Code Implementation:

using ProjectName.Models; // Namespace ইমপোর্ট করা জরুরি
using Microsoft.AspNetCore.Mvc;
 
public class HomeController : Controller
{
    public IActionResult GetBook(Book book)
    {
        // Model Binding অটোমেটিকভাবে book অবজেক্ট তৈরি করে ডেটা ফিল-আপ করে দিয়েছে।
        return Content(book.ToString());
    }
}

৪. Handling Missing Values & Validation (Priority: 7/10)

Why (কেন জানা জরুরি): যদি User Request-এ কোনো ডেটা না পাঠায় (যেমন Other এর ভ্যালু দিল না), তবে অ্যাপ্লিকেশন ক্র্যাশ করবে না বা কোনো Runtime Error দেবে না। এর পরিবর্তে Property-টির ভ্যালু ডিফল্টভাবে null হয়ে যাবে। তাই Action Method-এর ভেতরে Developer-কে ম্যানুয়ালি if কন্ডিশন ব্যবহার করে Request Data ভ্যালিডেট করতে হয়।

৫. Using [FromQuery] on the Entire Parameter (Priority: 8/10)

Why (কেন ব্যবহার করব): ডিফল্টভাবে Model Binding প্রথমে Route Data চেক করে, তারপর Query String চেক করে। কিন্তু আপনি যদি চান পুরো Book Object-টি শুধুমাত্র Query String (?key=value) থেকেই ডেটা রিসিভ করুক, তাহলে Action Method-এর Parameter-এ [FromQuery] ব্যবহার করতে পারেন।

Code Implementation:

public IActionResult GetBook([FromQuery] Book book)
{
    // এখন Route-এ BookId থাকলেও তা ইগনোর করা হবে। 
    // পুরো অবজেক্টটি শুধুমাত্র Query String থেকে ডেটা খুঁজবে।
    return Content(book.ToString());
}

৬. Using [FromQuery] at the Property Level (Priority: 10/10)

Why (কেন ব্যবহার করব): সবচেয়ে চমৎকার ফিচার হলো Fine-grained control! ধরুন, আপনি চান BookId শুধুমাত্র Query String থেকে আসুক, কিন্তু Other ভ্যালুটি Route বা ডিফল্ট যেকোনো জায়গা থেকে আসুক। তখন Action Method-এ Attribute না দিয়ে, সরাসরি Model Class-এর Property-র উপরে Attribute বসাতে হয়। এর জন্য Microsoft.AspNetCore.Mvc namespace ইমপোর্ট করতে হবে।

Code Implementation:

using Microsoft.AspNetCore.Mvc;
 
namespace ProjectName.Models
{
    public class Book
    {
        // এটি বাধ্য করবে যে BookId শুধুমাত্র Query String থেকেই আসবে।
        [FromQuery]
        public int? BookId { get; set; }
        
        // এটি ডিফল্ট নিয়মে চলবে (প্রথমে Route Data, তারপর Query String)।
        public string Other { get; set; }
    }
}

💡 Best Practices

  1. Always use Data Annotations for Validation: ম্যানুয়ালি if-else দিয়ে চেক করার চেয়ে Model Class-এর ভেতরে [Required], [MaxLength] ইত্যাদি Attribute ব্যবহার করা Best Practice।
  • Example:
[Required(ErrorMessage = "Book ID is strictly required")]
public int? BookId { get; set; }
  1. Separate DTOs from Domain Models: রিকোয়েস্ট রিসিভ করার জন্য যে Model ব্যবহার করছেন (যাকে DTO বা Data Transfer Object বলে), তাকে কখনোই ডেটাবেস Entity বা Domain Model-এর সাথে মিক্স করা উচিত নয়।
  2. PascalCase vs camelCase: Class এবং Property-র নাম সবসময় PascalCase (BookId) হবে। কিন্তু Action Method-এর Parameter-এর নাম camelCase (book) হবে।

🚀 .NET 10 Updates (Changes from .NET 6)

ট্রান্সক্রিপ্টের কনসেপ্টগুলো MVC Controller-ভিত্তিক, যা .NET 6 বা আগের ভার্সনের জন্য খুব জনপ্রিয়। তবে আধুনিক C# 13 এবং .NET 10-এ Minimal APIs ব্যবহার করে অনেক সহজে এবং ক্লিন উপায়ে Complex Model Binding করা যায় [AsParameters] ব্যবহার করে।

.NET 10-এ Class-এর বদলে record struct ব্যবহার করা হয় যা মেমরির জন্য অত্যন্ত এফিশিয়েন্ট।

.NET 10 Minimal API Code Implementation:

// ১. Record type তৈরি করা (Model-এর আধুনিক রূপ)
public record BookRequest([FromQuery] int? BookId, string Other);
 
var app = WebApplication.CreateBuilder(args).Build();
 
// ২. Minimal API-তে [AsParameters] ব্যবহার করা
app.MapGet("/bookstore/{Other?}", ([AsParameters] BookRequest request) => 
{
    // .NET 10 স্বয়ংক্রিয়ভাবে BookRequest অবজেক্ট তৈরি করবে এবং 
    // অ্যাট্রিবিউট অনুযায়ী (Route এবং Query থেকে) ডেটা ম্যাপ করে দেবে।
    return Results.Ok($"Book ID (from query): {request.BookId}, Other (from route/query): {request.Other}");
});
 
app.Run();

🛠️ Interactive Exploration: Property-Level Attributes

Model Class-এর ভেতরে [FromQuery] অ্যাট্রিবিউট দিলে Model Binding কীভাবে কাজ করে, তা হাতে-কলমে বোঝার জন্য নিচের সিমুলেটরটি ব্যবহার করুন। আপনি Route Data এবং Query String পরিবর্তন করে দেখতে পারবেন কীভাবে C# Object-টি ডেটা রিসিভ করছে।

Graph View

Backlinks