Validation support in minimal APIs 알아보기

[Chris_Shim]

Minimal API vs Controller 성능 비교 (1000배 차이)

.net 10 부터 미니멀 api 도 Model validation 이 지원된다고 하니, 이점은 주의해야겠습니다.

Minimal API vs Controller 성능 비교 (1000배 차이)

source generator 기반으로 MVC Model Validation과는 또 다른 물건 같군요. .net 10 preview 3에서도 테스트 해 볼 수 있습니다. interceptor를 사용합니다. 우선 발견한 불편사항은… record 타입의 dto를 지원하지 않는군요.

Minimal API vs Controller 성능 비교 (1000배 차이)

이 제한은 문제가 되지 않을 수 있습니다. Restful Api 에서, 요청 바디에 포함된 모델에 대한 유효성 검증이 필요한 경우는 Post, Put 요청인데, 클라이언트 입장에서 이 모델은 mutable 한 편이 좋습니다. 예를 들어, Post 요청 바디에 포함될 모델이 클래스로 선언된 경우, class CreatePersonRequest { public string Name { get; set; } = ""; } 클라이언트에서는, 별도의 Input 모델을 선언하지 않고, 이 모델을 사용하여 사용자 입력과 바인딩하고, api 로 바로 보낼 수 있습니다. 만약, 이 모델이 record 로 선언되어 있다면, record 는 사용자 입력과 바인딩할 수 없기에, 바인딩 용 class 를 별도로 선언하고, 이를 다시 record 로 변환해야 하는 추가적인 코드가 필요합니다. 저는 프론트 엔드와 백엔드에 동일한 C# 언어를 사용하는데, Post 와 Put 용 모델은 항상 c…

다른 주제로 내용이 길어질 거 같아서 글을 새로 만들었습니다.

asp.net core 9까지 minimal api는 validation 기능이 공식적으로 제공되지 않았습니다. 개발자가 외부 라이브러리나 filter를 통해 해결했었는데요.

.net 10 부터는 프레임워크에서 공식적으로 기능이 제공됩니다.

.net 10 preview 3 부터 테스트 해 볼 수 있으며 꽤 유용해 보입니다. 다만 아직까지는 일관성이 부족한 상태입니다.

[Chris_Shim]

interceptor 기반 소스제네레이터에 의존하기 때문에 csproj에 다음 구성을 추가해야 합니다.

<InterceptorsNamespaces>$(InterceptorsNamespaces);Microsoft.AspNetCore.Http.Validation.Generated</InterceptorsNamespaces>

사용 방법은 매우 단순한데요.

builder.Services.AddValidation();

DI에 Validation을 추가하면 바로 동작합니다.

[Chris_Shim]

minimal api 샘플

app.MapPost("minimal", ([FromBody] Dto dto) => dto);

Case 1. RequiredAttribute

public class Dto
{
    [Required]
    public string Required { get; init; }
}

1-1. 빈 BODY 전달

Post /minimal
Accept: application/json
Content-Type: application/json

{
}

.NET 8

200 OK
{
  "required": null
}

.NET 10

400 Bad Request
{
  "title": "One or more validation errors occurred.",
  "errors": {
    "Required": [
      "The Required field is required."
    ]
  }
}

1-2. 명시적 null 전달

Post /minimal
Accept: application/json
Content-Type: application/json

{
  "Required": null,
}

.NET 8

200 OK
{
  "required": null
}

.NET 10

400 Bad Request
{
  "title": "One or more validation errors occurred.",
  "errors": {
    "Required": [
      "The Required field is required."
    ]
  }
}

Case 2. RequiredAttribute with Inline initialization

public class Dto
{
    [Required]
    public string Required { get; init; } = "inline"
}

2-1. 빈 BODY 전달

Post /minimal
Accept: application/json
Content-Type: application/json

{
}

.NET 8, 10

200 OK
{
  "required": "inline"
}

2-2 . 명시적 null 전달

Post /minimal
Accept: application/json
Content-Type: application/json

{
  "Required": null,
}

.NET 8

200 OK
{
  "required": null
}

.NET 10

400 Bad Request
{
  "title": "One or more validation errors occurred.",
  "errors": {
    "Required": [
      "The Required field is required."
    ]
  }
}

[Chris_Shim]

입력	조건	.net 8	.net 10 with validation
	[Required]	null	error
null	[Required]	null	error
	[Requred] with inline	“inline”	“inline”
null	[Requred] with inline	null	error

[rkttu]

계속해서 Reflection을 대신해서 Source Generator 기반 인프라에 투자를 많이 하고 있는 것 같습니다. 닷넷 코어 초기부터 시작된 DI 중심의 패러다임 변화와 더불어서 Source Generator 기반의 코드 확장 패러다임에 대해서도 점차 밑그림이 분명하게 그려지는 것 같아서 잘 봐둘 필요가 있는 부분이 될 것 같습니다.

[Chris_Shim]

Update the "What's new in ASP.NET Core 10.0" for .NET 10 Preview 4

Minimal API vs Controller 성능 비교 (1000배 차이)

source generator 기반으로 MVC Model Validation과는 또 다른 물건 같군요. .net 10 preview 3에서도 테스트 해 볼 수 있습니다. interceptor를 사용합니다. 우선 발견한 불편사항은… record 타입의 dto를 지원하지 않는군요.

record 는 .net 10 preview 4에서 지원한다고 하는군요.
아주 좋네요.

잔여이슈

dotnet/aspnetcore