ءSwagger در NET 10. حذف شده؟ چطور دوباره اضافه‌اش کنیم 🔍

شما یک پروژه‌ی NET 10. می‌سازید، برنامه را اجرا می‌کنید، تلاش می‌کنید صفحه‌ی Swagger را باز کنید، و با خطای 404 Not Found مواجه می‌شوید. ❌
پس چطور باید آن را برگردانیم؟

چرا Swagger حذف شده است؟ 🤔

مایکروسافت پشتیبانی از Swagger را از NET 9. حذف کرده است. طبق این بحث در GitHub:

"The project is no longer actively maintained by its community owner. Issues have not been addressed or resolved..."

یعنی:
این پروژه دیگر به‌صورت فعال توسط مالک جامعه‌ی آن نگهداری نمی‌شود. مشکلات بررسی یا حل نشده‌اند.

مایکروسافت به سمت استفاده از OpenAPI حرکت کرده است، یعنی حالا مستندات OpenAPI می‌توانند بدون نیاز به Swagger تولید شوند. 📄

چطور Swagger را به NET 10. اضافه کنیم 🛠

ابتدا باید پکیج زیر را به پروژه‌ی Web API خود اضافه کنید:

Swashbuckle.AspNetCore.SwaggerUI

سپس داخل فایل Program.cs باید پارامتر options را به متد UseSwaggerUI اضافه کنید و endpoint را روی /openapi/v1.json تنظیم کنید.

// Program.cs
if (app.Environment.IsDevelopment())
{
  app.MapOpenApi();

  // Add this
  app.UseSwaggerUI(options =>
  {
    options.SwaggerEndpoint("/openapi/v1.json", "API v1");
  });
}

اجرای خودکار Swagger هنگام اجرا 🚀

اگر می‌خواهید برنامه هنگام اجرا به‌صورت خودکار با Swagger باز شود، به مسیر زیر بروید:
Properties > launchSettings.json

پروفایل https را پیدا کنید، مقدار launchBrowser را برابر true قرار دهید و launchUrl را روی swagger تنظیم کنید.

