Quartz 5

3. Hierarchical Configuration

4 min read

হ্যালো হাসিব! আমরা এখন Section 14: Configuration-এর তৃতীয় লেকচার “Hierarchical Configuration” (Lecture 152)-এ আছি।

আগের লেকচারে আমরা appsettings.json থেকে সিঙ্গেল Key-Value রিড করা শিখেছিলাম। কিন্তু রিয়েল-ওয়ার্ল্ড প্রোজেক্টে ডাটা সাধারণত ছড়ানো-ছিটানো (Flat) থাকে না, বরং একটি আরেকটির ভেতরে গ্রুপ করা থাকে। আজকের লেকচারে আমরা শিখবো কিভাবে Nested JSON Object বা Hierarchical Configuration থেকে ডাটা রিড করতে হয়।

চলো, শুরু করি!

সারসংক্ষেপ (Quick Revision List)

  • Hierarchical Configuration কী: appsettings.json ফাইলে সম্পর্কিত (Related) কনফিগারেশনগুলোকে আলাদা না লিখে একটি নির্দিষ্ট Parent Key-এর আন্ডারে Nested JSON Object হিসেবে গ্রুপ করে রাখা।
  • The Why: কোড এবং কনফিগারেশন ফাইলকে ক্লিন, অর্গানাইজড এবং মেইনটেইনেবল রাখার জন্য।
  • Method 1 (Colon Separator): ParentKey:ChildKey সিনট্যাক্স ব্যবহার করে সরাসরি ডাটা রিড করা। (যেমন: _configuration["WeatherAPI:ClientID"])।
  • Method 2 (GetSection): GetSection("ParentKey") মেথড ব্যবহার করে পুরো ব্লকটিকে একটি IConfigurationSection অবজেক্ট হিসেবে মেমোরিতে নিয়ে আসা এবং তারপর সেখান থেকে Child Key গুলো রিড করা। এটি কোড ডুপ্লিকেশন কমায়।

Comprehensive Breakdown

১. Hierarchical Configuration কী এবং কেন দরকার? [Priority: 10/10]

ধরো, তুমি একটি Weather API ব্যবহার করবে যার জন্য তোমার ClientID এবং ClientSecret প্রয়োজন। তুমি চাইলে appsettings.json ফাইলে এগুলোকে আলাদা আলাদা লিখতে পারো। কিন্তু এটি ব্যাড প্র্যাকটিস।

সঠিক উপায় হলো, এগুলো যেহেতু একই API-এর অংশ, তাই এদেরকে একটি Parent Key (যেমন: WeatherAPI)-এর ভেতরে গ্রুপ করে রাখা। একেই Hierarchical Configuration বলে।

Code Implementation (appsettings.json):

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  // Hierarchical Configuration / Nested JSON Object
  "WeatherAPI": {
    "ClientID": "my_client_id_from_settings",
    "ClientSecret": "my_super_secret_key"
  }
}

২. Method 1 - Colon (:) Separator ব্যবহার করে ডাটা রিড করা [Priority: 10/10]

Controller-এর ভেতরে Nested ডাটা রিড করার সবচেয়ে সহজ উপায় হলো Colon (:) ব্যবহার করা। এটি Parent Key এবং Child Key-কে আলাদা করে।

Code Implementation (Controllers/HomeController.cs):

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
 
namespace ConfigurationExample.Controllers
{
    public class HomeController : Controller
    {
        private readonly IConfiguration _configuration;
 
        public HomeController(IConfiguration configuration)
        {
            _configuration = configuration;
        }
 
        [Route("/")]
        public IActionResult Index()
        {
            // Colon (:) ব্যবহার করে Nested ডাটা রিড করা হচ্ছে
            string clientId = _configuration["WeatherAPI:ClientID"];
            
            // GetValue এর সাথেও Colon (:) ব্যবহার করা যায়
            string clientSecret = _configuration.GetValue<string>("WeatherAPI:ClientSecret", "default_secret");
 
            ViewBag.ClientID = clientId;
            ViewBag.ClientSecret = clientSecret;
 
            return View();
        }
    }
}

৩. Method 2 - GetSection() ব্যবহার করা (Smarter Way) [Priority: 9/10]

উপরের মেথডে একটি সমস্যা আছে। যদি তোমার WeatherAPI-এর আন্ডারে ১০টি প্রপার্টি থাকে, তবে তোমাকে ১০ বার WeatherAPI:... লিখতে হবে। এতে টাইপিং মিস্টেক হওয়ার চান্স থাকে।

এর সমাধান হলো GetSection() মেথড। এই মেথডটি WeatherAPI ব্লকটিকে একটি IConfigurationSection অবজেক্ট হিসেবে রিটার্ন করে।

