C# İle Modüler Yapıda Bir İndirme Yöneticisi Nasıl Yapılır?

Gereksinimler ve Ön Hazırlık

Projeye başlamadan önce geliştirme ortamınızın güncel olduğundan emin olmalısınız. .NET 9 veya üzeri bir sürüm, modern asenkron yapıları en verimli şekilde kullanmanıza olanak tanır.

• SDK: .NET 9.0 SDK veya daha güncel bir sürüm.
• IDE: Visual Studio 2022 (v17.12+) veya Visual Studio Code.
• Kütüphaneler: System.Net.Http (HTTP istekleri için), System.IO (dosya işlemleri için).

Projenizi oluşturmak için terminal üzerinden dotnet new console -n IndirmeYoneticisi komutunu kullanabilirsiniz. Bu yapı, modülerlik için gerekli olan servis odaklı mimariye temel oluşturacaktır.

Modüler Mimariyi Tasarlama

Modüler bir yapı kurmak, kodun bakımı ve test edilebilirliği için hayati önem taşır. İndirme yöneticimizi üç ana katmana ayıracağız: İndirme motoru (Core), Durum yönetimi (State Management) ve Kullanıcı arayüzü/Konsol katmanı.

Aşağıdaki kod örneği, indirme işlemini temsil eden temel arayüzümüzü (Interface) tanımlar. Bu arayüz, farklı indirme stratejileri (HTTP, FTP, P2P) için esneklik sağlar.

public interface IDownloadTask
{
    string Url { get; }
    string DestinationPath { get; }
    Task StartAsync(CancellationToken token);
    event EventHandler ProgressChanged;
}

Bu arayüz, her indirme görevinin aynı sözleşmeye (contract) uymasını garanti eder. Böylece ana yöneticimiz, görevin iç yapısını bilmeden onu başlatabilir veya durdurabilir.

HTTP İndirme Motorunu Adım Adım Oluşturma

İndirme işleminin kalbi, HttpClient sınıfıdır. Ancak büyük dosyalar için tüm içeriği RAM'e yüklemek yerine, akış (stream) tabanlı bir yaklaşım benimsemeliyiz. Bu, bellek sızıntılarını önler ve uygulamanın kararlılığını artırır.

public class HttpDownloadTask : IDownloadTask
{
    private readonly HttpClient _httpClient;
    public string Url { get; }
    public string DestinationPath { get; }

    public HttpDownloadTask(string url, string destinationPath, HttpClient httpClient)
    {
        Url = url;
        DestinationPath = destinationPath;
        _httpClient = httpClient;
    }

    public async Task StartAsync(CancellationToken token)
    {
        using var response = await _httpClient.GetAsync(Url, HttpCompletionOption.ResponseHeadersRead, token);
        response.EnsureSuccessStatusCode();

        using var contentStream = await response.Content.ReadAsStreamAsync(token);
        using var fileStream = new FileStream(DestinationPath, FileMode.Create, FileAccess.Write, FileShare.None, 8192, true);
        
        await contentStream.CopyToAsync(fileStream, token);
    }
}

Bu kodda HttpCompletionOption.ResponseHeadersRead kullanımı kritiktir. Bu parametre, tüm dosyanın indirilmesini beklemeden başlıkları okumamızı sağlar, böylece indirme işlemi anında başlar.

İndirme İlerlemesini Takip Etme ve Raporlama

Kullanıcı deneyimi için indirme yüzdesini göstermek önemlidir. CopyToAsync metodu, varsayılan olarak ilerleme bildirimi yapmaz. Bu yüzden bir tampon (buffer) kullanarak akışı manuel yönetmeliyiz.

