DDD Entity Nedir ?

🧱 Entity Nedir?

Özellikleri:

Mutabilite: Entity’nin durumu değişebilir ancak kimliği değişmez.

Örnek Domain Entity:

bash
Kopyala
public class Customer
{
  public Guid Id { get; private set; }
  public string Name { get; private set; }
  public string Email { get; private set; }
  public bool IsActive { get; private set; }
  public Customer(Guid id, string name, string email)
  {
      Id = id;
      Name = name;
      Email = email;
      IsActive = true;
  }
  public void ChangeEmail(string newEmail)
  {
      // Basit bir validasyon örneği
      if (string.IsNullOrWhiteSpace(newEmail) || !newEmail.Contains("@"))
          throw new ArgumentException("Geçerli bir email adresi giriniz.");
      Email = newEmail;
  }
  public void Deactivate()
  {
      IsActive = false;
  }
}

Bu örnekte Customer entity’si sadece verileri değil, aynı zamanda müşteriyle ilgili davranışları da kapsıyor.

Bellek (memory) içinde yaşarken bile o nesneyi tanımlamak için kullanılır. Henüz veritabanıyla hiçbir bağlantı kurmamış olsa bile, bir Order nesnesi Id değerine sahiptir ve bu sayede uygulama içinde tanımlıdır. Yani burada kimlik, sadece veri saklamak için değil, domain mantığında varlıkları ayırt etmek içindir.

🔍 Özetle şöyle diyebiliriz:

Örnek verelim

🎯 EF Core Entity Yaklaşımı (Persistence Odaklı)

bash
Kopyala
public class Order
{
  public int Id { get; set; } // Veritabanı tarafından atanır (Identity)
  public DateTime CreatedAt { get; set; }
  public decimal TotalAmount { get; set; }
}

🧠 DDD Entity Yaklaşımı (Domain Odaklı)

bash
Kopyala
csharp
KopyalaDüzenle
public class Order
{
  public Guid Id { get; private set; }  // Uygulama tarafından atanır
  public DateTime CreatedAt { get; private set; }
  public decimal TotalAmount { get; private set; }
  public Order(decimal totalAmount)
  {
      Id = Guid.NewGuid(); // Kimlik veritabanı değil, uygulama tarafından atanır
      CreatedAt = DateTime.UtcNow;
      TotalAmount = totalAmount;
  }
  public void UpdateTotal(decimal newTotal)
  {
      if (newTotal < 0)
          throw new InvalidOperationException("Tutar negatif olamaz.");
      TotalAmount = newTotal;
  }
}

Kimlik, iş mantığına göre belirlenir ve tüm sistem boyunca aynı kalır.

📌 Ne Kazanırız?

bash
Kopyala
namespace DomainDrivenDesign.Domain.Categories
{
    public sealed class Category: Entity
    {
        public Category(Guid CreatedTimeAssignedId) : base(CreatedTimeAssignedId)
        {
        }
        public string Name { get; set; }
        public ICollection<Product> Products { get; set; }
    }
}

bash
Kopyala
namespace DomainDrivenDesign.Domain.Abstractions
{
    //Sadece Kalıtım alınsın istiyoruz kendi başına bir oluşum olmasın
    //Bu yüzden abstract olarak tanımlıyoruz
    public abstract class Entity 
    {
        public Guid Id { get; init; } //Inıt property olarak tanımladık ki sadece constructor'da atama yapılabilsin ve değiştirilemesin
        protected Entity(Guid CreatedTimeAssignedId)
        {
            this.Id = CreatedTimeAssignedId;
        }
    }
}

bash
Kopyala
public class ExampleClass : Entity
{
    public ExampleClass(Guid CreatedTimeAssignedId) : base(CreatedTimeAssignedId)
    {
    }
}
public class TestRunner
{
    public void main()
    {
        Guid oneTimeCreatedGuid = Guid.NewGuid();
        ExampleClass example1 = new(oneTimeCreatedGuid);
        ExampleClass example2 = new(oneTimeCreatedGuid);
        Console.WriteLine(example1.Id == example2.Id);
        Console.WriteLine(example1.Equals(example2));  
    }
}

🎯 Eşitlik Kontrolü (Equality Check) Nedir ve Neden Önemlidir?

Tersine, tüm alanları aynı olsa bile Id farklıysa, bu iki Entity farklıdır.

🎯 Neden standart referans karşılaştırması yeterli değil?

bash
Kopyala
public abstract class Entity : IEquatable<Entity>
{
    public Guid Id { get; init; }
    protected Entity(Guid CreatedTimeAssignedId)
    {
        this.Id = CreatedTimeAssignedId;
    }
    /* Equals metodunu override ettik çünkü Entity sınıfından türetilen sınıfların 
    karşılaştırılmasını istiyoruz */
    public override bool Equals(object? obj)
    {
        if (obj is null)
        {
            return false;
        }
        if (obj is not Entity entity)
        {
            return false;
        }
        if (obj.GetType() == GetType())
        {
            return false;
        }
        return entity.Id == Id;
    }
    /*GetHashCode metodunu override ettik çünkü 
      Entity sınıfından türetilen Array veya List gibi koleksiyonlarda kullanılacaksa, 
      bu metodun da doğru çalışması gerekiyor. */
    public override int GetHashCode()
    {
        return Id.GetHashCode();
    }
    // IEquatable<Entity> arayüzünü implement ettik çünkü Entity sınıfından türetilen sınıfların karşılaştırılmasını istiyoruz
     public bool Equals(Entity? other)
 	{
     if (other is null)
     {
         return false;
     }
     if (other is not Entity entity)
     {
         return false;
     }
     if (other.GetType() != GetType())
     {
         return false;
     }
     return entity.Id == Id;
 	}
    /* 
     Burada ufak bir dipnot belirtmek istiyorum.
     Burada kullandığımız IEquatable<Entity> arayüzü ile kendi oluşturduğumuz
     equals methodundan daha biraz daha advance bir method.
       Fark Şu : - Kendi override ettiğimiz method Unboxing yapıyor yani basitçe objeyi tipe çeviriyor,
                     Tipe göre kontrol etme işlemi yapıyor biraz daha kötü performans sağlıyor.
                 - İmplement ettiğimiz method ise Unboxing yapmıyor.
     */
}