[KOSD] .NET o .NET8에서 FromQuery 모델 바인딩 변경

최근에 우리 팀 동료인 Jeremy Chan이 .NET 6에서 .NET 8로 프로젝트를 마이그레이션하는 동안 .NET 7 이후 나타나는 것으로 보이는 모델 바인딩 동작의 문서화되지 않은 변경 사항을 발견했습니다. 이 변경 사항은 공식 .NET에서 명확하게 설명되지 않습니다. 문서화되어 있으므로 개발자가 쉽게 간과할 수 있습니다.

문제를 설명하기 위해 간단한 웹 API 프로젝트부터 시작하여 변경 사항을 강조하는 간단한 컨트롤러 방법을 살펴보겠습니다.

[ApiController]
public class FooController
{
  [HttpGet()]
  public async void Get([FromQuery] string value = "Hello")
  {
    Console.WriteLine($"Value is {value}");

    return new JsonResult() { StatusCode = StatusCodes.Status200OK };
  }
}

그런 다음 .NET 6 및 .NET 8 프로젝트 모두에서 null 허용이 활성화되어 있다고 가정합니다.

<project sdk="Microsoft.NET.Sdk.Web">

    <propertygroup>
        <nullable>enable</nullable>
        ...
    </propertygroup>

    ...

</project>

.NET 6의 상황

.NET 6에서 /foo?value=로 엔드포인트를 호출하면 다음 오류가 발생합니다.

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "00-5bc66c755994b2bba7c9d2337c1e5bc4-e116fa61d942199b-00",
  "errors": {
    "value": [
      "The value field is required."
    ]
  }
}

단, 다음과 같이 메소드를 변경하면 오류가 발생하지 않습니다.

public async void Get([FromQuery] string? value)
{
    if (value is null)
        Console.WriteLine($"Value is null!!!");
    else
        Console.WriteLine($"Value is {value}");

    return new JsonResult() { StatusCode = StatusCodes.Status200OK };
}

/foo?value=로 엔드포인트를 호출할 때 로그에 "값이 null입니다!!!"가 됩니다.

따라서 값이 없는 쿼리 문자열은 null로 해석된다는 것을 알 수 있습니다. 그렇기 때문에 값이 Null 허용이 아닌 경우 유효성 검사 오류가 발생합니다.

따라서 .NET 6에서 엔드포인트가 작동하게 하려면 값을 선택적으로 만들기 위해 다음과 같이 변경해야 한다고 말할 수 있습니다. 값을 필수 필드로 표시하지 않습니다.

public async void Get([FromQuery] string? value = "Hello")

이제 /foo?value=로 엔드포인트를 호출하면 "Value is Hello"라는 로그가 인쇄되는 것을 받게 됩니다.

.NET 8(및 .NET 7)의 상황

그럼 아래와 같이 원래 설정이 동일한 .NET 8에서는 어떻습니까?

public async void Get([FromQuery] string value = "Hello")

.NET 8에서 /foo?value=로 엔드포인트를 호출하면 "Value is Hello"라는 로그가 인쇄되는 것을 볼 수 있습니다.

그럼 여기서 무슨 일이 일어나고 있는 걸까요?

.NET 7에는 새로운 IParsable 인터페이스가 도입되었습니다. 따라서 .NET 7부터 컨트롤러 작업 매개변수 값을 바인딩하는 데 IParsable.TryParse API가 사용됩니다.

초기 연구에 따르면 .NET 7 이후에는 새로운 모델 바인딩 구현이 사용되며 이로 인해 이러한 일이 발생하는 것으로 나타났습니다.

참고자료

• [API 제안]: 문자열은 IParsable을 구현해야 합니다.
• 부울과 문자열로 ISpanParsable을 구현합니다.

KOSD(Kopi-O Siew Dai)는 제가 즐겨 마시는 싱가포르 커피 중 하나입니다. 기본적으로 설탕을 약간 넣은 커피 한 잔입니다. 이번 시리즈는 제가 코피오 시에우다이(Kopi-O Siew Dai) 한 잔을 마시면서 얻은 기술적 지식을 블로그에 담아보려고 합니다.

위 내용은 [KOSD] .NET o .NET8에서 FromQuery 모델 바인딩 변경의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!