Quartz 5

7. Route Constraints - 03

4 min read

এই লেকচারটিতে ASP.NET Core-এর Routing Constraints-এর আরও কিছু গুরুত্বপূর্ণ এবং অ্যাডভান্সড ফিচার নিয়ে আলোচনা করা হয়েছে। একই সাথে বাস্তব জীবনে Constraints কখন ব্যবহার করা উচিত এবং কখন উচিত নয়— সেই সম্পর্কে Microsoft-এর রিকমেন্ডেশন বা বেস্ট প্র্যাকটিস নিয়েও খুব সুন্দর ধারণা দেওয়া হয়েছে।

চলো পুরো বিষয়টি ধাপে ধাপে বিস্তারিতভাবে বুঝে নিই।

১. লেকচারের বিস্তারিত বিশ্লেষণ (Comprehensive Breakdown)

ক. String Length Constraints (স্ট্রিংয়ের দৈর্ঘ্য নির্ধারণ)

স্ট্রিং বা টেক্সটের দৈর্ঘ্যের ওপর ভিত্তি করে আমরা Route-এ রেস্ট্রিকশন দিতে পারি:

  • minlength: কমপক্ষে কতগুলো ক্যারেক্টার থাকতে হবে। (যেমন: minlength(3))
  • maxlength: সর্বোচ্চ কতগুলো ক্যারেক্টার থাকতে পারে।
  • length(min, max): একসাথে minimum এবং maximum লিমিট সেট করা। (যেমন: length(4,7) মানে ৪ থেকে ৭ ক্যারেক্টারের মধ্যে হতে হবে)।
  • length(exact): একটি নির্দিষ্ট দৈর্ঘ্যের স্ট্রিং। (যেমন: Tax ID বা TIN নাম্বারের জন্য length(9) মানে ঠিক ৯ ক্যারেক্টারই হতে হবে)।

খ. Numerical Range Constraints (সংখ্যার সীমা নির্ধারণ)

নম্বরের ক্ষেত্রে আমরা ভ্যালুর লিমিট সেট করতে পারি (এটি length নয়, বরং ভ্যালু):

  • min: সর্বনিম্ন ভ্যালু। (যেমন: id:min(1) মানে আইডি ১ বা তার বেশি হতে হবে, নেগেটিভ ভ্যালু চলবে না)।
  • max: সর্বোচ্চ ভ্যালু।
  • range: একসাথে সর্বনিম্ন এবং সর্বোচ্চ ভ্যালু সেট করা। (যেমন: id:range(1,1000) মানে আইডি ১ থেকে ১০০০ এর মধ্যে হতে হবে)।

গ. Alphabetical Constraint (alpha)

যদি তুমি চাও কোনো Parameter-এ শুধুমাত্র বর্ণমালা (A-Z বা a-z) আসুক এবং কোনো নাম্বার বা স্পেশাল ক্যারেক্টার না থাকুক, তবে তুমি alpha Constraint ব্যবহার করতে পারো।

  • উদাহরণ: {employeeName:alpha}।
  • Multiple Constraints: তুমি চাইলে একাধিক Constraint একসাথে জুড়ে দিতে পারো। যেমন: {employeeName:alpha:length(4,7)}।

ঘ. Regular Expression Constraint (regex)

কঠিন বা কাস্টম কোনো প্যাটার্ন চেক করার জন্য regex ব্যবহার করা হয়।

  • লেকচারে একটি Sales Report-এর উদাহরণ দেওয়া হয়েছে, যেখানে বছর 1900 এর বেশি হতে হবে এবং মাস শুধুমাত্র এপ্রিল (apr), জুলাই (jul), অক্টোবর (oct) বা জানুয়ারি (jan) হতে পারবে।
  • SEO Tip: URL-এ আপারকেস লেটার বা স্পেস ব্যবহার না করে হাইফেন (-) ব্যবহার করা Search Engine Optimization (SEO)-এর জন্য ভালো (যেমন: sales-report বলা ভালো SalesReport-এর চেয়ে)।
  • Regex Pattern: regex(^(apr|jul|oct|jan)$)। এখানে ^ দিয়ে শুরু এবং $ দিয়ে শেষ বোঝায়। আর | (পাইপ) চিহ্নটি OR লজিক হিসেবে কাজ করে।

ঙ. Best Practice: Constraints vs. Validation (খুবই গুরুত্বপূর্ণ)

