C# İle Entity Framework Kullanarak Veri Taşıma Nesnesi Nasıl Yapılır?

Ön Hazırlık ve Gereksinimler

Uygulamaya başlamadan önce sisteminizde en güncel .NET 9 veya 10 SDK'sının yüklü olduğundan emin olun. Ayrıca, Entity Framework Core kütüphanesinin projenize dahil edilmiş olması gerekmektedir. İhtiyacınız olan temel araçlar şunlardır:

• Visual Studio 2022 veya güncel bir IDE (JetBrains Rider gibi).
• Entity Framework Core NuGet paketi.
• SQL Server veya PostgreSQL gibi bir veritabanı sağlayıcısı.

Projenize EF Core paketini eklemek için terminal üzerinden şu komutu çalıştırabilirsiniz:

dotnet add package Microsoft.EntityFrameworkCore.SqlServer

Bu paket, veritabanı ile olan iletişiminizde temel katmanı oluşturacaktır. Ayrıca, veritabanı işlemlerini kolaylaştırmak için Microsoft.EntityFrameworkCore.Tools paketini de projenize eklemeniz önerilir.

Veritabanı Modeli ile DTO Arasındaki Fark

Veritabanı modeli (Entity), veritabanındaki tabloları temsil eder ve genellikle hassas veriler (şifre hashleri, iç sistem alanları) içerir. DTO ise sadece istemciye gönderilmek istenen verileri taşır. Aşağıdaki tabloda bu iki yapının temel farklarını görebilirsiniz.

Adım 1: Temel Entity Sınıfını Tanımlama

İlk adım olarak veritabanında karşılığı olan ana sınıfımızı tanımlayalım. Bu sınıf, Entity Framework aracılığıyla veritabanı tablosuna yansıtılacaktır. Güvenlik nedeniyle bu sınıfı doğrudan API yanıtlarında kullanmamalısınız.

public class User
{
    public int Id { get; set; }
    public string Username { get; set; }
    public string PasswordHash { get; set; } // Asla dışarıya açılmamalı
    public string Email { get; set; }
    public DateTime CreatedAt { get; set; }
}

Yukarıdaki modelde PasswordHash alanı bulunmaktadır. Eğer bu nesneyi doğrudan API üzerinden dönerseniz, kullanıcı şifrelerinin hash'lenmiş halleri dış dünyaya açık hale gelir.

Adım 2: Veri Taşıma Nesnesini (DTO) Oluşturma

Şimdi, sadece istemciye göstermek istediğimiz alanları içeren UserDto sınıfını oluşturalım. Bu sınıf, veritabanı ile doğrudan bir ilişkisi olmayan, sadece veri taşıma amaçlı bir sınıftır.

public class UserDto
{
    public string Username { get; set; }
    public string Email { get; set; }
}

Bu sınıfı kullanarak, veritabanından gelen User nesnesini dış dünyaya güvenli bir şekilde sunabiliriz. DTO'lar genellikle records (C# 9.0+) olarak tanımlanır, çünkü genellikle değişmez (immutable) olmaları tercih edilir.

Adım 3: Verileri DTO'ya Dönüştürme (Mapping)

Veritabanından gelen veriyi DTO'ya dönüştürmek için manuel bir yöntem kullanabilir veya AutoMapper gibi kütüphanelerden faydalanabilirsiniz. Manuel dönüşüm, performans açısından daha şeffaf ve kontrol edilebilirdir.

public UserDto MapToDto(User user)
{
    return new UserDto
    {
        Username = user.Username,
        Email = user.Email
    };
}

Bu metot, User nesnesini alır ve sadece gerekli alanları içeren UserDto nesnesine dönüştürür. Bu sayede PasswordHash gibi veriler asla dışarıya çıkmaz.

Adım 4: Entity Framework ile Sorgulama ve Dönüşüm

EF Core kullanarak veritabanından veri çekerken, LINQ sorgusu içerisinde doğrudan dönüşüm yapmak performansı artırır. Select ifadesi ile sadece gerekli sütunları çekerek veritabanı yükünü de azaltabilirsiniz.

public async Task GetUsersAsync(MyDbContext context)
{
    return await context.Users
        .Select(u => new UserDto
        {
            Username = u.Username,
            Email = u.Email
        })
        .ToListAsync();
}

Bu yaklaşım, SQL tarafında SELECT Username, Email FROM Users sorgusunun çalışmasını sağlar. Gereksiz verilerin veritabanından uygulama katmanına taşınmasını engeller.

Kritik Güvenlik Uyarıları

Dikkat: DTO kullanımı, "Over-posting" (aşırı veri gönderme) saldırılarını önlemek için de kritiktir. Kullanıcıdan veri alırken (POST/PUT işlemleri), veritabanı modelini doğrudan kullanmak yerine mutlaka bir "Input DTO" tanımlayın. Böylece kullanıcı, veritabanındaki IsAdmin veya Balance gibi kritik alanları manipüle edemez.

Sıkça Sorulan Sorular

DTO kullanmak performansı düşürür mü?

Doğru uygulandığında (özellikle Select ifadesi ile sorgu anında dönüşüm yapıldığında) performansı düşürmez, aksine veritabanından çekilen veri miktarını azalttığı için performansı artırır.

Her tablo için ayrı bir DTO mu oluşturmalıyım?

