Automapper C# (Geliştiriciler İçin Nasıl Çalışır)

Automapper'ın Ana Özellikleri

• Kodun Basitleştirilmesi: Automapper, özelliklerin eşlemesini otomatikleştirdiği için manuel kod yazma ihtiyaçını büyük ölçüde azaltarak, hataların önüne geçer ve zaman kazandırır.
• Haritalama Yapılandırmalarında Esneklik: Automapper, geniş bir haritalama senaryoları yelpazesini karşılayacak şekilde haritalama yapılandırmalarının detaylı özelleştirilmesine olanak tanır.
• Performans Verimliliği: Kütüphane, kapsamlı performans zorlukları olmaksızın büyük ve karmaşık nesne modellerini ele alacak şekilde tasarlanmıştır.

Paket Yöneticisi Konsolu Üzerinden Kurulum

Paket yöneticisi konsolunuzda basit bir komutu çalıştırarak Automapper'ı projenize kolayca kurabilirsiniz:

Install-Package AutoMapper

Temel Haritalama Yapılandırmasının Kurulması

Automapper'ı kullanmanın temel adımı haritalama yapılandırmasını tanımlamaktır. Bu, bir girdi nesnesinin (kaynak) özelliklerinin bir çıktı nesnesine (hedef) nasıl aktarılacağını belirtmeyi içerir.

var config = new MapperConfiguration(cfg => 
{
    cfg.CreateMap<SourceClass, DestinationClass>();
});
IMapper mapper = config.CreateMapper();

var config = new MapperConfiguration(cfg => 
{
    cfg.CreateMap<SourceClass, DestinationClass>();
});
IMapper mapper = config.CreateMapper();

Dim config = New MapperConfiguration(Sub(cfg)
	cfg.CreateMap(Of SourceClass, DestinationClass)()
End Sub)
Dim mapper As IMapper = config.CreateMapper()

• Yukarıdaki örnekte, özellikleri SourceClass'den DestinationClass'ye eşlemek için bir eşleme yapılandırması oluşturulmuştur.
• Daha sonra, bu yapılandırma kullanılarak bir IMapper örneği oluşturulur.

Karmaşık Nesne Modellerini Yassılaştırma

Automapper'ın güçlü yönlerinden biri, karmaşık nesne modellerini yassılaştırma yeteneğidir. Bu özellik, yerleşik nesnelerle çalışırken özellikle kullanışlıdır ve bu yerleşik özelliklerin düz bir hedef sınıf yapısına haritalanmasına olanak tanır.

Esnek Nesne Türü Yönetimi

Automapper, çeşitli nesne türleri arasında ustalıkla haritalama yapabilir, kullanıcı alan nesneleri, DTO'lar ve hatta görünüm modelleri dahil olmak üzere farklı veri aktarım ihtiyaçları için esnek bir çözüm sağlar.

Örnek 1: Basit Eşleme

Bir kullanıcı varlığının özelliklerini bir kullanıcı DTO'suna haritalamamız gereken bir senaryoyu düşünün:

public class User
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

public class UserDTO
{
    public string FullName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<User, UserDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.FirstName + " " + src.LastName));
});
IMapper mapper = config.CreateMapper();
User user = new User { FirstName = "John", LastName = "Doe", Address = "123 Street", City = "CityName" };
UserDTO userDto = mapper.Map<UserDTO>(user);

public class User
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

public class UserDTO
{
    public string FullName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<User, UserDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.FirstName + " " + src.LastName));
});
IMapper mapper = config.CreateMapper();
User user = new User { FirstName = "John", LastName = "Doe", Address = "123 Street", City = "CityName" };
UserDTO userDto = mapper.Map<UserDTO>(user);

Public Class User
	Public Property FirstName() As String
	Public Property LastName() As String
	Public Property Address() As String
	Public Property City() As String
End Class

Public Class UserDTO
	Public Property FullName() As String
	Public Property Address() As String
	Public Property City() As String
End Class

' Mapping Configuration
Private config = New MapperConfiguration(Sub(cfg)
	cfg.CreateMap(Of User, UserDTO)().ForMember(Function(dest) dest.FullName, Function(opt) opt.MapFrom(Function(src) src.FirstName & " " & src.LastName))
End Sub)
Private mapper As IMapper = config.CreateMapper()
Private user As New User With {
	.FirstName = "John",
	.LastName = "Doe",
	.Address = "123 Street",
	.City = "CityName"
}
Private userDto As UserDTO = mapper.Map(Of UserDTO)(user)

• Bu örnek, User ile UserDTO arasındaki eşlemeyi göstermektedir, burada UserDTO'deki FullName, User'den FirstName ve LastName'nin bir birleşimidir.

