.NET 结果与错误处理利器 FluentResults
在项目开发中，方法返回的结果（成功或失败）对我们开发来说很重要。传统方法，如通过异常来指示错误或使用特定的返回类型（如布尔值加输出参数），虽然有效，但可能缺乏直观性和灵活性。
FluentResults库应运而生，它以一种既流畅又富有表达力的方式，极大地优化了这一过程。通过使用FluentResults，能够以一种更加自然和易于理解的方式传递操作结果，包括成功状态、错误信息、警告以及额外信息，提高代码的可读性和可维护性。
这种方式不仅让错误处理更加集中和一致，还使得代码结构更加清晰，逻辑更加流畅。
项目介绍
FluentResults
是一个在 .NET 环境中广泛使用的库，它提供了一种优雅的方式来处理方法执行的结果和错误。
使用
FluentResults
，可以很容易地创建包含成功值、错误、警告或信息的对象，并通过链式调用来处理这些对象。
那么如何使用
FluentResults
来优雅地处理结果和错误信息呢？
使用 FluentResults
1、安装 FluentResults
首先，在项目中安装
FluentResults
，可以通过 NuGet 包管理器来安装。在 Visual Studio 中也可以通过 NuGet 包管理器控制台输入以下命令：
Install-Package FluentResults
或者，在项目文件中添加 NuGet 包引用。
2、创建 Result 对象
使用
Result
类的静态方法来创建结果对象。
Result
类提供了多种方法来创建不同类型的结果，例如成功、失败、带有警告或信息的成功等。
usingFluentResults;
static void Main(string[] args)
{var result = IsInteger("");
if(result.IsSuccess)
{
Console.WriteLine($"结果：{result.Value}");
}else{
Console.WriteLine($"结果：{result.Reasons[0].Message}|{result.Errors[0].Message}");
}
}
public static Result<int> IsInteger(stringinput)
{//假设输入为空或null，我们可以选择认为它不是数字 if (string.IsNullOrWhiteSpace(input))
{return Result.Fail<int>("输入为空或null，无法判断是否是数字");
}//使用int.TryParse尝试将输入转换为整数//如果转换成功，out参数将包含转换后的值，方法返回true//如果转换失败，方法返回false if (int.TryParse(input, out intresult))
{returnResult.Ok(result);
}//如果无法转换为整数，则认为输入不是数字 return Result.Fail<int>("输入不是数字");
}
运行结果
通过使用Result 类我们可以看到，方法运行返回了标准的接口参数，包括IsSuccess，Message，Errors等参数，帮我们快速实现返回结构。
3、链式处理结果
FluentResults
允许你通过链式调用来处理结果，这使得错误处理和逻辑流程更加清晰和直观。
需要注意的是FluentResults 本身的
Resu
lt
类型并不直接提供
OnSuccess
和
OnFailure
这样的链式方法，因为这些方法可能是在 FluentResults 的某个版本中以扩展方法的形式添加的，或者是在基于 FluentResults 的自定义扩展中定义的。
自定义扩展类
/// <summary> ///Result 扩展方法/// </summary> public static classResultExtensions
{/// <summary> ///成功回调/// </summary> /// <param name="result"></param> /// <param name="successAction"></param> /// <returns></returns> public static Result OnSuccess(thisResult result, Action successAction)
{if(result.IsSuccess)
{
successAction?.Invoke();
}return result; //返回结果以支持链式调用 }
/// <summary> ///失败回调/// </summary> /// <param name="result"></param> /// <param name="failureAction"></param> /// <returns></returns> public static Result OnFailure(this Result result, Action<IError>failureAction)
{if (!result.IsSuccess && result.Errors!= null)
{foreach (var error inresult.Errors)
{
failureAction?.Invoke(error);
}
}return result; //返回结果以支持链式调用 }
}
自定义方法
/// <summary> ///验证输入字符串是否为整数/// </summary> /// <param name="input"></param> /// <returns></returns> public static Result IsIntegerInfo(stringinput)
{//假设输入为空或null，我们可以选择认为它不是数字 if (string.IsNullOrWhiteSpace(input))
{return Result.Fail("输入为空或null，无法判断是否是数字");
}//使用int.TryParse尝试将输入转换为整数//如果转换成功，out参数将包含转换后的值，方法返回true//如果转换失败，方法返回false if (int.TryParse(input, out intresult))
{returnResult.Ok();
}//如果无法转换为整数，则认为输入不是数字 return Result.Fail("输入不是数字");
}
调用示例
var result = IsIntegerInfo("")
.OnSuccess(()=>{//处理成功的情况 Console.WriteLine("Success!");
})
.OnFailure(error=>{//处理失败的情况 Console.WriteLine("Failed:" +error.Message);
});//注意：在 OnSuccess 或 OnFailure 中使用 result 变量可能不是安全的，//因为这些回调可能在这些回调执行之前就被修改了。//更好的做法是在 OnSuccess/OnFailure 的 lambda 表达式中使用局部变量。
运行结果
在这个示例中定义了两个扩展方法
OnSuccess
和
OnFailure
，它们分别接受成功和失败时要执行的回调函数。这些方法首先检查
Result
对象的状态，然后根据状态调用相应的回调函数。最后，它们返回原始的
Result
对象，以支持链式调用。
请注意，示例是为了说明目的而简化的，并且可能不包含 FluentResults 库中实际可用的所有功能和优化。在实际应用中，应该查看 FluentResults 的文档和源代码，以了解提供的具体功能。
4、
FluentResults 高级特性
FluentResults提供许多高级特性，如链式调用、自定义错误类型、以及包含额外数据和元数据的错误对象。
例如，可以使用
Result.Fail
的重载版本来包含更多的上下文信息
return Result.Fail("输入错误.").WithError("The input value must be greater than zero.");
5、自定义 Result 类型
FluentResults
还支持通过继承
Result
类来创建自定义的结果类型，以便在结果中携带额外的数据或状态。
public classCommonResult
{public Result Result { get; }public string MyData { get; }
public CommonResult(Result result, stringmyData)
{
Result=result;
MyData=myData;
Console.WriteLine($"{nameof(CommonResult)}: {MyData}|{result}");
}
}
调用示例
public static CommonResult DemoResult(stringinput)
{bool isSuccess =false;string errorMessage = "输入的字符串不是数字";string myData = "测试一下";
Result result= isSuccess ?Result.Ok() : Result.Fail(errorMessage);return newCommonResult(result, myData);
}
运行结果
通过以上步骤，可以在 .NET 应用快速、方便的使用
FluentResults
来处理结果和错误。可以提高代码的可读性和可维护性，还可以使错误处理更加集中和统一规范。
使用场景
- API 开发：在处理 HTTP 请求和响应时，FluentResults 构建清晰、一致和易于理解的错误响应。
- 业务逻辑验证：在执行业务逻辑验证时，FluentResults 可以验证多个错误，并一次性返回。
总结
FluentResults 提供了丰富的 API，可以灵活使用，与现有的 .NET 代码库和框架集成，如 ASP.NET Core、Entity Framework 等，还可以与其他第三方库一起使用，以提供更全面的错误处理和结果功能。
如果你的项目中需要一种更好的方式来处理结果，并希望提高代码的可读性和可维护性，那么 FluentResults 是一个不错的选择。
开源地址
如果觉得这篇文章对你有用，欢迎加入微信公众号 [
DotNet技术匠
] 社区，与其他热爱技术的同行交流心得，共同成长。
