Software Engineer Encyclopedia
0%
Domain 06 · Software Architecture & Design Patterns · Topic 6.7

Design Patterns في C#: حل المشكلة قبل حفظ اسم الـ Pattern

Design Patterns — Selective Practical Guide

أنماط التصميم الأكثر استخدامًا في .NET: Strategy، Factory، Builder، Adapter، Decorator، Observer، Mediator، Command، State، Chain، Repository وDistributed patterns.

  • Advanced
  • ~20 min read
  • 14 sections
  • 20 code examples
  • 1 diagrams
  • 5 questions
  • Priority L2 · Important
  • C# 14 · .NET 10

المتطلبات قبل ما تبدأ

خبرة عملية ببناء API بقاعدة بيانات — الأنماط دي حلول لمشاكل لازم تكون شفتها.

مستوى التعمق المطلوب

SELECTIVE PRACTICALLearn patterns in response to real design problems, not by memorizing a catalog.

01

إزاي تتعلم Pattern؟

Problem → forces → structure → trade-off
Deep dive

Design Pattern اسم لحل متكرر لمشكلة تصميم، مش code snippet لازم تنسخه. ابدأ بالمشكلة: ما الذي يتغير؟ ما الذي يصعب اختباره؟ ما الـ coupling؟ بعدين اختَر pattern، نفّذ أبسط شكل، وراجع trade-offs. Pattern بدون problem غالبًا overengineering.

التقسيم الشائع: Creational لإنشاء objects، Structural لتركيب objects/adapters، Behavioral لتوزيع behavior والتواصل، Enterprise patterns لتنظيم application/persistence، و Distributed patterns للتعامل مع network failure والرسائل والاتساق. بعض patterns تظهر أصلًا في ‎.NET framework؛ الهدف التعرف عليها وفهم حدودها.

02

Decorator chain في رسمة

Composing behaviour with decorators
Basics
CallerIPaymentGatewayLoggingRetryTimeoutStripeGatewayTimeout inside Retry = per-attempt; Retry inside Timeout = total budget
Each decorator implements the same interface and wraps the next; order changes behaviour
03

Strategy و Factory و Abstract Factory

Encapsulate variation and object creation
Deep dive

Strategy تعزل algorithm/policy قابلة للتبديل. مثال: طرق حساب shipping أو discount أو tax. الـ caller يعتمد على interface ويختار implementation من DI/configuration. Factory Method تخفي قرار إنشاء concrete type؛ Abstract Factory تنشئ عائلة objects متوافقة معًا. لا تستخدم Factory إذا constructor مباشر كافٍ.

C#Strategy selected by a factory
public interface IPaymentProcessor
{
    string Method { get; }
    Task<PaymentResult> PayAsync(PaymentRequest request, CancellationToken ct);
}

public sealed class PaymentProcessorFactory(
    IEnumerable<IPaymentProcessor> processors)
{
    private readonly IReadOnlyDictionary<string, IPaymentProcessor> _map =
        processors.ToDictionary(x => x.Method, StringComparer.OrdinalIgnoreCase);

    public IPaymentProcessor Get(string method) =>
        _map.TryGetValue(method, out var processor)
            ? processor
            : throw new NotSupportedException("Payment method is not supported.");
}

لو عندك عدد كبير من processors، DI يمكن أن يسجل كل implementations. Factory هنا تحل اختيار implementation، بينما Strategy تعزل algorithm. لا تجعل factory static global state ولا تضع business logic كبيرة بداخلها.

Factory Method vs Simple Factory vs Abstract Factory

Simple Factory غالبًا class/static method تختار implementation حسب input؛ هو idiom شائع وليس GoF pattern رسميًا مستقلًا في كل التصنيفات. Factory Method يجعل subclasses أو creator abstraction تتحكم في concrete product. Abstract Factory تنشئ عائلة منتجات متوافقة، مثل UI widgets لنظامين أو storage adapters مرتبطة بنفس cloud provider.

في ASP.NET Core، keyed DI registrations أو dictionary of strategies قد تغني عن factory custom. لو selection يعتمد على user input، تحقق من key allow-list ولا تستخدم reflection على type name من request. factory مسؤولة عن creation/selection، وليست مكان business workflow أو database operations.

Strategy vs State: تشابه في الشكل واختلاف في المعنى

Strategy غالبًا behavior يختاره caller أو configuration من مجموعة policies مستقلة: حساب الخصم، طريقة الشحن، tax calculation. State behavior يتغير بسبب lifecycle داخل object نفسه، والـ transitions تتحكم في المسموح. ممكن الاتنين يكونوا interface + implementations، لكن ownership مختلف.

C#Strategy: select a pricing policy
public interface IPricingPolicy
{
    decimal Calculate(decimal subtotal);
}

public sealed class StandardPricing : IPricingPolicy
{
    public decimal Calculate(decimal subtotal) => subtotal;
}

