.NET 6 中 System.Text.Json 的新特性

1支持忽略循环引用

在 .NET 6 之前,如果 System.Text.Json 检测到循环引用,就会抛出 JsonException 异常。在 .NET 6 中,你可以忽略它们。

Category dotnet = new()
{Name = ".NET 6",
};
Category systemTextJson = new()
{Name = "System.Text.Json",Parent = dotnet
};
dotnet.Children.Add(systemTextJson);JsonSerializerOptions options = new()
{ReferenceHandler = ReferenceHandler.IgnoreCycles,WriteIndented = true
};string dotnetJson = JsonSerializer.Serialize(dotnet, options);
Console.WriteLine($"{dotnetJson}");public class Category
{public string Name { get; set; }public Category Parent { get; set; }public List<Category> Children { get; set; } = new();
}// Output:
// {
//   "Name": ".NET 6",
//   "Parent": null,
//   "Children": [
//     {
//       "Name": "System.Text.Json",
//       "Parent": null,
//       "Children": []
//     }
//   ]
// }

2(反)序列化事件通知

在 .NET 6 中,System.Text.Json 暴露了(反)序列化的事件通知接口。

有四个新的接口可以根据你的需要来实现:

  • IJsonOnDeserialized

  • IJsonOnDeserializing

  • IJsonOnSerialized

  • IJsonOnSerializing

Product invalidProduct = new() { Name = "Name", Test = "Test" };
JsonSerializer.Serialize(invalidProduct);
// The InvalidOperationException is thrownstring invalidJson = "{}";
JsonSerializer.Deserialize<Product>(invalidJson);
// The InvalidOperationException is thrownclass Product : IJsonOnDeserialized, IJsonOnSerializing, IJsonOnSerialized
{public string Name { get; set; }public string Test { get; set; }public void OnSerialized(){throw new NotImplementedException();}void IJsonOnDeserialized.OnDeserialized() => Validate(); // Call after deserializationvoid IJsonOnSerializing.OnSerializing() => Validate();   // Call before serializationprivate void Validate(){if (Name is null){throw new InvalidOperationException("The 'Name' property cannot be 'null'.");}}
}

3支持 Order 属性

以前,序列化顺序是由反射顺序决定的。在 .NET 6 中,System.Text.Json 添加了 JsonPropertyOrderAttribute 特性,它允许控制属性的序列化顺序。

Product product = new()
{Id = 1,Name = "Surface Pro 7",Price = 550,Category = "Laptops"
};JsonSerializerOptions options = new() { WriteIndented = true };
string json = JsonSerializer.Serialize(product, options);
Console.WriteLine(json);class Product : A
{[JsonPropertyOrder(2)] // Serialize after Pricepublic string Category { get; set; }[JsonPropertyOrder(1)] // Serialize after other properties that have default orderingpublic decimal Price { get; set; }public string Name { get; set; } // Has default ordering value of 0[JsonPropertyOrder(-1)] // Serialize before other properties that have default orderingpublic int Id { get; set; }
}class A
{public int Test { get; set; }
}// Output:
// {
//   "Id": 1,
//   "Name": "Surface Pro 7",
//   "Price": 550,
//   "Category": "Laptops"
// }

4用 Utf8JsonWriter 写原始 JSON

.NET 6 引入了 System.Text.Json.Utf8JsonWriter,用它可以写原始 JSON。

在你有下面需要的时候很有用:

  • 在新的 JSON 中包含现有的 JSON

  • 以不同于默认格式的方式对数值进行格式化