public async Task DownloadWithProgressAsync(Stream source, Stream destination, long totalBytes, CancellationToken token)
{
    var buffer = new byte[8192];
    long totalRead = 0;
    int read;

    while ((read = await source.ReadAsync(buffer, token)) > 0)
    {
        await destination.WriteAsync(buffer.AsMemory(0, read), token);
        totalRead += read;
        double progress = (double)totalRead / totalBytes * 100;
        ProgressChanged?.Invoke(this, progress);
    }
}

Bu yöntem, her veri bloğu yazıldığında ProgressChanged olayını tetikler. Bu sayede UI veya konsol ekranı, %0'dan %100'e kadar olan süreci anlık güncelleyebilir.

İndirme Yöneticisinde Hata Yönetimi ve Güvenlik

İndirme yöneticileri ağ hatalarına karşı savunmasızdır. Bağlantı kopması durumunda yeniden deneme (retry) mekanizması eklemek, uygulamanızı profesyonel seviyeye taşır. Ayrıca, dosya yollarını doğrulamak (path validation) güvenlik açısından zorunludur.

Güvenlik Uyarısı: Kullanıcıdan alınan URL'leri asla doğrudan sistem komutlarında çalıştırmayın. Dosya yollarını Path.GetInvalidFileNameChars() ile filtreleyerek Path Traversal saldırılarını engelleyin.

Aşağıdaki örnek, basit bir yeniden deneme mantığını gösterir:

public async Task ExecuteWithRetryAsync(Func action, int retryCount = 3)
{
    for (int i = 0; i < retryCount; i++)
    {
        try
        {
            await action();
            return;
        }
        catch (HttpRequestException) when (i < retryCount - 1)
        {
            await Task.Delay(2000); // 2 saniye bekle ve tekrar dene
        }
    }
}

Karşılaştırma: İndirme Yöntemleri

Sıkça Sorulan Sorular

İndirme yöneticim neden büyük dosyalarda hata veriyor?

Büyük dosyalar genellikle zaman aşımına (timeout) uğrar veya bellek sınırlarını zorlar. HttpClient örneğinizi tek bir yerde tanımlayıp (Singleton pattern) yeniden kullanın ve akış tabanlı (stream-based) okuma yapın.

İndirmeyi nasıl durdurabilirim?

CancellationTokenSource sınıfını kullanın. İndirme görevine bir CancellationToken gönderdiğinizde, Cancel() metodunu çağırdığınız anda tüm asenkron işlemler güvenli bir şekilde sonlandırılır.

Çoklu indirme desteğini nasıl eklerim?

Bir List yapısı kurun ve Task.WhenAll() kullanarak tüm görevleri eş zamanlı olarak başlatın. Ancak, ağ bant genişliğini korumak için semafor (SemaphoreSlim) kullanarak aynı anda maksimum 3-4 dosya indirilmesini sağlayın.

Dosya bütünlüğünü nasıl doğrularım?

İndirme tamamlandıktan sonra dosyanın MD5 veya SHA256 özetini (hash) hesaplayın ve sunucudaki değerle karşılaştırın.

Neden HttpClient kullanmalıyım?

HttpClient, .NET ekosisteminde HTTP istekleri için standarttır, asenkron yapıyı tam destekler ve bağlantı havuzlama (connection pooling) sayesinde yüksek performans sunar.

İndirme Yöneticisi İçin Birim Testleri ve Kalite Güvencesi

Modüler bir indirme yöneticisi geliştirdiğinizde, sistemin farklı ağ koşullarında nasıl tepki verdiğini doğrulamak kritik öneme sahiptir. Özellikle HttpClient üzerinden gelen yanıtların kesilmesi veya geçersiz içerik türleri gibi senaryoları test etmek için xUnit ve Moq kütüphanelerini kullanabilirsiniz. Aşağıdaki örnek, bir indirme işleminin başarı durumunu simüle eden temel bir test yapısını göstermektedir.

