Quartz 5

2. Route Parameter

5 min read

হ্যালো হাসিব! আজকের লেকচারটা কিন্তু ব্যাকএন্ড ডেভেলপমেন্টের একদম কোর একটা টপিক নিয়ে—Route Parameters। তুমি যখনই কোনো ডাইনামিক ওয়েব অ্যাপ্লিকেশন বা API বানাবে, তখন এই কনসেপ্টটা পদে পদে কাজে লাগবে।

চলো, ইনস্ট্রাক্টর যা যা বলেছেন তার একদম চুলচেরা বিশ্লেষণ করি। কোনো পয়েন্ট বাদ যাবে না!

Topic Overview

এই লেকচারে মূলত শেখানো হয়েছে কীভাবে আমরা ডাইনামিক URL তৈরি করতে পারি। একটা URL-এর কোন অংশগুলো ফিক্সড (Literal Text) থাকবে আর কোন অংশগুলো ইউজারের রিকোয়েস্ট অনুযায়ী পরিবর্তনশীল (Route Parameters) হবে, এবং সেই পরিবর্তনশীল ডেটাগুলো কীভাবে আমরা C# কোডের ভেতর রিসিভ করে প্রসেস করতে পারি—এটাই ছিল আজকের মূল ফোকাস।

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

লেকচারের প্রতিটি কনসেপ্ট নিচে সহজ করে ভেঙে দিলাম:

১. Literal Text বনাম Route Parameter:

  • Literal Text: URL-এর যে অংশটা একদম ফিক্সড, যার কোনো পরিবর্তন হবে না। ইউজারকে ঠিক ওই বানানেই রিকোয়েস্ট পাঠাতে হবে। যেমন: files/ বা employee/profile/।
  • Route Parameter: URL-এর যে অংশটা পরিবর্তনশীল (Variable)। ইউজার চাইলে এখানে যেকোনো ভ্যালু পাঠাতে পারে। একে ডিক্লেয়ার করা হয় কোঁকড়ানো বন্ধনী বা Curly braces {} এর মাধ্যমে। যেমন: {fileName}।

২. Files URL উদাহরণ (files/{filename}.{extension}):

  • ইনস্ট্রাক্টর একটা প্যাটার্ন দেখিয়েছেন: files/{filename}.{extension}।
  • এখানে files/ এবং মাঝখানের ডট (.) হলো Literal Text। ইউজারকে অবশ্যই ফাইলে স্ল্যাশ এবং নামের পর একটা ডট দিতেই হবে।
  • {filename} এবং {extension} হলো প্যারামিটার। ইউজার চাইলে এখানে sample.txt, hello.pdf, image.png—যেকোনো কিছু পাঠাতে পারে।

৩. Employee URL উদাহরণ (employee/profile/{employeeName}):

  • এখানে employee/profile/ হলো ফিক্সড বা Literal Text।
  • {employeeName} হলো প্যারামিটার। ইউজার চাইলে Smith, John বা Hasib পাঠাতে পারে।

৪. Exact Match এবং 404 Error (Fallback):

  • রাউটিং ইঞ্জিন খুবই স্ট্রিক্ট। তুমি যদি files/ এর জায়গায় file/ (s ছাড়া) লিখে রিকোয়েস্ট পাঠাও, অথবা sample.txt এর জায়গায় ডট ছাড়া sampletxt পাঠাও, তাহলে রাউট ম্যাচ করবে না।
  • ম্যাচ না করলে সেটা সরাসরি MapFallback মিডলওয়্যারে চলে যাবে (বা 404 Not Found এরর দেবে)।

৫. কোডে ভ্যালু রিড করা (Request.RouteValues):

  • ইউজার URL-এ যে ডাইনামিক ভ্যালুগুলো পাঠাচ্ছে, সেগুলো কোডে ধরবে কীভাবে? এর জন্য HttpContext.Request.RouteValues ডিকশনারি ব্যবহার করা হয়।
  • Type Conversion: RouteValues["parameterName"] বাই-ডিফল্ট System.Object টাইপের ডেটা রিটার্ন করে। তাই এটাকে স্ট্রিং বা ইনটিজারে কনভার্ট করে নিতে হয় (যেমন: Convert.ToString(...))।