public sealed class VipPricing : IPricingPolicy
{
    public decimal Calculate(decimal subtotal) => subtotal * 0.90m;
}
C#State-like lifecycle guard
public sealed class Shipment
{
    public ShipmentStatus Status { get; private set; } = ShipmentStatus.Created;

    public void MarkDispatched()
    {
        if (Status != ShipmentStatus.LabelCreated)
            throw new DomainException("A label must exist before dispatch.");
        Status = ShipmentStatus.Dispatched;
    }
}

لا تجعل pricing policy تغير shipment status، ولا تجعل entity تعرف DI container لاختيار strategy. Application تختار policy المناسبة وتقدمها للـ domain operation. ولو كل State object لا يفعل أكثر من تغيير enum، غالبًا classes كثيرة غير لازمة.

Factory مع DI: اختيار آمن ومتين

في ASP.NET Core، تقدر تسجل عدة implementations لنفس interface وتحقن `IEnumerable`. Factory تبني lookup dictionary عند الإنشاء، وتتحقق من duplicate keys، وتتعامل مع unknown key كـ domain/application error مناسب. لا تستقبل assembly-qualified type name من HTTP request ثم تنفذ reflection/Activator؛ ده يفتح باب arbitrary type activation ويجعل contract غير مضبوط.

C#Validated strategy registry
public interface IShippingQuote
{
    string Code { get; }
    Task<decimal> CalculateAsync(Shipment shipment, CancellationToken ct);
}

public sealed class ShippingQuoteRegistry
{
    private readonly IReadOnlyDictionary<string, IShippingQuote> _quotes;

    public ShippingQuoteRegistry(IEnumerable<IShippingQuote> quotes)
    {
        var list = quotes.ToArray();
        var duplicate = list.GroupBy(x => x.Code, StringComparer.OrdinalIgnoreCase)
            .FirstOrDefault(group => group.Count() > 1);
        if (duplicate is not null)
            throw new InvalidOperationException($"Duplicate shipping code: {duplicate.Key}");

        _quotes = list.ToDictionary(x => x.Code, StringComparer.OrdinalIgnoreCase);
    }

    public IShippingQuote Get(string code) =>
        _quotes.TryGetValue(code, out var quote)
            ? quote
            : throw new UnsupportedShippingMethodException(code);
}

الـ registry هنا scoped/transient حسب lifetime dependencies. لو implementations scoped لأنها تستخدم DbContext، لا تجعل registry singleton. لو تريد keyed services، قارنها بالـ registry؛ keyed DI مفيد لاختيار service by key، بينما registry يمكن أن يضيف validation/business mapping. لا تكرر نفس key في config وفي code من غير startup validation.

Strategy كاملة: خصم قابل للتغيير مع اختبارات حدود

Strategy مناسبة عندما تتغير خوارزمية أو سياسة مستقلة عن workflow. لا تجعل كل نوع خصم يرث Order أو Customer؛ اجعل policy مستقلة تستقبل بيانات كافية وتعيد نتيجة. حدّد هل الخصم مبلغ أم نسبة، وهل يسمح بتجميع العروض، وكيف تتعامل مع rounding والعملة. هذه قواعد business وليست تفاصيل شكلية.

C#Discount strategy with an explicit result
public sealed record DiscountResult(decimal Amount, string Reason);
public interface IDiscountStrategy
{
    bool CanApply(OrderSnapshot order);
    DiscountResult Calculate(OrderSnapshot order);
}
public sealed class PercentageDiscount(decimal rate) : IDiscountStrategy
{
    public bool CanApply(OrderSnapshot order) => order.Subtotal > 0;
    public DiscountResult Calculate(OrderSnapshot order)
    {
        if (rate is < 0 or > 1) throw new ArgumentOutOfRangeException(nameof(rate));
        var amount = decimal.Round(order.Subtotal * rate, 2,
            MidpointRounding.ToEven);
        return new DiscountResult(amount, $"{rate:P0} promotion");
    }
}

لو عندك استراتيجية واحدة فقط ولا يوجد اختلاف متوقع، لا تحتاج interface. ولو توجد قواعد أولوية أو stacking، لا تجعل ترتيب IEnumerable من DI هو business rule؛ عرّف Priority صريحة أو اجعل policy aggregate مسؤولة عن composition. اختبر أن مجموع الخصومات لا يتجاوز subtotal، وأن إعادة الحساب تعطي نفس النتيجة لنفس input إن كانت السياسة pure.

Factory مع DI: اختيار صريح وتجنب التسجيل المكرر

Factory غالبًا دورها اختيار strategy من مجموعة مسجلة. استخدم key مضبوطًا وثابتًا، واكشف duplicate keys عند startup بدل أن تختار آخر تسجيل بصمت. تجنب Service Locator الذي يمرر IServiceProvider إلى كل business class؛ factory صغيرة ذات contract محدد أفضل.

C#Validate strategy registrations at construction
public sealed class PaymentFactory(IEnumerable<IPaymentProcessor> processors)
{
    private readonly IReadOnlyDictionary<string, IPaymentProcessor> _items =
        Build(processors);

