精品一区二区视频,亚洲精品国产男人的天堂,欧美日韩国产伦理

設(shè)計(jì)強(qiáng)大的 API 的一個(gè)關(guān)鍵方面是能夠以各種格式返回響應(yīng)，以滿足不同的客戶端需求。在 API 的上下文中，序列化和反序列化對(duì)于客戶端和服務(wù)器之間的數(shù)據(jù)交換至關(guān)重要。當(dāng)客戶端向 API 發(fā)出請(qǐng)求時(shí)，它通常需要向服務(wù)器發(fā)送數(shù)據(jù)（例如 JSON）。服務(wù)器將此數(shù)據(jù)反序列化為它可以處理的對(duì)象。當(dāng)服務(wù)器響應(yīng)時(shí)，它會(huì)將對(duì)象序列化回客戶端可以理解的格式（例如，JSON、XML）。

序列化是將對(duì)象轉(zhuǎn)換為易于存儲(chǔ)或傳輸?shù)母袷降倪^程。這可能涉及將對(duì)象轉(zhuǎn)換為字節(jié)流、JSON 字符串、XML 文檔或其他格式。序列化可以將對(duì)象的狀態(tài)保存到文件中，通過網(wǎng)絡(luò)發(fā)送對(duì)象，或?qū)⑵浯鎯?chǔ)在數(shù)據(jù)庫(kù)中。

反序列化是相反的過程。它涉及將數(shù)據(jù)從存儲(chǔ)或傳輸?shù)母袷睫D(zhuǎn)換回對(duì)象。這允許使用其原始狀態(tài)和數(shù)據(jù)重建對(duì)象。

API 可以根據(jù)需求和客戶端的偏好返回各種類型的數(shù)據(jù)格式。以下是 API 可以返回的一些常見數(shù)據(jù)類型：

HTTP本身并不規(guī)定數(shù)據(jù)如何在格式上在客戶端和服務(wù)器之間傳遞;它與所使用的內(nèi)容類型和編碼無(wú)關(guān)。JSON 是一種被廣泛接受的現(xiàn)代 Web API 數(shù)據(jù)交換格式，因?yàn)樗哂泻?jiǎn)單性、可讀性以及與 JavaScript 和許多其他編程語(yǔ)言的易用性。

以下是 HTTP 請(qǐng)求和響應(yīng)中通常如何處理 JSON 數(shù)據(jù)：

HTTP 請(qǐng)求：

Content-Type Header：當(dāng)客戶端向服務(wù)器發(fā)送 JSON 數(shù)據(jù)時(shí)（例如，在 POST 或 PUT 請(qǐng)求中），它包含一個(gè)指定 .此標(biāo)頭告訴服務(wù)器請(qǐng)求正文包含 JSON 數(shù)據(jù)。Content-Typeapplication/json
請(qǐng)求正文：JSON 數(shù)據(jù)本身作為 HTTP 請(qǐng)求的正文發(fā)送。它是一個(gè)符合 JSON 格式的純文本字符串，除非有特定的應(yīng)用程序級(jí)要求或約束，否則不需要以 base64 編碼。

HTTP 響應(yīng)：

Content-Type Header：當(dāng)服務(wù)器使用 JSON 數(shù)據(jù)進(jìn)行響應(yīng)時(shí)，它會(huì)在響應(yīng)中包含一個(gè)指定 .此標(biāo)頭向客戶端指示響應(yīng)正文包含 JSON 數(shù)據(jù)。Content-Typeapplication/json
響應(yīng)正文：JSON 數(shù)據(jù)作為 HTTP 響應(yīng)的正文返回。同樣，它是一個(gè)符合 JSON 格式的純文本字符串。

編碼問題：

Base64 編碼：當(dāng)您需要通過基于文本的協(xié)議（如 HTTP ）傳輸二進(jìn)制數(shù)據(jù)（如圖像或文件）時(shí)，通常使用 Base64 編碼。JSON 基于文本，由 UTF-8 編碼字符組成，其核心功能不需要 base64 編碼。它以原始文本格式按原樣傳輸。
特定于應(yīng)用程序的需求：有時(shí)，應(yīng)用程序可能出于特定原因需要以 base64 格式編碼 JSON 數(shù)據(jù)，例如在某些安全上下文中或與需要二進(jìn)制安全傳輸?shù)南到y(tǒng)集成時(shí)。但是，這不是 Web API 中典型 JSON 數(shù)據(jù)交換的標(biāo)準(zhǔn)做法。

在 .NET 中，在中間件中配置序列化涉及設(shè)置適當(dāng)?shù)男蛄谢绦蚝透袷交绦騺?lái)處理各種數(shù)據(jù)格式。以下是在 .NET 6 中執(zhí)行此操作的方法。

在 .NET 中間件中配置序列化的分步指南

使用 System.Text.Json 進(jìn)行1. JSON序列化

