现在 .NET 最小 API(Minimal API) 也可以自动帮你做“数据验证”了。意思就是——如果用户请求你的 API 时,传过来的参数不符合你规定的要求,比如某个字段必须有值、有最大长度、格式要对等等,框架可以自动帮你检查这些东西,不用你手动去写判断逻辑。
首先需要在项目文件中添加InterceptorsNamesapces:
<Project Sdk="Microsoft.NET.Sdk.Web"><PropertyGroup><TargetFramework>net10.0</TargetFramework><able>enable</able><ImplicitUsings>enable</ImplicitUsings></PropertyGroup><PropertyGroup><InterceptorsNamespaces>$(InterceptorsNamespaces);Microsoft.AspNetCore.Http.Validation.Generated</InterceptorsNamespaces></PropertyGroup></Project>
using Microsoft.AspNetCore.Http.Validation;using Microsoft.AspNetCore.Mvc;using System.ComponentModel.DataAnnotations;var builder = WebApplication.CreateBuilder(args);builder.Services.AddValidation();var app = builder.Build();// DisableValidation无效化验证app.MapGet("/person/{id}",([Range(1, 10000, ErrorMessage = "id的范围在1~10000之间")] int id)=> TypedResults.Ok(id)).DisableValidation();//验证app.MapPost("/person", ([Required(ErrorMessage = "姓名不能为空")] string name, [Range(0, 120, ErrorMessage = "年龄应该在0~120之间")] int age) =>TypedResults.Ok($"{name},{age}"));//嵌套验证app.MapPost("/order", ([FromBody] Order order) =>TypedResults.Ok($"{order.OrderNo},{order.Amount}"));app.Run();public class Person{public string Name { get; set; }public int Age { get; set; }}public class Order{[]public string OrderNo { get; set; }[]public decimal Amount { get; set; }[]public User OrderUser { get; set; }}public class User{[]public int UserID { get; set; }[]public string UserName { get; set; }}