    private static IReadOnlyDictionary<string, IPaymentProcessor> Build(
        IEnumerable<IPaymentProcessor> processors)
    {
        var items = processors.ToArray();
        var duplicates = items.GroupBy(x => x.Method, StringComparer.OrdinalIgnoreCase)
            .Where(g => g.Count() > 1).Select(g => g.Key).ToArray();
        if (duplicates.Length > 0)
            throw new InvalidOperationException(
                $"Duplicate payment methods: {string.Join(", ", duplicates)}");
        return items.ToDictionary(x => x.Method,
            StringComparer.OrdinalIgnoreCase);
    }

    public IPaymentProcessor Get(string method) =>
        _items.TryGetValue(method, out var processor)
            ? processor
            : throw new NotSupportedException($"Unknown method: {method}");
}

لو implementations scoped أو transient وتحتاج instance جديدة لكل request، لا تحتفظ بها داخل singleton factory؛ ده يسبب captive dependency. اجعل factory بنفس lifetime المناسب، أو استخدم keyed DI services في الإصدارات المدعومة مع contract واضح. اختبر unknown key و duplicate key و case-insensitivity و lifetime.

04

Builder

Construct complex objects safely
Practical

Builder مناسب عندما object يحتاج إعدادات كثيرة أو خطوات اختيارية أو validation عند البناء. في C#‎ object initializer/records/options قد تكفي؛ لا تنشئ Builder لكل DTO. استخدم builder عندما construction process نفسها معقدة أو تريد fluent API تحمي valid combinations.

C#Builder with required construction state
var report = ReportBuilder.ForTenant(tenantId)
    .Between(from, to)
    .IncludeCancelled(false)
    .WithCurrency("EGP")
    .Build();

Builder يجب أن يمنع invalid state عند Build، ولا يترك object نصف مكتمل. لو builder mutable ومشارك بين threads، لا تستخدمه كـ singleton.

05

Adapter و Decorator

Translate contracts and add behavior
Deep dive

Adapter يحول interface خارجية إلى contract داخلي مناسب. مثال: payment provider API مختلفة عن IPaymentGateway. Decorator يلف implementation ويضيف behavior من غير تعديل الأصل: logging، caching، retry، metrics. Decorator يجب يحافظ على contract ويكون واضحًا في DI registration order.

C#Adapter around an external provider
public sealed class AcmePaymentAdapter(AcmeSdkClient client) : IPaymentGateway
{
    public async Task<PaymentResult> ChargeAsync(
        Money amount, string idempotencyKey, CancellationToken ct)
    {
        var response = await client.CreateChargeAsync(
            amount.Amount, amount.Currency, idempotencyKey, ct);
        return response.Approved
            ? PaymentResult.Approved(response.Reference)
            : PaymentResult.Declined(response.Code);
    }
}
C#Decorator adds timing
public sealed class TimedPaymentGateway(
    IPaymentGateway inner, ILogger<TimedPaymentGateway> logger) : IPaymentGateway
{
    public async Task<PaymentResult> ChargeAsync(
        Money amount, string key, CancellationToken ct)
    {
        var started = Stopwatch.GetTimestamp();
        try { return await inner.ChargeAsync(amount, key, ct); }
        finally
        {
            logger.LogInformation("Payment call took {Elapsed} ms",
                Stopwatch.GetElapsedTime(started).TotalMilliseconds);
        }
    }
}

Adapter vs Facade vs Decorator vs Proxy

الأربعة قد تبدو كأنها wrapper لكن intent مختلف: Adapter يغير interface لتوافق contract؛ Facade يقدم واجهة أبسط لعدة collaborators؛ Decorator يحافظ على نفس interface ويضيف behavior؛ Proxy يحافظ على interface ويتحكم في access/lazy/remote/caching. لا تختَر الاسم بناءً على شكل class؛ اختَر بناءً على intent.

C#Decorator chain for resilience and metrics
IPaymentGateway gateway = new AcmePaymentAdapter(sdkClient);
gateway = new RetryPaymentGateway(gateway, retryPolicy);
gateway = new MetricsPaymentGateway(gateway, meter);

// In production, register the chain through DI/decorator tooling
// and ensure retry is safe for the provider's idempotency contract.

Decorator order matters: Metrics outside Retry measures total elapsed including retries؛ Metrics inside Retry measures each attempt. Logging/exception translation/caching order يمكن أن يغير semantics. اختبر chain behavior بدل الاعتماد على ترتيب DI غير واضح.

Decorator Composition: ترتيب الطبقات والاختبارات

Decorator chain ليست مجرد مجموعة wrappers؛ ترتيبها يغير semantics. لو Retry خارج Metrics، metrics قد تسجل كل attempt أو total operation حسب مكانها. لو Cache خارج Authorization، قد ترجع بيانات cached من غير التحقق من user/tenant context. لو Logging يسجل body قبل redaction، قد يكشف PII. لازم تحدد contract وترتيب wrappers صراحة.

