Share via

ASP.NET Core 앱은 따옴표 붙은 숫자를 역직렬화할 수 있음

  • 아티클

.NET 5부터 ASP.NET Core 앱은 JsonSerializerDefaults.Web에 지정된 대로 기본 deserialization 옵션을 사용합니다. 옵션의 Web 집합에는 NumberHandling을 JsonNumberHandling.AllowReadingFromString으로 설정하는 작업이 포함됩니다. 이 변경 내용은 ASP.NET Core 앱이 예외를 throw하는 대신 JSON 문자열로 표현되는 숫자를 역직렬화함을 의미합니다.

변경 내용 설명

.NET Core 3.0 - 3.1에서는 JSON 페이로드에 따옴표 붙은 숫자가 있는 경우 JsonSerializer에서 deserialization 중에 JsonException을 throw합니다. 따옴표 붙은 숫자는 개체 그래프의 숫자 속성으로 매핑하는 데 사용됩니다. .NET Core 3.0 - 3.1에서 숫자는 JsonTokenType.Number 토큰에서만 읽을 수 있습니다.

.NET 5부터 JSON 페이로드의 따옴표 붙은 숫자는 기본적으로 ASP.NET Core 앱에 유효한 것으로 간주합니다. 따옴표 붙은 숫자 deserialization 중에는 예외가 throw되지 않습니다.

팁

  • 기본, 독립 실행형 JsonSerializer 또는 JsonSerializerOptions에 대한 동작은 변경되지 않습니다.
  • 기술적으로는 더욱 제한적이기보다는 더욱 허용하는 시나리오를 만들기 때문에 호환성이 손상되는 변경이 아닙니다. 즉, 예외를 throw하는 대신 JSON 문자열에서 숫자를 강제 변환하는 데 성공합니다. 그러나 ASP.NET Core 앱에 영향을 주는 중요한 동작 변경 사항이기 때문에 여기에 설명되어 있습니다.
  • HttpClientJsonExtensions.GetFromJsonAsync 및 HttpContentJsonExtensions.ReadFromJsonAsync 확장 메서드도 serialization 옵션의 Web 집합을 사용합니다.

도입된 버전

5.0

변경 이유

여러 사용자가 JsonSerializer에서 더욱 허용적인 숫자 처리에 대한 옵션을 요청했습니다. 이 피드백은 많은 JSON 생산자(예: 웹의 서비스)가 따옴표 붙은 숫자를 내보냄을 나타냅니다. 따옴표 붙은 숫자를 읽을 수 있도록 역직렬화하면 .NET 앱은 기본적으로 웹 컨텐스트에서 이러한 페이로드를 구문 분석할 수 있습니다. 클라이언트, 서버 및 공유와 같이 여러 애플리케이션 계층에서 동일한 옵션을 지정할 수 있도록 JsonSerializerDefaults.Web을 통해 구성이 노출됩니다.

예를 들어 유효성 검사를 위해 엄격한 숫자 처리를 사용하는 경우처럼 이러한 변경이 중단되면 이전 동작을 다시 사용하도록 설정할 수 있습니다. JsonSerializerOptions.NumberHandling 옵션을 JsonNumberHandling.Strict으로 설정하세요.

ASP.NET Core MVC 및 웹 API 앱의 경우 다음 코드를 사용하여 Startup에서 옵션을 구성할 수 있습니다.

services.AddControllers()
   .AddJsonOptions(options => options.JsonSerializerOptions.NumberHandling = JsonNumberHandling.Strict);

영향을 받는 API