৬. Nullable Reference Types (?):

  • C# 8 এবং এর পরের ভার্সনে Null Safety অনেক কড়াকড়ি। যেহেতু ইউজার কোনো ভ্যালু না-ও পাঠাতে পারে, তাই ভ্যারিয়েবল ডিক্লেয়ার করার সময় string? লেখা হয়েছে। নামের শেষে এই ? চিহ্ন দেওয়ার মানে হলো— “আমি জানি এই ভ্যারিয়েবলের মান null হতে পারে, তুমি আমাকে ওয়ার্নিং দিও না।”

৭. Case Insensitivity এবং Naming Rules:

  • রাউটিংয়ের ক্ষেত্রে প্যারামিটারের নাম এবং Literal Text হলো Case Insensitive। অর্থাৎ তুমি কোডে {employeeName} লিখলে ইউজার URL-এ EMPLOYEE/PROFILE/Smith লিখলেও সেটা ম্যাচ করবে। আবার কোডের ভেতর RouteValues["Employeename"] লিখলেও কাজ করবে।
  • Rule: প্যারামিটারের নামের মাঝখানে কোনো স্পেস (Space) দেওয়া যাবে না। {employee name} লেখা সম্পূর্ণ বেআইনি!

Practical C# Code Implementation

লেকচারে বলা সব কনসেপ্ট মিলিয়ে একটা কমপ্লিট এবং রানেবল Program.cs কোড নিচে দেওয়া হলো। এই কোডটা ইন্টারনালি কীভাবে কাজ করে, সেটা কমেন্টে বুঝিয়ে দিয়েছি:

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;
using System;
 
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
// -------------------------------------------------------------
// Endpoint 1: Files Route (Multiple Parameters & Literals)
// Pattern: files/{filename}.{extension}
// -------------------------------------------------------------
app.MapGet("files/{filename}.{extension}", async (HttpContext context) =>
{
    // ১. RouteValues থেকে ভ্যালুগুলো অবজেক্ট হিসেবে নিয়ে স্ট্রিংয়ে কনভার্ট করা হচ্ছে।
    // string? মানে হলো এই ভ্যালুটা null হতে পারে (Nullable Reference Type)।
    string? fileName = Convert.ToString(context.Request.RouteValues["filename"]);
    string? extension = Convert.ToString(context.Request.RouteValues["extension"]);
 
    // ২. রেসপন্স হিসেবে ইউজারের পাঠানো ডেটা প্রিন্ট করা হচ্ছে।
    await context.Response.WriteAsync($"In Files Endpoint!\nFile Name: {fileName}\nExtension: {extension}");
});
 
// -------------------------------------------------------------
// Endpoint 2: Employee Profile Route
// Pattern: employee/profile/{employeeName}
// -------------------------------------------------------------
app.MapGet("employee/profile/{employeeName}", async (HttpContext context) =>
{
    // ১. RouteValues থেকে ডেটা রিড করা। (খেয়াল করো: নামের কেসিং আলাদা হলেও কাজ করবে)
    string? empName = Convert.ToString(context.Request.RouteValues["employeeName"]);
 
    // রিয়েল ওয়ার্ল্ড সিনারিও: এখানে আমরা SQL Server থেকে empName দিয়ে ডেটা খুঁজতাম।
    // আপাতত শুধু প্রিন্ট করে দেখাচ্ছি।
    await context.Response.WriteAsync($"Employee Profile Page\nRequested Employee: {empName}");
});
 
// -------------------------------------------------------------
// Fallback Route
// -------------------------------------------------------------
// যদি URL-এ ডট না থাকে বা নামের বানান ভুল হয়, তখন এই রাউট ফায়ার হবে।
app.MapFallback(async (HttpContext context) =>
{
    await context.Response.WriteAsync("HTTP 404: Invalid URL Pattern! Please check your literal texts and parameters.");
});
 
app.Run();