C#Test a decorator preserves cancellation and errors
[Fact]
public async Task Metrics_decorator_does_not_swallow_inner_failure()
{
    var inner = new FailingPaymentGateway();
    var gateway = new MetricsPaymentGateway(inner, meter);

    await Assert.ThrowsAsync<PaymentProviderException>(() =>
        gateway.ChargeAsync(new Money(100, "EGP"), "idem-1", CancellationToken.None));
}

اختبر إن decorator يحافظ على return value، exceptions، cancellation token، idempotency key، headers/context، streaming semantics لو موجودة. لا تلتقط exception وتعيد null إلا لو contract ينص على ذلك. Decorator جيد يحافظ على Liskov substitution: العميل يقدر يستبدل inner بال wrapped دون مفاجأة غير موثقة.

Decorator Chain: Logging + Timeout + Retry من غير خلط المسؤوليات

Decorator يضيف behavior حول object يلتزم بنفس interface. يمكن تركيب logging و metrics و cache و timeout، لكن ترتيب wrappers يغيّر السلوك. Timeout خارج Retry قد يحدد deadline للعملية كلها؛ timeout داخل كل محاولة قد يسمح بمدة إجمالية أطول. لا تضع Retry عشوائيًا حول عملية دفع غير idempotent.

C#A decorator preserves the gateway contract
public sealed class LoggingPaymentGateway(
    IPaymentGateway inner, ILogger<LoggingPaymentGateway> logger)
    : IPaymentGateway
{
    public async Task<PaymentResult> ChargeAsync(
        Money amount, string key, CancellationToken ct)
    {
        logger.LogInformation("Starting payment {Key}", key);
        try
        {
            var result = await inner.ChargeAsync(amount, key, ct);
            logger.LogInformation("Payment outcome: {Succeeded}", result.Succeeded);
            return result;
        }
        catch (OperationCanceledException) when (ct.IsCancellationRequested)
        {
            logger.LogInformation("Payment request cancelled by caller");
            throw;
        }
        catch (Exception ex)
        {
            logger.LogError(ex, "Payment gateway failed");
            throw;
        }
    }
}

لا تسجل card number أو access token أو بيانات شخصية في decorator. لا تحوّل exception إلى Declined؛ failure تقني ليس رفضًا من البنك. إذا أضفت Retry، استخدم idempotency key ثابتًا لكل logical payment، وسياسة retry على أخطاء transient فقط، و bounded attempts مع jitter و overall deadline. وإلا قد يتكرر الخصم.

06

Observer و Mediator و Command

Decouple event publishers, receivers and requests
Deep dive

Observer publisher يخطر subscribers عند event. داخل process ممكن C#‎ events أو notifications؛ distributed systems تحتاج durable messaging/outbox لو فقد الحدث غير مقبول. Mediator يوجه request إلى handler ويقلل direct dependencies، لكنه ليس message broker. Command object يمثل intent/operation ويمكن تخزينه أو queue أو log؛ لا تخلط command مع event: command طلب، event حقيقة حصلت.

C#Command object and handler
public sealed record CancelReservation(Guid ReservationId, string Reason);

public sealed class CancelReservationHandler(IReservationRepository repo)
{
    public async Task Handle(CancelReservation command, CancellationToken ct)
    {
        var reservation = await repo.GetAsync(command.ReservationId, ct)
            ?? throw new NotFoundException();
        reservation.Cancel(command.Reason);
        await repo.SaveChangesAsync(ct);
    }
}

لا تستخدم in-process event كأنه guaranteed delivery عبر restart. لا تجعل observer exceptions تكسر publisher بشكل غير متوقع؛ حدد error isolation policy. لو event مهمة بين services، استخدم outbox + broker + idempotent consumer.

Observer vs Pub/Sub vs Message Broker

Observer داخل process ينادي subscribers في نفس process؛ لو subscriber فشل أو process توقفت، event قد تضيع أو تؤثر على publisher حسب implementation. Pub/Sub broker يوزع messages لكنه قد يكون ephemeral أو durable حسب technology/config. Queue/stream توفر acknowledgement/replay semantics مختلفة. لا تستخدم C#‎ event لتوصيل services منفصلة.

لو subscriber مجرد metrics counter أو cache hint، in-process notification قد تكفي. لو event تمثل OrderPaid ويجب أن تصل إلى Billing/Shipping، استخدم outbox + durable broker، consumer idempotency، schema versioning و dead-letter strategy. اختيار delivery semantics جزء من business requirement.

07

Template Method و State و Chain of Responsibility

Behavioral flow patterns
Deep dive

Template Method يحدد skeleton algorithm في base class ويترك خطوات معينة subclasses؛ استخدمه بحذر لأن inheritance coupling قد يصعب التغيير. State يمثل سلوكًا يتغير حسب lifecycle state، مثل Pending/Approved/Cancelled؛ قد يكون enum + transition methods كافيًا، ولا تحتاج class لكل state إلا لو السلوك معقد. Chain of Responsibility يمرر request عبر handlers متتابعين مثل middleware/validation pipeline.

