Byndyusoft.AspNetCore.Mvc.Formatters.ProtoBuf

Byndyusoft.aspnetcore.mvc.formatters.protobuf

ASP.NET Core MVC Formatters untuk input dan output protobuf.

Buffer Protokol adalah mekanisme yang dapat diperluas oleh bahasa Google, platform-netral, yang dapat diperluas untuk membuat serial data terstruktur-pikirkan XML, tetapi lebih kecil, lebih cepat, dan lebih sederhana.

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 ProtoBuf :

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

Dalam contoh ini paket byndyusoft.net.http.protobuf digunakan.

Konfigurasikan formatters

Asp.net Core Apps yang perlu mendukung format protobuf dapat menambahkan paket nuget Byndyusoft.AspNetCore.Mvc.Formatters.ProtoBuf 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.ProtoBuf

Tambahkan Dukungan Format Protobuf ke ASP.NET

Format Protobuf Diimplementasikan Menggunakan ProtoBufSerializer dikonfigurasi dengan menelepon AddProtoBufFormatters :

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

Kode sebelumnya membuat serial hasil menggunakan ProtoBufSerializer .

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 .protobuf.

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.protobuf	Formatter protobuf (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]