前言

文本主要讲 MinimalApis 中的使用自定义IResultModel和系统自带IResult做响应返回值。

MinimalApis支持以下类型的返回值:

  • string - 这包括 Task<string>ValueTask<string>

  • T(任何其他类型)- 这包括 Task<T>ValueTask<T>

  • 基于 IResult - 这包括 Task<IResult>ValueTask<IResult>

    本文的完整源代码在文末

string 返回值

行为 Content-Type
框架将字符串直接写入响应。 text/plain

200 状态代码与 text/plain Content-Type 标头和以下内容一起返回

Hello World

T(任何其他类型)返回值

我们上面说的自定义 IResultModel就是用这种模式处理的

行为 Content-Type
框架 JSON 序列化响应。 application/json

MinimalApis 框架 Json 序列化全局配置如下

    //通过调用 ConfigureHttpJsonOptions 来全局配置应用的选项
builder.Services.ConfigureHttpJsonOptions(options =>
{
options.SerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;//忽略循环引用
options.SerializerOptions.WriteIndented = true;
options.SerializerOptions.IncludeFields = true;
options.SerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull;
});

返回 T


app.MapGet("/TestT", User () => new User() { Name = "Ruipeng", Email = "xxx@163.com", Age = 18 })
.WithSummary("测试类")
.Produces<User>();

返回值

{
"name": "Ruipeng",
"email": "xxx@163.com",
"age": 18
}

200 状态代码与 application/json Content-Type 标头和以下内容一起返回

这个 HttpCode状态码只能返回 200,且不支持多种返回形式,比较局限


统一响应格式代码


public interface IResultModel
{
/// <summary>
/// 是否成功
/// </summary>
bool? IsSuccess { get; } /// <summary>
/// 错误信息
/// </summary>
string? Message { get; } /// <summary>
/// 业务码,用于业务中自定义
/// </summary>
int? StatusCode { get; set; } /// <summary>
/// 时间戳
/// </summary>
long? Timestamp { get; }
} /// <summary>
/// 返回结果模型泛型接口
/// </summary>
/// <typeparam name="T"></typeparam>
public interface IResultModel<out T> : IResultModel
{
/// <summary>
/// 返回数据
/// </summary> T? Data { get; }
}

实现

public class ResultModel<T> : IResultModel<T>
{
public ResultModel()
{
Timestamp = DateTimeOffset.Now.ToUnixTimeSeconds();
} /// <summary>
/// 处理是否成功
/// </summary>
public bool? IsSuccess { get; set; } /// <summary>
/// 错误信息
/// </summary>
public string? Message { get; set; } /// <summary>
/// 业务码
/// </summary>
public int? StatusCode { get; set; } /// <summary>
/// 时间戳
/// </summary>
public long? Timestamp { get; } /// <summary>
/// 返回数据
/// </summary>
public T? Data { get; set; } /// <summary>
/// 成功
/// </summary>
/// <param name="Data"></param>
public ResultModel<T> Success(T? data = default)
{
this.IsSuccess = true;
StatusCode = 200;
Data = data;
return this;
} /// <summary>
/// 失败
/// </summary>
/// <param name="msg">说明</param>
/// <param name="code"></param>
public ResultModel<T> Failed(string? msg = "failed", int? code = 500)
{
IsSuccess = false;
Message = msg;
StatusCode = code;
return this;
}
} /// <summary>
/// 返回结果
/// </summary>
public static class ResultModel
{
/// <summary>
/// 数据已存在
/// </summary>
/// <returns></returns>
public static IResultModel<string> HasExists => Failed("data already exists"); /// <summary>
/// 数据不存在
/// </summary>
public static IResultModel<string> NotExists => Failed("data doesn't exist"); /// <summary>
/// 成功
/// </summary>
/// <param name="data">返回数据</param>
/// <returns></returns>
public static IResultModel<T> Success<T>(T? data = default)
{
return new ResultModel<T>().Success(data);
} /// <summary>
/// 成功
/// </summary>
/// <param name="task">任务</param>
/// <returns></returns>
public static async Task<IResultModel<T>> SuccessAsync<T>(Task<T>? task = default)
{
return task is not null && task != default ? new ResultModel<T>().Success(await task) : new ResultModel<T>();
} /// <summary>
/// 成功
/// </summary>
/// <returns></returns>
public static IResultModel<string> Success()
{
return Success<string>();
} /// <summary>
/// 失败
/// </summary>
/// <param name="error">错误信息</param>
/// <returns></returns>
public static IResultModel<T> Failed<T>(string? error = null)
{
return new ResultModel<T>().Failed(error ?? "failed");
} /// <summary>
/// 失败
/// </summary>
/// <returns></returns>
public static IResultModel<string> Failed(string? error = null)
{
return Failed<string>(error);
} /// <summary>
/// 根据布尔值返回结果
/// </summary>
/// <param name="success"></param>
/// <returns></returns>
public static IResultModel<T> Result<T>(bool success)
{
return success ? Success<T>() : Failed<T>();
} /// <summary>
/// 根据布尔值返回结果
/// </summary>
/// <param name="success"></param>
/// <returns></returns>
public static async Task<IResultModel> Result(Task<bool> success)
{
return await success ? Success() : Failed();
} /// <summary>
/// 根据布尔值返回结果
/// </summary>
/// <param name="success"></param>
/// <returns></returns>
public static IResultModel<string> Result(bool success)
{
return success ? Success() : Failed();
} /// <summary>
/// 时间戳起始日期
/// </summary>
public static readonly DateTime TimestampStart = new(1970, 1, 1, 0, 0, 0, 0); }