Evet, her iş mantığı (use-case) için özel DTO'lar oluşturmak, uygulamanın esnekliğini ve güvenliğini artırır. Bir tabloyu farklı amaçlarla farklı DTO'lar üzerinden sunabilirsiniz.

AutoMapper kullanmak zorunlu mu?

Hayır, zorunlu değildir. Küçük projelerde manuel dönüşüm (yukarıdaki örnekteki gibi) daha okunabilir ve hata ayıklaması daha kolaydır. Büyük projelerde ise AutoMapper gibi kütüphaneler kod tekrarını azaltır.

Record tipi neden tercih edilir?

C# record tipleri, veri taşıma nesneleri için biçilmiş kaftandır. Varsayılan olarak değişmez (immutable) oldukları için çok kanallı (multi-threaded) uygulamalarda güvenlidirler.

DTO'lar veritabanı ile nasıl ilişkilendirilir?

DTO'lar veritabanı ile doğrudan ilişkilendirilmez. Onlar sadece uygulamanın katmanları arasındaki veri taşıyıcılarıdır. İlişkilendirme, dönüşüm (mapping) katmanında yapılır.

DTO'larda Performans Optimizasyonu ve Projeksiyon Teknikleri

DTO kullanımı sırasında yapılan en yaygın hata, veritabanından tüm nesneyi çekip ardından bellekte DTO'ya dönüştürmektir. Bu durum, özellikle geniş tablolarda ve yüksek trafikli uygulamalarda ciddi bellek yükü oluşturur. Bunun yerine, Entity Framework'ün Select operatörü ile doğrudan veritabanı seviyesinde projeksiyon (projection) yapmak, sadece ihtiyaç duyulan sütunların SQL sorgusuna dahil edilmesini sağlar.

// Yanlış: Tüm veriyi çekip bellekte dönüştürmek
var users = _context.Users.ToList();
var dtos = users.Select(u => new UserDto { Name = u.Name }).ToList();

// Doğru: Veritabanı seviyesinde projeksiyon (Sadece Name kolonu çekilir)
var dtos = _context.Users
    .Select(u => new UserDto { 
        Name = u.Name 
    })
    .ToList();

Bu yöntem, SELECT * yerine SELECT Name sorgusunun çalışmasını tetikleyerek ağ trafiğini ve veritabanı yükünü minimize eder. Büyük ölçekli listelemelerde bu teknik, uygulamanızın yanıt süresini milisaniyeler seviyesinde iyileştirebilir.

DTO Katmanında Hata Ayıklama (Debugging) ve İzleme

DTO dönüşümleri sırasında oluşan hataları tespit etmek, özellikle karmaşık nesne hiyerarşilerinde zorlayıcı olabilir. Dönüşüm sırasında verilerin kaybolup kaybolmadığını veya yanlış eşleşip eşleşmediğini anlamak için şu stratejileri izleyebilirsiniz:

• Data Annotations Kontrolü: DTO sınıflarınızdaki [Required] veya [StringLength] gibi özniteliklerin, veritabanı kısıtlamalarıyla çakışıp çakışmadığını kontrol edin.
• Mapping Testleri: Her DTO dönüşümü için küçük bir birim testi yazarak, kaynak nesnedeki değerin hedef DTO'ya doğru aktarıldığını doğrulayın.
• EF Core Logging: EF Core tarafından üretilen SQL sorgularını izleyerek, DTO'ya aktarılan verinin veritabanından doğru şekilde gelip gelmediğini gözlemleyin.

// EF Core sorgularını konsolda izlemek için basit bir yapılandırma
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .LogTo(Console.WriteLine, LogLevel.Information)
        .EnableSensitiveDataLogging();
}

Hata ayıklama sürecinde, DTO'nun boş (null) dönme ihtimaline karşı her zaman null-coalescing operatörlerini veya varsayılan değer atamalarını kullanmanız önerilir. Bu, API uç noktalarınızın beklenmedik 500 hataları vermesini engeller ve istemci tarafında daha tutarlı bir kullanıcı deneyimi sağlar.

Profesyonel İpucu: DTO'larınızı tasarlarken "Single Responsibility" (Tek Sorumluluk) prensibine sadık kalın. Bir DTO, sadece bir ekranın veya bir API metodunun ihtiyaç duyduğu veriyi taşımalıdır. Gereğinden fazla veri içeren "God DTO" yapılarından kaçınmak, bakım maliyetlerinizi düşürecektir.

Sonuç

Entity Framework kullanarak veri taşıma nesnesi (DTO) oluşturmak, profesyonel bir C# geliştiricisinin sahip olması gereken en temel yetkinliklerden biridir. Bu yöntem, uygulamanızı veritabanı şeması değişikliklerinden korur, güvenliği artırır ve API'larınızın daha temiz bir arayüze sahip olmasını sağlar. Bir sonraki adım olarak, projenize FluentValidation kütüphanesini ekleyerek DTO'larınızın içeriklerini nasıl doğrulayacağınızı (validation) araştırmanızı öneririm.

Yasal Uyarı: Bu rehberdeki kod örnekleri eğitim amaçlıdır. Üretim ortamında (production) kullanmadan önce mutlaka birim testleri (unit tests) yazmalı ve veri doğrulama (validation) süreçlerini tamamlamalısınız. Hatalı veri girişi veya yetersiz doğrulama, uygulama güvenliğini tehlikeye atabilir.