Quartz 5

17. Get Person By Person ID - Implementation

5 min read

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

📝 Lecture Summary (Quick Revision)

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

  • Initial Null Check: মেথডের ইনপুট personId প্যারামিটারটি null কিনা তা চেক করা এবং null হলে সরাসরি null রিটার্ন করা।
  • Data Fetching (LINQ): _persons লিস্ট থেকে নির্দিষ্ট ID অনুযায়ী ডেটা খুঁজে বের করতে LINQ-এর FirstOrDefault() মেথড ব্যবহার করা।
  • Result Null Check: লিস্ট থেকে ডেটা খোঁজার পর সেটি পাওয়া গেছে কিনা (অর্থাৎ অবজেক্টটি null কিনা) তা ভেরিফাই করা।
  • DTO Conversion: খুঁজে পাওয়া Person (Domain Model) অবজেক্টটিকে রেসপন্স হিসেবে পাঠানোর জন্য PersonResponse (DTO) টাইপে কনভার্ট করা (পূর্বের তৈরি করা হেল্পার মেথড দিয়ে)।
  • Test Verification: xUnit Test রান করে দেখা যে GetPersonByPersonId এর দুটি টেস্ট পাস করেছে, কিন্তু GetAllPersons ইমপ্লিমেন্ট না থাকায় আগের একটি টেস্ট এখনো ফেইল করছে।

🧠 Comprehensive Breakdown

এই লেকচারে আমরা PersonsService ক্লাসের ভেতরে GetPersonByPersonId মেথডটির আসল লজিক (Implementation) লিখেছি। চলুন প্রতিটি ধাপ বিস্তারিতভাবে বুঝে নিই।

১. Parameter Null Checking (Priority: 8/10)

Concept & Why: যখন Controller থেকে এই মেথডটি কল করা হবে, তখন personId হিসেবে null আসতে পারে। যদি আমরা সরাসরি null ভ্যালু দিয়ে লিস্টে বা ডাটাবেসে ডেটা খুঁজতে যাই, তাহলে সিস্টেমে এরর আসতে পারে। তাই মেথডের শুরুতেই চেক করে নেওয়া হয় ইনপুট null কিনা।

if (personId == null)
{
    return null;
}

২. Searching with LINQ FirstOrDefault (Priority: 10/10)

Concept & Why: Data Store (এখানে _persons লিস্ট) থেকে একটি নির্দিষ্ট Person খুঁজে বের করার জন্য আমরা LINQ-এর FirstOrDefault মেথড ব্যবহার করেছি।

  • এটি একটি Lambda Expression (যেমন: temp => temp.PersonId == personId) গ্রহণ করে।
  • এটি লিস্টের প্রতিটি অবজেক্ট চেক করে। যদি কন্ডিশন মিলে যায়, তবে সাথে সাথে সেই অবজেক্টটি রিটার্ন করে দেয়।
  • যদি পুরো লিস্ট খুঁজেও কোনো অবজেক্ট না পায়, তবে এটি ডিফল্ট ভ্যালু হিসেবে null রিটার্ন করে।
// Nullable Person টাইপ ব্যবহার করা হয়েছে কারণ ডেটা না-ও পাওয়া যেতে পারে
Person? person = _persons.FirstOrDefault(temp => temp.PersonId == personId);

৩. Fetched Object Null Checking (Priority: 8/10)

Concept & Why: FirstOrDefault থেকে যে ভ্যালুটি রিটার্ন আসবে, সেটি null হতে পারে (যদি ওই ID এর কোনো Person লিস্টে না থাকে)। তাই কনভার্শন বা অন্য কোনো কাজ করার আগে চেক করে নিতে হবে অবজেক্টটি আসলেই পাওয়া গেছে কিনা। না পাওয়া গেলে মেথডটি null রিটার্ন করবে।

if (person == null)
{
    return null;
}

৪. Convert Domain Model to DTO (Priority: 9/10)

Concept & Why: আমরা আগেই শিখেছি যে, Service লেয়ার থেকে কখনোই ডাটাবেসের মেইন Entity (Domain Model) সরাসরি রিটার্ন করা উচিত নয়। তাই আমরা person অবজেক্টটিকে আগের লেকচারে তৈরি করা হেল্পার মেথড (ConvertPersonToPersonResponse) ব্যবহার করে PersonResponse (DTO) তে কনভার্ট করে রিটার্ন করেছি।