C#State transition guard
public enum PaymentStatus { Pending, Authorized, Captured, Refunded, Failed }
public sealed class Payment
{
    public PaymentStatus Status { get; private set; } = PaymentStatus.Pending;
    public void Capture()
    {
        if (Status != PaymentStatus.Authorized)
            throw new DomainException("Only authorized payments can be captured.");
        Status = PaymentStatus.Captured;
    }
}

State pattern class-based مناسب عندما كل state لها behavior مختلف ومعقد؛ enum + methods أبسط لو transitions قليلة. لا تنشئ inheritance hierarchy فقط لتجنب switch صغير مفهوم.

Command و State و Chain: كيف تفرق؟

Command يمثل request لتنفيذ action: CancelOrder. State يمثل الحالة الحالية والسلوك المسموح فيها: Pending/Confirmed/Cancelled. Chain of Responsibility يمرر request عبر handlers: authentication → authorization → validation → endpoint. Mediator يختار handler ل command/query، و Observer ينشر fact بعد وقوعه. الأنماط قد تتعاون لكنها ليست مترادفات.

لو lifecycle transitions بسيطة، enum + guarded methods أفضل من State class hierarchy. لو كل state لها behavior كبير و transition matrix معقدة، State objects قد تقلل branching. لو chain تحتاج short-circuit، وضح متى handler يوقف الطلب وكيف تنتقل errors.

08

DI و Repository و Unit of Work و Specification

Patterns already common in .NET
Practical

Dependency Injection يفصل construction عن usage، و composition root يربط interfaces بال implementations. Repository يعبر عن aggregate persistence boundary، و Unit of Work يجمع التغييرات؛ EF Core DbContext يوفر الكثير من UoW behavior بالفعل. Specification encapsulates reusable query criteria. لا تلف DbContext generic wrapper بلا value.

الـ ‎.NET framework نفسه يستخدم patterns كثيرة: middleware pipeline Chain of Responsibility، options pattern، ILogger abstraction، HttpClientFactory، decorators عبر DI، iterator في IEnumerable، builder APIs، factory APIs و observer/event callbacks. تعرّف على pattern داخل framework بدل إعادة تنفيذها.

Patterns داخل DI Container

DI container يعمل composition/creation، لكنه لا يحل كل pattern تلقائيًا. سجل stateless strategies كـ transient/singleton حسب thread-safety، repositories scoped مع DbContext، و HttpClient عبر IHttpClientFactory. لو decorator يلف service، تأكد أن DI لا يحقن نفسه recursively. استخدم Scrutor أو explicit registration إذا كان ذلك مناسبًا، لكن راجع package version/licensing.

C#Register multiple strategies
builder.Services.AddScoped<IDiscountPolicy, VipDiscount>();
builder.Services.AddScoped<IDiscountPolicy, SeasonalDiscount>();
builder.Services.AddScoped<DiscountPolicyFactory>();

// Factory resolves the requested policy from IEnumerable<IDiscountPolicy>.

لا تسجل DbContext-dependent implementation كـ Singleton. ولا تستخدم Singleton strategy إذا كانت تحتفظ request-specific state. Pattern correctness تشمل lifetime semantics، مش interface design فقط.

09

Facade و Proxy و Composite و Prototype و Iterator و Null Object

Recognize supporting patterns
Practical

Facade واجهة مبسطة فوق subsystem معقد؛ مثل CheckoutFacade ينسق inventory/payment/shipping. Proxy object وسيط يتحكم في access أو remote/lazy/cached behavior. Composite يعامل leaf و group بنفس contract مثل file/folder tree أو product bundle. Prototype ينسخ object configured؛ انتبه shallow vs deep copy. Iterator يتيح traversal من غير كشف collection internals؛ IEnumerable<T> مثال ‎.NET. Null Object implementation بلا behavior لتجنب null branches، لكن لا تستخدمه لإخفاء missing mandatory dependency.

C#Null Object for optional notification
public interface IAuditNotifier
{
    Task NotifyAsync(AuditEvent auditEvent, CancellationToken ct);
}
public sealed class NoOpAuditNotifier : IAuditNotifier
{
    public Task NotifyAsync(AuditEvent auditEvent, CancellationToken ct) => Task.CompletedTask;
}

Null Object مناسب لو «عدم الإرسال» behavior صحيح ومقصود. لو notifier مطلوب أمنيًا، NoOp implementation قد يخفي misconfiguration؛ الأفضل fail fast.

Bridge و Composite و Proxy: ثلاثة أشكال مختلفة للتركيب

