Levge.Exceptions 2.2.0

Levge.Exceptions

Levge projelerinde kullanılmak üzere özel exception tiplerini içeren bir pakettir. HTTP semantiğine uygun, tutarlı ve anlamlı hata yönetimi sağlar.

Kurulum

dotnet add package Levge.Exceptions

Exception Listesi

Kullanım

Base — LevgeException

Tüm Levge exception'larının türevidir. StatusCode ve ErrorCode property'lerini taşır.

throw new LevgeException(500, "Beklenmeyen bir hata oluştu.", "INTERNAL_ERROR");

// StatusCode ve ErrorCode okuma
catch (LevgeException ex)
{
    Console.WriteLine(ex.StatusCode);  // 500
    Console.WriteLine(ex.ErrorCode);   // "INTERNAL_ERROR"
}

HTTP — NotFoundException

throw new LevgeNotFoundException("Kullanıcı bulunamadı.");

// Alan adıyla birlikte
throw new LevgeNotFoundException("UserId", "Kullanıcı bulunamadı.");

HTTP — UnauthorizedException

throw new LevgeUnauthorizedException();
// veya
throw new LevgeUnauthorizedException("Oturumunuz sona erdi.");

HTTP — ForbiddenException

throw new LevgeForbiddenException();
// veya
throw new LevgeForbiddenException("Bu kaynağa erişim yetkiniz yok.");

HTTP — ConflictException

throw new LevgeConflictException("Bu kayıt zaten mevcut.");

// Alan adıyla birlikte
throw new LevgeConflictException("Email", "Bu e-posta adresi zaten kullanılıyor.");

HTTP — BadRequestException

throw new LevgeBadRequestException("Gönderilen istek geçersiz.");

Validation — ValidationException

// Tek alan
throw new LevgeValidationException("Email", "Geçerli bir e-posta adresi giriniz.");

// Çoklu alan (FluentValidation entegrasyonu)
var errors = new Dictionary<string, string[]>
{
    { "Email", ["E-posta zorunludur.", "Geçersiz format."] },
    { "Password", ["Şifre en az 8 karakter olmalıdır."] }
};
throw new LevgeValidationException(errors);

// Errors dictionary'sine erişim
catch (LevgeValidationException ex)
{
    foreach (var (field, messages) in ex.Errors)
        Console.WriteLine($"{field}: {string.Join(", ", messages)}");
}

Domain — BusinessRuleException

throw new LevgeBusinessRuleException("Bakiye yetersiz.");

// Özel kural koduyla
throw new LevgeBusinessRuleException("INSUFFICIENT_BALANCE", "Bakiye yetersiz.");

// RuleCode okuma
catch (LevgeBusinessRuleException ex)
{
    Console.WriteLine(ex.RuleCode); // "INSUFFICIENT_BALANCE"
}

Domain — TenantException

// Tenant bulunamadı (400)
throw new LevgeTenantException("Tenant bulunamadı.");

// Tenant erişimi reddedildi (403) — static factory
throw LevgeTenantException.AccessDenied();
throw LevgeTenantException.AccessDenied("Bu tenant'a erişim izniniz yok.");

Domain — LicenseException

// Lisans geçersiz (403)
throw new LevgeLicenseException("Lisansınız geçersiz veya süresi dolmuş.");

// Özel hata koduyla
throw new LevgeLicenseException("LICENSE_EXPIRED", "Lisans süresi dolmuş.");

// Cihaz limiti aşıldı — static factory
throw LevgeLicenseException.DeviceLimitExceeded();
throw LevgeLicenseException.DeviceLimitExceeded("Maksimum cihaz limitine ulaştınız.");

Teknik — ExternalServiceException

throw new LevgeExternalServiceException("Stripe", "Ödeme servisi yanıt vermedi.");

// InnerException ile
catch (HttpRequestException ex)
{
    throw new LevgeExternalServiceException("Iyzico", "Ödeme işlemi başarısız.", ex);
}

// ServiceName okuma
catch (LevgeExternalServiceException ex)
{
    Console.WriteLine(ex.ServiceName); // "Stripe"
}

Global Exception Handler ile Kullanım

Bu exception'lar, Levge.ConsistentResponse paketindeki GlobalExceptionMiddleware ile otomatik olarak yakalanıp StatusCode değerine göre HTTP yanıtlarına dönüştürülür.

Hedef Framework

net8.0 ve net9.0 desteklenir.

Lisans

MIT