MindResult 2.3.1

MindResult

MindResult kütüphanesi, işlemlerin sonucunu standart ve tip güvenli bir şekilde döndürmek için geliştirilmiş bir C# yapısıdır.
API response, servis sonuçları veya genel işlem çıktıları için kullanılabilir.

🚀 Kurulum

NuGet veya proje referansınız üzerinden ekledikten sonra, ASP.NET Core projelerinde DI ile kolayca yapılandırabilirsiniz:

// Varsayılan enum ile
services.AddMindResult();

// Kendi enum'unuzla
services.AddMindResult<ExtraFields>();

📍 Temel Sınıf Yapısı

• IsSuccess → İşlemin başarılı olup olmadığını gösterir (bool). Varsayılan: true.

• Message → Sonuç mesajı. Varsayılan: "OK".

• StatusCode → HTTP benzeri durum kodu. Varsayılan: 200.

• Data → Result<T> için döndürülen veri.

• AdditionalFields → Ek alanları tutar (enum tabanlı anahtarlar).

var result = new Result { IsSuccess = true, Message = "Başarılı" };
var resultWithData = new Result<string>("Merhaba Dünya");

📍 CreateResult Yardımcı Sınıfı

Kolay ve standart Result üretimi için:

// Başarılı sonuç
var okResult = CreateResult.Ok("İşlem başarılı");

// Başarısız sonuç
var failResult = CreateResult.Failure("Geçersiz istek", 400);

// Data ile başarılı sonuç
var user = new { Id = 1, Name = "Ali" };
var dataResult = CreateResult.Ok(user, "Kullanıcı bulundu");

// Data ile başarısız sonuç
var failDataResult = CreateResult.Failure<object>("Kullanıcı bulunamadı", 404);

Çıktı Formatı

// AdditionalFields yok
okResult.ToDictionary()
{
  "IsSuccess": true,
  "Message": "İşlem başarılı",
  "StatusCode": 200
}

failResult.ToDictionary()
{
  "IsSuccess": false,
  "Message": "Geçersiz istek",
  "StatusCode": 400
}

dataResult.ToDictionary()
{
  "IsSuccess": true,
  "Message": "Kullanıcı bulundu",
  "StatusCode": 200,
  "Data": { "Id": 1, "Name": "Ali" }
}

📍 Ek Alanlar (AdditionalFields) ve Fluent Kullanım

With extension metodu ile enum tabanlı ek alan ekleyebilirsiniz:

public enum ExtraFields
{
    ErrorCode,
    TraceId
}

// DI veya CreateResult.ConfigureKeys<ExtraFields>() ile enum yapılandırıldıysa:
var result = CreateResult.Failure("Hatalı veri", 422)
                         .With(ExtraFields.ErrorCode, "INVALID_INPUT")
                         .With(ExtraFields.TraceId, Guid.NewGuid().ToString());

Çıktı Formatı

{
  "IsSuccess": false,
  "Message": "Hatalı veri",
  "StatusCode": 422,
  "ErrorCode": "INVALID_INPUT",
  "TraceId": "550e8400-e29b-41d4-a716-446655440000"
}

📍 Özellikler

✅ Standartlaştırılmış dönüş yapısı

✅ Tip güvenliği (Result<T>)

✅ Ok ve Failure yardımcı metotları

✅ Fluent ek alan ekleme (With)

✅ Enum tabanlı ek alan yönetimi

✅ DI ile kolay yapılandırma (AddMindResult)

✅ ToDictionary() ile JSON’a dönüştürmeye hazır yapı

📌 Notlar

CreateResult.ConfigureKeys<TEnum>() veya services.AddMindResult<TEnum>() ile hangi enum tipini kullanacağınızı belirleyin.

Ek alan ekleme (AdditionalFields) sadece enum tipleriyle yapılmalıdır.

ResultExtensions.With metodu, fluent kullanım için tasarlanmıştır.

📝 Örnek ASP.NET Core Controller Kullanımı

[ApiController]
[Route("api/[controller]")]
public class UserController : ControllerBase
{
    [HttpGet("{id}")]
    public IActionResult GetUser(int id)
    {
        var user = GetUserFromDb(id);
        if (user == null)
        {
            return Ok(CreateResult.Failure<object>("Kullanıcı bulunamadı")
                                    .With(ExtraFields.ErrorCode, "NOT_FOUND"));
        }

        return Ok(CreateResult.Ok(user, "Kullanıcı bulundu"));
    }
}