JsonWriterOptions writerOptions = new() { Indented = true, };using MemoryStream stream = new();
using Utf8JsonWriter writer = new(stream, writerOptions);writer.WriteStartObject();
writer.WriteStartArray("customJsonFormatting");
foreach (double result in new double[] { 10.2, 10 })
{writer.WriteStartObject();writer.WritePropertyName("value");writer.WriteRawValue(FormatNumberValue(result), skipInputValidation: true);writer.WriteEndObject();
}
writer.WriteEndArray();
writer.WriteEndObject();
writer.Flush();string json = Encoding.UTF8.GetString(stream.ToArray());
Console.WriteLine(json);static string FormatNumberValue(double numberValue)
{return numberValue == Convert.ToInt32(numberValue)? numberValue.ToString() + ".0": numberValue.ToString();
}// Output:
// {
//    "customJsonFormatting": [
//      {
//        "value": 10.2
//      },
//      {
//        "value": 10.0
//      }
//  ]
// }

5支持 IAsyncEnumerable

在 .NET 6 中,System.Text.Json 支持 IAsyncEnumerableIAsyncEnumerable 的序列化将其转化为一个数组。对于根级 JSON 数组的反序列化,增加了 DeserializeAsyncEnumerable 方法。

static async IAsyncEnumerable<int> GetNumbersAsync(int n)
{for (int i = 0; i < n; i++){await Task.Delay(1000);yield return i;}
}
// Serialization using IAsyncEnumerable
JsonSerializerOptions options = new() { WriteIndented = true };
using Stream outputStream = Console.OpenStandardOutput();
var data = new { Data = GetNumbersAsync(5) };
await JsonSerializer.SerializeAsync(outputStream, data, options);
// Output:
// {
//    "Data": [
//      0,
//      1,
//      2,
//      3,
//      4
//  ]
// }// Deserialization using IAsyncEnumerable
using MemoryStream memoryStream = new(Encoding.UTF8.GetBytes("[0,1,2,3,4]"));
// Wraps the UTF-8 encoded text into an IAsyncEnumerable<T> that can be used to deserialize root-level JSON arrays in a streaming manner.
await foreach (int item in JsonSerializer.DeserializeAsyncEnumerable<int>(memoryStream))
{Console.WriteLine(item);
}
// Output:
// 0
// 1
// 2
// 3
// 4

下面的 GIF 展示了 IAsyncEnumerable 如何被序列化:

05ba71b9fa320ab500b9314d3e699ddb.gif

6JSON 和 Stream 互转

在 .NET 6 中,添加了同步方法 Serialize/DeserializeStream 重载。

string json = "{\"Value\":\"Deserialized from stream\"}";
byte[] bytes = Encoding.UTF8.GetBytes(json);// Deserialize from stream
using MemoryStream ms = new MemoryStream(bytes);
Example desializedExample = JsonSerializer.Deserialize<Example>(ms);
Console.WriteLine(desializedExample.Value);
// Output: Deserialized from stream// ==================================================================// Serialize to stream
JsonSerializerOptions options = new() { WriteIndented = true };
using Stream outputStream = Console.OpenStandardOutput();
Example exampleToSerialize = new() { Value = "Serialized from stream" };
JsonSerializer.Serialize<Example>(outputStream, exampleToSerialize, options);
// Output:
// {
//    "Value": "Serialized from stream"
// }class Example
{public string Value { get; set; }
}

7像 DOM 一样操作 JSON

在 .NET 6 中,提供了处理 in-memory 可写文档对象模型(DOM)的类型,用于随机访问结构化数据视图中的 JSON 元素。

新类型:

  • JsonArray

  • JsonNode

  • JsonObject

  • JsonValue

// Parse a JSON object
JsonNode jNode = JsonNode.Parse("{\"Value\":\"Text\",\"Array\":[1,5,13,17,2]}");
string value = (string)jNode["Value"];
Console.WriteLine(value); // Text// or
value = jNode["Value"].GetValue<string>();
Console.WriteLine(value); // Textint arrayItem = jNode["Array"][1].GetValue<int>();
Console.WriteLine(arrayItem); // 5// or
arrayItem = jNode["Array"][1].GetValue<int>();
Console.WriteLine(arrayItem); // 5// Create a new JsonObject
var jObject = new JsonObject
{["Value"] = "Text",["Array"] = new JsonArray(1, 5, 13, 17, 2)
};
Console.WriteLine(jObject["Value"].GetValue<string>());  // Text
Console.WriteLine(jObject["Array"][1].GetValue<int>());  // 5// Converts the current instance to string in JSON format
string json = jObject.ToJsonString();
Console.WriteLine(json); // {"Value":"Text","Array":[1,5,13,17,2]}