{
  "$schema": "https://json.schemastore.org/launchsettings.json",
  "profiles": {
    "http": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": false,
      "applicationUrl": "http://localhost:5155",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "https": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "launchUrl": "swagger",
      "applicationUrl": "https://localhost:7284;http://localhost:5155",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

جایگزین‌های Swagger 🔄

ءSwagger دوباره اضافه شده، اما آیا جایگزین‌های بهتری وجود دارند؟

Scalar ✨

ءScalar یک جایگزین برای Swagger است. این ابزار به شما اجازه می‌دهد endpointها را با یک رابط کاربری متفاوت تست کنید.

برای اضافه کردن Scalar، پکیج Scalar.AspNetCore را در پروژه‌ی Web API خود نصب کنید.

سپس، در فایل Program.cs، فضای نام Scalar.AspNetCore را import کنید و کد زیر را اضافه کنید:

// Program.cs
using Scalar.AspNetCore; // <-- Import this namespace

...

if (app.Environment.IsDevelopment()) 
{
  app.MapOpenApi();
  app.MapScalarApiReference(); // <-- Add this line
}

برای اجرای برنامه همراه با Scalar، فایل launchSettings.json را باز کنید.

مقدار launchBrowser را روی true بگذارید و launchUrl را برابر scalar/v1 تنظیم کنید.

{
  "$schema": "https://json.schemastore.org/launchsettings.json",
  "profiles": {
    "http": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": false,
      "applicationUrl": "http://localhost:5155",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "https": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "launchUrl": "scalar/v1",
      "applicationUrl": "https://localhost:7284;http://localhost:5155",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

همچنین می‌توانید تنظیمات Scalar را شخصی‌سازی کنید. در این مثال، عنوان روی "My API" تنظیم شده، تم برابر با ScalarTheme.Mars است و نوار کناری مخفی شده است.

// Program.cs
if (app.Environment.IsDevelopment()) 
{
  app.MapOpenApi();
  app.MapScalarApiReference(options => 
  {
    options.WithTitle("My API");
    options.WithTheme(ScalarTheme.Mars);
    options.HideSidebar();
  });
}

Redoc 📘

ءRedoc مستندات API را تولید می‌کند، اما اجازه‌ی تست endpointها را نمی‌دهد.

برای اضافه کردن Redoc، پکیج Redoc.AspNetCore را در پروژه‌ی Web API خود نصب کنید.

سپس کد زیر را به Program.cs اضافه کنید:

// Program.cs
if (app.Environment.IsDevelopment()) 
{
  app.MapOpenApi();
  app.UseReDoc(options => 
  {
    options.RoutePrefix = "docs";
    options.SpecUrl = "/openapi/v1.json";
  });
}

برای اجرای برنامه همراه با Redoc، فایل launchSettings.json را باز کنید.

مقدار launchBrowser را روی true بگذارید و launchUrl را برابر با docs تنظیم کنید (یا هر مقداری که در options.RoutePrefix گذاشته‌اید).

{
  "$schema": "https://json.schemastore.org/launchsettings.json",
  "profiles": {
    "http": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": false,
      "applicationUrl": "http://localhost:5155",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "https": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "launchUrl": "docs",
      "applicationUrl": "https://localhost:7284;http://localhost:5155",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

جایگزین‌ها به‌جای استفاده از UI 🧩

ممکن است نخواهید یک رابط کاربری (UI) شامل تمام endpointهای خود را در دسترس قرار دهید.

فایل http. 📄

وقتی یک Web API می‌سازید، یک فایل http. به‌صورت پیش‌فرض ایجاد می‌شود. اگر از Visual Studio استفاده می‌کنید، این فایل به شما اجازه می‌دهد endpoint پیش‌فرض WeatherForecast را تست کنید. وقتی برنامه در حال اجراست، می‌توانید درخواست‌ها را ارسال کنید یا آن‌ها را مستقیماً دیباگ کنید.

در Visual Studio، اگر بخواهید endpointهای بیشتری از برنامه‌ی خود را به فایل http. اضافه کنید، به مسیر زیر بروید:

View > Other Windows > Endpoints Explorer

این بخش لیستی از تمام endpointهای موجود در Web API شما را نمایش می‌دهد.

با راست‌کلیک روی یک endpoint و انتخاب گزینه‌ی Generate request،
ءVisual Studio آن درخواست را به فایل http. اضافه می‌کند.

Postman 📬

گزینه‌ی دیگر استفاده از Postman است. شما می‌توانید endpointها را به‌صورت دستی اضافه کنید یا یک سند OpenAPI را ایمپورت کنید.

برای ایمپورت کردن یک سند OpenAPI، برنامه‌ی خود را اجرا کنید و به مسیر زیر بروید:
/openapi/v1.json

آدرس URL را کپی کنید.

در Postman، به بخش Import بروید و URL را Paste کنید.
ءPostman سپس تمام endpointها را ایمپورت می‌کند تا بتوانید آن‌ها را تست کنید. 🚀

🔖هشتگ‌ها:
#DotNet #OpenAPI #Postman #HttpFile #WebAPI #ASPNetCore #DeveloperTools

معرفی کتاب‌ها 📚

ء"Head First Design Pattern" نوشته‌ی Eric Freeman و Elisabeth Robson یک کتاب کلاسیک است که در سال 2004 منتشر شده و درباره‌ی design patternهای نرم‌افزاری است.

بعد از انتشار، این کتاب به‌خاطر سادگی و سبک ارائه‌ی سرگرم‌کننده‌اش بسیار محبوب شد. این کتاب با استفاده از تصاویر قوی و روایت داستانی، مفاهیم پیچیده‌ای مثل design pattern را ساده و قابل‌فهم می‌کند. همچنین برخلاف بسیاری از کتاب‌های دیگر، فقط 13 تا 15 design pattern پرکاربرد را پوشش می‌دهد. این کتاب بسیار beginner friendly است برای یادگیری design patternها. واقعاً دوست‌داشتنی است. 😍

نمای کلی در سطح بالا 🧠

🔹️Head First Design Pattern

هدف این کتاب معرفی design patternها در توسعه‌ی نرم‌افزار به شکلی جذاب و قابل‌دسترس است. این کتاب از رویکردی منحصربه‌فرد استفاده می‌کند که شامل تصاویر بصری، طنز و مثال‌های عملی برای انتقال مؤثر مفاهیم پیچیده است.

مرور کلی کتاب:
• Introduction to Design Patterns:
معرفی design patternها و توضیح اینکه چرا در توسعه‌ی نرم‌افزار ضروری هستند و چگونه به ایجاد کدی flexible، reusable و maintainable کمک می‌کنند.

• Understanding Design Principles:
قبل از ورود به patternها، اصولی مثل encapsulation، inheritance و polymorphism توضیح داده می‌شود.

• Categorization:
ابتدا creational patternها، سپس structural و در نهایت behavioral patternها بررسی می‌شوند.

• Real-World Examples and Case Studies:
مثال‌های واقعی برای کاربرد عملی patternها ارائه می‌شود.

• Anti-Patterns and Pitfalls:
به anti-patternها و اشتباهات رایج اشاره می‌شود.

• Design Patterns in Context:
بررسی جایگاه patternها در معماری نرم‌افزار.

• Review and Reinforcement:
تمرین‌ها، کوییزها و پازل‌ها برای تثبیت یادگیری. 🧩

نوشتن Middleware سفارشی در ASP.NET Core 🧩

ءMiddleware نرم‌افزاری است که در قالب یک pipeline داخل برنامه کنار هم قرار می‌گیرد تا درخواست‌ها (requests) و پاسخ‌ها (responses) را مدیریت کند.
ءASP.NET Core مجموعه‌ی غنی‌ای از middlewareهای داخلی (built-in) را ارائه می‌دهد، اما در بعضی سناریوها ممکن است بخواهید یک middleware سفارشی (custom middleware) بنویسید.

کلاس Middleware

ءMiddleware معمولاً داخل یک کلاس کپسوله می‌شود و از طریق یک extension method در دسترس قرار می‌گیرد. مثال زیر یک middleware درون‌خطی (inline) را نشان می‌دهد که culture مربوط به درخواست جاری را از روی query string تنظیم می‌کند:

using System.Globalization;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.UseHttpsRedirection();

app.Use(async (context, next) =>
{
    var cultureQuery = context.Request.Query["culture"];
    if (!string.IsNullOrWhiteSpace(cultureQuery))
    {
        var culture = new CultureInfo(cultureQuery);

        CultureInfo.CurrentCulture = culture;
        CultureInfo.CurrentUICulture = culture;
    }

    // Call the next delegate/middleware in the pipeline.
    await next(context);
});

app.Run(async (context) =>
{
    await context.Response.WriteAsync(
        $"CurrentCulture.DisplayName: {CultureInfo.CurrentCulture.DisplayName}");
});

app.Run();

ءMiddleware درون‌خطی بالا برای نمایش نحوه‌ی ساخت یک middleware با استفاده از متد Microsoft.AspNetCore.Builder.UseExtensions.Use استفاده شده است. این متد، یک delegate تعریف‌شده به‌صورت درون‌خطی را به pipeline درخواست‌های برنامه اضافه می‌کند.

متدهای Use

دو overload برای متد Use وجود دارد:

یکی که HttpContext و <Func<Task می‌گیرد. در این حالت <Func<Task بدون پارامتر فراخوانی می‌شود.

دیگری که HttpContext و RequestDelegate می‌گیرد. در این حالت RequestDelegate با ارسال HttpContext فراخوانی می‌شود.

استفاده از overload دوم ترجیح داده می‌شود چون باعث صرفه‌جویی در دو allocation داخلی در هر درخواست می‌شود. ⚡️

تست Middleware

می‌توانید middleware را با ارسال culture تست کنید. مثلاً:

https://localhost:5001/?culture=es-es

انتقال Middleware به یک کلاس

کد زیر همان middleware قبلی را داخل یک کلاس قرار می‌دهد:

using System.Globalization;

namespace Middleware.Example;

public class RequestCultureMiddleware
{
    private readonly RequestDelegate _next;

    public RequestCultureMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        var cultureQuery = context.Request.Query["culture"];
        if (!string.IsNullOrWhiteSpace(cultureQuery))
        {
            var culture = new CultureInfo(cultureQuery);

            CultureInfo.CurrentCulture = culture;
            CultureInfo.CurrentUICulture = culture;
        }

        // Call the next delegate/middleware in the pipeline.
        await _next(context);
    }
}

الزامات کلاس Middleware

کلاس middleware باید شامل موارد زیر باشد:

• یک constructor عمومی با پارامتر از نوع RequestDelegate
• یک متد عمومی به نام Invoke یا InvokeAsync که:
• مقدار بازگشتی آن Task باشد
• اولین پارامتر آن از نوع HttpContext باشد

پارامترهای اضافی در constructor و متد Invoke/InvokeAsync از طریق Dependency Injection (DI) مقداردهی می‌شوند. 💉

Extension Method برای Middleware

معمولاً یک extension method ساخته می‌شود تا middleware از طریق IApplicationBuilder قابل استفاده باشد:

using System.Globalization;

namespace Middleware.Example;

public class RequestCultureMiddleware
{
    private readonly RequestDelegate _next;

    public RequestCultureMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        var cultureQuery = context.Request.Query["culture"];
        if (!string.IsNullOrWhiteSpace(cultureQuery))
        {
            var culture = new CultureInfo(cultureQuery);

            CultureInfo.CurrentCulture = culture;
            CultureInfo.CurrentUICulture = culture;
        }

        await _next(context);
    }
}

public static class RequestCultureMiddlewareExtensions
{
    public static IApplicationBuilder UseRequestCulture(
        this IApplicationBuilder builder)
    {
        return builder.UseMiddleware<RequestCultureMiddleware>();
    }
}

استفاده از Middleware در Program.cs

using Middleware.Example;
using System.Globalization;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.UseHttpsRedirection();

app.UseRequestCulture();

app.Run(async (context) =>
{
    await context.Response.WriteAsync(
        $"CurrentCulture.DisplayName: {CultureInfo.CurrentCulture.DisplayName}");
});

app.Run();

وابستگی‌های Middleware

ءMiddleware باید از اصل Explicit Dependencies Principle پیروی کند؛ یعنی وابستگی‌های خود را در constructor مشخص کند.
🔹️ءMiddleware فقط یک بار در طول عمر برنامه ساخته می‌شود. 🕒

🔹️ءMiddleware می‌تواند وابستگی‌های خود را از طریق DI در constructor دریافت کند. همچنین متد UseMiddleware می‌تواند پارامترهای اضافی هم بگیرد.

وابستگی‌های سطح درخواست (Per-request)

از آنجا که middleware در زمان startup ساخته می‌شود، طول عمر آن برابر طول عمر برنامه است. بنابراین سرویس‌های با Scoped lifetime که در constructor تزریق شوند، با بقیه سرویس‌های هر درخواست به اشتراک گذاشته نمی‌شوند.

برای اشتراک سرویس‌های scoped بین middleware و سایر بخش‌ها، باید آن‌ها را در متد InvokeAsync تزریق کنیم:

namespace Middleware.Example;

public class MyCustomMiddleware
{
    private readonly RequestDelegate _next;

    public MyCustomMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    // IMessageWriter is injected into InvokeAsync
    public async Task InvokeAsync(HttpContext httpContext, IMessageWriter svc)
    {
        svc.Write(DateTime.Now.Ticks.ToString());
        await _next(httpContext);
    }
}

public static class MyCustomMiddlewareExtensions
{
    public static IApplicationBuilder UseMyCustomMiddleware(
        this IApplicationBuilder builder)
    {
        return builder.UseMiddleware<MyCustomMiddleware>();
    }
}

تست Middleware سفارشی

using Middleware.Example;
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddScoped<IMessageWriter, LoggingMessageWriter>();

var app = builder.Build();

app.UseHttpsRedirection();

app.UseMyCustomMiddleware();

app.MapGet("/", () => "Hello World!");

app.Run();

تعریف Interface و Implementation
namespace Middleware.Example;

public interface IMessageWriter
{
    void Write(string message);
}

public class LoggingMessageWriter : IMessageWriter
{
    private readonly ILogger<LoggingMessageWriter> _logger;

    public LoggingMessageWriter(ILogger<LoggingMessageWriter> logger) =>
        _logger = logger;

    public void Write(string message) =>
        _logger.LogInformation(message);
}

جمع‌بندی ذهنی 🧠

ءMiddleware قلب pipeline در ASP.NET Core است.
🔹️می‌تواند درون‌خطی یا در قالب کلاس پیاده‌سازی شود
🔸️باید RequestDelegate و متد Invoke/InvokeAsync داشته باشد
🔹️برای وابستگی‌های scoped، تزریق باید در InvokeAsync انجام شود
🔸️بهترین ابزار برای پیاده‌سازی cross-cutting concernها مثل:

• Logging
• Authentication
• Localization
• Exception Handling

🔖هشتگ‌ها:
#ASPNETCore #Middleware #DotNet #Backend

میخوایم یکسری مطالب درمورد یکی از معروف‌ترین کتاب‌های حوزه‌ی نرم‌افزار داشته باشیم 📘

مهم‌ترین سرفصل‌هاش رو با هم برسی می‌کنیم، و هر نکته‌ای که به چشمم جالب و کاربردی بود رو باهاتون شیر می‌کنم😄

اگه دوست دارید خلاصه‌ی مفیدِ یه کتاب قطور رو بدون دردِ کمر و سردرد ،مفهومی یاد بگیرید، این پست‌ها احتمالاً به کارتون میان 😉

"Domain Driven Design"
📌سرفصل : ایزوله کردن دامنه

Heap و Stack Allocation در C# 🧠💾(بخش اول)

درک نحوه‌ی تخصیص (allocation) و مدیریت حافظه در #C برای بهینه‌سازی عملکرد (performance) برنامه و اطمینان از استفاده‌ی کارآمد از منابع بسیار حیاتی است.

در این راهنمای جامع، مفاهیم heap و stack allocation در #C را بررسی می‌کنیم؛ اینکه چگونه کار می‌کنند، چه زمانی استفاده می‌شوند، و چگونه بر عملکرد کد شما تأثیر می‌گذارند.

مقدمه‌ای بر Memory Allocation

مدیریت حافظه در #C اغلب توسط runtime مربوط به NET. انجام می‌شود؛ به این معنا که توسعه‌دهندگان در بیشتر مواقع نیازی به تخصیص و آزادسازی دستی حافظه ندارند.

با این حال، درک اینکه داده‌های شما چگونه و در کجا تخصیص داده می‌شوند — در stack یا در heap — می‌تواند به شما کمک کند کدی کارآمدتر و با performance بهتر بنویسید. ⚙️

در سی‌شارپ ، stack و heap دو ناحیه‌ی حافظه هستند که برای ذخیره‌سازی داده‌ها استفاده می‌شوند:

• ءstack برای static memory allocation استفاده می‌شود

• ءheap برای dynamic memory allocation استفاده می‌شود

ءStack Allocation چیست؟

ءstack ناحیه‌ای از حافظه است که value typeها و pointerهای reference type را ذخیره می‌کند.
این ساختار از مدل Last-In, First-Out (LIFO) پیروی می‌کند؛ به این معنی که آخرین داده‌ی تخصیص داده‌شده، اولین داده‌ای است که آزاد می‌شود.

به دلیل این ساختار، stack allocation بسیار سریع و کارآمد است. 🚀

ویژگی‌های Stack Allocation:

🔹️Automatic Memory Management:
داده‌ها به‌صورت خودکار هنگام خروج از scope آزاد می‌شوند

🔹️LIFO Structure:
استفاده از مدل LIFO باعث استفاده‌ی بهینه از حافظه می‌شود

🔹️Limited Size:
اندازه‌ی stack محدود است و برای objectهای بزرگ مناسب نیست

ءHeap Allocation چیست؟

ءheap برای dynamic memory allocation استفاده می‌شود.
اینجاست که reference typeها (مانند objectها، stringها و ...) تخصیص داده می‌شوند.

ءheap توسط Garbage Collector (GC) مدیریت می‌شود که به‌صورت دوره‌ای حافظه‌ای که دیگر استفاده نمی‌شود را آزاد می‌کند. ♻️

ویژگی‌های Heap Allocation:

🔹️Managed by Garbage Collector:
ء GC فرآیند آزادسازی حافظه را به‌صورت خودکار مدیریت می‌کند

🔹️Dynamic Allocation:
ءobjectها می‌توانند حتی پس از اتمام متدی که آن‌ها را ایجاد کرده، باقی بمانند

🔹️Larger Memory Pool:
ءheap می‌تواند نسبت به stack objectهای بسیار بزرگ‌تری را ذخیره کند

تفاوت بین Stack و Heap

تفاوت‌های کلیدی بین stack و heap allocation در #C حول محور نحوه و زمان تخصیص و آزادسازی حافظه می‌چرخند.

حافظه‌ی stack کارآمد است و برای داده‌های کوتاه‌عمر (short-lived) که scope آن‌ها محدود به function یا method است مناسب می‌باشد.

در مقابل، heap برای داده‌هایی استفاده می‌شود که نیاز دارند فراتر از scope یک method باقی بمانند؛ مانند instanceهای reference type.

ءstack مدیریت حافظه‌ی خودکار و بسیار سریعی را فراهم می‌کند، اما از نظر اندازه محدود است و نمی‌تواند ساختارهای داده‌ای بزرگ و پیچیده را مدیریت کند.

ءheap در حالی که انعطاف‌پذیری بیشتر و تخصیص حافظه‌ی بزرگ‌تری ارائه می‌دهد، نیازمند garbage collection است که مقداری overhead در performance ایجاد می‌کند. 📉

نحوه‌ی عملکرد Stack در #C: مثال

برای درک بهتر stack allocation، به مثال زیر توجه کنید:

public void StackExample()
{
    int a = 5;
    int b = 10;
    int result = a + b;
}

در مثال بالا:
اعداد صحیح a، b و result روی stack تخصیص داده می‌شوند زیرا از نوع value type هستند

زمانی که متد StackExample به پایان می‌رسد، تمام حافظه‌ی استفاده‌شده توسط این متغیرها به‌صورت خودکار آزاد می‌شود

Local Variables و Stack Allocation

متغیرهای محلی (Local variables)، شامل value typeها و reference به objectها، روی stack ذخیره می‌شوند.
با این حال، referenceهای مربوط به objectها به heap اشاره می‌کنند؛ جایی که داده‌ی واقعی object در آن قرار دارد.

زمانی که یک value type بخشی از یک reference type باشد (برای مثال، یک فیلد داخل یک class)، آن value type به‌عنوان بخشی از object مربوط به reference type روی heap ذخیره می‌شود.

نحوه‌ی عملکرد Heap در #C: مثال
کد زیر را در نظر بگیرید:

public class Person
{
    public string Name;
    public int Age;
}

public void HeapExample()
{
    Person person = new Person();
    person.Name = "Alice";
    person.Age = 30;
}

در این مثال: object از نوع Person روی heap ایجاد می‌شود زیرا یک reference type است.reference با نام person روی stack ذخیره می‌شود که به object روی heap اشاره می‌کند.
فیلدهای Name و Age نیز به‌عنوان بخشی از object مربوط به Person روی heap ذخیره می‌شوند

Value Typeها در مقابل Reference Typeها

درک value typeها و reference typeها به شفاف‌سازی نحوه‌ی استفاده از حافظه کمک می‌کند.

🔹️Value Types:
به‌صورت مستقیم در حافظه‌ی stack ذخیره می‌شوند. مانند int، float، bool و structهای سفارشی

🔹️Reference Types:
روی heap ذخیره می‌شوند، اما reference مربوط به آن‌ها روی stack قرار می‌گیرد. مانند classها، arrayها و stringها

مثال: Value Type در مقابل Reference Type

// Value type, allocated on the stack
int x = 10;            

// Reference type, reference on stack, object on heap
Person p1 = new Person(); 

در مثال بالا، x روی stack ذخیره می‌شود زیرا یک value type است، در حالی که p1 روی heap ذخیره می‌شود زیرا یک reference type است.

Memory Management در .NET

ءruntime مربوط به NET. شامل یک Garbage Collector (GC) است که به مدیریت تخصیص و آزادسازی حافظه برای heap کمک می‌کند.

ءGC به‌صورت خودکار objectهایی که همچنان در حال استفاده هستند را ردیابی کرده و حافظه‌ای که دیگر مورد نیاز نیست را آزاد می‌کند. ♻️

Heap و Stack Allocation در C# 🧠💾(بخش دوم)
Generational Garbage Collection

ءGC در NET. برای بهینه‌سازی پرفورمنس، objectها را به سه نسل تقسیم می‌کند:

🔹️Generation 0:
ءobjectهای کوتاه‌عمر که معمولاً در methodها تخصیص داده می‌شوند

🔸️Generation 1:
ءobjectهای با طول عمر متوسط که از collection مربوط به Gen 0 عبور کرده‌اند

🔹️Generation 2:
ءobjectهای بلندعمر که معمولاً برای داده‌های سطح application استفاده می‌شوند

مثال: نحوه‌ی عملکرد GC

public void GarbageCollectionExample()
{
    // Allocated on the heap (Generation 0)
    Person p1 = new Person(); 
}

مثال Generation 0 (GarbageCollectionExample):

ءinstance مربوط به Person با نام p1 روی heap تخصیص داده شده و در Generation 0 آغاز می‌شود که برای objectهای کوتاه‌عمر در نظر گرفته شده است.

اگر پس از اتمام method هیچ reference دیگری به p1 وجود نداشته باشد، garbage collector ممکن است آن را در طی collection مربوط به Generation 0 آزاد کند.

public void Generation1Example()
{
    List<int> numbers = new List<int>();
    for (int i = 0; i < 1000; i++)
    {
        numbers.Add(i);
    }
    // 'numbers' will likely survive Gen 0 collection and move to Gen 1.
}

مثال Generation 1 (Generation1Example):

ء<List<int با نام numbers روی heap تخصیص داده می‌شود. از آنجا که شامل چندین مقدار بوده و برای مدت نسبتاً طولانی‌تری باقی می‌ماند (برای مثال، تا پایان method)، ممکن است از garbage collection مربوط به Generation 0 عبور کرده و به Generation 1 ارتقاء یابد.

ءGeneration 1 برای objectهایی است که به اندازه‌ی objectهای Generation 0 کوتاه‌عمر نیستند اما همچنان نیازی به باقی‌ماندن در طول کل عمر application ندارند.

public class CacheManager
{
    private static Dictionary<string, string> _cache = new Dictionary<string, string>();

    public static void AddItem(string key, string value)
    {
        _cache[key] = value;
    }
}

public void Generation2Example()
{
    CacheManager.AddItem("user1", "data1");
    CacheManager.AddItem("user2", "data2");
    // '_cache' is a static reference and is long-lived, likely residing in Generation 2.
}

مثال Generation 2 (Generation2Example):

کلاس CacheManager از یک Dictionary به‌صورت static استفاده می‌کند، که به این معناست داده‌های آن در طول چرخه‌ی عمر application باقی می‌مانند.
از آنجا که این dictionary (_cache) بلندعمر است، احتمالاً به Generation 2 ارتقاء می‌یابد که objectهایی را نگه‌داری می‌کند که انتظار می‌رود برای مدت طولانی باقی بمانند؛ مانند cacheها، داده‌های static یا objectهای singleton.

مشکلات رایج و Best Practiceها

🔹️Stack Overflow:
زمانی رخ می‌دهد که تعداد زیادی فراخوانی method تودرتو یا recursion بیش از حد وجود داشته باشد که منجر به اتمام حافظه‌ی stack می‌شود

🔸️Memory Leaks:
با اینکه NET. دارای GC است، memory leak همچنان می‌تواند رخ دهد اگر referenceها به‌صورت ناخواسته زنده نگه داشته شوند و مانع از جمع‌آوری آن‌ها توسط GC شوند

Best Practices

🔹️Minimize Long-Lived Objects:
از نگه‌داشتن referenceها بیش از حد لازم خودداری کنید

🔸️Use Structs Wisely:
تنها زمانی از struct استفاده کنید که type کوچک و کوتاه‌عمر باشد تا از تخصیص غیرضروری روی heap جلوگیری شود

🔹️Avoid Recursive Calls:
برای recursionهای عمیق، از روش‌های iterative استفاده کنید تا از stack overflow جلوگیری شود

نتیجه‌گیری

🔹️درک تفاوت‌های بین heap و stack allocation در #C می‌تواند به شما کمک کند applicationهایی کارآمدتر و با performance بالاتر بنویسید.

🔸️با دانستن اینکه داده‌های شما کجا و چگونه ذخیره می‌شوند، می‌توانید تصمیمات بهتری درباره‌ی مدیریت حافظه اتخاذ کنید، از pitfalls جلوگیری کنید و از مزایای هر دو نوع تخصیص حافظه بهره ببرید. ⚡️

🔹️برای درک کامل پتانسیل memory management، مهم است بدانید که هر نوع allocation دارای سناریوهای استفاده‌ی بهینه‌ی خاص خود است.

🔸️ء stack برای سناریوهایی ایده‌آل است که داده‌ها دارای طول عمر کوتاه و مشخص هستند؛ مانند محاسبات سطح method و value typeهای ساده.

🔹️دسترسی سریع و آزادسازی خودکار آن تضمین می‌کند که داده‌های کوچک و موقتی با حداقل overhead مدیریت شوند که منجر به performance بهینه می‌شود.

🔸️از سوی دیگر، heap انعطاف‌پذیری لازم برای dynamic memory allocation و objectهای بلندعمر را فراهم می‌کند، اما این امر با هزینه‌ی زمان دسترسی کندتر و نیاز به garbage collection همراه است.

🔹️برای ساختارهای داده‌ای پیچیده، منابع اشتراکی یا objectهایی که فراتر از method ایجادکننده‌ی خود باقی می‌مانند، heap ضروری است.

🔸️با این حال، توسعه‌دهندگان باید مراقب باشند referenceها را بیش از حد لازم نگه ندارند تا از memory leak و افزایش GC pressure جلوگیری شود.

🔹️ءGenerational garbage collection با دسته‌بندی objectها بر اساس طول عمر آن‌ها، به ایجاد تعادل میان performance و کارایی memory management کمک می‌کند.

🔸️درک نحوه‌ی ارتقاء objectها میان نسل‌ها می‌تواند به توسعه‌دهندگان کمک کند کدی بنویسند که توقف‌های GC را به حداقل رسانده و throughput را به حداکثر برساند.

🔹️در عمل، آگاهی از محل و نحوه‌ی تخصیص حافظه می‌تواند به شما کمک کند کدی بنویسید که عملکرد بهتری داشته باشد، از مشکلات رایجی مانند stack overflow یا memory leak جلوگیری کند و از منابع سیستم به‌صورت مؤثرتری استفاده نماید.

🔸️برای مثال، با کاهش تخصیص objectهای غیرضروری روی heap و استفاده از تخصیص‌های مبتنی بر stack در صورت امکان، می‌توانید overhead ناشی از garbage collection را کاهش داده و responsiveness applicationهای خود را بهبود دهید.

🔹️درک عمیق این مفاهیم حافظه همچنین شما را در انتخاب ساختارهای داده‌ای و design patternهای مناسب راهنمایی می‌کند.

🔸️برای مثال، استفاده از struct به‌جای class برای objectهای کوچک و immutable می‌تواند به کاهش تخصیص روی heap کمک کند، در حالی که استفاده‌ی هوشمندانه از مکانیزم‌های caching می‌تواند تضمین کند objectهای بلندعمر در Generation 2 به‌درستی مدیریت شوند بدون آنکه استفاده از حافظه بیش از حد افزایش یابد.

🔹️در نهایت، memory management در #C ابزاری قدرتمند است اگر با رویکردی استراتژیک مورد استفاده قرار گیرد.

🔸️استفاده‌ی مؤثر از heap و stack در کنار best practiceهای مربوط به garbage collection به توسعه‌دهندگان کمک می‌کند applicationهایی مقاوم و با performance بالا ایجاد کنند.

🔹️با افزایش پیچیدگی پروژه‌های شما، در نظر داشتن این مفاهیم تضمین می‌کند که applicationهای شما همچنان scalable، maintainable و کارآمد باقی بمانند.

🔸️به تفاوت‌های میان value type و reference type توجه داشته باشید و از garbage collector مربوط به runtime در NET. بهره ببرید، در حالی که نسبت به مشکلات رایج حافظه مانند leakها و stack overflow نیز هوشیار باشید.

🔹️درک مناسب این مفاهیم در پروژه‌های پیچیده‌تر #C به شما کمک شایانی خواهد کرد. 🚀

🔖هشتگ‌ها:
#CSharp #DotNet #MemoryManagement #GarbageCollector #Heap #Stack #Performance

📌عنوان : Factory Method

📌Domain Driven Design : A Model Expressed in Software

در تصور معمول ما، یک شخص دارای هویتی است که از تولد تا مرگ و حتی فراتر از آن امتداد می‌یابد. ویژگی‌های فیزیکی آن شخص تغییر می‌کنند و در نهایت از بین می‌روند. نام ممکن است تغییر کند. روابط مالی به وجود می‌آیند و از بین می‌روند. حتی یک ویژگی هم در انسان وجود ندارد که تغییرناپذیر باشد؛ با این حال، هویت باقی می‌ماند. آیا من همان فردی هستم که در پنج‌سالگی بودم؟ این نوع پرسش متافیزیکی در جستجوی مدل‌های دامنه (domain models) مؤثر اهمیت دارد.
با بیانی کمی متفاوت: آیا کاربرِ اپلیکیشن اهمیتی می‌دهد که من همان فردی هستم که در پنج‌سالگی بودم؟

دو واریز (deposit) با مبلغ یکسان، به یک حساب یکسان، در یک روز یکسان، همچنان دو transaction متمایز محسوب می‌شوند.بنابراین دارای هویت هستند و یک ENTITY به شمار می‌آیند.
از سوی دیگر، attribute مبلغ این دو transaction احتمالاً instanceهایی از یک Object از نوع money هستند. این مقادیر هیچ هویتی ندارند، زیرا تمایز میان آن‌ها هیچ سودمندی‌ای ندارد.
در واقع، ممکن است دو Object دارای هویت یکسان باشند، بدون آنکه attributeهای یکسانی داشته باشند یا حتی الزاماً از یک class یکسان باشند.

در واقع، ممکن است یک چیز واحد در دنیای واقعی در یک domain model به‌صورت یک ENTITY نمایش داده شود یا اصلاً چنین نباشد.
برای مثال، یک application جهت رزرو صندلی در یک استادیوم ممکن است صندلی‌ها (seat) و شرکت‌کنندگان (attendee) را به‌عنوان ENTITY در نظر بگیرد.
در حالت assigned seating که روی هر بلیت شماره صندلی درج شده است، صندلی یک ENTITY محسوب می‌شود. شناسه (identifier) آن شماره صندلی است که در محدوده‌ی استادیوم یکتا (unique) است.
صندلی ممکن است attributeهای دیگری نیز داشته باشد، مانند:
• موقعیت مکانی
• داشتن یا نداشتن دیدِ مسدود
•‌ قیمت
اما تنها شماره صندلی یا ترکیب یکتای ردیف (row) و موقعیت (position) برای شناسایی و تمایز صندلی‌ها استفاده می‌شود.
از سوی دیگر، اگر رویداد از نوع general admission باشد به این معنا که دارندگان بلیت در هر صندلی خالی که پیدا کنند می‌نشینند نیازی به تمایز میان صندلی‌های منفرد وجود ندارد.
در این حالت، تنها تعداد کل صندلی‌ها اهمیت دارد. با اینکه شماره صندلی‌ها همچنان به‌صورت فیزیکی روی صندلی‌ها حک شده‌اند، هیچ نیازی نیست که software آن‌ها را ردیابی کند.
در واقع، اگر مدل شماره صندلی خاصی را به بلیت‌ها نسبت دهد، این یک خطای مدلسازی خواهد بود؛ زیرا در یک رویداد با general admission چنین محدودیتی وجود ندارد.
در چنین شرایطی، صندلی‌ها دیگر ENTITY نیستند و هیچ identifierای نیز موردنیاز نخواهد بود.

🔖هشتگ‌ها :
#DDD #DomainModel
#Entity

ءVertical Slices دقیقاً کجای Modular Monolith قرار می‌گیرند؟ 🤔

بیشتر تیم‌ها معماری در سطح کلان (macro architecture) را به‌درستی پیاده‌سازی می‌کنند. آن‌ها یک Modular Monolith با مرزهای مشخص بین ماژول‌ها، APIهای عمومی و ایزولاسیون مناسب داده‌ها می‌سازند.
اما بعد از آن، دیگر به معماری فکر نمی‌کنند! ❌

هر ماژول دقیقاً همان ساختار داخلی را دریافت می‌کند. معمولاً نوعی از Layered Architecture.

موضوع اینجاست که Clean Architecture و Vertical Slice Architecture آن‌قدرها هم که فکر می‌کنید از هم دور نیستند. هر دو روی Use Caseها تمرکز دارند و هدفشان حداکثرسازی Cohesion است.

ءClean Architecture فقط یک قانون اضافه می‌کند:
جهت وابستگی‌ها (Direction of Dependencies) باید کنترل شود. که این معمولاً منجر به Abstractionها و Ceremonyهای بیشتری می‌شود.

رویکرد Pragmatic Clean Architecture یک حد وسط را انتخاب می‌کند و از نظر ماهیت، شباهت زیادی به VSA دارد.

سوال اصلی این نیست که کدام‌یک "بهتر" است.
سوال این است که هر کدام در کجای Modular Monolith شما می‌درخشند ✨
و بخش جذاب ماجرا اینجاست:
می‌توانید آن‌ها را با هم Mix & Match کنید.

🧠 دو سطح از معماری

وقتی یک Modular Monolith می‌سازید، باید دو تصمیم معماری مهم بگیرید:

1️⃣ Macro Architecture

سیستم را چطور به ماژول‌ها تقسیم می‌کنید؟
این شامل موارد زیر است:
🔹️مرزهای ماژول‌ها
🔹️الگوهای ارتباطی بین ماژول‌ها
🔹️ایزولاسیون داده‌ها
🔹️طراحی Public API
🔹️نحوه Deploy شدن ماژول‌ها

2️⃣ Micro Architecture

کد داخل هر ماژول چطور سازماندهی می‌شود؟
این شامل موارد زیر است:
🔸️ساختار پوشه‌ها
🔸️جهت وابستگی‌ها
🔸️نحوه پیاده‌سازی Use Caseها
🔸️محل قرارگیری Validation
ُ🔸️نحوه دسترسی به دیتابیس

بیشتر مقالات درباره Modular Monolith کاملاً روی سطح Macro تمرکز می‌کنند.
و دلیل خوبی هم دارد — اشتباه گرفتن مرزهای ماژول‌ها، هزینه‌ی اصلاح بسیار بالایی دارد 💸

اما سطح Micro هم به همان اندازه مهم است.
چرا؟ چون تعیین می‌کند:
🔹️اضافه کردن Feature جدید چقدر آسان است
🔹️ءNavigation در کد چقدر ساده است
🔹️ءOnboard کردن توسعه‌دهنده جدید چقدر زمان می‌برد
این همان معماری‌ای است که تیم شما هر روز با آن تعامل دارد.

🔑 نکته کلیدی:

ءMacro Architecture مشخص می‌کند که ماژول‌ها چگونه با یکدیگر تعامل داشته باشند.
اما Micro Architecture یک تصمیم محلی است که هر ماژول می‌تواند به‌صورت مستقل بگیرد.

ماژول Ticketing شما مجبور نیست همان ساختار داخلی ماژول Notifications را دنبال کند.
مرز ماژولار این آزادی را به شما می‌دهد 🚀

ءVertical Sliceها ماژول نیستند ❗️

من دیده‌ام که بعضی‌ها Vertical Sliceها را با ماژول‌ها یکی می‌دانند.
در سطح Macro، یک ماژول می‌تواند شبیه یک "vertical slice" از دامنه‌ی کسب‌وکار به نظر برسد.
اما این تشبیه در سطح Application از بین می‌رود.

یک ماژول یک Bounded Context است.
مالک داده‌های خودش است، یک Public API ارائه می‌دهد، و یک قابلیت کسب‌وکاری را کپسوله می‌کند.

یک Vertical Slice یک الگوی پیاده‌سازی Feature است.
درخواست (Request)، Handler، Validation، و Data Access را برای یک Use Case در کنار هم گروه‌بندی می‌کند.

ماژول‌ها و Vertical Sliceها در سطوح متفاوتی عمل می‌کنند.ماژول‌ها مرزهای سیستم را تعریف می‌کنند.Vertical Sliceها کد داخل این مرزها را سازماندهی می‌کنند.

📦 ءVertical Sliceها داخل یک ماژول

ءVertical Slice Architecture کد را بر اساس Feature سازماندهی می‌کند، نه بر اساس لایه‌های فنی.

هر Feature یک واحد Self-contained است:
🔹️ءRequest، Handler، Validation، Data Access — همه در یک مکان.

🔸️در داخل یک ماژول از Modular Monolith، این یک انتخاب طبیعی است. مرز ماژول از قبل جداسازی از بقیه سیستم را اعمال می‌کند. شما به Layerها برای محافظت نیازی ندارید.Public API ماژول این کار را انجام می‌دهد.

🧭 انتخاب معماری داخلی

یک سوءبرداشت رایج این است که VSA فقط برای ماژول‌های ساده است و Clean Architecture برای ماژول‌های پیچیده. این‌طور نیست.
ءVertical Sliceها با Domain Modelهای غنی هم عالی کار می‌کنند. می‌توانید Domain Entityها، Value Objectها، و Domain Eventها را داخل یک Vertical Slice داشته باشید.

ءSlice نقطه ورود و Orchestration را سازماندهی می‌کند.Domain Model قوانین کسب‌وکار را مدیریت می‌کند. با رشد پیچیدگی Slice، منطق را به Domain منتقل می‌کنید دقیقاً همان‌طور که در Clean Architecture انجام می‌دهید.

به‌طور مشابه، Pragmatic Clean Architecture برای ماژول‌های ساده هم به خوبی کار می‌کند. پس تصمیم‌گیری درباره پیچیدگی نیست. بلکه درباره راحتی تیم شما و میزان شفافیتی است که به دست می‌آورید.

📌 چند موردی که باید در نظر بگیرید:

✨️آشنایی تیم
اگر تیم شما با Layer و Direction of Dependencies فکر می‌کند، Clean Architecture طبیعی‌تر خواهد بود. اگر ترجیح می‌دهند حول Featureها سازماندهی شوند، VSA اصطکاک را کاهش می‌دهد.

✨️منطق Domain مشترک
وقتی Use Caseهای زیادی از Domain Entityهای مشابه استفاده می‌کنند، داشتن یک Domain Layer اختصاصی می‌تواند این اشتراک را واضح‌تر کند. در VSA می‌توانید منطق مشترک را به یک پوشه جداگانه استخراج کنید.

✨️استقلال Featureها
وقتی Featureها مستقل هستند و به ندرت رفتار مشترک دارند، Vertical Sliceها همه چیز را ساده نگه می‌دارند.
مرز ماژول، صرف‌نظر از انتخاب شما در داخل آن،از بقیه سیستم محافظت می‌کند.
پس چیزی را انتخاب کنید که تیم شما را بیشترین بهره‌ور می‌کند و آماده تغییر باشید وقتی ماژول تکامل پیدا می‌کند.

🎯 جمع‌بندی

ءModular Monolith به سوال Macro پاسخ می‌دهد:
چگونه سیستم را به ماژول‌هایی با مرزهای مشخص تقسیم کنیم؟

ءVertical Slice Architecture به سوال Micro پاسخ می‌دهد:چگونه کد را بر اساس Feature داخل این ماژول‌ها سازماندهی کنیم؟

آن‌ها در سطوح متفاوتی عمل می‌کنند.
ءModular Monolith Cohesion بالا در سطح ماژول فراهم می‌کند و Coupling بین ماژول‌ها را مدیریت می‌کند.

ءVertical Slice Architecture Cohesion بالا در سطح Feature داخل ماژول فراهم می‌کند.
شما مجبور نیستید یک معماری داخلی را برای کل سیستم انتخاب کنید. هر ماژول می‌تواند گزینه مناسب با Context خودش را انتخاب کند.برخی ماژول‌ها از Pragmatic Clean Architecture استفاده خواهند کرد.
برخی دیگر از Vertical Sliceها.
مرز ماژول که به‌خوبی تعریف شده باشد،
این انتخاب را ایمن می‌کند.

🔖هشتگ‌ها:
#DotNet #SoftwareArchitecture #ModularMonolith #VerticalSliceArchitecture #CleanArchitecture

📌عنوان : معرفی Collection Expression Arguments در C# 15.0

📌Domain Driven Design : Value Object

مفهوم Value Object یکی از مهم‌ترین Building Blockهایی است که توسط Eric Evans در کتاب معروفش Domain-Driven Design: Tackling Complexity in the Heart of Software معرفی شد؛ مفهومی که اگر درست درک شود، می‌تواند ساختار Domain Model شما را به‌شدت ساده‌تر، Maintainableتر و Expressiveتر کند.

💡ءValue Object چیست؟

در DDD، همه چیز در Domain یا Identity دارد یا فقط Value است.

یک Value Object:
🔹 هویتی (Identity) ندارد
🔹 فقط با مقدارش (Value) تعریف می‌شود
🔹 ءImmutable است
🔹 قابل جایگزینی است بدون اینکه معنی Domain تغییر کند

به بیان ساده:
اگر دو Object از نظر مقدار برابر باشند، در Domain یکی محسوب می‌شوند.

مثال:
📍 Address
💰 Money
📧 Email
📏 Distance

در Domain، مهم نیست کدام Address instance را داریم؛ اگر مقدارشان برابر باشد، از نظر Business یکی هستند.

🆚 Entity vs Value Object

📌Entity :
• دارای Identity
• ءMutable
• ءLifecycle دارد
• مقایسه با Id
• قابل Track شدن

📌 Value Object :
• بدون Identity
• ءImmutable
• ءLifecycle ندارد
• مقایسه با Value
• ءReplaceable

مثال:
Customer → Entity
CustomerEmail → Value Object
در دامین، Email هویت ندارد؛ فقط مقدار آن مهم است.

🔒 Immutability در Value Object

طبق تعریف Evans:
"Value Object should be immutable"
چرا؟چون اگر مقدار تغییر کند، دیگر همان مفهوم قبلی نیست.

مثال:

public sealed class Email
{
    public string Value { get; }

    public Email(string value)
    {
        if(string.IsNullOrWhiteSpace(value))
            throw new ArgumentException("Email is required");

        Value = value;
    }
}

اگر Email تغییر کند:
یعنی یک Email جدید ساخته‌ایم،
نه اینکه Email قبلی تغییر کرده باشد.

⚖️ Equality بر اساس Value

ءValue Objectها باید بر اساس مقدارشان مقایسه شوند نه Reference.

public override bool Equals(object? obj)
{
    if (obj is not Email other)
        return false;

    return Value == other.Value;
}

public override int GetHashCode()
{
    return Value.GetHashCode();
}

در Domain:

new Email("a@gmail.com") == new Email("a@gmail.com")

باید True باشد حتی اگر دو Instance متفاوت باشند.

🎯 چه زمانی از Value Object استفاده کنیم؟

وقتی:
✅ ءObject مفهوم Domain دارد
✅ ءIdentity ندارد
✅ فقط با مقدار تعریف می‌شود
✅ قابل تغییر نیست
✅ ءLifecycle مستقل ندارد

🚫 ءAnti-Pattern رایج

بسیاری از پروژه‌ها این اشتباه را انجام می‌دهند:

public string Email { get; set; }

در حالی که:
ءEmail یک Primitive نیست
بلکه یک Concept در Domain است.

این همان Primitive Obsession است که DDD سعی دارد از آن جلوگیری کند.

🧠 مزایای استفاده از Value Object

✔️ جلوگیری از Invalid State
✔️ افزایش Expressiveness در Domain Model
✔️ کاهش Coupling
✔️ ءEncapsulation بهتر Business Ruleها
✔️ جلوگیری از Primitive Obsession
✔️ تست‌پذیری بیشتر

✅ جمع‌بندی

ءValue Objectها کمک می‌کنند:

🔹️ءDomain شما Richتر شود
🔸️ءBusiness Ruleها نزدیک به Data تعریف شوند
🔹️ءModel شما از Primitive Typeها جدا شود
🔸️و مهم‌تر از همه، زبان Ubiquitous Language در کد منعکس شود

اگر در Domain چیزی Identity ندارد،
احتمالاً باید یک Value Object باشد.

🔖هشتگ‌ها:
#DDD #ValueObject #DomainModel