Örnek 2: Karmaşık Nesnelerle İleri Düzey Eşleme

Daha karmaşık bir senaryoda, sipariş nesnesini yerleşik kullanıcı detayları ile basitleştirilmiş bir sipariş DTO'suna haritalayalım:

public class Order
{
    public User OrderedBy { get; set; }
    // Other properties...
}

public class OrderDTO
{
    public string FullName { get; set; }
    // Other properties...
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Order, OrderDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.OrderedBy.FirstName + " " + src.OrderedBy.LastName));
});
IMapper mapper = config.CreateMapper();
Order order = new Order { OrderedBy = new User { FirstName = "Jane", LastName = "Doe" } };
OrderDTO orderDto = mapper.Map<OrderDTO>(order);

public class Order
{
    public User OrderedBy { get; set; }
    // Other properties...
}

public class OrderDTO
{
    public string FullName { get; set; }
    // Other properties...
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Order, OrderDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.OrderedBy.FirstName + " " + src.OrderedBy.LastName));
});
IMapper mapper = config.CreateMapper();
Order order = new Order { OrderedBy = new User { FirstName = "Jane", LastName = "Doe" } };
OrderDTO orderDto = mapper.Map<OrderDTO>(order);

Public Class Order
	Public Property OrderedBy() As User
	' Other properties...
End Class

Public Class OrderDTO
	Public Property FullName() As String
	' Other properties...
End Class

' Mapping Configuration
Private config = New MapperConfiguration(Sub(cfg)
	cfg.CreateMap(Of Order, OrderDTO)().ForMember(Function(dest) dest.FullName, Function(opt) opt.MapFrom(Function(src) src.OrderedBy.FirstName & " " & src.OrderedBy.LastName))
End Sub)
Private mapper As IMapper = config.CreateMapper()
Private order As New Order With {
	.OrderedBy = New User With {
		.FirstName = "Jane",
		.LastName = "Doe"
	}
}
Private orderDto As OrderDTO = mapper.Map(Of OrderDTO)(order)

• Bu örnek, iç içe geçmiş OrderedBy detaylarını içeren bir Order nesnesinden düz bir OrderDTO'ye eşlemeyi, kullanıcı adlarını tek bir FullName özelliğinde çıkarmayı ve birleştirmeyi göstermektedir.

Sürüm 9.0 ile AutoMapper, statik bir API'den (Mapper.Initialize) örnek tabanlı bir API'ye geçmiştir. Bu değişiklik, esnekliği artırır ve özellikle bağımlılık enjeksiyonu kullanan modern uygulamalar için daha uygundur. 9.0 öncesi sürümlerle çalışıyorsanız, sabit API yaklaşımı geçerlidir. Ancak, daha yeni sürümler için, yukarıda belirtilen örneklerdeki gibi örnek tabanlı API'yi benimsemeniz tavsiye edilir.

Iron Software Suite'in Temel Bileşenleri

1. IronPDF for PDF Yönetimi: Bu bileşen, geliştiricilerin PDF'leri oluşturmasına, okumasına, düzenlemesine ve imzalamasına olanak tanır. Ayrıca, HTML'yi PDF'ye dönüştürme yeteneği sunar, web tabanlı verilerden rapor veya dokümantasyon üretmede özellikle yararlıdır.

2. IronXL Excel Dosya Yönetimi: IronXL, Office Interop'a ihtiyaç duymadan Excel dosyalarıyla çalışma kolaylığı sağlar, veri manipülasyonu ve analiz görevlerini kolaylaştırır.

3. IronOCR Metin Çıkarma: Görüntülerden metin çıkarmaya olanak tanır, uluslararası projeler için yüksek derecede uygun hale getirerek 125 dilde destekler.

4. IronBarcode QR ve Barkod Desteği: Envanter yönetimi, izleme ve ilgili diğer görevler için yetenekleri artıran, QR kodları ve barkodları okuma ve yazma kütüphanesidir.

Automapper ile Tamamlayıcılık

Her ne kadar Automapper, C# içinde farklı nesne modelleri arasında özellik eşlemelerinde başarılı olsa da, Iron Software'in Kütüphaneleri çeşitli veri formatları ve tipleriyle başa çıkmak için araçlar sunarak işlevselliği genişletmektedir. Örneğin, bir kullanıcı alan nesnesini bir DTO'ya dönüştürmek için Automapper'ı kullandıktan sonra, IronPDF kapsamlı bir raporu PDF formatında üretmek için kullanılabilir. Benzer şekilde, Automapper kullanılarak çıkarılan veya dönüştürülen veriler, Excel dosya işlemleri için IronXL kullanılarak daha da manipüle edilebilir veya analiz edilebilir.