Domain Event sistemde meydana gelen olayların kayıdıdır.
Bir domain event geçmiş zamanda meydana gelmiş bir olayı temsil eder. Yani bu olay gerçekleşmiştir. Ve bu olayın gerçekleşmesiyle ilgilenen diğer ilgililer bilgilendirilir. Bu bilgilendirme işini yapmak içinde MediatR kütüphanesi kullanılabilir.
Örneğin MemberCreatedDomainEvent, GatheringCreatedDomainEvent, InvitationAcepptedDomainEvent.
Domain Eventler immutabledır.
Value Objectler sadece değerleriyle tanımlanan türlerdir. Değerleri aynıysa iki value object eşit kabul edilir. Value Objectler daha karmaşık yapıları temsil etmek için primitive tipler(int, string, boolean vs.) kullanırken ortaya çıkan sorunları çözmek için kullanılır.
FirstName alanı için databasede nvarchar tipinde bir alan tutmamız gerekiyor. Dolayısıyla da uygulama tarafında string tipinde saklamak durumunda kalıyoruz. Yada PhoneNumber alanı için aynı şekilde string tipini kullanıyoruz. Mesela string sınıfına ait toLower() metodu için konuşursak bu metod phoneNumber için uygun mudur? Tabiki uygun değildir. Onun için PhoneNumberı value object olarak tanımlayabiliriz. Yada aynı şekilde firstName alanınıda value object olarak tanımlayabiliriz. Value objectler içerisinde kendisi ile ilgili bussineslara sahip olabilir.
Yukarıdaki member sınıfını ele aldığımız da member sınıfından nesne üretmek için
Member member1 = new Member(37,"Aytaç","demirci","aytac@gmail.com")
Member member2 = new Member(37,"aytac@gmail.com","Aytaç","Demirci")
Firstname yerine email, email yerine isim yazdığımızda bu bir hata vermez ve çalışır fakat doğru bir işlem yapmış olmayız. Ayrıca firstName için en az 50 karakter olsun. Empty olmasın gibi kısıtlar getirmek isteyebiliriz. İşte bunu sağlayabilmek için value objectleri kullanabiliriz.
namespace Gatherly.Domain.ValueObjects
{
public sealed class FirstName : ValueObject
{
private FirstName() { }
public const int MaxLength = 50;
public string Value { get; }
private FirstName(string value)
{
Value = value;
}
public override IEnumerable<object> GetAtomicValues()
{
yield return Value;
//Bu value objectin extra propertyleri olursa buraya eklenecek.
}
public static FirstName Create(string firstName)
{
if (string.IsNullOrWhiteSpace(firstName))
{
throw new ArgumentNullException($"{nameof(firstName)} is empty.");
}
if (firstName.Length > MaxLength)
{
throw new InvalidLenghtException($"{nameof(firstName)} is too long.");
}
return new FirstName(firstName);
}
}
}Alttaki abstract GetAtomicValues metodu miras alınan sınıflarda override edilip buraya o sınıfın propertyleri yield return peropertyname şeklinde eklenecektir.
public abstract class ValueObject : IEquatable<ValueObject>
{
public abstract IEnumerable<object> GetAtomicValues();
public override bool Equals(object? obj)
{
return obj is ValueObject other && ValuesAreEqual(other);
}
public bool Equals(ValueObject? other)
{
return other is not null && ValuesAreEqual(other);
}
private bool ValuesAreEqual(ValueObject other)
{
return GetAtomicValues().SequenceEqual(other.GetAtomicValues());
}
public override int GetHashCode()
{
return GetAtomicValues()
.Aggregate(default(int), HashCode.Combine);
}
}
Domain Layer da Validationu nasıl uygularız ?
I-) DomainException isminde Exception sınıfından miras alan bir sınıf oluşturuyoruz.
II-) En yukarıda Switch içindeki ikinci case için oluşan Validation Rule Exceptionı için örnek exception yazımı aşağıdadır.
III-) Son olarak Switch içindeki Exceptionlar yazmış olduğumuz CustomExceptionlarla değiştirilir.
- 12.satır Bir Entity yaratıldığında ve ona constructerda bir Id atandıktan sonra artık bu Id değerinin hiç bir zaman değiştirilememesini sağlamak için Id propertisinin set metodunu silip init yapıyoruz. Daha sonra private init yaparak bu Entitye Id ataması işlemini sadece bu Entity clası içerisinde yapılabileceğini garanti ediyoruz.
Entityler oluşturulurken zorunlu olan propertyler constructer üzerinden alınmalıdır. Diğer değerler metodlar aracılığıyla alınmalıdır.
Yukarıdaki screen incelenirse eğer;
public abstract class Entity : IEquatable<Entity>
{
protected Entity(Guid id)
{
Id = id;
}
protected Entity()
{
}
public Guid Id { get; private init; }
public override bool Equals(object? obj)
{
if(obj is null)
{
return false;
}
if(obj.GetType() != GetType())
{
return false;
}
if(obj is not Entity entity)
{
return false;
}
return entity.Id == Id;
}
public bool Equals(Entity? other)
{
if (other is null)
{
return false;
}
if (other.GetType() != GetType())
{
return false;
}
return other.Id == Id;
}
public override int GetHashCode()
{
return Id.GetHashCode();
}
public static bool operator ==(Entity? first, Entity? second)
{
return first is not null && second is not null && first.Equals(second);
}
public static bool operator !=(Entity? first, Entity? second)
{
return !(first == second);
}
}
Yukarıda görüldüğü gibi Gathering clası içerisinde Invitations isminde bir List bulunmaktadır. Projenin herhangi bir yerinde bir gathering nesnesi oluştulup daha sonra bu nesnenin içindeki Invitation listesi üzerinde Remove ve Add işlemleri yapılabilir.
Böyle bir durumla başa çıkabilmek için ilk olarak Gathering sınıfındaki Invitation listesine eleman eklemek için Gathering sınıfı içerisinde geriye invitation dönen bir adet SendInvitation isminde metod oluşturacağız ve bu metodun görevi bir adet Invitation nesnesi oluşturmak ve bu nesneyi Gathering sınıfındaki invatation list collectionuna eklemek olacaktır.
Burada invation nesnesinin sadece Domain katmanında oluşturulmasını sağlamak içinde invaitation sınıfının constructeri internal yapılır. Artık Application Layerda invitation nesnesi new() lenemez.
Gathering sınıfındaki List<Invitation> şeklinde kullanılan tanımlama IReadOnlyCollection ile değiştirilir. IReadOnlyCollection içersinde Add ve Remove metodları yoktur. Böylece projenin herhangi bir yerinde bu liste üzerinde Remove yada Add işlemi yapılamaz.
Son olarak güncellememiz gerekirse, Gathering sınıfı içerisinde bir adet private readonly _invitations isminde invitation List oluşturuyoruz. Daha sonra IReadOnlyCollection invitation propertysinin resultına bunu ekliyoruz.
1 - Anemic model yapıda constructer ve metodlar olmaz. Bu class içerisinde sadece data propertyler bulunur.
Clean Architecture Nedir ?
4 ayrı bileşeni vardır ve bunlara Clean Arthitecturenin layerları denir.