.NET Core 内置的 System.Text.Json 使用注意

System.Text.Json 是 .NET Core 3.0 新引入的高性能 json 解析、序列化、反序列化类库,武功高强,但毕竟初入江湖,炉火还没纯青,使用时需要注意,以下是我们在实现使用中遇到的一下问题。

1)默认设置下中文会被编码

序列化时中文会被编码,详见博问 .NET Core 3.0 中使用 System.Text.Json 序列化中文时的编码问题

解决方法:

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers().AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Encoder = JavaScriptEncoder.Create(UnicodeRanges.All);
    });
}

2)不能序列化公有字段(成员变量),只能序列化公有属性。

比如

public class FollowBloggerRequest
{
    public Guid blogUserGuid;
}

要改为

public class FollowBloggerRequest
{
    public Guid blogUserGuid { get; set; }
}

3)全是数字的字符串不能隐式反序列化为 int 类型

比如 { "postId": "12345" } 不能反序列化为 int PostId ,github 上的相关 issue : System.Text.Json: Deserialization support for quoted numbers

4)对于枚举类型属性值(非数字型)的序列化,需要加 [JsonStringEnumConverter] 特性

比如

[JsonConverter(typeof(JsonStringEnumConverter))]
public SiteCategoryType CategoryType { get; set; }

Json.NET 对应的是 StringEnumConverter

5)反序列化 Guid 的问题

详见博问:https://q.cnblogs.com/q/120383/

注:对应类型转换问题,可以通过实现自定义 JsonConverter<T> 解决,参考 corefx#36639 (comment)

posted @ 2019-09-27 14:33 dudu 阅读(...) 评论(...) 编辑 收藏