Bridge يفصل abstraction عن implementation عندما يوجد محوران يتغيران مستقلين. مثال: NotificationChannel (email/SMS/push) مع DeliveryProvider (provider A/B). بدل inheritance explosion مثل EmailProviderA و EmailProviderB و SmsProviderA، اجعل channel تعتمد على sender abstraction. Composite يعامل عنصرًا مفردًا ومجموعة عناصر عبر contract موحد، مثل folders/files أو rule groups. Proxy يتحكم في الوصول أو lazy loading أو remote call مع الحفاظ على contract.

C#Bridge: channel varies independently from provider
public interface IMessageSender
{
    Task SendAsync(string destination, string body, CancellationToken ct);
}
public sealed class EmailChannel(IMessageSender sender)
{
    public Task NotifyAsync(string email, string text, CancellationToken ct) =>
        sender.SendAsync(email, text, ct);
}

لا تجعل Proxy يخفي latency/network failure وكأن العملية local؛ contract يجب أن يوضح async و timeouts و exceptions. Composite مناسب للشجرة التي يحتاج caller التعامل معها recursively، وليس لأي collection. Bridge يفيد عندما محورين variation حقيقيين؛ وإلا composition العادي يكفي.

Visitor و Prototype و Null Object: متى تفيد؟

Prototype ينشئ object جديدًا بالنسخ من prototype؛ في C#‎ قد يكفي copy constructor أو record with، لكن راجع shallow vs deep copy والـ mutable nested references. Null Object يقدم implementation بلا أثر بدل null checks المتكررة، لكن يجب ألا يخفي failure مهمًا مثل missing payment provider. Visitor يضيف عمليات على object structures دون تعديل كل concrete types، لكنه يجعل إضافة نوع جديد أصعب لأن كل visitors تحتاج تحديثًا.

C#Null Object for optional telemetry
public interface IAuditSink
{
    Task WriteAsync(AuditEntry entry, CancellationToken ct);
}
public sealed class NoOpAuditSink : IAuditSink
{
    public Task WriteAsync(AuditEntry entry, CancellationToken ct) =>
        Task.CompletedTask;
}

Null Object آمن عندما “لا يوجد audit sink” حالة مسموح بها صراحة. لو audit إلزامي لأسباب قانونية أو أمنية، لا تستخدم NoOp implementation في production؛ فشل التسجيل يجب أن يكون مرئيًا وفق policy. لا تستخدم pattern لإخفاء configuration error.

10

Result و Option Patterns

Represent expected outcomes explicitly
Practical

Result يعبّر عن نجاح أو failure متوقع كقيمة typed بدل exceptions لكل validation/not-found/conflict. Option/Maybe يعبّر عن وجود أو غياب قيمة. لا تخلط expected business outcome مع unexpected infrastructure failure. اختَر error model consistent عبر application، وخلي mapping إلى HTTP في Presentation.

C#Simple Result type sketch
public sealed record Result<T>(T? Value, string? Error)
{
    public bool IsSuccess => Error is null;
    public static Result<T> Success(T value) => new(value, null);
    public static Result<T> Failure(string error) => new(default, error);
}

في production قد تحتاج discriminated union أو typed error codes بدل string، و Result بدون null ambiguity. لا تبنِ mini framework معقدًا إن كانت exceptions أو validation result الموجودة كافية.

11

Outbox و Saga و Retry/Circuit Breaker/Bulkhead

Patterns for unreliable networks
Deep dive

Outbox يسجل message مع DB change في transaction واحدة ثم ينشرها. Saga تنسق business workflow موزعًا عبر عدة services بخطوات و compensations؛ ليست distributed ACID transaction. Retry يعيد transient operation، Circuit Breaker يوقف calls مؤقتًا بعد failures، وBulkhead يعزل الموارد حتى لا يستهلك dependency واحدة كل threads/connections.

Retry يجب أن يكون محدودًا وبـ backoff+jitter، ويطبق فقط على operations قابلة لإعادة التنفيذ أو محمية بـ idempotency. Circuit breaker لا يصلح business error. Bulkhead لا يضمن durability. Saga compensation ليست rollback حقيقيًا؛ قد تكون refund أو cancellation عملية business جديدة قابلة للفشل.

Outbox و Saga: Pattern مش مجرد Queue

Outbox يحل مشكلة dual write: application تحفظ Order في DB ثم تنشر message إلى broker؛ لو DB commit نجح والنشر فشل، الحالة والحدث يختلفان. في Outbox تسجل business change و outbox row داخل نفس DB transaction. Background publisher يقرأ pending rows، ينشر، ثم يعلّمها processed. ده يوفر at-least-once غالبًا وليس exactly-once end-to-end؛ لذلك consumer لازم يكون idempotent ويمنع duplicate processing عبر message ID/inbox table أو unique constraint.

C#Persist aggregate and outbox record in one transaction
await using var tx = await db.Database.BeginTransactionAsync(ct);

order.MarkPaid(paymentReference);
db.Orders.Update(order);
db.OutboxMessages.Add(new OutboxMessage(
    messageId: Guid.NewGuid(),
    type: "OrderPaid",
    payload: JsonSerializer.Serialize(new OrderPaid(order.Id, paymentReference)),
    occurredAtUtc: clock.UtcNow));

