在.NET應用程序中，我們經常需要編寫一些方法來執行某些操作，并返回相應的結果。

這些結果可能是成功的，也可能是失敗的，而且可能需要攜帶一些額外的信息，比如成功的返回值或者錯誤的原因。

為了實現這一目的，我們通常會使用以下幾種方式：

• 使用異常。當方法執行出現錯誤時，我們可以拋出一個異常，讓調用者捕獲并處理。這種方式可以讓我們傳遞詳細的錯誤信息，但是異常可能會導致代碼難以閱讀和維護，因為它會打斷正常的控制流程。
• 使用布爾值。當方法執行成功或失敗時，我們可以返回一個布爾值，表示結果的狀態。這種方式可以讓我們避免使用異常，但是布爾值不能夠提供足夠的信息，比如錯誤的原因或者返回值, 必須添加另外的ref/out參數。
• 使用元組返回值。當方法執行成功或失敗時，我們可以返回一個元組（Tuple），包含一個布爾值和一個任意類型的值。這種方式可以讓我們同時傳遞結果的狀態和數據，但是元組不能夠清晰地傳達語義，比如什么是結果狀態，什么是數據。

為了克服以上這些方式帶來的不足，我們可以使用 FluentResults。

FluentResults 介紹

FluentResults 是一個開源的 .NET 庫，它為我們提供了一種簡潔而強大的方式來表示和處理結果和錯誤。

FluentResults 的核心思想是使用 Result 對象來封裝操作的結果。Result 對象可以表示成功或失敗，并且可以攜帶任意類型的值或錯誤。

使用 FluentResults 有以下幾個好處：

• FluentResults 可以讓我們以統一和明確的方式表達結果和錯誤，避免 null 或無效值的問題。
• FluentResults 可以讓我們以一種簡單而強大的方式組合和轉換結果和錯誤，避免使用復雜的邏輯。
• FluentResults 可以讓我們以一種優雅而靈活的方式處理結果和錯誤，避免使用冗余的代碼。

FluentResults 示例

下面是一個使用 FluentResults 的簡單示例。

假設我們有一個方法 CalculatePrice ，它接收一個 Order 對象作為參數，并返回一個 Result對象作為結果。Result對象表示計算價格是否成功，并且攜帶價格作為返回值。

我們可以使用 Result 類的靜態方法來創建 Result 對象，并返回成功或失敗的結果：

public Result<decimal> CalculatePrice(Order order)
{
    // 檢查訂單是否有效
    if (order == null || order.Items.Count == 0)
    {
        // 返回失敗的結果，并攜帶一個錯誤對象
        return Result.Fail(new Error("無效訂單"));
    }

    // 計算訂單的總價
    decimal totalPrice = 0;
    foreach (var item in order.Items)
    {
        // 檢查商品是否有效
        if (item == null || item.Price <= 0)
        {
            // 返回失敗的結果，并攜帶一個錯誤對象
            return Result.Fail(new Error("無效商品"));
        }

        // 累加商品的價格
        totalPrice += item.Price;
    }

    // 返回成功的結果，并攜帶價格作為返回值
    return Result.Ok(totalPrice);
}

在調用者的角度，我們可以使用 Result 對象的屬性和方法來檢查和處理結果：

// 計算訂單的價格
var result = CalculatePrice(order);

// 檢查結果是否成功
if (result.IsSuccess)
{
    // 獲取價格
    decimal price = result.Value;
    Console.WriteLine($"訂單的價格是 {price}");
}
else
{
    // 獲取錯誤
    foreach (var error in result.Errors)
    {
        Console.WriteLine($"計算訂單價格時出現錯誤：{error.Message}");
    }
}

總結

FluentResults 可以讓我們以一種簡潔而強大的方式表示和處理結果和錯誤，提高代碼質量。