Code Implementation (HomeController এর Index মেথড):

[Route("/")]
public IActionResult Index()
{
    // ১. পুরো WeatherAPI সেকশনটি একবারেই মেমোরিতে নিয়ে আসা হলো
    IConfigurationSection weatherApiSection = _configuration.GetSection("WeatherAPI");
 
    // ২. এবার আর Parent Key লিখতে হবে না, সরাসরি Child Key রিড করা যাবে
    ViewBag.ClientID = weatherApiSection["ClientID"];
    ViewBag.ClientSecret = weatherApiSection["ClientSecret"];
 
    return View();
}

(এই পদ্ধতিটি কোডকে অনেক বেশি রিডেবল এবং ক্লিন করে)।

৪. View-তে ডাটা দেখানো [Priority: 5/10]

আগের লেকচারের মতোই ViewBag থেকে ডাটাগুলো View-তে দেখানো হয়েছে।

Code Implementation (Views/Home/Index.cshtml):

<div class="container">
    <h2>Hierarchical Configuration Values</h2>
    <div class="box">
        <p><strong>Client ID:</strong> @ViewBag.ClientID</p>
        <p><strong>Client Secret:</strong> @ViewBag.ClientSecret</p>
    </div>
</div>

VS / VS Code Shortcuts (For faster development)

  • Introduce Local Variable: যখন তুমি _configuration.GetSection("WeatherAPI") লিখবে, তখন সেটির উপর কার্সর রেখে Ctrl + . চাপলে “Introduce local variable” অপশন আসবে। এটি সিলেক্ট করলে অটোমেটিক IConfigurationSection weatherApiSection = ... তৈরি হয়ে যাবে।

Best Practices & .NET 10 Context

Best Practices for Hierarchical Configuration:

  1. Avoid Magic Strings: GetSection("WeatherAPI") বা weatherApiSection["ClientID"] এগুলোতে হার্ডকোড স্ট্রিং (Magic Strings) ব্যবহার করা হয়েছে। যদি বানান ভুল হয়, তবে কোড রানটাইমে এরর খাবে। প্রফেশনাল প্রোজেক্টে এগুলোকে const string হিসেবে একটি আলাদা ক্লাসে রাখা হয়।
  2. Move to strongly typed objects: IConfigurationSection বা Indexer ব্যবহার করে ডাটা রিড করাটা ছোট প্রোজেক্টের জন্য ঠিক আছে, কিন্তু বড় প্রোজেক্টের জন্য এটি মেইনটেইন করা কষ্টকর। এর জন্য Options Pattern ব্যবহার করতে হয়।

.NET 10 Context (The Modern & Smarter Way): যদিও লেকচারার পরের লেকচারে Options Pattern শেখাবেন, তবে .NET 10-এ Hierarchical Configuration-কে সরাসরি একটি C# ক্লাসের সাথে ম্যাপ (Bind) করার একটি দারুণ শর্টকাট মেথড আছে, যা Get<T>() নামে পরিচিত। এটি IConfigurationSection এর চেয়ে অনেক বেশি স্মার্ট।

.NET 10 Modern Code Example (Strongly Typed Binding): প্রথমে একটি C# ক্লাস তৈরি করো যা JSON-এর স্ট্রাকচারের সাথে মিলে যায়:

public class WeatherApiSettings
{
    public string ClientID { get; set; }
    public string ClientSecret { get; set; }
}

এরপর Controller-এ সরাসরি ক্লাস হিসেবে ডাটা রিড করো:

[Route("/")]
public IActionResult Index()
{
    // .NET 10-এ Get<T>() ব্যবহার করে পুরো JSON Section-কে সরাসরি C# অবজেক্টে কনভার্ট করে ফেলা!
    var weatherSettings = _configuration.GetSection("WeatherAPI").Get<WeatherApiSettings>();
 
    // এখন তুমি Strongly Typed উপায়ে ইন্টেলিসেন্স (IntelliSense) সহ ডাটা ব্যবহার করতে পারবে
    ViewBag.ClientID = weatherSettings.ClientID;
    ViewBag.ClientSecret = weatherSettings.ClientSecret;
 
    return View();
}

হাসিব, appsettings.json থেকে Hierarchical Configuration রিড করার পদ্ধতি কি তোমার কাছে ক্লিয়ার হয়েছে? রেডি থাকলে আমরা নেক্সট লেকচার “Options Pattern”-এ মুভ করতে পারি, যা এই সেকশনের সবচেয়ে গুরুত্বপূর্ণ এবং ইন্ডাস্ট্রিতে সবচেয়ে বেশি ব্যবহৃত আর্কিটেকচারাল প্যাটার্ন!

Graph View

Backlinks