Quartz 5

8. Get All Countries - Implementation

5 min read

আমি আপনার “Simple Coding Tutor”। চলুন, আজকের লেকচারটি অত্যন্ত সহজভাবে এবং গভীর বিষদ আলোচনা সহকারে বুঝে নেওয়া যাক।

📝 Lecture Summary (Quick Revision)

ভবিষ্যতে দ্রুত রিভিশন দেওয়ার জন্য সম্পূর্ণ লেকচারের মূল অংশগুলো নিচে লিস্ট আকারে দেওয়া হলো:

  • GetAllCountries Implementation: LINQ-এর Select() মেথড ব্যবহার করে ডাটা সোর্সের প্রতিটি Country অবজেক্টকে ToCountryResponse() এক্সটেনশন মেথডের মাধ্যমে CountryResponse-এ রূপান্তর করা এবং ToList() দিয়ে লিস্ট আকারে রিটার্ন করা।
  • The Test Failure Issue: GetAllCountries ইমপ্লিমেন্ট করার পরেও Assert.Contains ব্যবহার করা টেস্টগুলো ফেল করে। কারণ এটি ডিফল্টভাবে Reference Equality চেক করে, Value Equality নয়।
  • Reference vs Value Equality: ডিফল্টভাবে C#-এর ক্লাস দুটি ভিন্ন অবজেক্টের মেমরি অ্যাড্রেস বা রেফারেন্স তুলনা করে। অবজেক্টের ভেতরের ডেটা (যেমন: ID বা Name) একই হলেও রেফারেন্স আলাদা হলে তারা সমান হয় না।
  • Overriding Equals Method: CountryResponse ক্লাসে Equals মেথডটি Override করে কাস্টম লজিক লেখা হয়, যা দুটি অবজেক্টের CountryID এবং CountryName এর মান তুলনা করে সত্য বা মিথ্যা (True/False) রিটার্ন করে।
  • Typecasting in Equals: Equals মেথডের প্যারামিটার টাইপ object হওয়ায় প্রথমে সেটিকে CountryResponse টাইপে নিরাপদভাবে Typecast করতে হয়।
  • Overriding GetHashCode: C#-এর নিয়ম অনুযায়ী Equals মেথড Override করলে GetHashCode মেথডও Override করতে হয়। এটি অবজেক্টকে Dictionary বা HashSet-এর Key হিসেবে ব্যবহার করতে সাহায্য করে এবং কম্পাইলার ওয়ার্নিং দূর করে।
  • Test Success: Equals মেথড সঠিকভাবে ইমপ্লিমেন্ট করার পর সকল ইউনিট টেস্ট (যেমন: AddFewCountries এবং ProperCountryDetails) সফলভাবে পাস হয়।

🧠 Comprehensive Breakdown

১. GetAllCountries মেথড ইমপ্লিমেন্টেশন (Priority: 8/10)

Why: আমাদের ICountriesService-এর কন্ট্রাক্ট অনুযায়ী ডাটা স্টোর থেকে সব Country তুলে এনে ক্লায়েন্টকে দিতে হবে। ডাটাবেসের মেইন মডেল সরাসরি এক্সপোজ না করার জন্য আমরা ডেটাকে CountryResponse ডিটিও (DTO)-তে কনভার্ট করে পাঠাবো।

Concept & Implementation: এখানে LINQ (Language Integrated Query)-এর Select মেথড ব্যবহার করা হয়েছে। Select মেথডটি একটি লুপের মতো কাজ করে। এটি _countries লিস্টের প্রতিটি Country অবজেক্টকে একে একে ধরে এবং Lambda Expression-এর মাধ্যমে ToCountryResponse() মেথড কল করে রূপান্তর সম্পন্ন করে। অবশেষে ToList() মেথড দিয়ে সেটিকে List<CountryResponse>-এ রূপান্তর করে রিটার্ন করা হয়।

public List<CountryResponse> GetAllCountries()
{
    // _countries লিস্টের প্রতিটি আইটেমকে CountryResponse এ ম্যাপ করা হচ্ছে
    return _countries.Select(country => country.ToCountryResponse()).ToList();
}

২. কেন আমাদের Unit Test-গুলো Fail করলো? (Priority: 10/10)

Concept: টেস্ট রান করার পর দেখা গেল GetAllCountries_EmptyList পাস করলেও বাকি টেস্টগুলো ফেল করেছে, যেখানে Assert.Contains() ব্যবহার করা হয়েছিল।

Why: Assert.Contains(expected, collection) মেথডটি ইন্টারনালি কালেকশনের প্রতিটি আইটেমের ওপর .Equals() মেথড কল করে চেক করে যে expected অবজেক্টটি লিস্টে আছে কিনা। C#-এ ক্লাসের (Reference Type) ডিফল্ট Equals মেথড শুধুমাত্র Reference Equality চেক করে। অর্থাৎ, দুটি ভ্যারিয়েবল মেমরির একই লোকেশন বা অ্যাড্রেস নির্দেশ করছে কিনা তা দেখে।

যেহেতু GetAllCountries() মেথডটি কল করার সময় প্রতিবার Select() মেথডের ভেতরে new CountryResponse() তৈরি হচ্ছে, তাই মেমরিতে এদের রেফারেন্স সম্পূর্ণ নতুন। ফলে AddCountry() থেকে পাওয়া অবজেক্টের ডেটা আর GetAllCountries() থেকে পাওয়া অবজেক্টের ডেটা (ID এবং Name) হুবহু এক হওয়া সত্ত্বেও মেমরি রেফারেন্স আলাদা হওয়ায় Assert.Contains() সেটিকে খুঁজে পায় না এবং টেস্ট ফেল করে।

