1. Creating Controllers

হ্যালো! একজন সফটওয়্যার ইঞ্জিনিয়ারিং ট্রেইনার হিসেবে আমি আপনার দেওয়া লেকচার ট্রান্সক্রিপ্টটি খুব মনোযোগ দিয়ে বিশ্লেষণ করেছি। এটি ASP.NET Core-এ Controllers এবং Routing-এর একদম বেসিক এবং অত্যন্ত গুরুত্বপূর্ণ একটি ফাউন্ডেশনাল লেকচার।

চলুন, খুব সুন্দর এবং গোছানোভাবে পুরো বিষয়টি বুঝে নেওয়া যাক।

📋 লেকচার আউটলাইন এবং প্রায়োরিটি (Lecture Outline & Priorities)

নিচে লেকচারের মূল টপিকগুলোর একটি আউটলাইন দেওয়া হলো। [১-১০ স্কেলে] এর গুরুত্ব এবং কারণ সংক্ষেপে দেওয়া হলো:

Problem with Single File / Middleware [Priority: 8/10]
- কেন গুরুত্বপূর্ণ: কেন আমরা Controller ব্যবহার করব, তার পেছনের “Why” বা কারণটি বুঝতে এটি সাহায্য করে।
Concept of Controllers & Action Methods [Priority: 10/10]
- কেন গুরুত্বপূর্ণ: এটি MVC বা Web API আর্কিটেকচারের হার্ট (Heart)। Controller কী এবং কীভাবে কাজ করে তা জানা অপরিহার্য।
Project Setup & Controllers Folder Convention [Priority: 5/10]
- কেন গুরুত্বপূর্ণ: প্রজেক্টের কোড অর্গানাইজ রাখার জন্য folder structure মেইনটেইন করা Good Practice।
Naming Convention & Public Modifier [Priority: 9/10]
- কেন গুরুত্বপূর্ণ: Class-এর নামের শেষে “Controller” না লিখলে বা class “public” না হলে ASP.NET Core এটিকে Controller হিসেবে চিনতে পারে না।
Registering Services (AddControllers) [Priority: 10/10]
- কেন গুরুত্বপূর্ণ: Dependency Injection-এর জন্য Controller-কে Service হিসেবে add করা বাধ্যতামূলক।
Enabling Routing (MapControllers) [Priority: 10/10]
- কেন গুরুত্বপূর্ণ: এটি ছাড়া কোনো Request আপনার Action Method পর্যন্ত পৌঁছাতে পারবে না।
Attribute Routing ([Route]) [Priority: 9/10]
- কেন গুরুত্বপূর্ণ: একটি নির্দিষ্ট URL কীভাবে একটি নির্দিষ্ট Action Method-কে ট্রিগার করবে, তা নির্ধারণ করার জন্য।

🚀 বিস্তারিত ব্যাখ্যা (Comprehensive Breakdown)

এবার আমরা ট্রান্সক্রিপ্টের প্রতিটি বিষয় ধাপে ধাপে, Code Implementation এবং “Why” (কেন) সহ আলোচনা করব।

১. মূল সমস্যা: Single Middleware-এ সব কোড লেখা

লেকচারের শুরুতে একটি বাস্তব সমস্যার কথা বলা হয়েছে। আমরা যদি প্রতিটি URL-এর জন্য Endpoint-এর কোড একটি মাত্র ফাইলে (যেমন Program.cs বা একটি মাত্র Middleware-এ) লিখি, তবে ছোট প্রজেক্টের জন্য তা কাজ করলেও Real-world প্রজেক্টে তা ভয়ংকর রূপ নেবে।

Why (কেন এটি খারাপ): একটি বড় প্রজেক্টে হাজার হাজার URL থাকে। সব কোড এক জায়গায় থাকলে কোড অনেক বড় হয়ে যাবে, লজিকগুলো জট পাকিয়ে যাবে, এবং কোনো Error আসলে তা Debug করা বা মেইনটেইন করা প্রায় অসম্ভব হয়ে পড়বে।

২. সমাধান: Controllers এবং Action Methods

এই সমস্যা সমাধানের জন্য আমাদের কোডগুলোকে Logical Purpose অনুযায়ী Group বা আলাদা করতে হবে। এখানেই আসে Controllers-এর কনসেপ্ট।