8收尾

所有的代码示例你都可以在我的 GitHub 上找到:

https://github.com/okyrylchuk/dotnet6_features/tree/main/System.Text.Json%20features

原文:bit.ly/3zma38X
作者:Oleg Kyrylchuk
翻译:精致码农

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/293131.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Java基础知识回顾--线程

基本概念 线程是一个程序内部的顺序控制流 Java的线程是通过java.lang.Thread类来实现的。main函数是一个主线程&#xff0c;用户可以通过创建Thread的实例来创建新的线程。每一个线程都必须实现run方法。通过Thread类的start方法来启动一个线程。 两种方式实现&#xff0c;一…

四、物理优化(1)范式化

一、范式化的概念范式化&#xff08;Normalization&#xff09;的目标是消除数据冗余&#xff0c;减小物理存储空间。常用的范式有以下3种&#xff1a;1. 第一范式&#xff08;1NF&#xff09;在任何一个关系数据库中&#xff0c;1NF是对关系模式的基本要求&#xff0c;不满足1…

​如何在图书馆收获一段爱情?​

1 你为什么不喜欢拍照片&#xff08;素材来源网络&#xff0c;侵删&#xff09;▼2 当登记处挂起横幅▼3 这几天老是犯的错误▼4 在图书馆收获的爱情&#xff08;素材来源网络&#xff0c;侵删&#xff09;▼5 当老师用键盘讲课&#xff08;素材来源网络&#xff0c;侵删&a…

MongoDB服务无法启动,原因居然是...

前言某台CentOS服务器上的MongoDB服务突然停止运行&#xff0c;于是登上去排查原因&#xff0c;接下来就是苦逼的爬坑之旅。爬坑记录1、重启服务使用systemctl命令重启服务&#xff1a;systemctl restart mongod.service查看系统日志&#xff1a;journalctl -ex只是提示启动失败…

python绘制饼图双层_有趣!如何用Python-matplotlib绘制双层饼图及环形图?

&#xff08;1&#xff09; 饼图&#xff08;pie&#xff09;&#xff0c;即在一个圆圈内分成几块&#xff0c;显示不同数据系列的占比大小&#xff0c;这也是我们在日常数据的图形展示中最常用的图形之一。 在python中常用matplotlib的pie来绘制&#xff0c;基本命令如下所示&…

C# 获取Excel中的合并单元格

C# 获取Excel中的合并单元格 我们在制作表格时&#xff0c;有时经常需要合并及取消合并一些单元格。在取消合并单元格时需要逐个查找及取消&#xff0c;比较麻烦。这里分享一个简单的方法来识别Excel中的合并单元格&#xff0c;识别这些合并单元格之后对这些单元格进行取消合并…

SQL Server 解读【已分区索引的特殊指导原则】(3) - 非聚集索引分区

一、前言 在MSDN上看到一篇关于SQL Server 表分区的文档&#xff1a;已分区索引的特殊指导原则&#xff0c;如果你对表分区没有实战经验的话是比较难理解文档里面描述的意思。这里我就里面的一些概念进行讲解&#xff0c;方便大家的交流。 SQL Server 解读【已分区索引的特殊指…

Android之SharedPreferences 存储复杂对象

用SharedPreferences存储一些常用的设置信息很方便&#xff0c;但是我们知道SharedPreferences只能存储一些简单的类型 如何用SharedPreferences来存储一些复杂的对象&#xff1f;下面以map为例&#xff0c;看看SharedPreferences 存储复杂对象的方法 如果想用SharedPreference…

.NET 云原生架构师训练营(设计原则设计模式)--学习笔记

