翼度科技»论坛 编程开发 .net 查看内容

.NET 结果与错误处理利器 FluentResults

9

主题

9

帖子

27

积分

新手上路

Rank: 1

积分
27
前言

在项目开发中,方法返回的结果(成功或失败)对我们开发来说很重要。传统方法,如通过异常来指示错误或使用特定的返回类型(如布尔值加输出参数),虽然有效,但可能缺乏直观性和灵活性。
FluentResults库应运而生,它以一种既流畅又富有表达力的方式,极大地优化了这一过程。通过使用FluentResults,能够以一种更加自然和易于理解的方式传递操作结果,包括成功状态、错误信息、警告以及额外信息,提高代码的可读性和可维护性。
这种方式不仅让错误处理更加集中和一致,还使得代码结构更加清晰,逻辑更加流畅。
项目介绍

FluentResults 是一个在 .NET 环境中广泛使用的库,它提供了一种优雅的方式来处理方法执行的结果和错误。
使用 FluentResults,可以很容易地创建包含成功值、错误、警告或信息的对象,并通过链式调用来处理这些对象。
那么如何使用 FluentResults 来优雅地处理结果和错误信息呢?
使用 FluentResults

1、安装 FluentResults

首先,在项目中安装 FluentResults,可以通过 NuGet 包管理器来安装。在 Visual Studio 中也可以通过 NuGet 包管理器控制台输入以下命令:
  1. Install-Package FluentResults
复制代码
或者,在项目文件中添加 NuGet 包引用。

2、创建 Result 对象

使用 Result 类的静态方法来创建结果对象。Result 类提供了多种方法来创建不同类型的结果,例如成功、失败、带有警告或信息的成功等。
  1. using FluentResults;  
  2. static  void Main(string[] args)
  3. {
  4.      var result = IsInteger("");
  5.      if (result.IsSuccess)
  6.      {
  7.          Console.WriteLine($"结果:{result.Value} ");
  8.      }
  9.      else
  10.      {
  11.          Console.WriteLine($"结果:{result.Reasons[0].Message}|{result.Errors[0].Message}");
  12.      }
  13. }
  14. public static Result<int>  IsInteger(string input)
  15. {
  16.      // 假设输入为空或null,我们可以选择认为它不是数字  
  17.      if (string.IsNullOrWhiteSpace(input))
  18.      {
  19.          return Result.Fail<int>("输入为空或null,无法判断是否是数字");
  20.      }
  21.      // 使用int.TryParse尝试将输入转换为整数  
  22.      // 如果转换成功,out参数将包含转换后的值,方法返回true  
  23.      // 如果转换失败,方法返回false  
  24.      if (int.TryParse(input, out int result))
  25.      {
  26.          return Result.Ok(result);
  27.      }
  28.      // 如果无法转换为整数,则认为输入不是数字  
  29.      return Result.Fail<int>("输入不是数字");
  30. }
复制代码
运行结果

通过使用Result 类我们可以看到,方法运行返回了标准的接口参数,包括IsSuccess,Message,Errors等参数,帮我们快速实现返回结构。
3、链式处理结果

FluentResults 允许你通过链式调用来处理结果,这使得错误处理和逻辑流程更加清晰和直观。
需要注意的是FluentResults 本身的 Result 类型并不直接提供 OnSuccess 和 OnFailure 这样的链式方法,因为这些方法可能是在 FluentResults 的某个版本中以扩展方法的形式添加的,或者是在基于 FluentResults 的自定义扩展中定义的。
自定义扩展类
  1.   /// <summary>
  2.    /// Result 扩展方法
  3.    /// </summary>
  4.    public static class ResultExtensions
  5.    {
  6.        /// <summary>
  7.        /// 成功回调
  8.        /// </summary>
  9.        /// <param name="result"></param>
  10.        /// <param name="successAction"></param>
  11.        /// <returns></returns>
  12.        public static Result OnSuccess(this Result result, Action successAction)
  13.        {
  14.            if (result.IsSuccess)
  15.            {
  16.                successAction?.Invoke();
  17.            }
  18.            return result; // 返回结果以支持链式调用  
  19.        }
  20.        /// <summary>
  21.        /// 失败回调
  22.        /// </summary>
  23.        /// <param name="result"></param>
  24.        /// <param name="failureAction"></param>
  25.        /// <returns></returns>
  26.        public static Result OnFailure(this Result result, Action<IError> failureAction)
  27.        {
  28.            if (!result.IsSuccess && result.Errors!= null)
  29.            {
  30.                foreach (var error in result.Errors)
  31.                {
  32.                    failureAction?.Invoke(error);
  33.                }
  34.            }
  35.            return result; // 返回结果以支持链式调用  
  36.        }
  37.    }