Controller কী: Controller হলো একটি Class, যার ভেতরে অনেকগুলো Action Method থাকে।
Action Method কী: Controller-এর ভেতরের একেকটি Method হলো একেকটি Endpoint, যা নির্দিষ্ট URL-এর Request হ্যান্ডেল করে।
Logical Grouping: উদাহরণস্বরূপ, UserRegistration এবং SignIn দুটি আলাদা Action Method। কিন্তু এই দুটিই ইউজার অ্যাকাউন্ট রিলেটেড। তাই এদেরকে একত্রে AccountController নামক একটি Controller-এ রাখা হয়।

৩. Project Setup এবং Folder Convention

ASP.NET Core Empty প্রজেক্ট তৈরি করে তাতে Controllers নামে একটি ফোল্ডার তৈরি করতে বলা হয়েছে।
Why: ফোল্ডারের নাম Controllers রাখাটা কোনো বাধ্যতামূলক নিয়ম নয়, তবে এটি একটি স্টান্ডার্ড General Practice। এতে করে প্রজেক্টের স্ট্রাকচার পরিষ্কার থাকে।

৪. Controller Class তৈরি করা

ফোল্ডারের ভেতর MVC Controller - Empty সিলেক্ট করে HomeController.cs নামে একটি ফাইল তৈরি করতে হবে।

ট্রান্সক্রিপ্টে বলা হয়েছে, ডিফল্টভাবে তৈরি হওয়া বেস ক্লাস (Controller থেকে inherit করা) এবং IActionResult মুছে ফেলে একদম Plain একটি Class দিয়ে শুরু করতে, যেন বেসিকটা ক্লিয়ার হয়।

প্রাথমিক Controller Code:

ControllersExample.Controllers
{
    // Class-টি অবশ্যই public হতে হবে
    // নামের শেষে অবশ্যই "Controller" সাফিক্স থাকতে হবে
    public class HomeController 
    {
        // এটি একটি Action Method
        public string MethodOne()
        {
            return "Hello from Method One!";
        }
    }
}

Why “Controller” Suffix: Class-এর নাম শুধু Home রাখলে এটি একটি সাধারণ ক্লাস হিসেবে গণ্য হবে। নামের শেষে Controller (যেমন HomeController) দিলে ASP.NET Core Compiler নিজে থেকেই বুঝে নেয় যে এটি একটি Controller ক্লাস।
Why “public”: ক্লাসটি public না হলে ASP.NET Core রানটাইমে এই ক্লাসের Object তৈরি (Instantiate) করতে পারবে না।

৫. Program.cs কনফিগারেশন: Services এবং Routing

শুধুমাত্র Controller বানালেই তা কাজ করবে না। Program.cs ফাইলে ২ টি গুরুত্বপূর্ণ কাজ করতে হবে।

ক. Controller-কে Service হিসেবে Add করা (AddControllers):

Controller-গুলোকে ASP.NET Core-এ Service হিসেবে ট্রিট করা হয়। builder.Services.AddControllers(); কল করলে ASP.NET Core পুরো প্রজেক্ট স্ক্যান করে যত ক্লাসের নামের শেষে “Controller” আছে, সবগুলোকে Dependency Injection কন্টেইনারে একবারে Add করে নেয়।

খ. Routing Enable করা (MapControllers):

app.MapControllers(); কল করলে এটি সব Controller-এর Action Method-গুলোকে খুঁজে বের করে এবং তাদের জন্য Routing System চালু করে।

৬. Attribute Routing সেট আপ করা

Action Method তৈরি হলো, কিন্তু কোন URL-এ হিট করলে এই Method-টি রান করবে? এটার জন্য মেথডের ঠিক ওপরে [Route] অ্যাট্রিবিউট ব্যবহার করতে হয়। একে Attribute Routing বলা হয়।

চূড়ান্ত কোড (HomeController.cs):

using Microsoft.AspNetCore.Mvc;
 
namespace ControllersExample.Controllers
{
    public class HomeController
    {
        // Attribute Routing
        [Route("sayhello")]
        public string MethodOne()
        {
            return "Hello from Method One!";
        }
    }
}

চূড়ান্ত কোড (Program.cs):

var builder = WebApplication.CreateBuilder(args);
 
// Step 1: Controller-গুলোকে Service হিসেবে Add করা
builder.Services.AddControllers();
 
var app = builder.Build();
 
