JetMapper 1.0.0

🚀 JetMapper — Simple. Fast. Powerful.

AutoMapper'a alternatif olarak tasarlanmış minimal, sezgisel ve ultra-hızlı .NET object mapper.

JetMapper, AutoMapper'dan 2-4 kat daha hızlı çalışır ve %500+ daha az bellek kullanır. Karmaşık konfigürasyonlar olmadan, tek satırda mapping yapabilirsiniz.

⚡ Performance Comparison

🏆 JetMapper vs AutoMapper vs Mapster

🧠 Memory Optimization

🎯 Features

• ⚡ Ultra-Fast: Expression tree compilation for maximum performance
• 🧠 Memory Optimized: 500%+ savings in complex mappings
• 🔒 Type Safe: Enhanced type compatibility checks
• 🚀 Low Allocation: Minimal memory usage
• 📦 Lightweight: Minimal dependencies
• 🔧 Easy to Use: Simple and intuitive API
• ✨ Fluent API: Builder pattern for custom mappings
  • Set() - Property value assignment
  • SetIf() - Conditional value assignment
  • SetFirstIfExist() - First available property assignment
  • Ignore() - Ignore sensitive properties
  • BeforeMap()/AfterMap() - Lifecycle hooks

📦 Installation

dotnet add package JetMapper

🚀 Quick Start

Basit Mapping (Tek Satır)

using JetMapper;

// Tek satırda mapping
var user = new User { FirstName = "Ahmet", LastName = "Yılmaz", Age = 25 };
var dto = user.FastMapTo<UserDto>();

// Collection mapping
var users = new[]
{
    new User { FirstName = "Ahmet", LastName = "Yılmaz", Age = 25 },
    new User { FirstName = "Ayşe", LastName = "Demir", Age = 30 },
    new User { FirstName = "Mehmet", LastName = "Kaya", Age = 28 }
};
var dtos = users.FastMapToList<User, UserDto>();

Mevcut Nesneye Mapping

// Mevcut nesneyi güncelle
var existingDto = new UserDto { FirstName = "Eski", LastName = "Değer" };
user.FastMapTo(existingDto);
// existingDto artık user'ın değerlerini içerir

✨ Fluent API — Gelişmiş Mapping

Basit Değer Ataması (Set)

public class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public DateTime BirthDate { get; set; }
}

public class PersonDto
{
    public string FullName { get; set; }
    public int Age { get; set; }
}

var person = new Person 
{ 
    FirstName = "Ayşe", 
    LastName = "Demir",
    BirthDate = new DateTime(1990, 5, 15)
};

var dto = person.Builder()
    .MapTo<PersonDto>()
    .Set(d => d.FullName, p => $"{p.FirstName} {p.LastName}")
    .Set(d => d.Age, p => DateTime.Now.Year - p.BirthDate.Year)
    .Create();

// Sonuç: FullName = "Ayşe Demir", Age = 35

Koşullu Atama (SetIf)

public class Account
{
    public decimal Balance { get; set; }
    public bool IsActive { get; set; }
    public bool IsPremium { get; set; }
}

public class AccountDto
{
    public string Status { get; set; }
    public string MembershipLevel { get; set; }
}

var account = new Account 
{ 
    Balance = 5000m, 
    IsActive = true,
    IsPremium = true
};

var dto = account.Builder()
    .MapTo<AccountDto>()
    .SetIf(d => d.Status, a => a.IsActive, a => "✅ Aktif")
    .SetIf(d => d.Status, a => !a.IsActive, a => "❌ Pasif")
    .SetIf(d => d.MembershipLevel, a => a.IsPremium, a => "⭐ Premium")
    .SetIf(d => d.MembershipLevel, a => !a.IsPremium, a => "👤 Standart")
    .Create();

// Sonuç: Status = "✅ Aktif", MembershipLevel = "⭐ Premium"

Öncelikli Atama (SetFirstIfExist)

public class Contact
{
    public string Email { get; set; }
    public string Phone { get; set; }
    public string Address { get; set; }
}

