MERSELSDK.Caching 0.1.0-preview.20260710002836

MERSELSDK.Caching

Genel Bakış

MERSELSDK.Caching modülü, .NET uygulamaları için esnek ve genişletilebilir bir önbellekleme (caching) altyapısı sunar. Hem dağıtık (Redis gibi) hem de bellek içi (in-memory) önbellek desteği sağlar. Modül, kolayca entegre edilebilen arayüzler ve servisler ile önbellek yönetimini standartlaştırır.

Özellikler

• Dağıtık önbellek (Redis) ve bellek içi önbellek desteği
• ICacheService arayüzü ile soyutlama
• Kolay DI (Dependency Injection) entegrasyonu
• Özelleştirilebilir önbellek anahtarı ve yaşam süresi yönetimi
• Gelişmiş get/set ve get-or-create fonksiyonları
• .NET IDistributedCache ve IMemoryCache ile uyumlu

Kurulum

NuGet üzerinden ekleyin:

dotnet add package MERSELSDK.Caching

Konfigürasyon

Redis Dağıtık Önbellek

appsettings.json dosyanıza aşağıdaki bölümü ekleyin:

{
  "DistributedCache": {
    "Configuration": "localhost:6379",
    "InstanceName": "myapp_cache_"
  }
}

Kullanım

Servislerin Kaydı

Program.cs dosyanızda aşağıdaki gibi servisleri kaydedin:

using Microsoft.Extensions.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);

// Redis ile dağıtık önbellek
builder.Services.AddRedisDistributedCache(options =>
{
    options.Configuration = builder.Configuration["DistributedCache:Configuration"];
    options.InstanceName = builder.Configuration["DistributedCache:InstanceName"];
});

// veya sadece bellek içi önbellek
builder.Services.AddInMemoryCacheService();

Temel Kullanım

ICacheService arayüzünü kullanarak önbelleğe veri ekleyebilir, okuyabilir veya get-or-create mantığıyla çalışabilirsiniz:

using MERSELSDK.Caching.Interfaces;

public class SampleService
{
    private readonly ICacheService _cacheService;

    public SampleService(ICacheService cacheService)
    {
        _cacheService = cacheService;
    }

    public async Task<string> GetOrSetExampleAsync()
    {
        var cacheKey = "sample_key";
        var value = await _cacheService.GetOrCreateAsync(
            cacheKey,
            async () => await GetDataFromSourceAsync(),
            new DistributedCacheEntryOptions { SlidingExpiration = TimeSpan.FromMinutes(5) }
        );
        return value;
    }
}

Gelişmiş Kullanım: CacheEntry ile

Kendi CacheEntry tipinizi türeterek anahtar ve yaşam süresi yönetimini merkezi hale getirebilirsiniz:

using MERSELSDK.Caching;

public class UserCacheEntry : CacheEntry
{
    public override string CacheKey => $"user_{UserId}";
    protected override string Template => "user_{UserId}";
    public string UserId { get; set; }

    public override DistributedCacheEntryOptions GetCacheEntryOptions()
    {
        return new DistributedCacheEntryOptions
        {
            AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(10)
        };
    }
}

Ana Sınıflar ve Arayüzler

• ICacheService: Temel önbellek işlemleri için arayüz.
• DistributedCacheService: Redis gibi dağıtık önbellek implementasyonu.
• InMemoryCacheService: Bellek içi önbellek implementasyonu.
• CacheEntry: Anahtar ve yaşam süresi yönetimi için soyut sınıf.
• DistributedCacheOptions: Dağıtık önbellek yapılandırma seçenekleri.

Katkıda Bulunma

Katkı sağlamak için issue veya pull request açabilirsiniz.

Lisans

MIT Lisansı ile lisanslanmıştır.