Byndyusoft.AspNetCore.Mvc.Formatters.MessagePack 다운로드 - Byndyusoft.AspNetCore.Mvc.Formatters.MessagePack 소스 코드 다운로드

Byndyusoft.AspNetCore.Mvc.Formatters.MessagePack

기타 카테고리

v0.4.0: .net 8.0 migration

다운로드

byndyusoft.aspnetcore.mvc.formatters.messagepack

MessagePack 입력 및 출력을위한 ASP.NET Core MVC Formatter.

MessagePack은 효율적인 이진 직렬화 형식입니다. JSON과 같은 여러 언어로 데이터를 교환 할 수 있습니다. 그러나 더 빠르고 작습니다. 작은 정수는 단일 바이트로 인코딩되며 일반적인 짧은 줄은 문자열 자체 외에 하나의 여분의 바이트 만 필요합니다.

콘텐츠 협상

컨텐츠 협상은 클라이언트가 Accept 헤더를 지정할 때 발생합니다. ASP.NET Core에서 사용하는 기본 형식은 JSON입니다. 그러나 클라이언트는 MessagePack 형식을 지정할 수 있습니다.

 using ( var httpClient = new HttpClient ( ) )
{
	client . DefaultRequestHeaders . Accept . Add ( new MediaTypeWithQualityHeaderValue ( "application/msgpack" ) ) ;
	var response = await client . GetAsync ( "/api/products/5" ) ;
	var product = response . Content . ReadFromMessagePackAsync < Product > ( ) ;
}

이 예에서는 byndyusoft.net.http.messagepack 패키지가 사용됩니다.

포맷터를 구성하십시오

MessagePack 형식을 지원 해야하는 ASP.NET Core 앱은 Byndyusoft.AspNetCore.Mvc.Formatters.MessagePack nuget 패키지를 추가하고 지원을 구성 할 수 있습니다. 입력 및 출력을위한 별도의 형성자가 있습니다. 입력 포피터는 모델 바인딩에 의해 사용됩니다. 출력 포피터는 응답을 포맷하는 데 사용됩니다.

설치

dotnet add package Byndyusoft.AspNetCore.Mvc.Formatters.MessagePack

ASP.NET에 MessagePack 형식 지원을 추가하십시오

MessagePackSerializer 사용하여 구현 된 MessagePack Formatters는 AddMessagePackFormatters 호출하여 구성됩니다.

 public void ConfigureServices ( IServiceCollection services )
{
     services . AddMvcCore ( )
        . AddMessagePackFormatters ( ) ;
}

앞의 코드는 MessagePackSerializer 사용하여 결과를 연속화합니다.

MessagePack Formatters를 구성하십시오

MosePack Formatters의 기능은 Microsoft.AspNetCore.Mvc.MvcMessagePackOptions.SerializerOptions 를 사용하여 구성 할 수 있습니다.

 services . AddMvcCore ( )
	. AddMessagePackFormatters (
		options =>
		{
			options . SerializerOptions
				. WithResolver ( TypelessContractlessStandardResolver . Instance )
				. WithCompression ( MessagePackCompression . Lz4Block )
				. WithSecurity ( MessagePackSecurity . TrustedData ) ;
		} ) ;

응답 형식 URL 매핑

클라이언트는 URL의 일부로 특정 형식을 요청할 수 있습니다.

쿼리 문자열 또는 경로의 일부에서.
.json 또는 .msgpack과 같은 형식 별 파일 확장자를 사용합니다.

API가 사용하는 경로에 요청 경로에서 매핑을 지정해야합니다. 예를 들어:

 [ Route ( "api/[controller]" ) ]
[ ApiController ]
[ FormatFilter ]
public class ProductsController : ControllerBase
{
    [ HttpGet ( "{id}.{format?}" ) ]
    public Product Get ( int id )
    {

앞의 경로를 사용하면 요청 된 형식을 선택적 파일 확장자로 지정할 수 있습니다. [FormatFilter] 속성은 Routedata에 형식 값의 존재를 확인하고 응답이 생성 될 때 응답 형식을 적절한 형식에 맵핑합니다.

노선	형성자
/API/Products/5	기본 출력 포맷터
/api/products/5.json	JSON Formatter (구성된 경우)
/api/products/5.msgpack	MessagePack Formatter (구성된 경우)