// Step 2: Controller-এর Action Method গুলোর জন্য Routing Map করা
app.MapControllers();
 
app.Run();

৭. পর্দার আড়ালে কী ঘটে? (Behind the Scenes)

যখন আপনি ব্রাউজার থেকে http://localhost:<port>/sayhello লিখে Request পাঠান:

ASP.NET Core চেক করে এই URL-এর সাথে কোনো Route ম্যাচ করে কি না।
[Route("sayhello")] ম্যাচ হয়ে যায়।
যেহেতু AddControllers() কল করা ছিল, ASP.NET Core নিজে থেকেই HomeController ক্লাসের একটি Object তৈরি করে।
এরপর সেই Object-এর মাধ্যমে MethodOne() এক্সিকিউট করে।
Method-টি যে String রিটার্ন করে, তা Browser-এ Response হিসেবে ফিরে যায়।

⭐ Best Practices & Context Updates (আধুনিক গাইডলাইন)

লেকচারটি অত্যন্ত সুন্দরভাবে বেসিক ক্লিয়ার করেছে। তবে Real-world ইন্ডাস্ট্রিতে কাজ করার সময় আপনাকে কিছু Best Practices মেনে চলতে হবে, যা লেকচারের বেসিক ধারণার পরবর্তী ধাপ:

১. Return Type হিসেবে String ব্যবহার না করা:

লেকচারে সহজে বোঝানোর জন্য string রিটার্ন করা হয়েছে। কিন্তু বাস্তবে string রিটার্ন করা Best Practice নয়। আধুনিক ASP.NET Core-এ সর্বদা IActionResult অথবা ActionResult<T> রিটার্ন করতে হয়। এটি আপনাকে HTTP Status Code (যেমন 200 OK, 404 Not Found) সহ ডাটা পাঠাতে সাহায্য করে।

আধুনিক কোড উদাহরণ:

[Route("sayhello")]
public IActionResult MethodOne()
{
    // এটি HTTP 200 OK স্ট্যাটাস কোডের সাথে ডাটা রিটার্ন করবে
    return Ok("Hello from Method One!"); 
}

২. Base Class এবং [ApiController] Attribute ব্যবহার করা:

আপনার Controller-টি যদি Web API এর জন্য হয়, তবে ControllerBase থেকে Inherit করা উচিত এবং ক্লাসের ওপর [ApiController] Attribute দেওয়া উচিত। এতে অনেক বিল্ট-ইন ফিচার (যেমন Auto Model Validation) পাওয়া যায়।

আধুনিক কোড উদাহরণ:

using Microsoft.AspNetCore.Mvc;
 
namespace ControllersExample.Controllers
{
    [ApiController] // API এর জন্য Best Practice
    [Route("api/[controller]")] // Route-এ [controller] টোকেন ব্যবহার করলে এটি নিজে থেকেই "api/home" হয়ে যাবে
    public class HomeController : ControllerBase // ControllerBase থেকে inherit করা
    {
        [HttpGet("sayhello")] // শুধু Route এর বদলে HttpGet বা HttpPost ব্যবহার করা ভালো
        public IActionResult MethodOne()
        {
            return Ok("Hello from Method One!");
        }
    }
}

৩. .NET 6/7/8 এর Minimal API Context:

আপনার ট্রান্সক্রিপ্টটি আধুনিক .NET 6/7/8 ভার্সনের (Program.cs এ builder প্যাটার্ন ব্যবহার করা হয়েছে)। জেনে রাখা ভালো, ছোট প্রজেক্টের ক্ষেত্রে Controller না বানিয়ে সরাসরি Program.cs-এ app.MapGet() ব্যবহার করেও Endpoint বানানো যায়, যাকে Minimal APIs বলে। তবে বড় প্রজেক্ট বা Enterprise অ্যাপ্লিকেশনগুলোতে এখনও Controllers-ই স্ট্যান্ডার্ড এবং সবচেয়ে বেশি ব্যবহৃত হয়।

এই বিষয়গুলো প্র্যাকটিস করলে আপনি ট্রান্সক্রিপ্টের জ্ঞানকে একদম ইন্ডাস্ট্রি স্ট্যান্ডার্ড লেভেলে নিয়ে যেতে পারবেন! অন্য কোনো টপিক বুঝতে চাইলে নির্দ্বিধায় জানাবেন।

Quartz 5

Explorer