System.Text.Json是 .NET Core 和 .NET 6 中的默認(rèn) JSON 序列化程序。它以其性能和低內(nèi)存使用率而聞名。

2. JSON 使用 Newtonsoft.Json 進(jìn)行序列化

Newtonsoft.Json（也稱為 Json.NET）是用于 .NET 的常用 JSON 框架。它具有高度的通用性，并因其廣泛的功能而被廣泛使用。我們需要添加 nuget 包 Microsoft.AspNetCore.Mvc.NewtonsoftJson，并在 .net 中間件中配置它，如下所示

var builder = WebApplication.CreateBuilder(args);  



builder.Services.AddControllers()  

    .AddNewtonsoftJson();  



var app = builder.Build();  



if (app.Environment.IsDevelopment())  

{  

    app.UseDeveloperExceptionPage();  

}  



app.UseHttpsRedirection();  

app.UseAuthorization();  

app.MapControllers();  

app.Run();

3. XML序列化

對(duì)于 XML 序列化，您需要將 XML 格式化程序添加到 API 配置中。我們需要 dotnet 添加 nuget 包和配置 Microsoft.AspNetCore.Mvc.Formatters.Xml

var builder = WebApplication.CreateBuilder(args);  



// Add services to the container.  

builder.Services.AddControllers()  

    .AddXmlSerializerFormatters(); // Add XML support  



var app = builder.Build();  



if (app.Environment.IsDevelopment())  

{  

    app.UseDeveloperExceptionPage();  

}  



app.UseHttpsRedirection();  

app.UseAuthorization();  

app.MapControllers();  

app.Run();

4. 協(xié)議緩沖區(qū) （Protobuf）

協(xié)議緩沖區(qū)用于高效的數(shù)據(jù)序列化，適用于性能關(guān)鍵型應(yīng)用程序。我們需要添加包 Google.Protobuf 和 Grpc.AspNetCore 以及處理請(qǐng)求和響應(yīng)的控制器，并將其配置為支持 JSON 和 XML 序列化。

var builder = WebApplication.CreateBuilder(args);  

builder.Services.AddGrpc();  

builder.Services.AddControllers();  



var app = builder.Build();  

if (app.Environment.IsDevelopment())  

{  

    app.UseDeveloperExceptionPage();  

}  



app.UseHttpsRedirection();  

app.UseRouting();  

app.UseAuthorization();

在 .NET 6 中，可以將中間件配置為支持多種序列化格式，例如 XML 和 JSON。讓我們看看下面的代碼，以同時(shí)使用 XML 序列化和 Newtonsoft.Json 序列化。

var builder = WebApplication.CreateBuilder(args);  



builder.Services.AddControllers()  

    .AddNewtonsoftJson() // Add Newtonsoft.Json support  

    .AddXmlSerializerFormatters(); // Add XML support  



var app = builder.Build();  

if (app.Environment.IsDevelopment())  

{  

    app.UseDeveloperExceptionPage();  

}  

app.UseHttpsRedirection();  

app.UseAuthorization();  

app.MapControllers();  

app.Run();

[ApiController]

[Route("api/[controller]")]

public class OrderController : ControllerBase

{

     [HttpPost]

    [Produces("application/json", "application/xml")]

    public IActionResult CreateOrder()

    {

        var contentType = Request.ContentType;



        if (contentType.Contains("application/json"))

        {

            using var reader = new StreamReader(Request.Body);

            var jsonString = reader.ReadToEnd();

            var order = JsonConvert.DeserializeObject<Order>(jsonString);



            if (order == null)

            {

                return BadRequest();

            }



            return Ok(order); // Return the created order in JSON

        }

        else if (contentType.Contains("application/xml"))

        {

            var serializer = new XmlSerializer(typeof(Order));

            using var reader = new StreamReader(Request.Body);

            var order = (Order)serializer.Deserialize(reader);

            if (order == null)

            {

                return BadRequest();

            }

            return Ok(order); // Return the created order in XML

        }

        else

        {

            return UnsupportedMediaType();

        }

    }

}

結(jié)論

在 .NET 中間件中配置序列化涉及選擇適當(dāng)?shù)男蛄谢绦虿⒃O(shè)置必要的格式化程序。通過理解和利用 System.Text.Json、Newtonsoft.Json、XML 格式化程序和協(xié)議緩沖區(qū)等庫(kù)，您可以確保您的 API 有效地處理各種數(shù)據(jù)格式，滿足不同的客戶端需求并優(yōu)化性能。這些配置和庫(kù)使開發(fā)人員能夠創(chuàng)建多功能且強(qiáng)大的 API，這些 API 可以有效地序列化和反序列化數(shù)據(jù)，從而增強(qiáng)互操作性和性能。

本文章轉(zhuǎn)載微信公眾號(hào)@dotNET跨平臺(tái)