Quartz 5

1. Map star

6 min read

আগের লেকচারে আমরা বেসিক রাউটিং নিয়ে কথা বলেছিলাম, আর এই লেকচারে ইনস্ট্রাক্টর দেখিয়েছেন কীভাবে আমরা app অবজেক্টের Map মেথডগুলো ব্যবহার করে প্র্যাকটিক্যালি এন্ডপয়েন্ট (Endpoint) বানাতে পারি এবং এর ভেতরের লজিক কীভাবে কাজ করে।

তুমি যেহেতু .NET ব্যাকএন্ড নিয়ে কাজ করছ, এই রাউটিং পাইপলাইনের কনসেপ্টটা তোমার জন্য সুপার ইম্পর্টেন্ট। চলো শুরু করি!

Topic Overview

এই লেকচারের মূল ফোকাস হলো ASP.NET Core-এ Map Methods (Map, MapGet, MapPost, MapFallback) ব্যবহার করে নির্দিষ্ট URL এবং HTTP Method-এর উপর ভিত্তি করে রিকোয়েস্ট হ্যান্ডেল করা। পাশাপাশি, রাউটিং পাইপলাইনে মিডলওয়্যারগুলো কীভাবে সাজানো থাকে এবং কোন অর্ডারে এক্সিকিউট হয়, তার একটা গভীর ধারণা দেওয়া হয়েছে।

Detailed Breakdown: স্টেপ-বাই-স্টেপ বিশ্লেষণ

লেকচারের প্রতিটি পয়েন্ট আমি ভেঙে ভেঙে বুঝিয়ে দিচ্ছি এবং সবশেষে এর সম্পূর্ণ কোড ইমপ্লিমেন্টেশনটাও দিয়ে দিচ্ছি।

১. Map Method দিয়ে এন্ডপয়েন্ট তৈরি:

  • app.Map("/map1", ...) ব্যবহার করে আমরা একটা এন্ডপয়েন্ট বানাতে পারি। এর প্রথম আর্গুমেন্ট হলো URL পাথ (যেমন map1 বা /map1 — প্রথম স্ল্যাশটা অপশনাল)।
  • দ্বিতীয় আর্গুমেন্ট হলো একটা Request Delegate (অর্থাৎ একটা মিডলওয়্যার/ফাংশন), যা HttpContext রিসিভ করে।
  • আমরা চাইলে এই ডেলিগেটটাকে async বানাতে পারি, যাতে await context.Response.WriteAsync(...) ব্যবহার করে ব্রাউজারে রেসপন্স পাঠাতে পারি।

২. Multiple Maps এবং 404 Error:

  • তুমি চাইলে এরকম অনেকগুলো এন্ডপয়েন্ট বানাতে পারো (যেমন map1, map2)।
  • ব্রাউজারে রিকোয়েস্ট করার সময় URL-এ পোর্টের পর যে অংশটুকু থাকে, সেটাকে বলা হয় Path (যেমন: localhost:5000/map1 এখানে /map1 হলো পাথ)।
  • যদি তুমি এমন কোনো URL-এ হিট করো, যেটা তুমি কোডে ডিক্লেয়ার করোনি (যেমন /map3), তাহলে বাই-ডিফল্ট তুমি HTTP 404 Not Found এরর খাবে।

৩. MapFallback (ডিফল্ট বা ক্যাচ-অল রাউট):

  • এই 404 এরর ঠেকানোর জন্য বা আনম্যাচড রিকোয়েস্টগুলো হ্যান্ডেল করার জন্য app.MapFallback() ব্যবহার করা হয়।
  • যদি ইনকামিং রিকোয়েস্টের URL উপরের কোনো Map মেথডের সাথে না মেলে, তখন একমাত্র তখনই এই ফলব্যাক মেথডটা এক্সিকিউট হয়।
  • ইনস্ট্রাক্টর এখানে context.Request.Path ব্যবহার করে দেখিয়েছেন যে, ইউজার আসলে কোন ভুল URL-এ হিট করেছিল, সেটা প্রিন্ট করে দেখানো যায়।

