16. Get Person By Person ID - xUnit Test

📝 Lecture Summary (Quick Revision)

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

• Interface Update: IPersonsService ইন্টারফেসে GetPersonByPersonId নামের নতুন মেথড ডিক্লেয়ার করা, যা ইনপুট হিসেবে Guid? গ্রহণ করে এবং PersonResponse? রিটার্ন করে।
• Dummy Implementation: PersonsService ক্লাসে মেথডটির ইনিশিয়াল বা ডামি ইমপ্লিমেন্টেশন করা (যেখানে NotImplementedException থ্রো করা হয়)।
• Test Case 1 (Null ID): GetPersonByPersonId_NullPersonId মেথড তৈরি করে চেক করা যে, ইনপুট null দিলে মেথডটি null রিটার্ন করে কিনা (Using Assert.Null)।
• Dependency Setup: Test ক্লাসের কনস্ট্রাক্টরে ICountriesService ইনিশিয়ালাইজ করা, কারণ Person অ্যাড করার জন্য একটি ভ্যালিড CountryId প্রয়োজন।
• Test Case 2 (Valid ID): GetPersonByPersonId_WithProperPersonId মেথড তৈরি করা। এখানে প্রথমে একটি Country অ্যাড করা হয়, তারপর সেই দেশের ID দিয়ে একটি Person অ্যাড করা হয়। শেষে সেই Person-এর ID দিয়ে GetPersonByPersonId কল করে চেক করা হয় ডেটা ঠিকমতো আসছে কিনা (Using Assert.Equal)।
• TDD Verification: টেস্টগুলো রান করে দেখা যে সবগুলো ফেইল করছে, কারণ মেথডটিতে এখনো আসল লজিক লেখা হয়নি।

---

🧠 Comprehensive Breakdown

এই লেকচারে আমরা TDD (Test Driven Development) অ্যাপ্রোচ ব্যবহার করে ডাটাবেস (বা লিস্ট) থেকে নির্দিষ্ট একটি ID দিয়ে Person খুঁজে বের করার লজিক টেস্ট করা শিখব। চলুন প্রতিটি ধাপ বিস্তারিতভাবে বুঝে নিই।

১. Interface-এ Method ডিক্লেয়ারেশন (Priority: 7/10)

Concept & Why: যখন Controller থেকে কোনো একটি নির্দিষ্ট Person-এর ডিটেইলস দেখার রিকোয়েস্ট আসবে, তখন এই মেথডটি ব্যবহার করা হবে। যদি ওই ID-এর কোনো Person না পাওয়া যায় বা ID null হয়, তবে Exception থ্রো করার বদলে মেথডটি null রিটার্ন করবে। তাই রিটার্ন টাইপ এবং ইনপুট প্যারামিটার উভয়কেই Nullable (?) করা হয়েছে।

// ServiceContracts/IPersonsService.cs
/// <summary>
/// Returns the matching person object
/// </summary>
/// <param name="personId">Person ID to search</param>
/// <returns>Returns matching person object or null</returns>
PersonResponse? GetPersonByPersonId(Guid? personId);
 

২. Dummy Implementation in Service (Priority: 5/10)

Concept & Why: ইন্টারফেসে মেথড ডিক্লেয়ার করার পর Service ক্লাসে তা ইমপ্লিমেন্ট করতে হয়। TDD-এর নিয়ম অনুযায়ী কোড লেখার আগেই তার টেস্ট লিখতে হয়, তাই আমরা সাময়িকভাবে একটি ডামি এক্সেপশন থ্রো করে রাখছি।

(VS / VS Code Shortcut: IPersonsService-এর ওপর কার্সর রেখে Ctrl + . চাপলে “Implement Interface” অপশন আসবে, যা স্বয়ংক্রিয়ভাবে মেথড তৈরি করে দেয়।)

// Services/PersonsService.cs
public PersonResponse? GetPersonByPersonId(Guid? personId)
{
    throw new NotImplementedException();
}
 

৩. Unit Test 1: Null PersonId চেক করা (Priority: 9/10)

Concept & Why: আমাদের প্রথম টেস্ট কেস হলো— যদি ইউজার ভুল করে null ভ্যালু পাঠায়, তবে সিস্টেম ক্র্যাশ না করে যেন সুন্দরভাবে null রিটার্ন করে।

#region GetPersonByPersonId
[Fact]
public void GetPersonByPersonId_NullPersonId()
{
    // Arrange
    Guid? personId = null;
 
    // Act
    PersonResponse? person_response_from_get = _personsService.GetPersonByPersonId(personId);
 
    // Assert
    Assert.Null(person_response_from_get);
}
#endregion
 

৪. Test Class-এ Dependency Setup (Priority: 8/10)

Concept & Why: একটি ভ্যালিড Person তৈরি করতে হলে তার CountryId (Foreign Key) দরকার। যেহেতু প্রতিটি ইউনিট টেস্ট সম্পূর্ণ স্বাধীন (Independent) এবং ডাটাবেস/লিস্ট ফাঁকা থাকে, তাই আমাদের টেস্টের ভেতরেই আগে একটি Country তৈরি করে নিতে হবে। এর জন্য PersonsServiceTest ক্লাসের কনস্ট্রাক্টরে CountriesService ইনজেক্ট করতে হবে।

