Byndyusoft.AspNetCore.Mvc.Formatters.MessagePack

Byndyusoft.aspnetcore.mvc.Formatters.MessagePack

ASP.NET Core MVC Formatters untuk Input dan Output MessagePack.

MessagePack adalah format serialisasi biner yang efisien. Ini memungkinkan Anda bertukar data di antara berbagai bahasa seperti JSON. Tapi lebih cepat dan lebih kecil. Bilangan bulat kecil dikodekan menjadi satu byte, dan string pendek yang khas hanya membutuhkan satu byte tambahan selain string itu sendiri.

Negosiasi konten

Negosiasi konten terjadi ketika klien menentukan header Accept . Format default yang digunakan oleh ASP.NET Core adalah JSON. Tetapi klien dapat menentukan format 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 > ( ) ;
}

Dalam contoh ini ByndyUsoft.net.http.messagePack digunakan.

Konfigurasikan formatters

Asp.net Core Apps yang perlu mendukung format MessagePack dapat menambahkan Byndyusoft.AspNetCore.Mvc.Formatters.MessagePack Nuget Paket dan mengkonfigurasi dukungan. Ada formatter terpisah untuk input dan output. Formatter input digunakan oleh pengikatan model. Formatter output digunakan untuk memformat respons.

Menginstal

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

Tambahkan Dukungan Format MessagePack ke ASP.NET

Formatter MessagePack diimplementasikan menggunakan MessagePackSerializer dikonfigurasi dengan memanggil AddMessagePackFormatters :

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

Kode sebelumnya membuat serial hasil menggunakan MessagePackSerializer .

Mengkonfigurasi FORMITTERS MESSAGEPACK

Fitur untuk format messagePack dapat dikonfigurasi menggunakan Microsoft.AspNetCore.Mvc.MvcMessagePackOptions.SerializerOptions .

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

Pemetaan URL format respons

Klien dapat meminta format tertentu sebagai bagian dari URL, misalnya:

• Di string kueri atau bagian dari jalur.
• Dengan menggunakan ekstensi file khusus format seperti .json atau .msgpack.

Pemetaan dari jalur permintaan harus ditentukan dalam rute yang digunakan API. Misalnya:

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

Rute sebelumnya memungkinkan format yang diminta ditentukan sebagai ekstensi file opsional. Atribut [FormatFilter] memeriksa adanya nilai format dalam routedata dan memetakan format respons ke formatter yang sesuai ketika respons dibuat.

Rute	Formatter
/API/Produk/5	Formatter output default
/api/products/5.json	Formatter JSON (jika dikonfigurasi)
/api/products/5.msgpack	Formatter MessagePack (jika dikonfigurasi)

Berkontribusi

Untuk berkontribusi, Anda perlu mengatur lingkungan lokal Anda, lihat prasyarat. Untuk panduan kontribusi dan alur kerja, lihat siklus hidup pengembangan paket.

Tinjauan terperinci tentang cara berkontribusi dapat ditemukan di panduan yang berkontribusi.

Prasyarat

Pastikan Anda telah memasang semua prasyarat berikut di mesin pengembangan Anda:

• Git - Unduh & Instal Git. Mesin OSX dan Linux biasanya sudah menginstal ini.
• .Net (versi 8.0 atau lebih tinggi) - Unduh & instal .NET Core.

Tata letak folder umum

SRC

• Kode Sumber

tes

• tes unit

Siklus Pengembangan Paket

• Menerapkan logika paket di src
• Tambahkan atau Tes Unit Addapt (lebih disukai sebelumnya dan bersamaan dengan pengkodean) dalam tests
• Menambah atau mengubah dokumentasi sesuai kebutuhan
• Buka permintaan tarik di cabang yang benar. Targetkan Cabang master Proyek

Pemelihara

[email protected]