public class DownloadManagerTests
{
    [Fact]
    public async Task DownloadFile_ValidUrl_ReturnsSuccess()
    {
        // Arrange
        var downloader = new DownloadEngine();
        var testUrl = "https://example.com/testfile.zip";
        
        // Act
        var result = await downloader.DownloadAsync(testUrl, "test.zip");
        
        // Assert
        Assert.True(result.IsSuccess);
    }
}

İleri Seviye Optimizasyon: Paralel İndirme ve Chunking

Büyük dosyaları tek bir akış üzerinden indirmek yerine, dosyayı parçalara (chunks) bölerek eşzamanlı indirmek, bant genişliği kullanımını maksimize eder. Bu yöntemde Range HTTP başlığı kullanılır. Sunucu desteklediği sürece, dosyanın belirli bayt aralıklarını talep ederek indirme hızını önemli ölçüde artırabilirsiniz.

HTTP Range Başlığı ile Parçalı İndirme

Aşağıdaki kod parçası, bir dosyanın belirli bir aralığını nasıl talep edeceğinizi gösterir:

public async Task DownloadRangeAsync(string url, string path, long start, long end)
{
    using var client = new HttpClient();
    var request = new HttpRequestMessage(HttpMethod.Get, url);
    request.Headers.Range = new System.Net.Http.Headers.RangeHeaderValue(start, end);
    
    using var response = await client.SendAsync(request, HttpCompletionOption.ResponseHeadersRead);
    using var stream = await response.Content.ReadAsStreamAsync();
    using var fileStream = new FileStream(path, FileMode.OpenOrCreate, FileAccess.Write);
    
    fileStream.Position = start;
    await stream.CopyToAsync(fileStream);
}

Performans İpuçları

• Buffer Boyutu: CopyToAsync metodunda kullanılan tampon boyutunu (buffer size) 81920 bayt (80KB) civarında tutmak, bellek kullanımı ile hız arasında en iyi dengeyi sağlar.
• Bağlantı Havuzu: HttpClient nesnesini static veya Singleton olarak tanımlayarak SocketException hatalarının önüne geçin.
• İptal Belirteçleri: CancellationTokenSource kullanarak kullanıcının indirmeyi anlık olarak durdurabilmesini sağlayın; bu, kaynak sızıntılarını önler.

Dağıtım ve Hata Ayıklama Stratejileri

Uygulamanızı dağıtmadan önce, özellikle dosya sistemi izinleri ve ağ kısıtlamaları üzerinde durmalısınız. Windows ortamında Program Files dizinine yazmaya çalışmak genellikle yetki hatasına yol açar. Bu nedenle, kullanıcı verilerini Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData) dizininde saklamak en güvenli yaklaşımdır.

Not: Uygulamanızın üretim ortamında hata ayıklamasını kolaylaştırmak için Serilog veya NLog gibi bir kütüphane kullanarak indirme hatalarını ve ağ kopmalarını log dosyalarına kaydedin. Bu, kullanıcıdan gelen "indirme hata veriyor" şikayetlerini analiz etmenizi kolaylaştıracaktır.

Sonuç

C# ile modüler bir indirme yöneticisi oluşturmak, yazılım mimarisi yeteneklerinizi geliştiren harika bir pratik çalışmasıdır. Bu rehberde, bir indirme işleminin temelinden başlayarak, hata yönetimi ve ilerleme takibi gibi kritik bileşenleri ele aldık. Bir sonraki adım olarak, indirme işlemlerini bir veritabanında (SQLite gibi) saklayarak, uygulama kapansa bile indirmelerin kaldığı yerden devam etmesini sağlayan bir "Persistence" (kalıcılık) katmanı ekleyebilirsiniz.

Sorumluluk Reddi: Bu makaledeki kod örnekleri eğitim amaçlıdır. Üretim ortamında kullanmadan önce tüm girdi doğrulamalarını, hata yakalama mekanizmalarını ve güvenlik testlerini (özellikle dosya sistemi erişim izinleri) detaylıca gözden geçirmeniz gerekmektedir.