public class ContactDto
{
    public string PreferredContact { get; set; }
}

var contact = new Contact 
{ 
    Email = "ahmet@example.com",
    Phone = null,
    Address = "İstanbul"
};

var dto = contact.Builder()
    .MapTo<ContactDto>()
    .SetFirstIfExist(d => d.PreferredContact,
        (d => d.Email, c => $"📧 {c.Email}"),      // Önce email kontrolü
        (d => d.Phone, c => $"📱 {c.Phone}"),      // Sonra phone
        (d => d.Address, c => $"🏠 {c.Address}"))  // En son address
    .Create();

// Sonuç: PreferredContact = "📧 ahmet@example.com"

Hassas Verileri Gizleme (Ignore)

public class User
{
    public int Id { get; set; }
    public string Username { get; set; }
    public string Password { get; set; }  // Bu alanı gizleyeceğiz
    public string Email { get; set; }
}

public class UserDto
{
    public int Id { get; set; }
    public string Username { get; set; }
    public string Password { get; set; }
    public string Email { get; set; }
}

var user = new User 
{ 
    Id = 1,
    Username = "ahmet.yilmaz",
    Password = "gizli123",
    Email = "ahmet@example.com"
};

var dto = user.Builder()
    .MapTo<UserDto>()
    .Ignore(d => d.Password)  // Şifreyi DTO'ya kopyalama
    .Create();

// Sonuç: Password = null (ignore edildi)

Lifecycle Hooks (BeforeMap/AfterMap)

var dto = order.Builder()
    .MapTo<OrderDto>()
    .BeforeMap((src, dest) => 
    {
        Console.WriteLine($"📦 Sipariş #{src.OrderId} hazırlanıyor...");
        // Veri temizleme, doğrulama vb.
    })
    .Set(d => d.OrderNumber, o => $"#ORD-{o.OrderId}")
    .Set(d => d.TotalPrice, o => $"{(o.Amount + o.Tax):C}")
    .AfterMap((src, dest) => 
    {
        Console.WriteLine($"✅ Sipariş hazır!");
        // Loglama, bildirim gönderme vb.
    })
    .Create();

🎯 Gerçek Dünya Örneği: E-Ticaret Siparişi

public class OrderEntity
{
    public int Id { get; set; }
    public decimal Amount { get; set; }
    public decimal Tax { get; set; }
    public bool IsPaid { get; set; }
    public bool IsShipped { get; set; }
    public string CustomerEmail { get; set; }
    public string CustomerPhone { get; set; }
    public DateTime CreatedAt { get; set; }
}

public class OrderViewModel
{
    public string OrderNumber { get; set; }
    public string TotalPrice { get; set; }
    public string Status { get; set; }
    public string ContactInfo { get; set; }
    public string OrderAge { get; set; }
}

var order = new OrderEntity
{
    Id = 12345,
    Amount = 500m,
    Tax = 90m,
    IsPaid = true,
    IsShipped = false,
    CustomerEmail = "musteri@example.com",
    CustomerPhone = "555-1234",
    CreatedAt = DateTime.Now.AddDays(-2)
};

var viewModel = order.Builder()
    .MapTo<OrderViewModel>()
    .BeforeMap((src, dest) => 
        Console.WriteLine($"📦 Sipariş #{src.Id} hazırlanıyor..."))
    
    .Set(vm => vm.OrderNumber, o => $"#ORD-{o.Id}")
    .Set(vm => vm.TotalPrice, o => $"{(o.Amount + o.Tax):C}")
    
    .SetIf(vm => vm.Status, o => o.IsPaid && o.IsShipped, 
        o => "✅ Teslim Edildi")
    .SetIf(vm => vm.Status, o => o.IsPaid && !o.IsShipped, 
        o => "🚚 Kargoda")
    .SetIf(vm => vm.Status, o => !o.IsPaid, 
        o => "⏳ Ödeme Bekleniyor")
    
    .SetFirstIfExist(vm => vm.ContactInfo,
        (vm => vm.CustomerEmail, o => $"📧 {o.CustomerEmail}"),
        (vm => vm.CustomerPhone, o => $"📱 {o.CustomerPhone}"))
    
    .Set(vm => vm.OrderAge, o => 
    {
        var days = (DateTime.Now - o.CreatedAt).Days;
        return days == 0 ? "Bugün" : 
               days == 1 ? "Dün" : 
               $"{days} gün önce";
    })
    
    .AfterMap((src, dest) => 
        Console.WriteLine($"✅ Sipariş hazır!"))
    
    .Create();

