‫بررسی قابلیت FullJoin در NET 11.؛ قطعه گم‌شده پازل LINQ

سلب مسئولیت (Disclaimer): هرچند کلیات این API مورد تأیید (Approved) قرار گرفته است، اما تا زمان نگارش این مقاله هنوز Pull Request (PR) رسمی برای ادغام آن در SDK دات‌نت یا Entity Framework Core باز نشده‌است. بنابراین، ساختار نهایی و جزئیات پیاده‌سازی آن ممکن است تا زمان عرضه نسخه نهایی .NET 11 دستخوش تغییرات شود.

• اگر هر دو سمت تطابق داشته باشند: یک جفت متناظر (Pair) در خروجی ایجاد می‌شود.
• اگر داده فقط در مجموعه سمت چپ باشد: داده سمت چپ حفظ شده و مقدار سمت راست null در نظر گرفته می‌شود.
• اگر داده فقط در مجموعه سمت راست باشد: داده سمت راست حفظ شده و مقدار سمت چپ null در نظر گرفته می‌شود.

var customers = new[]
{
    new Customer(1, "Alice"),
    new Customer(2, "Bob"),
    new Customer(3, "Charlie")
};

var orders = new[]
{
    new Order(1, 100), // سفارش برای Alice
    new Order(1, 101), // سفارش دوم برای Alice
    new Order(4, 102)  // سفارشی بدون مشتری ثبت شده در این آرایه
};

• Alice + Order 100 (تطابق کامل)
• Alice + Order 101 (تطابق کامل)
• Bob + بدون سفارش (مشتری بدون سفارش - در Inner Join حذف می‌شد)
• Charlie + بدون سفارش (مشتری بدون سفارش - در Inner Join حذف می‌شد)
• بدون مشتری + Order 102 (سفارش بدون مشتری - رکورد کلیدی که هم در Inner Join و هم در Left Join حذف می‌شد اما در Full Join باقی می‌ماند).

public static IEnumerable<TResult> FullJoin<TOuter, TInner, TKey, TResult>(
    this IEnumerable<TOuter> outer,
    IEnumerable<TInner> inner,
    Func<TOuter, TKey> outerKeySelector,
    Func<TInner, TKey> innerKeySelector,
    Func<TOuter?, TInner?, TResult> resultSelector);

Func<TOuter?, TInner?, TResult> resultSelector

• اورلودی که یک IEqualityComparer را برای مقایسه سفارشی کلیدها می‌پذیرد.
• پشتیبانی از Tuple-overload جهت تسهیل نگاشت‌های سریع بدون نیاز به نوشتن عبارت‌های پیچیده.
• پیاده‌سازی همگام برای اکوسیستم‌های دیگر مانند IQueryable (جهت استفاده در ORMهایی مثل EF Core) و IAsyncEnumerable (برای پردازش‌های ناهمگام جریان داده‌ها).

var results = customers.FullJoin(
    orders,
    c => c.CustomerId,
    o => o.CustomerId,
    (customer, order) => new
    {
        CustomerName = customer?.Name ?? "(no customer)",
        OrderId = order?.Id ?? 0
    });

// راهکار سنتی و پیچیده فعلی (شبیه‌سازی Full Join)
var leftJoin = from customer in customers
               join order in orders on customer.CustomerId equals order.CustomerId into joinedOrders
               from order in joinedOrders.DefaultIfEmpty()
               select new { customer, order };

var rightJoin = from order in orders
                join customer in customers on order.CustomerId equals customer.CustomerId into joinedCustomers
                from customer in joinedCustomers.DefaultIfEmpty()
                select new { customer, order };

var fullJoinAlternative = leftJoin.Union(rightJoin);

• کاهش شدید خوانایی: کد بسیار طولانی و مستعد خطای منطقی است.
• افت کارایی (Performance Penalty): ارزیابی مجموعه‌ها در این حالت (به ویژه استفاده از Union برای حذف تکراری‌ها) نیاز به تخصیص حافظه (Memory Allocation) بیشتر و زمان پردازش مضاعف دارد.