定义接口

app.MapGet("/TestResultModel", IResultModel (int age) =>
{
List<User> users = [new User() { Name = "Ruipeng", Email = "xxx@163.com", Age = 18 }];
return users.FirstOrDefault(_ => _.Age > age) is User user ? ResultModel.Success(user) : ResultModel.Failed();
})
.WithSummary("测试自定义IResultModel")
.Produces<IResultModel<User>>();

封装了一个静态类来简化自定义类的创建,支持多个返回类型

返回值

{
"isSuccess": true,
"statusCode": 200,
"timestamp": 1711001093,
"data": {
"name": "Ruipeng",
"email": "xxx@163.com",
"age": 18
}

自定义类的自动包装实现

创建一个Attribute

[AttributeUsage(AttributeTargets.Method)]
public class EnableResponseWrapperAttribute : Attribute { }

创建中间件自动包装

public class ResponseWrapperMiddleware(RequestDelegate next)
{
public async Task InvokeAsync(HttpContext context)
{ if (context.GetEndpoint()?.Metadata.GetMetadata<EnableResponseWrapperAttribute>() is not null)
{
// 存储原始响应体流
var originalResponseBodyStream = context.Response.Body;
try
{
// 创建内存流以捕获响应
using var memoryStream = new MemoryStream();
context.Response.Body = memoryStream; // 调用管道中的下一个中间件
await next(context); // 恢复原始响应体流并写入格式化结果
context.Response.Body = originalResponseBodyStream; // 重置内存流位置并读取响应内容
memoryStream.Seek(0, SeekOrigin.Begin);
var readToEnd = await new StreamReader(memoryStream).ReadToEndAsync();
var objResult = JsonSerializer.Deserialize<dynamic>(readToEnd);
var result = new ResultModel<object>
{
Data = objResult,
IsSuccess = true,
StatusCode = context.Response.StatusCode
};
await context.Response.WriteAsJsonAsync(result as object); }
finally
{
// 确保在出现异常时恢复原始响应体流
context.Response.Body = originalResponseBodyStream;
}
}
else
{
await next(context);
}
}
}

应用中间件

app.UseMiddleware<ResponseWrapperMiddleware>();

创建测试接口

app.MapGet("/TestTestAutoWarpper", [EnableResponseWrapper] User () => new User() { Name = "Ruipeng", Email = "xxx@163.com", Age = 18 }).WithSummary("测试类")
.Produces<User>();

返回值

{
"isSuccess": true,
"statusCode": 200,
"timestamp": 1711005201,
"data": {
"name": "Ruipeng",
"email": "xxx@163.com",
"age": 18
}
}

为了方便测试在MinimalApis 的接口上如果添加了EnableResponseWrapperAttribute则通过中间件自动包装返回值

IResult 返回值

行为 Content-Type
框架调用 IResult.ExecuteAsync 由 IResult 实现决定

dotNet7 之后多了一个TypedResults类来替代 Results

IResult 接口定义一个表示 HTTP 终结点结果的协定。 静态 Results 类和静态 TypedResults 用于创建表示不同类型的响应的各种 IResult 对象。

返回 TypedResults(而不是 Results)有以下优点:

  • TypedResults 帮助程序返回强类型对象,这可以提高代码可读性、改进单元测试并减少运行时错误的可能性。
  • 实现类型会自动为 OpenAPI 提供响应类型元数据来描述终结点。

    实现在Microsoft.AspNetCore.Http.HttpResults
//Return IResult
app.MapGet("/IResult/TestResult", IResult () => Results.Ok(new User() { Name = "Ruipeng", Email = "xxx@163.com", Age = 18 }));

没有调用扩展方法 Produces

app.MapGet("/IResult/TestTypedResult", IResult () => TypedResults.Ok(new User() { Name = "Ruipeng", Email = "xxx@163.com", Age = 18 }));

可以看到 TypedResults 默认就会添加路由终结点的元数据描述

返回多个 IResult 实现类型

app.MapGet("/IResult/ReturnMultipleTypes", Results<Ok<User>, NotFound> (int age) =>
{
List<User> users = [new User() { Name = "Ruipeng", Email = "xxx@163.com", Age = 18 }];
return users.FirstOrDefault(_ => _.Age > age) is User user ? TypedResults.Ok(user) : TypedResults.NotFound();
});

图简单可以直接用 IResult 返回类型 但是,由于 TypedResults 帮助程序自动包含终结点的元数据,因此可以改为返回 Results<Ok<User>, NotFound> 联合类型

IResult 自定义响应

添加 Html 扩展


public static class ResultsExtensions
{
public static IResult Html(this IResultExtensions resultExtensions, string html)
{
ArgumentNullException.ThrowIfNull(resultExtensions); return new HtmlResult(html);
}
} class HtmlResult(string html) : IResult
{
private readonly string _html = html; public Task ExecuteAsync(HttpContext httpContext)
{
httpContext.Response.ContentType = MediaTypeNames.Text.Html;
httpContext.Response.ContentLength = Encoding.UTF8.GetByteCount(_html);
return httpContext.Response.WriteAsync(_html);
}
}
app.MapGet("/IResult/Html", () => Results.Extensions.Html(@$"<!doctype html>
<html>
<head><title>miniHTML</title></head>
<body>
<h1>Hello World</h1>
<p>The time on the server is {DateTime.Now:O}</p>
</body>
</html>"));

返回结果

<!DOCTYPE html>
<html>
<head>
<title>miniHTML</title>
</head>
<body>
<h1>Hello World</h1>
<p>The time on the server is 2024-03-21T17:31:36.2931959+08:00</p>
</body>
</html>

自定义 Json 格式

上面写了ConfigureHttpJsonOptions方法来配置全局请求的 Json 格式,下面则是针对单个路由终结点请求,方便一些个性化接口的处理

var options = new JsonSerializerOptions(JsonSerializerDefaults.Web)
{ WriteIndented = true }; app.MapGet("/IResult/CustomJsonConfig", () =>
TypedResults.Json(new User() { Name = "Ruipeng", Email = "xxx@163.com", Age = 18 }, options));

返回 ProblemDetail

app.MapGet("/IResult/ProblemDetail", () =>
{
var problemDetail = new ProblemDetails()
{
Status = StatusCodes.Status500InternalServerError,
Title = "内部错误"
};
return TypedResults.Problem(problemDetail);
});

返回值

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.6.1",
"title": "内部错误",
"status": 500
}

Microsoft.AspNetCore.Http.Results的扩展下,TypedResults 有非常多扩展的方法,比如处理文件,回调,流以及登录认证等,大家可以根据需求使用.

最后

用那种方式还是取决于项目的实际情况,如果你的系统是业务码httpStateCode要求分离的形式那建议用上面自定义统一响应的形式,要是没这方面的需求那dotNet自带的TypedResults使用起来就更合适。

官网文档 如何在最小 API 应用中创建响应

以下是本文的完整 源代码

希望本文对你有帮助!

.Net MinimalApis响应返回值的更多相关文章

  1. requests的响应返回值显示content和text方法的区别

    requests的get或者post请求,返回的响应response获取方法:content和text content用于获取图片,返回二进制数据 text用于获取内容,返回的是unicode解码字符 ...

  2. SpringMVC02:返回值、json数据、文件上传、拦截器

     一.响应返回值 1.搭建环境(两个webapp,不要选错) 2.响应之返回值是String类型 package cn.itcast.controller; import cn.itcast.doma ...

  3. SendMessage的返回值,就是由相应的响应消息函数的返回值(解释的简洁明了)

    SendMessage Return Values The return value specifies the result of the message processing and depend ...

  4. 一个相对通用的JSON响应结构,其中包含两部分:元数据与返回值

    定义一个相对通用的JSON响应结构,其中包含两部分:元数据与返回值,其中,元数据表示操作是否成功与返回值消息等,返回值对应服务端方法所返回的数据. public class Response { pr ...

  5. 使用 ResponseBodyAdvice 拦截Controller方法默认返回参数,统一处理返回值/响应体

    使用 @ControllerAdvice & ResponseBodyAdvice 拦截Controller方法默认返回参数,统一处理返回值/响应体 1.Controller代码 以下是Con ...

  6. SSM框架之SpringMVC(4)返回值类型及响应数据类型

    SpringMVC(4)返回值类型及响应数据类型 1. 返回值分类 1.1. 返回字符串 Controller方法返回字符串可以指定逻辑视图的名称,根据视图解析器为物理视图的地址. @RequestM ...

  7. spring MVC 返回值信息和ResponseBody的响应json数据

    spring mvc的界面返回: 如果我们定义的返回类型是String 那么我们返回的时候直接写入 我们的界面的名字就可以了  springmvc会自动去找到我们的界面,如果是void类型的返回那么 ...

  8. 05 SpringMVC:02.参数绑定及自定义类型转换&&04.SpringMVC返回值类型及响应数据类型&&05.文件上传&&06.异常处理及拦截器

    springMVC共三天 第一天: 01.SpringMVC概述及入门案例 02.参数绑定及自定义类型转换 03.SpringMVC常用注解 第二天: 04.SpringMVC返回值类型及响应数据类型 ...

  9. SpringMVC返回值类型及响应数据类型

    1.SpringMVC 和 Struts2 的优略分析 共同点: 它们都是表现层框架,都是基于 MVC 模型编写的. 它们的底层都离不开原始 ServletAPI. 它们处理请求的机制都是一个核心控制 ...

  10. 分析案例:应用服务无响应,任务管理器中发现大量w3wp僵尸进程----等待异构系统WebService返回值

    问题描述:       某二次开发的项目反馈,不定期出现应用服务器无响应的情况,登录服务器发现任务管理器中有大量的w3wp僵尸进程. 分析过程: 针对同一进程每隔15秒抓取dump,连续抓取3个,对比 ...

随机推荐

  1. 好书推荐之JAVA并发编程扛鼎之作:《Java并发编程实战》、《Java并发编程的艺术》

    (pdf文档下载见文末) 大佬推荐 <Java 并发编程实战>,是一本完美的 Java 并发参考手册. 书中从并发性和线程安全性的基本概念出发,介绍了如何使用类库提供的基本并发构建块,用于 ...

  2. vue3的宏到底是什么东西?

    前言 从vue3开始vue引入了宏,比如defineProps.defineEmits等.我们每天写vue代码时都会使用到这些宏,但是你有没有思考过vue中的宏到底是什么?为什么这些宏不需要手动从vu ...

  3. Slot 的含义

    Slot 解释 1)slot就是槽的意思,是一个资源单位,只有给task分配了一个slot之后,这个task才可以运行.slot分两种,map slot沪蓉reduce slot.另外,slot是一个 ...

  4. Linux证书问题:curl#60 - “The certificate issuer‘s certificate has expired

    问题说明 最近在centos7上打算安装php7版本,需要下载一个外网https的yum源,结果报错如下: 执行命令 rpm -Uvh https://mirror.webtatic.com/yum/ ...

  5. Direct2D 另一种与D3D创建类似的方法

    在进行D2D学习的时候,发现了这样一篇文档, Direct2D Quickstart for Windows 8 只有这么一小段介绍, Direct2D is a native-code, immed ...

  6. Selenium入门介绍

    目录 Selenium概述 浏览器支持 工具库 开发实践 等待 操作浏览器 定位元素 定位单个元素 定位多个元素 获取HTML元素内容的方式 Selenium概述 https://github.com ...

  7. MySQL和Redis基本安装和配置

    MySQL 下载和安装 mysql官网下载:https://dev.mysql.com/downloads/mysql/ 下载后将目录下的bin路径加入到环境变量中 在安装目录下创建 my.ini 配 ...

  8. 在MATPool矩池云完成Pytorch训练MNIST数据集

    本文为矩池云入门手册的补充:Pytorch训练MNIST数据集代码运行过程. 案例代码和对应数据集,以及在矩池云上的详细操作可以在矩池云入门手册中查看,本文基于矩池云入门手册,默认用户已经完成了机器租 ...

  9. 【Azure 应用服务】Azure Function 部署槽交换时,一不小心把预生产槽上的配置参数交换到生产槽上,引发生产错误

    问题描述 部署Function代码先到预生产槽中,进行测试后通过交换方式,把预生产槽中的代码交换到生产槽上,因为在预生产槽中的设置参数值与生产槽有不同,但是在交换的时候,没有仔细检查.导致在交换的时候 ...

  10. 机器学习策略篇:详解训练/开发/测试集划分(Train/dev/test distributions)

    训练/开发/测试集划分 设立训练集,开发集和测试集的方式大大影响了或者团队在建立机器学习应用方面取得进展的速度.同样的团队,即使是大公司里的团队,在设立这些数据集的方式,真的会让团队的进展变慢而不是加 ...