await db.SaveChangesAsync(ct);
await tx.CommitAsync(ct);

الـ publisher يحتاج locking/claim strategy تمنع workers من نشر نفس rows بالتوازي، retry policy محدودة، poison-message handling، observability، retention/cleanup و schema versioning. لا تمسح message بمجرد محاولة publish؛ تعامل مع broker acknowledgment بشكل صحيح. Outbox لا يحل ترتيب الأحداث تلقائيًا عبر aggregates؛ لو ordering مهم، صمم partition/key/sequence semantics.

Saga تنسق workflow موزعًا: ReserveInventory → ChargePayment → ArrangeShipping. لو الدفع فشل بعد حجز المخزون، تعمل compensation مثل ReleaseInventory. Compensation business action جديدة وقد تفشل؛ لذلك saga تحتاج persistent state، timeout/retry، duplicate handling، manual intervention queue، و monitoring. لا تستخدم Saga لو كل الخطوات داخل DB واحدة وتكفي transaction قصيرة.

Retry و Circuit Breaker و Timeout: ترتيبهم مهم

Timeout يحدد أقصى مدة انتظار للعملية. Retry يعيد operation بعد فشل مؤقت. Circuit breaker يرفض calls لفترة بعد failures متكررة. Bulkhead يحدد concurrent capacity لكل dependency. ترتيب composition يؤثر: timeout داخل retry يعني لكل attempt timeout؛ timeout خارج retry يعني حد إجمالي للعملية. حدد ما إذا كان client cancellation يوقف retries.

لا تعمل retry على 400/validation أو payment operation بلا idempotency. لا تجعل retries في كل layer تتضاعف (API 3 مرات × service 3 × SDK 3 = 27 attempts). اختَر owner واحد لل retry policy، أضف jitter، واحترم Retry-After عند provider. Circuit breaker يجب يميز transient failure عن business rejection.

12

Anti-Corruption Layer و Strangler Fig

Integrate and modernize legacy systems
Practical

Anti-Corruption Layer يترجم external/legacy model إلى internal language حتى لا تتسرب تفاصيله. Strangler Fig migration تدريجية: ضع routing/facade أمام legacy، وانقل capabilities واحدة تلو الأخرى إلى implementation جديد، مع مراقبة parity والـ data ownership. لا تعمل big-bang rewrite إلا مع سبب قوي.

13

إمتى ما تستخدمش Pattern؟

Avoid pattern-driven design
Practical

لو الحل المباشر واضح وقابل للاختبار، pattern قد لا تضيف قيمة. لا تستخدم Singleton بدل DI lifetime، ولا Factory حول new واحد، ولا Mediator لكل method، ولا Repository فوق DbContext من غير boundary، ولا Saga في monolith transaction بسيطة. pattern مفيدة عندما تقلل change cost أو تعزل complexity، لا عندما تزيد عدد الملفات فقط.

Pattern Review: سؤال وجواب قبل الدمج

  • ما المشكلة المحددة التي يحلها pattern؟
  • ما الذي يتغير؟ وهل التغيير متكرر أم افتراضي؟
  • هل contract يعبر عن domain need أم ينسخ vendor API؟
  • ما lifetime المناسب لكل collaborator؟
  • هل pattern تغير error/cancellation/retry semantics؟
  • هل tests تغطي duplicate delivery/concurrency/failure؟
  • هل direct implementation أو function صغيرة أوضح؟

Pattern مفيدة عندما تجعل design intent واضحًا وتقلل cost. لو القارئ يحتاج يفتح خمس classes لفهم شرط if بسيط، ربما pattern أضافت تعقيدًا غير لازم.

اختيار Pattern بناءً على سبب التغيير

أهم سؤال قبل اختيار pattern: إيه اللي بيتغير؟ لو algorithm تتبدل حسب نوع العميل أو سياسة العمل، Strategy. لو تحتاج تختار implementation أو تخفي construction، Factory. لو integration مع vendor contract غريب، Adapter. لو تحتاج تضيف behavior حول implementation مع الحفاظ على نفس interface، Decorator. لو تريد واجهة مبسطة لعدة services، Facade. لو lifecycle يسمح بعمليات مختلفة حسب state، State. لو request يمر عبر مراحل قابلة للتركيب، Chain of Responsibility. لو عملية لازم تتسجل/تؤجل/تُعاد، Command أو durable message حسب boundary.

المشكلةPattern محتملةعلامة إنك لا تحتاجها
اختلاف خوارزمية/سياسةStrategyاختلاف واحد ثابت لا يتغير ولا يحتاج abstraction
اختيار concrete implementationFactoryconstructor مباشر واضح ولا يوجد branching
Vendor API لا تناسب domainAdapter / ACLexternal contract بسيط ومستقر ويمكن استخدامه مباشرة عند boundary
إضافة logging/caching/metricsDecoratorbehavior موضعي صغير لا يستحق wrapper
إخفاء subsystem معقدFacadeالواجهة الحالية بالفعل بسيطة ومفهومة
انتقالات lifecycle معقدةStateenum و guarded methods تغطي الحالات ببساطة
رسالة تحتاج durability/retryOutbox + Brokerالعملية داخل transaction واحدة ولا يوجد cross-process delivery