▲ 点击上方“DotNet NB”关注公众号回复“1”获取开发者路线图学习分享 丨作者 / 郑 子 铭 这是DotNet NB 公众号的第180篇原创文章目录设计原则设计模式设计原则DRY (Dont repeat yourself 不要重复)KISS (Keep it stupid simple 简单到傻子都能看懂)YAGNI (You Arent Gon…

qt qss设置字体大小_Qt编写自定义控件70-扁平化flatui

一、前言对于现在做前端开发人员来说&#xff0c;FlatUI肯定不陌生&#xff0c;最近几年扁平化的设计越来越流行&#xff0c;大概由于现在PC端和移动端的设备的分辨率越来越高&#xff0c;扁平化反而看起来更让人愉悦&#xff0c;而通过渐变色产生的质感色彩反而没有扁平化来得…

机器学习之决策树熵信息增量求解算法实现

此文不对理论做相关阐述,仅涉及代码实现: 1.熵计算公式: P为正例,Q为反例 Entropy(S) -PLog2(P) - QLog2(Q); 2.信息增量计算: Gain(S,Sv) Entropy(S) - (|Sv|/|S|)ΣEntropy(Sv); 举例: 转化数据输入: 5 14Outlook Sunny Sunny Overcast Rain Rain Rain …

centos6.4下安装jdk

centos安装好后一般默认安装好了openJDK&#xff0c;且在6.4版本下是jdk7&#xff0c;我们要将其卸载在安装jdk6 1.卸载默认安装好的jdk&#xff0c;按下图所示的命令行命令卸载jdk 2.将jdk安装包上传到/usr/local目录下(将jdk其安装到这个目录下&#xff0c;可用winSCP工具上传…

实践剖析.NET Core如何支持Cookie滑动过期和JWT混合认证、授权

【导读】为防止JWT Token被窃取&#xff0c;我们将Token置于Cookie中&#xff0c;但若与第三方对接&#xff0c;调用我方接口进行认证、授权此时仍需将Token置于请求头&#xff0c;通过实践并联系理论&#xff0c;我们继续开始整活首先我们实现Cookie认证&#xff0c;然后再次引…

简单音乐播放实例的实现,Android Service AIDL 远程调用服务

2019独角兽企业重金招聘Python工程师标准>>> Android Service是分为两种&#xff1a; 本地服务&#xff08;Local Service&#xff09;&#xff1a; 同一个apk内被调用 远程服务&#xff08;Remote Service&#xff09;&#xff1a;被另一个apk调用 远程服务需要借…

C# 使用int.TryParse,Convert.ToInt32,(int)将浮点类型转换整数时的区别

int.TryParse,Convert.ToInt32,(int) 这几种类型在将浮点类型转换整数时是有差别Convert.ToInt32则会进行四舍五入int.TryParse只能转换整数,即浮点类型全部会返回0(int)不会进行四舍五入,只取整数部分,小数点部分完全舍弃using System;public class DoubleToInt{public …

每个女孩子起床后做的第一件事......

1 假如你暴富了&#xff08;素材来源网络&#xff0c;侵删&#xff09;▼2 当客服到底有多难&#xff1f;&#xff08;素材来源网络&#xff0c;侵删&#xff09;▼3 挺好的&#xff08;素材来源网络&#xff0c;侵删&#xff09;▼4 每个女孩子起床后做的第一件事&#xff…

国产知名老牌 PDF 工具正式开源

文 | Travis出品 | OSC开源社区&#xff08;ID&#xff1a;oschina2013&#xff09;「PDF 补丁丁」是开发者 wmjordan 所开发的一款适用于 Windows 系统的多功能 PDF 文档工具箱&#xff0c;开发者最早于 2009 年开始了该程序的开发&#xff0c;如今已有十二年历史&#xff0c;…

.net Repeater知识知多少

&#xff08;一&#xff09;.net中使用Repeater绑定数据&#xff0c;并使用repeater循环出的两个值&#xff0c;赋给repeater中的div的value值。详细如下&#xff1a; 前端.net代码&#xff1a; <div class"wytz_xmlb_nr clear"><asp:Repeater ID"RpBi…