public class PersonsServiceTest
{
    private readonly IPersonsService _personsService;
    private readonly ICountriesService _countriesService;
 
    public PersonsServiceTest()
    {
        _personsService = new PersonsService();
        _countriesService = new CountriesService();
    }
}
 

৫. Unit Test 2: Valid PersonId দিয়ে ডেটা রিট্রিভ করা (Priority: 10/10)

Concept & Why: এটি এই লেকচারের সবচেয়ে গুরুত্বপূর্ণ অংশ। xUnit-এ Test Isolation-এর কারণে আমাদের প্রথমে একটি Country অ্যাড করে তার ID নিতে হবে, তারপর সেই ID ব্যবহার করে একটি Person অ্যাড (Arrange) করে নিতে হবে। এরপর জেনারেট হওয়া Person ID ব্যবহার করে ডেটা তুলে আনতে (Act) হবে। এবং সবশেষে Expected এবং Actual ডেটা মেলাতে (Assert) হবে।

[Fact]
public void GetPersonByPersonId_WithProperPersonId()
{
    // Arrange 1: Country তৈরি করা
    CountryAddRequest country_request = new CountryAddRequest() { CountryName = "Canada" };
    CountryResponse country_response = _countriesService.AddCountry(country_request);
 
    // Arrange 2: Person তৈরি করা (ওপরের CountryId ব্যবহার করে)
    PersonAddRequest person_request = new PersonAddRequest()
    {
        PersonName = "John",
        Email = "john@example.com",
        Address = "123 Street",
        CountryId = country_response.CountryId,
        Gender = GenderOptions.Male,
        DateOfBirth = DateTime.Parse("2000-01-01"),
        ReceiveNewsLetters = false
    };
 
    PersonResponse person_response_from_add = _personsService.AddPerson(person_request);
 
    // Act: অ্যাড করা Person এর ID দিয়ে ডেটা রিট্রিভ করা
    PersonResponse? person_response_from_get = _personsService.GetPersonByPersonId(person_response_from_add.PersonId);
 
    // Assert: অ্যাড করা ডেটা (Expected) এবং রিট্রিভ করা ডেটা (Actual) হুবহু এক কিনা তা চেক করা
    Assert.Equal(person_response_from_add, person_response_from_get);
}
 

নোট: Assert.Equal এখানে সঠিকভাবে কাজ করবে কারণ আগের লেকচারগুলোতে আমরা PersonResponse ক্লাসে Equals মেথডটি Override করে এসেছিলাম, যা Value Equality চেক করে।

---

🚀 Modern C# (.NET 10) Updates & Smarter Approach

লেকচারের কোডটি সঠিক, তবে আধুনিক C# (C# 9 - 12) ব্যবহার করে টেস্টিং এবং অবজেক্ট তৈরি আরও স্মার্ট ও ক্লিন করা যায়।

1. Target-typed new Expressions: অবজেক্ট তৈরি করার সময় ক্লাসের নাম বারবার না লিখে শুধু new() ব্যবহার করা যায়।

// Old
CountryAddRequest country_request = new CountryAddRequest() { CountryName = "Canada" };
 
// Modern (C# 9+)
CountryAddRequest country_request = new() { CountryName = "Canada" };
 

2. Assert.Equivalent (xUnit Update): আগের লেকচারগুলোতে আমাদের ম্যানুয়ালি Equals মেথড ওভাররাইড করতে হয়েছিল। কিন্তু xUnit-এর আধুনিক ভার্সনগুলোতে Assert.Equivalent() মেথড আনা হয়েছে। আপনি যদি Equals মেথড ওভাররাইড নাও করেন, তবুও Assert.Equivalent() দুটি অবজেক্টের ভেতরের প্রপার্টিগুলোর ভ্যালু (Value Equality) চেক করতে পারে!

// Modern way to check object equivalence without needing custom Equals() override
Assert.Equivalent(person_response_from_add, person_response_from_get);
 

---

🏆 Best Practices (For xUnit & Service Testing)

• Test Independence: একটি ইউনিট টেস্টকে কখনোই অন্য একটি ইউনিট টেস্টের ওপর নির্ভরশীল করা যাবে না। টেস্ট রান হওয়ার আগে ডাটাবেস/ডাটা স্টোর ডিফল্ট অবস্থায় (Empty) আছে ধরে নিয়ে தேவையான ডেটা টেস্টের ভেতরেই (Arrange ব্লকে) তৈরি করে নিতে হবে (যেমনটি লেকচারে Country অ্যাড করে করা হয়েছে)।
• AAA Pattern: টেস্টের ভেতরে কমেন্ট করে // Arrange, // Act, // Assert ব্লকগুলো আলাদা করে রাখা উচিত। এতে অন্য ডেভেলপাররা কোড দেখলেই বুঝতে পারে টেস্টের ফ্লো কেমন।
• Meaningful Naming: টেস্ট মেথডের নাম দেখেই এর উদ্দেশ্য বোঝা উচিত। যেমন: GetPersonByPersonId_WithProperPersonId_ReturnsPersonResponse।