LightPoint.Foundation.Result 1.3.5.8

dotnet add package LightPoint.Foundation.Result --version 1.3.5.8
                    
NuGet\Install-Package LightPoint.Foundation.Result -Version 1.3.5.8
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="LightPoint.Foundation.Result" Version="1.3.5.8" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="LightPoint.Foundation.Result" Version="1.3.5.8" />
                    
Directory.Packages.props
<PackageReference Include="LightPoint.Foundation.Result" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add LightPoint.Foundation.Result --version 1.3.5.8
                    
#r "nuget: LightPoint.Foundation.Result, 1.3.5.8"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package LightPoint.Foundation.Result@1.3.5.8
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=LightPoint.Foundation.Result&version=1.3.5.8
                    
Install as a Cake Addin
#tool nuget:?package=LightPoint.Foundation.Result&version=1.3.5.8
                    
Install as a Cake Tool

简要说明

LightPoint.Foundation.Result 是用于在 .net core 中实现 Result 模式,用于在 Light Point 架构设计中,常规设计中的方法或者服务返回值的包装(Result)处理,具体来说,构建一个可支持 http 代码可以直接映射的抽象结果,在需要的时候使用。

本项目是参考 Steve Smith 的 Result 的项目来具体实现的。

针对的问题

许多服务上的方法需要返回某种类型的值。例如,它们可能在查找一些数据并返回一组结果或单个对象。它们可能在创建某个东西,将其保存下来,然后返回它。通常,这类方法的实现方式如下:

public Customer GetCustomer(int customerId)
{
  // more logic
  return customer;
}

public Customer CreateCustomer(string firstName, string lastName)
{
  // more logic
  return customer;
}

这种方法在我们只关注正常流程的情况下工作得很好。但是,如果存在多种可能的异常故障隐含其中,而且并非所有异常故障都适合通过异常来处理,那么会发生什么情况呢?

  • 如果 customerId 缺少,将会发生?
  • customer 对象数据中 lastName 是必须的,但没有提供,将会发生什么?
  • 如果当前用户不能处理新增用户的操作,将会发生什么 ?

处理这些顾虑的常规方法是使用异常。一般通过 try,为每种不同的异常故障抛出不同的异常,然后 catch 来具体处理异常故障。事实上,这给客户端代码带来了繁琐的设计要求,并导致许多异常,对于设计来说并非一定属于“异常情况”的事情。如下所示:

[HttpGet]
public async Task<ActionResult<CustomerDTO>> GetCustomer(int customerId)
{
  try
  {
    var customer = _repository.GetById(customerId);
    
    var customerDTO = CustomerDTO.MapFrom(customer);
    
    return Ok(customerDTO);
  }
  catch (NullReferenceException ex)
  {
    return NotFound();
  }
  catch (Exception ex)
  {
    return new StatusCodeResult(StatusCodes.Status500InternalServerError);
  }
}

另一种方法是返回一个元组(Tuple),其中包括预期的结果以及其他内容,比如状态码和额外的故障模式元数据。虽然 Tuple 在处理个体的、灵活的响应时非常出色,但它们并不适合用于提供单一的、标准的、可重用的问题解决方案。

Result 模式提供了一种标准的、可重用的方法,以易于映射到 API 响应类型的方式从 .NET 服务返回成功以及多种非成功响应。这种方式使得处理成功和多种类型的非成功响应变得更加统一和便捷。

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on LightPoint.Foundation.Result:

Package Downloads
LightPoint.Foundation.Specification

Specification 模式是一种设计模式,用于将复杂的业务规则或验证逻辑封装为独立、可重用的组件。这种模式允许你将一个或多个业务规则表示为特定的规范(Specification),然后可以轻松地在应用程序的各个部分中应用这些规范。 本项目是参考 Steve Smith 的 [Specification](https://github.com/ardalis/Specification) 的项目来具体实现的。

LightPoint.Foundation.Result.AspNetCore

在 .net core 中实现 Result 模式,用于在 Light Point 架构设计中,常规设计中的方法或者服务返回值的包装(Result)处理,具体来说,构建一个可支持 http 代码可以直接映射的抽象结果,在需要的时候使用。 本项目是参考 Steve Smith 的 [Result](https://github.com/ardalis/Result) 的项目来具体实现的。

LightPoint.Foundation.Kernel.Mapper

通过针对 ILpEntityBase 和 ILpDtoBase 的扩展,分别构建简化的,针对 Light Point 的 LpDto 和 LpDomainEntity 对象映射的方法。

LightPoint.Foundation.Kernel.DtoServices

Package Description

LightPoint.Foundation.Result.FluentValidation

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.3.5.8 179 12/17/2024
1.3.5.6 169 11/13/2024
1.3.5.5 192 9/25/2024
1.3.5.3 183 9/1/2024
1.3.5.2 177 8/29/2024
1.3.5.1 195 8/29/2024
1.3.5 144 8/29/2024
1.3.4.4 208 8/19/2024
1.3.4.3 174 8/19/2024
1.3.4.2 186 8/19/2024
1.3.4.1 195 8/19/2024
1.3.4 223 8/1/2024
1.3.1 112 7/25/2024
1.3.0 139 7/25/2024
1.2.0 167 4/19/2024
1.0.0 227 12/29/2023