৪. Pipeline Execution & Short-circuiting (খুবই গুরুত্বপূর্ণ কনসেপ্ট):

  • Terminal/Short-circuiting: প্রত্যেকটা এন্ডপয়েন্ট (Map methods) হলো “টার্মিনাল মিডলওয়্যার”। মানে হলো, রিকোয়েস্ট যখন কোনো একটা এন্ডপয়েন্টের সাথে ম্যাচ করে যায়, তখন সেটার কাজ শেষ হয়ে যায়। সে আর রিকোয়েস্টটাকে পরবর্তী কোনো মিডলওয়্যারে ফরোয়ার্ড করে না।
  • Order of execution: তুমি তোমার কোডে app.Use (কাস্টম মিডলওয়্যার) যেখনেই লেখো না কেন (এমনকি Map মেথডগুলোর নিচে লিখলেও), ফ্রেমওয়ার্ক নিজে থেকেই রাউটিং এন্ডপয়েন্টগুলোকে পাইপলাইনের একদম শেষে জায়গা দেয়। তাই app.Use সবসময় রাউটিং এক্সিকিউট হওয়ার আগেই রান হবে।
  • Registration Order Doesn’t Matter: তুমি কোডে আগে map2 লিখলে নাকি আগে map1 লিখলে, তাতে কিচ্ছু যায় আসে না। রাউটিং সিস্টেম রিকোয়েস্টের পাথ আর মেথড দেখে সঠিক গন্তব্য খুঁজে বের করে, কোডের লাইন নম্বর দেখে নয়।

৫. HTTP Methods (Map vs MapGet vs MapPost):

  • app.Map(): এটা যেকোনো ধরণের HTTP রিকোয়েস্ট (GET, POST, PUT, DELETE) গ্রহণ করে।
  • app.MapGet(): এটা খুব স্ট্রিক্ট। এটা শুধুমাত্র GET রিকোয়েস্ট ছাড়া অন্য কোনো রিকোয়েস্ট এক্সেপ্ট করবে না।
  • app.MapPost(): একইভাবে, এটা শুধু POST রিকোয়েস্ট এক্সেপ্ট করবে।
  • ইনস্ট্রাক্টর Postman ব্যবহার করে দেখিয়েছেন যে, ব্রাউজার থেকে সরাসরি POST রিকোয়েস্ট পাঠানো যায় না। তাই POST রিকোয়েস্ট টেস্ট করার জন্য Postman ব্যবহার করা হয়েছে। যদি তুমি MapPost দিয়ে বানানো কোনো এন্ডপয়েন্টে GET রিকোয়েস্ট পাঠাও, তবে সেটা ম্যাচ করবে না এবং সোজা MapFallback-এ চলে যাবে।

Practical C# Code Implementation

লেকচারে আলোচনা করা পুরো সিনারিওটা যদি আমরা একসাথে কোড করি, তাহলে দেখতে ঠিক এরকম হবে। এই কোডটা তুমি চাইলে তোমার .NET প্রজেক্টে রান করে দেখতে পারো:

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;
 
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
// -------------------------------------------------------------
// Middleware Pipeline Proof (app.Use)
// -------------------------------------------------------------
// লেকচারের পয়েন্ট: এটা কোডে যেখানেই থাকুক, Map মেথডগুলোর আগেই এক্সিকিউট হবে।
app.Use(async (context, next) =>
{
    // এই লজিকটা প্রতিটা রিকোয়েস্টেই রাউটিং হওয়ার আগে কল হবে।
    Console.WriteLine($"Incoming request pipeline started for: {context.Request.Path}");
    await next(); // পরবর্তী ধাপে ফরোয়ার্ড করা
});
 
// -------------------------------------------------------------
// Endpoint Configurations (Map Methods)
// -------------------------------------------------------------
 
// ১. Map - এটা যেকোনো HTTP Method (GET, POST, PUT) গ্রহণ করবে
app.Map("/map1", async (HttpContext context) =>
{
    // ইনস্ট্রাক্টর এখানে ব্রেকপয়েন্ট বসিয়ে চেক করার কথা বলেছিলেন
    await context.Response.WriteAsync("In map1 (Accepts ANY HTTP Method)");
});
 
// ২. MapGet - এটা শুধুমাত্র GET Method গ্রহণ করবে
app.MapGet("/map2", async (HttpContext context) =>
{
    await context.Response.WriteAsync("In map2 (Accepts ONLY GET requests)");
});
 
// ৩. MapPost - এটা শুধুমাত্র POST Method গ্রহণ করবে (Postman দিয়ে টেস্ট করতে হবে)
// লক্ষ্য করো: একই URL ("/map2") কিন্তু মেথড ভিন্ন (POST)। এটা সম্পূর্ণ ভ্যালিড।
app.MapPost("/map2", async (HttpContext context) =>
{
    await context.Response.WriteAsync("In map2 (Accepts ONLY POST requests)");
});
 
// -------------------------------------------------------------
// Fallback Route
// -------------------------------------------------------------
// ৪. MapFallback - উপরের কোনো রাউটের সাথে URL বা Method ম্যাচ না করলে এটা রান হবে
app.MapFallback(async (HttpContext context) =>
{
    // ইউজারের দেওয়া ভুল পাথটা প্রিন্ট করে দেখানো
    await context.Response.WriteAsync($"Request received at: {context.Request.Path} (Unhandled Route)");
});
 