৩. Equals Method Override করা (Priority: 10/10)

Why: রেফারেন্স আলাদা হলেও অবজেক্টের ভেতরের প্রপার্টির মান (Value) যদি একই হয় (যেমন: ID এবং Name মিলে যায়), তবে আমাদের বিজনেস লজিক অনুযায়ী অবজেক্ট দুটি সমান। একেই Value Equality বলে। এটি অর্জন করতে আমাদের CountryResponse ক্লাসের ডিফল্ট Equals মেথডকে Override করতে হবে।

Implementation: Equals মেথডের প্যারামিটার হিসেবে আসে একটি সাধারণ object টাইপ। তাই আমাদের প্রথমে চেক করতে হবে সেটি null কিনা এবং সেটি আসলেই CountryResponse টাইপের অবজেক্ট কিনা। তারপর সেটিকে Typecast করে প্রপার্টিগুলো তুলনা করতে হবে।

// CountryResponse.cs ক্লাসের ভেতরে
public override bool Equals(object? obj)
{
    // ১. অবজেক্টটি null কিনা চেক করা
    if (obj == null) return false;
 
    // ২. অবজেক্টটি CountryResponse টাইপের কিনা চেক করা
    if (obj is not CountryResponse) return false;
 
    // ৩. Typecasting করা
    CountryResponse country_to_compare = (CountryResponse)obj;
 
    // ৪. প্রপার্টির মানগুলো তুলনা করে True/False রিটার্ন করা
    return this.CountryID == country_to_compare.CountryID && 
           this.CountryName == country_to_compare.CountryName;
}

৪. GetHashCode Method Override করার গুরুত্ব (Priority: 7/10)

Why: C#-এর স্ট্যান্ডার্ড গাইডলাইন অনুযায়ী, আপনি যদি কোনো ক্লাসে Equals মেথড Override করেন, তবে আপনাকে অবশ্যই GetHashCode মেথডটিও Override করতে হবে। যদি আপনি এটি না করেন, তবে কম্পাইলার একটি Warning দেখাবে।

Concept: GetHashCode মেথডটি একটি অবজেক্টের জন্য একটি ইউনিক ইন্টিজার (Integer) আইডি বা হ্যাশ কোড জেনারেট করে। যখন কোনো অবজেক্টকে হ্যাশ-বেসড কালেকশন যেমন Dictionary<Key, Value> বা HashSet<T>-এর Key হিসেবে ব্যবহার করা হয়, তখন এই হ্যাশ কোডটি অত্যন্ত গুরুত্বপূর্ণ ভূমিকা পালন করে। যদিও এই প্রজেক্টে আমরা এটিকে Key হিসেবে ব্যবহার করছি না, তাও ওয়ার্নিং দূর করা এবং বেস্ট প্র্যাকটিস বজায় রাখার জন্য এটি নিচে দেখানো উপায়ে ইমপ্লিমেন্ট করা উচিত।

public override int GetHashCode()
{
    // ডিফল্ট বেস ইমপ্লিমেন্টেশন রিটার্ন করা হলো
    return base.GetHashCode();
}

🏆 Best Practices & Modern .NET Updates

১. Best Practices for Object Equality

  • যখনই কোনো DTO বা মডেল অবজেক্টকে কোনো কালেকশনে (List.Contains, Assert.Contains, Distinct) তুলনা করার প্রয়োজন হবে, তখনই Equals এবং GetHashCode ওoverride করা নিশ্চিত করুন।
  • Equals মেথডের শুরুতে সব সময় টাইপ সেফটি এবং null চেক করুন, যাতে রানটাইমে NullReferenceException বা InvalidCastException না ঘটে।

২. Modern C# (C# 9+ / .NET 8, 9, 10) Update: The record Type

লেকচারে দেখানো পদ্ধতিতে আমাদের ম্যানুয়ালি Equals এবং GetHashCode লিখতে হয়েছে এবং অনেকগুলো কোড টাইপ করতে হয়েছে। আধুনিক .NET এবং C# সংস্করণে এই ধরণের ডেটা কন্টেইনার বা DTO-এর জন্য record টাইপ নিয়ে আসা হয়েছে।

যদি আমরা CountryResponse ক্লাসটিকে একটি record হিসেবে ডিক্লেয়ার করি, তবে C# কম্পাইলার ব্যাকগ্রাউন্ডে স্বয়ংক্রিয়ভাবে (by default) Value-based Equality, Equals(), এবং GetHashCode() জেনারেট করে দেয়। আমাদের একটি লাইনের কোডও ম্যানুয়ালি লিখতে হয় না!

Modern Implementation Example:

// প্রজেক্টের CountryResponse.cs ফাইলটিকে এভাবে পরিবর্তন করা যায়:
public record CountryResponse
{
    public Guid CountryID { get; init; }
    public string? CountryName { get; init; }
}

শুধু এইটুকু লিখলেই C# নিজেই বুঝে নেবে যে দুটি CountryResponse রেকর্ড এর CountryID এবং CountryName মিলে গেলে তারা একে অপরের সমান (Equal), কোনো কাস্টম মেথড ওভাররাইড করার প্রয়োজনই নেই!

Graph View

Backlinks