الجدول ليس rule engine؛ هو بداية تفكير. pattern ممكن يحل أكثر من مشكلة، لكن لازم تكتب سببًا واضحًا في code review: «استخدمنا Decorator لأننا نريد إضافة metrics لكل provider من غير تعديل provider implementations». الجملة دي أقوى من «لأن Decorator من GoF».

اختبارات Patterns و Code Review Checklist

  • Strategy: هل كل policy تحقق نفس contract؟ هل الحدود مثل صفر/سالب/rounding واضحة؟
  • Factory: ماذا يحدث مع unknown key و duplicate registrations و configuration invalid؟
  • Adapter: هل يترجم provider errors إلى domain/application errors؟ هل يحمي من vendor DTO leakage؟
  • Decorator: هل يحافظ على cancellation/exceptions/order؟ وهل logging redacted؟
  • State: هل كل transition مسموح/مرفوض؟ وهل concurrent transitions محمية في persistence؟
  • Observer/Outbox: ماذا يحدث عند duplicate delivery أو subscriber failure أو process restart؟
  • Retry/Circuit Breaker: هل retry على transient errors فقط؟ هل العملية idempotent؟ هل توجد timeout budget إجمالية؟
  • Repository/UoW: هل abstraction تضيف domain meaning أم تعيد تسمية DbContext؟

اختبر behavior عبر public contract قدر الإمكان، وليس private implementation details. pattern قد تتغير من Factory إلى keyed DI بعد سنة؛ الاختبارات الجيدة تثبت business behavior وليس أسماء classes.

Pattern Misuse: 12 علامة إن التصميم بقى أعقد من المشكلة

من علامات overengineering: interface لها implementation واحدة ولا boundary متوقعة؛ Factory تنشئ نوعًا واحدًا؛ Abstract Factory حول constructor بسيط؛ Repository يكرر DbSet دون إخفاء query behavior؛ Mediator لكل getter صغير؛ Event لكل method call؛ Singleton mutable state؛ Strategy لمجرد switch من حالتين ثابتتين؛ Decorator يغيّر معنى contract؛ Retry لعملية غير idempotent؛ Saga لعملية محلية داخل database واحدة؛ و Generic framework لا يستخدمه إلا feature واحدة.

قبل إضافة pattern اكتب في سطرين: (1) ما الـ variation أو coupling الذي نعالجه؟ (2) ما الاختبار أو التغيير الذي سيصبح أسهل؟ بعد التنفيذ قارن عدد الملفات والـ indirections والتعقيد التشغيلي. لو لم تتحسن قابلية التغيير أو الاختبار، ارجع للحل الأبسط. Pattern اختيار trade-off وليس علامة احتراف.

14

اختبر فهمك

Knowledge check
Practical
ما الفرق بين Adapter و Decorator؟
Adapter يغير/يترجم contract؛ Decorator يضيف behavior حول implementation مع الحفاظ على نفس contract.
هل Mediator بديل عن message broker؟
لا؛ Mediator غالبًا in-process dispatch، أما broker فيدير distributed messaging/delivery.
متى Retry خطير؟
عندما operation غير idempotent أو الخطأ permanent أو retry غير محدود.
ما الفرق بين Command و Event؟
Command طلب لتنفيذ action؛ Event حقيقة حدثت بالفعل.
ما الذي يضيفه Outbox؟
ربط حفظ business state وتسجيل رسالة في نفس transaction ثم نشرها لاحقًا بشكل retryable.
↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

مصادر تعليمية ومتقدمة — Third-party & advanced reading

خريطة التغطية: 30 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapStrategy§01
RoadmapFactory§01
RoadmapAbstract Factory Concepts§01
RoadmapBuilder§01
RoadmapAdapter§01
RoadmapDecorator§01
RoadmapObserver§01
RoadmapMediator§01
RoadmapCommand§01
RoadmapTemplate Method§01
RoadmapState§01
RoadmapChain of Responsibility§01
RoadmapDependency Injection and Composition§01
RoadmapRepository§01
RoadmapUnit of Work§01
RoadmapSpecification§01
RoadmapWhen Not to Use Patterns§01
SuggestedFacade§09
SuggestedProxy§09
SuggestedComposite§09
SuggestedPrototype§09
SuggestedIterator§09
SuggestedNull Object§09
SuggestedResult / Option§09
SuggestedOutbox§11
SuggestedSaga§11
SuggestedRetry, Circuit Breaker, Bulkhead§05
SuggestedAnti-Corruption Layer§12
SuggestedStrangler Fig§12
SuggestedPatterns .NET already uses (see the full map in 7.10)§01

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس