基于 System.Text.Json 重构的 FreeSql.Extensions.JsonMap

[woodcoal]

首先叶大提供的 FreeSql，作为 FreeSql 的长期用户。官方的 FreeSql.Extensions.JsonMap 扩展库非常实用，可以让对象属性轻松映射为数据库中的 JSON 字段。

然而，原版依赖于 Newtonsoft.Json。随着 .NET Core 和 .NET 5/6+ 的普及，System.Text.Json 已经成为官方推荐的高性能序列化库。为了减少项目依赖（摆脱对 Newtonsoft 的强依赖）并提升序列化性能，我基于官方源码进行了重构，推出了 FreeSql.Extensions.JsonMap.STJ。

🚀 主要特性与变化

1. 零外部依赖：底层完全迁移至 System.Text.Json，对于现代 .NET 项目，无需再引入 Newtonsoft.Json。

2. 性能提升：享受 STJ 带来的低内存分配和高性能序列化体验。

3. 高度可配置：支持传入 JsonSerializerOptions，轻松定制驼峰命名、缩进、忽略只读属性等行为。

4. 环境要求：由于 STJ 的特性，本项目最低支持 .NET Standard 2.0 (不再支持 .NET 4.0/4.5)。

📦 项目地址

欢迎大家试用、Star 或提 Issue！

👉 GitHub 仓库: https://github.com/woodcoal/FreeSql_JsonMap

💻 快速上手

安装包后，使用方式与原版基本一致，但现在支持更强大的配置：

// 1. 基础启用 (默认忽略大小写，且已配置 Encoder 防止中文转义)
fsql.UseJsonMap();

// 2. 高级配置 (支持 STJ 原生选项)
var options = new JsonSerializerOptions
{
    PropertyNamingPolicy = JsonNamingPolicy.CamelCase, // 驼峰命名
    WriteIndented = true,                              // 格式化输出
    IgnoreReadOnlyProperties = true
};
fsql.UseJsonMap(options);

📝 实体类示例

[Table(Name = "sysconfig")]
public class S_SysConfig<T>
{
    [Column(IsPrimary = true)]
    public string Name { get; set; }

    // 标记 [JsonMap] 即可自动序列化存储
    [JsonMap]
    public T Config { get; set; }
}

希望这个重构版本能帮助到正在使用 FreeSql 且希望精简依赖的朋友们！欢迎任何反馈。

[2881099]

感谢贡献，可以PR到文档上：https://github.com/2881099/FreeSql.Wiki.VuePress/edit/main/docs/guide/type-mapping.md