复制代码
自定义方法
  1. /// <summary>
  2. /// 验证输入字符串是否为整数
  3. /// </summary>
  4. /// <param name="input"></param>
  5. /// <returns></returns>
  6. public static Result IsIntegerInfo(string input)
  7. {
  8.     // 假设输入为空或null,我们可以选择认为它不是数字  
  9.     if (string.IsNullOrWhiteSpace(input))
  10.     {
  11.         return Result.Fail("输入为空或null,无法判断是否是数字");
  12.     }
  13.     // 使用int.TryParse尝试将输入转换为整数  
  14.     // 如果转换成功,out参数将包含转换后的值,方法返回true  
  15.     // 如果转换失败,方法返回false  
  16.     if (int.TryParse(input, out int result))
  17.     {
  18.         return Result.Ok();
  19.     }
  20.     // 如果无法转换为整数,则认为输入不是数字  
  21.     return Result.Fail("输入不是数字");
  22. }
复制代码
调用示例
  1. var result = IsIntegerInfo("")
  2.      .OnSuccess(() =>
  3.      {
  4.              // 处理成功的情况  
  5.              Console.WriteLine("Success!");
  6.      })
  7.      .OnFailure(error =>
  8.      {
  9.          // 处理失败的情况  
  10.          Console.WriteLine("Failed: " + error.Message);
  11.      });
  12. // 注意:在 OnSuccess 或 OnFailure 中使用 result 变量可能不是安全的,  
  13. // 因为这些回调可能在这些回调执行之前就被修改了。  
  14. // 更好的做法是在 OnSuccess/OnFailure 的 lambda 表达式中使用局部变量。
复制代码
运行结果

 
在这个示例中定义了两个扩展方法 OnSuccess 和 OnFailure,它们分别接受成功和失败时要执行的回调函数。这些方法首先检查 Result 对象的状态,然后根据状态调用相应的回调函数。最后,它们返回原始的 Result 对象,以支持链式调用。
请注意,示例是为了说明目的而简化的,并且可能不包含 FluentResults 库中实际可用的所有功能和优化。在实际应用中,应该查看 FluentResults 的文档和源代码,以了解提供的具体功能。
4、FluentResults 高级特性

FluentResults提供许多高级特性,如链式调用、自定义错误类型、以及包含额外数据和元数据的错误对象。
例如,可以使用Result.Fail的重载版本来包含更多的上下文信息
  1. return Result.Fail("输入错误.").WithError("The input value must be greater than zero.");
复制代码
5、自定义 Result 类型

FluentResults 还支持通过继承 Result 类来创建自定义的结果类型,以便在结果中携带额外的数据或状态。
  1. public class CommonResult
  2. {
  3.     public Result Result { get; }
  4.     public string MyData { get; }
  5.     public CommonResult(Result result, string myData)
  6.     {
  7.         Result = result;
  8.         MyData = myData;
  9.         Console.WriteLine($"{nameof(CommonResult)}: {MyData}|{result}");
  10.     }
  11. }
复制代码
调用示例
  1. public static CommonResult DemoResult(string input)
  2. {
  3.      bool isSuccess =false;
  4.      string errorMessage = "输入的字符串不是数字";
  5.      string myData = "测试一下";
  6.      Result result = isSuccess ? Result.Ok() : Result.Fail(errorMessage);
  7.      return new CommonResult(result, myData);
  8. }
复制代码
运行结果

通过以上步骤,可以在 .NET 应用快速、方便的使用 FluentResults 来处理结果和错误。可以提高代码的可读性和可维护性,还可以使错误处理更加集中和统一规范。
使用场景


  • API 开发:在处理 HTTP 请求和响应时,FluentResults 构建清晰、一致和易于理解的错误响应。
  • 业务逻辑验证:在执行业务逻辑验证时,FluentResults 可以验证多个错误,并一次性返回。
  • 复杂操作的结果处理:当需要处理包含多个步骤的复杂操作时,FluentResults 可以帮助管理每个步骤的结果,并将它们组合成一个最终的结果。
总结

FluentResults 提供了丰富的 API,可以灵活使用,与现有的 .NET 代码库和框架集成,如 ASP.NET Core、Entity Framework 等,还可以与其他第三方库一起使用,以提供更全面的错误处理和结果功能。
如果你的项目中需要一种更好的方式来处理结果,并希望提高代码的可读性和可维护性,那么 FluentResults 是一个不错的选择。
开源地址

https://github.com/altmann/FluentResults
如果觉得这篇文章对你有用,欢迎加入微信公众号 [DotNet技术匠] 社区,与其他热爱技术的同行交流心得,共同成长。


来源:https://www.cnblogs.com/1312mn/p/18336221
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x

举报 回复 使用道具