return ConvertPersonToPersonResponse(person);

৫. Unit Test Evaluation (Priority: 5/10)

Concept: কোড লেখা শেষ হলে Test Explorer থেকে টেস্টগুলো রান করা হয়েছে।

  • Pass: GetPersonByPersonId_NullPersonId এবং GetPersonByPersonId_WithProperPersonId সফলভাবে পাস করেছে, কারণ আমাদের লেখা লজিক ঠিকমতো কাজ করছে।
  • Fail: AddPerson_ProperPersonDetails টেস্টটি এখনো ফেইল করছে। Why? কারণ ওই টেস্টের শেষে GetAllPersons মেথডটি কল করা হয়েছিল, যা আমরা এখনো ইমপ্লিমেন্ট করিনি (সেখানে এখনো NotImplementedException থ্রো করা আছে)। এটি পরবর্তী লেকচারগুলোতে ইমপ্লিমেন্ট করা হবে।

💻 Complete Implementation Code (As per Transcript)

লেকচারারের দেখানো স্টেপগুলো মিলিয়ে সম্পূর্ণ কোডটি নিচে দেওয়া হলো:

public PersonResponse? GetPersonByPersonId(Guid? personId)
{
    // ১. Parameter Null Check
    if (personId == null)
    {
        return null;
    }
 
    // ২. Fetch matching person from the list
    Person? person = _persons.FirstOrDefault(temp => temp.PersonId == personId);
 
    // ৩. Fetched object Null Check
    if (person == null)
    {
        return null;
    }
 
    // ৪. Convert to DTO and Return
    return ConvertPersonToPersonResponse(person);
}

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

লেকচারে দেখানো কোডটি বেসিক এবং নতুনদের শেখার জন্য দারুণ। তবে মডার্ন C# (C# 9 থেকে C# 12+) ব্যবহার করে এই কোডটিকে আরও অনেক বেশি রিডেবল এবং মাত্র এক-দুই লাইনে নামিয়ে আনা যায়।

Modern Code Implementation:

public PersonResponse? GetPersonByPersonId(Guid? personId)
{
    // C# 9+ Pattern Matching (is null) is faster and safer than (== null)
    if (personId is null)
        return null;
 
    // Using LINQ and Null-conditional operator (?.) to simplify the logic into a single line
    Person? person = _persons.FirstOrDefault(temp => temp.PersonId == personId);
    
    return person is not null ? ConvertPersonToPersonResponse(person) : null;
}

Why this is better: * == null এর বদলে is null ব্যবহার করাটা আধুনিক C# এ বেস্ট প্র্যাকটিস, কারণ এটি সরাসরি মেমরি রেফারেন্স চেক করে এবং কোনো অপারেটর ওভারলোডিং থাকলে তাতে কনফিউজড হয় না।

  • আমরা টার্নারি অপারেটর (? :) ব্যবহার করে ২-৩টি if-return ব্লককে এক লাইনে সুন্দরভাবে গুছিয়ে এনেছি।

🏆 Best Practices (Service Layer & LINQ)

  1. Direct Condition in FirstOrDefault: কখনোই _persons.Where(x => x.PersonId == personId).FirstOrDefault() লিখবেন না। Where পুরো লিস্ট স্ক্যান করে একটি নতুন কালেকশন বানায়, তারপর সেখান থেকে ফার্স্ট আইটেম নেয় যা পারফরম্যান্সের জন্য ক্ষতিকর। সরাসরি FirstOrDefault এর ভেতরে কন্ডিশন দেওয়া বেস্ট প্র্যাকটিস।
  2. Early Return / Fail Fast: মেথডের শুরুতেই null বা ইনভ্যালিড ডেটা চেক করে মেথড থেকে বের হয়ে যাওয়া (Return করা) উচিত। লেকচারার ঠিক এই কাজটিই করেছেন। এর ফলে নেস্টেড if-else (Deep nesting) তৈরি হয় না এবং কোড রিডেবিলিটি বাড়ে।
  3. Data Encapsulation: Controller বা Unit Test-এর কাছে কখনোই Person মডেল এক্সপোজ না করে PersonResponse DTO রিটার্ন করা একটি সিকিউর আর্কিটেকচারাল প্যাটার্ন।

Graph View

Backlinks