在构建现代应用程序时，服务层操作的执行结果通常需要被清晰、统一地传递给调用方，尤其是在Web API的场景中。传统的做法可能涉及频繁地抛出异常来表示失败，但这往往会模糊业务错误与系统异常的界限，并可能带来不必要的性能开销。

SimpleResults 是一个专注于解决这类挑战的开源库。它基于结果模式（Result Pattern）设计，提供了一套简洁且富有表达力的API，帮助开发者以更结构化的方式管理操作结果，无论是成功返回数据、报告业务警告，还是捕获详细的错误信息。该库的独特之处在于其与ASP.NET Core框架的深度融合能力，能够将服务层产生的 Result 对象无缝转换为标准化的HTTP响应，从而大幅简化API接口的实现逻辑。

核心设计理念与组件

SimpleResults 的核心在于其类型体系，它围绕一个通用的 Result 类型构建，并通过泛型支持携带任意类型的数据。此外，为适应更复杂的业务需求，它还提供了如 ListedResult 用于列表数据，以及 PagedResult 用于分页数据的特定派生类型。

这种设计理念使得开发者能够封装操作是否成功、返回的具体数据、潜在的错误消息集合以及任何警告信息，从而提供一个全面的操作上下文，而非简单的布尔值或抛出的异常。

主要应用场景

• 服务层业务逻辑结果封装：在业务服务层中，无论是用户注册、订单处理还是数据更新，SimpleResults 都提供了一种规范的方式来表达这些操作的最终状态。它使得函数签名清晰地表明将返回一个包含所有必要信息的对象，而非依赖于异常捕获。
• Web API 响应标准化：当作为 Web API 的后端服务时，SimpleResults 能够将服务层产生的 Result 对象自动映射到相应的 HTTP 状态码和响应体。例如，成功的操作可能对应 200 OK，附带数据；业务逻辑错误可能对应 400 Bad Request，附带错误详情，极大地简化了控制器层的代码。
• 集成验证与用户反馈：与 Fluent Validation 等验证库结合使用时，SimpleResults 可以轻松收集并统一展示验证失败信息，为前端提供一致且友好的用户反馈机制。

优势概览

• 代码清晰与可维护性：通过将成功、失败和警告状态显式化，SimpleResults 提升了代码的可读性。开发者可以一眼看出函数可能产生的所有结果，并以结构化的方式处理它们，而非散落在各处的 try-catch 块。
• 优化性能开销：在许多场景下，将预期内的业务错误作为返回结果的一部分，而非抛出异常，可以避免异常处理机制带来的栈回溯和性能损耗。这对于高吞吐量的系统尤为重要。
• 无缝框架集成：SimpleResults 旨在与 .NET 生态系统，特别是 ASP.NET Core 深度集成。它提供了方便的扩展点，例如自定义Action过滤器，以自动化 Result 到 ActionResult 的转换过程。

代码示例与集成演示

一个泛型结果对象可以封装操作的成功状态、返回数据及任何关联消息：

public class OperationResult<T>
{
    public bool IsSuccessful { get; set; }
    public T? Data { get; set; }
    public List<string> ErrorMessages { get; set; } = new List<string>();
    public List<string> WarningMessages { get; set; } = new List<string>();

    public static OperationResult<T> Success(T data)
    {
        return new OperationResult<T> { IsSuccessful = true, Data = data };
    }

    public static OperationResult<T> Failure(params string[] errors)
    {
        return new OperationResult<T> { IsSuccessful = false, ErrorMessages = errors.ToList() };
    }
}

// 假设我们有一个用户数据传输对象
public class UserDto { public int Id { get; set; } public string Name { get; set; } }

// 示例：创建一个成功的结果
OperationResult<UserDto> createUserResult = OperationResult<UserDto>.Success(new UserDto { Id = 1, Name = "Alice" });

// 示例：创建一个失败的结果，包含错误信息
OperationResult<UserDto> invalidInputResult = OperationResult<UserDto>.Failure("用户名不能为空", "密码格式不正确");

在ASP.NET Core中，可以通过自定义过滤器自动化 Result 对象到 ActionResult 的转换，简化控制器逻辑：

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;

// 在 Program.cs 或 Startup.cs 中配置 MVC 服务
builder.Services.AddControllers(options =>
{
    // 注册一个 Action 过滤器，用于将特定结果类型转换为 HTTP 响应
    options.Filters.Add(typeof(ResultToHttpActionResultConverter));
});

// 假定 ResultToHttpActionResultConverter 的简化实现大致如下：
// public class ResultToHttpActionResultConverter : IActionFilter
// {
//     public void OnActionExecuting(ActionExecutingContext context) { /* do nothing */ }
//     public void OnActionExecuted(ActionExecutedContext context)
//     {
//         // 检查 Action 返回的结果是否是 ObjectResult，并且其值是我们定义的 OperationResult
//         if (context.Result is ObjectResult objectResult && objectResult.Value is OperationResult<?> opResult)
//         {
//             context.Result = opResult.IsSuccessful
//                 ? new OkObjectResult(opResult.Data) // 成功则返回 200 OK 和数据
//                 : new BadRequestObjectResult(opResult.ErrorMessages); // 失败则返回 400 Bad Request 和错误信息
//         }
//     }
// }