// Sonuç:
// OrderNumber = "#ORD-12345"
// TotalPrice = "₺590.00"
// Status = "🚚 Kargoda"
// ContactInfo = "📧 musteri@example.com"
// OrderAge = "2 gün önce"

🔧 Type Converter ve Custom Mapping

// Type Converter (int -> string)
MapperExtensions.AddTypeConverter<int, string>(n => n.ToString());

// Custom mapping
MapperExtensions.AddCustomMapping<User, ReportDto>(
    "FirstName", "DisplayName",
    src => $"{((User)src).FirstName} {((User)src).LastName}"
);

var report = user.FastMapTo<ReportDto>();

⚡ Performance Notları

• 100,000 mapping ≈ 20–30ms Apple M2 (.NET 6) üzerinde
• Detaylı benchmark sonuçları: benchmarks/JetMapper.Benchmarks
• Gerçek zamanlı test: ExampleConsoleApp/Program.cs

🏆 Temel Bulgular

• Karmaşık Mapping: JetMapper AutoMapper'dan 2.76x, Mapster'dan 2.67x daha hızlı
• Mevcut Nesne Mapping: JetMapper AutoMapper'dan 2.60x, Mapster'dan 3.24x daha hızlı
• Toplu Mapping: JetMapper AutoMapper'dan 2.97x, Mapster'dan 3.53x daha hızlı
• Çalışan Mapping: JetMapper AutoMapper'dan 4.53x, Mapster'dan 4.38x daha hızlı
• Bellek Verimliliği: Karmaşık senaryolarda %500+ bellek tasarrufu
• Tip Güvenliği: Runtime hataları önlenir

🎯 API Özeti

💡 İpuçları

1. Set() kullanın - Basit değer atamaları için
2. SetIf() kullanın - Tek koşul varsa
3. SetFirstIfExist() kullanın - Öncelik sırasına göre atama yapacaksanız
4. Ignore() kullanın - Hassas verileri kopyalamamak için
5. BeforeMap/AfterMap - Loglama, validasyon için

🧩 Örnek Modeller

public class User 
{ 
    public string FirstName { get; set; } 
    public string LastName { get; set; } 
    public int Age { get; set; } 
}

public class UserDto 
{ 
    public string FirstName { get; set; } 
    public string LastName { get; set; } 
    public int Age { get; set; } 
    public string FullName { get; set; } 
}

public class ReportDto 
{ 
    public string DisplayName { get; set; } 
    public string Age { get; set; } 
}

🚀 Neden JetMapper?

✅ Avantajlar

• Hız: AutoMapper'dan 2-4 kat daha hızlı
• Bellek: %500+ daha az bellek kullanımı
• Basitlik: Karmaşık konfigürasyon yok
• Tip Güvenliği: Compile-time kontrol
• Minimal: Sadece gerekli bağımlılıklar
• Sezgisel: Okunabilir ve anlaşılır API

❌ AutoMapper Sorunları

• Yavaş performans
• Yüksek bellek kullanımı
• Karmaşık konfigürasyon
• Runtime hatalar
• Büyük bağımlılık listesi

📄 Lisans

MIT — LICENSE dosyasına bakın

🙏 Teşekkürler

• AutoMapper - Karşılaştırma için
• Mapster - Karşılaştırma için
• BenchmarkDotNet - Benchmark framework

JetMapper — Simple. Fast. Powerful. 🚀

AutoMapper'a veda edin, JetMapper'a hoş geldiniz!