Priority Specification (কী মনে রাখবে, কী বাদ দেবে)

  • 🔥 High Priority (অবশ্যই মনে রাখবে):

  • {} ব্যবহার করে Route Parameter তৈরি করা।

  • Literal text-এর ক্ষেত্রে একদম হুবহু বানান বা প্যাটার্ন ম্যাচ করার বিষয়টা।

  • প্যারামিটারের নামে কোনো স্পেস না দেওয়া।

  • 📉 Low Priority (ভুলে গেলেও সমস্যা নেই):

  • context.Request.RouteValues["name"] দিয়ে ম্যানুয়ালি অবজেক্ট থেকে স্ট্রিংয়ে কনভার্ট করা। (কেন এটা লো-প্রায়োরিটি, সেটা নিচের ‘Best Practices’ অংশে বলছি)।

Added Context (Gaps Filled)

রিয়েল ওয়ার্ল্ডে এই Route Parameter দিয়ে কী হয়? ইনস্ট্রাক্টর শেষে একটা দারুণ কথা বলেছেন—“In the real world projects… you can write the code for getting the corresponding employee data from the database.”

ধরো, তুমি তোমার Chatrabash প্রোজেক্টে একটা রাউট বানালে hostel/details/{id}। যখন কেউ hostel/details/5 লিখে হিট করবে, তখন তোমার ব্যাকএন্ড ওই 5 আইডিটা রিসিভ করবে। তারপর Entity Framework (EF Core) দিয়ে ডাটাবেসে কুয়েরি চালাবে: db.Hostels.FirstOrDefault(h => h.Id == 5)। ডেটা পেলে সেটা JSON হিসেবে ক্লায়েন্টকে রিটার্ন করবে। এটাই হলো যেকোনো ওয়েব API-এর মূল ভিত্তি!

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

১. Route Values ম্যানুয়ালি রিড না করা (Model Binding): ইনস্ট্রাক্টর বেসিক বোঝানোর জন্য context.Request.RouteValues["..."] ব্যবহার করেছেন। কিন্তু প্রফেশনাল C# ডেভেলপমেন্টে আমরা এভাবে করি না। আমরা সরাসরি ল্যাম্বডা ফাংশনের প্যারামিটার হিসেবে নামটা ডিক্লেয়ার করে দিই। ASP.NET Core নিজ দায়িত্বে ভ্যালুটা ম্যাপ করে দেয় (যাকে Model Binding বলে)।

বাজে প্র্যাকটিস (পুরনো স্টাইল):

app.MapGet("employee/profile/{employeeName}", async (HttpContext context) => {
    string? name = Convert.ToString(context.Request.RouteValues["employeeName"]);
});

প্রফেশনাল প্র্যাকটিস (মডার্ন Minimal API):

// প্যারামিটারের নাম রাউটের নামের সাথে মিলে গেলেই .NET অটোমেটিক ভ্যালু বসিয়ে দেবে!
app.MapGet("employee/profile/{employeeName}", (string employeeName) => {
    return $"Requested Employee: {employeeName}";
});

২. Kebab-case URL ব্যবহার করা: URL-এর Literal Text-গুলো সবসময় ছোট হাতের অক্ষর এবং হাইফেন দিয়ে লেখা উচিত (যাকে kebab-case বলে)। যেমন employeeProfile/{name} না লিখে employee-profile/{name} লেখাটা ইন্ডাস্ট্রি স্ট্যান্ডার্ড।

৩. Route Constraints (সামনের লেকচারের ট্রেইলার): তুমি চাইলে প্যারামিটারকে আরও স্ট্রিক্ট করে দিতে পারো। ধরো তুমি চাও আইডির জায়গায় কেউ যেন টেক্সট না দিতে পারে, শুধু নাম্বার দিতে পারে। তখন তুমি {id:int} লিখতে পারো। এগুলোকে বলে Route Constraints, যা হয়তো ইনস্ট্রাক্টর সামনের লেকচারে কভার করবেন।

হাসিব, কনসেপ্টটা কি পুরোপুরি ক্লিয়ার? কোনো পয়েন্ট নিয়ে খটকা লাগলে নির্দ্বিধায় জানাও!

Graph View

Backlinks