app.Run();

Priority Specification (কোনটা বেশি ইম্পর্টেন্ট?)

  • 🔥 High Priority:

  • Terminal Middleware Concept: এন্ডপয়েন্ট যে রিকোয়েস্টকে আর সামনে যেতে দেয় না, এটা বোঝা।

  • HTTP Verbs: MapGet এবং MapPost এর পার্থক্য এবং কখন কোনটা ব্যবহার করতে হয়।

  • 📉 Low Priority:

  • app.Map() এর ঢালাও ব্যবহার। বাস্তবে আমরা স্পেসিফিক MapGet, MapPost, MapPut ইত্যাদি বেশি ব্যবহার করি।

  • context.Response.WriteAsync ম্যানুয়ালি লেখা। আগের লেকচারেই আমি বলেছি, প্রফেশনাল লাইফে আমরা IResult বা অবজেক্ট রিটার্ন করি, ফ্রেমওয়ার্ক অটোমেটিক্যালি রেসপন্স জেনারেট করে নেয়।

Added Context (Gaps Filled): ইন্টারনাল মেকানিজম

১. Registration Order কেন ম্যাটার করে না? তোমার মনে প্রশ্ন আসতে পারে, কোড তো লাইন-বাই-লাইন রান হয়, তাহলে আগে-পিছে লিখলে কেন সমস্যা হয় না? কারণ, যখন তুমি app.Run() কল করো, তখন ASP.NET Core ভেতরের সব রাউটগুলোকে নিয়ে একটা Routing Tree (যাকে Radix Tree বলে) তৈরি করে ফেলে। যখন রিকোয়েস্ট আসে, সে ওই ট্রির মধ্যে সার্চ করে সবচেয়ে স্পেসিফিক ম্যাচ কোনটা। সে লাইন-বাই-লাইন স্ক্যান করে না।

২. একই URL-এ GET এবং POST: কোডে খেয়াল করো, আমি map2 নামের একই URL দিয়ে একটা MapGet এবং একটা MapPost বানিয়েছি। এটা সম্পূর্ণ ভ্যালিড। রাউটার শুধু URL চেক করে না, একইসাথে HTTP Method-ও চেক করে। ইউজার যদি ব্রাউজার থেকে হিট করে (GET), তাহলে MapGet টা ফায়ার হবে। আর Postman থেকে POST রিকোয়েস্ট পাঠালে MapPost ফায়ার হবে।

C# Best Practices (প্রফেশনাল টিপস)

১. Never use generic app.Map for Data Operations: কোনো স্পেসিফিক কারণ (যেমন, প্রক্সি সার্ভার বানানো) ছাড়া কখনো ঢালাওভাবে app.Map() ব্যবহার করবে না। সবসময় স্পেসিফিক HTTP Verb ব্যবহার করবে। ডেটা আনার জন্য MapGet, ডেটা সেভ করার জন্য MapPost, আপডেট করার জন্য MapPut। ২. Avoid Logic After Map: ইনস্ট্রাক্টর একটা দারুণ কথা বলেছেন, “If you need any custom logic after a request is handled, it must be written inside the route handler itself.” যেহেতু এন্ডপয়েন্ট টার্মিনাল, তাই তুমি যদি রেসপন্স পাঠানোর পরে ডাটাবেসে লগ সেভ করার মতো কোনো কাজ করতে চাও, সেটা ওই ডেলিগেটের (ল্যাম্বডা ফাংশনের) ভেতরেই করতে হবে। এন্ডপয়েন্টের নিচে কোনো app.Use লিখলে সেটা জীবনেও ফায়ার হবে না। ৩. Debugging Tip: লেকচারে ইনস্ট্রাক্টর ব্রেকপয়েন্ট (Breakpoint) বসানোর কথা বলেছেন। তুমি যখন Chatrabash প্রজেক্টের API বানাবে, তখন রাউটে হিট হচ্ছে কি না, বা ডাটা ঠিকমতো আসছে কি না, সেটা চেক করার জন্য Console.WriteLine ব্যবহার করার চেয়ে ভিজ্যুয়াল স্টুডিও বা রাইডারে ব্রেকপয়েন্ট বসিয়ে ডিবাগ করা অনেক বেশি প্রফেশনাল এবং সময়সাপেক্ষ।

হাসিব, কনসেপ্টগুলো কি পুরোপুরি ক্লিয়ার হলো? এই রাউটিং পাইপলাইন বা মিডলওয়্যার অর্ডারিং নিয়ে যদি কোনো প্রশ্ন থাকে, তাহলে ফিল ফ্রি টু আস্ক!

Graph View

Backlinks