লেকচারের শেষ অংশে একটি অত্যন্ত গুরুত্বপূর্ণ রিয়েল-ওয়ার্ল্ড কনসেপ্ট বোঝানো হয়েছে।

  • Microsoft-এর রিকমেন্ডেশন: Route Constraints-কে ডেটা Validation-এর কাজে ব্যবহার করা উচিত নয়।
  • কারণ: Constraint ফেইল করলে অ্যাপ্লিকেশন সরাসরি Fallback Route-এ চলে যায় (বা 404 Not Found দেয়)। ক্লায়েন্ট বা ইউজার বুঝতে পারে না যে সে ঠিক কী ভুল করেছে।
  • সঠিক উপায়: Route-এ ভ্যালু এক্সেপ্ট করে নাও (Constraint ছাড়া)। এরপর Endpoint-এর ভেতরে if কন্ডিশন দিয়ে চেক করো। যদি ভ্যালু ভুল হয়, তবে 400 Bad Request স্ট্যাটাস কোড এবং একটি মিনিংফুল মেসেজ (যেমন: “This month is not allowed”) রিটার্ন করো। এতে ক্লায়েন্ট সহজে ভুল শুধরাতে পারবে।

চ. Code Implementation

লেকচারে আলোচিত বিষয়গুলোর একটি পূর্নাঙ্গ C# ইমপ্লিমেন্টেশন নিচে দেওয়া হলো:

app.UseEndpoints(endpoints =>
{
    // ১. String Length & Alpha Constraint
    endpoints.MapGet("employee/profile/{employeeName:alpha:length(4,7)}", async context =>
    {
        var name = context.Request.RouteValues["employeeName"];
        await context.Response.WriteAsync($"Employee Profile of: {name}");
    });
 
    // ২. Numerical Range Constraint
    endpoints.MapGet("products/details/{id:range(1,1000)}", async context =>
    {
        int productId = Convert.ToInt32(context.Request.RouteValues["id"]);
        await context.Response.WriteAsync($"Product details of ID: {productId}");
    });
 
    // ৩. Best Practice Implementation (No Regex Constraint, Validating inside code)
    endpoints.MapGet("sales-report/{year:min(1900)}/{month}", async context =>
    {
        int year = Convert.ToInt32(context.Request.RouteValues["year"]);
        string? month = context.Request.RouteValues["month"]?.ToString()?.ToLower();
 
        // কোডের ভেতরে ভ্যালিডেশন করা হচ্ছে
        if (month == "apr" || month == "jul" || month == "oct" || month == "jan")
        {
            await context.Response.WriteAsync($"Sales report for {month.ToUpper()} {year}");
        }
        else
        {
            // ভুল মাসের জন্য মিনিংফুল রেসপন্স এবং 400 Bad Request
            context.Response.StatusCode = 400; // Bad Request
            await context.Response.WriteAsync("Invalid month. Allowed values are: apr, jul, oct, jan.");
        }
    });
});

২. মূল্যায়ন (Critical Evaluation)

  • Strengths (সবল দিক):

  • দৈনন্দিন প্রোজেক্টে ব্যবহৃত প্রায় সব ধরনের বেসিক Constraints কভার করা হয়েছে।

  • SEO ফ্রেন্ডলি URL তৈরির টিপসটি প্র্যাকটিক্যাল ডেভেলপমেন্টের জন্য দারুণ।

  • Route Constraint এবং Input Validation-এর পার্থক্য এবং 400 Bad Request হ্যান্ডেল করার রিয়েল-ওয়ার্ল্ড অ্যাপ্রোচটি এই লেকচারের সবচেয়ে শক্তিশালী এবং শিক্ষণীয় দিক।

  • Limitations (সীমাবদ্ধতা):

  • Regular Expression নিয়ে খুব বিস্তারিত কোনো গাইডলাইন দেওয়া হয়নি (যদিও ইন্সট্রাক্টর বলেছেন যে এটি এই কোর্সের আওতার বাইরে)।

৩. পরবর্তী ধাপ ও প্রাসঙ্গিক বিষয় (Future Learning Path)

এই লেকচারের পর তোমার .NET স্কিলকে আরও এক ধাপ এগিয়ে নিতে নিচের বিষয়গুলো স্টাডি করা উচিত:

  • Custom Route Constraints: (IRouteConstraint ইন্টারফেস ইমপ্লিমেন্ট করে নিজেদের ডাটাবেস লজিক দিয়ে কাস্টম কনস্ট্রেইন্ট তৈরি করা)।
  • Input Validation in ASP.NET Core: (কীভাবে Data Annotations বা FluentValidation ব্যবহার করে আরও সহজে ভ্যালিডেশন করা যায়)।
  • HTTP Status Codes: (REST API তৈরির ক্ষেত্রে 400 Bad Request, 404 Not Found, 200 OK ইত্যাদির সঠিক ব্যবহার)।
  • C# Regular Expressions (System.Text.RegularExpressions): (Regex-এর বেসিক সিনট্যাক্স এবং C#-এ এর ব্যবহার)।

Graph View

Backlinks