12.3 Json 的四个实现

jfinal 官方默认给出了四种 json 实现：JFinalJson、FastJson、Jackson、MixedJson，可以满足绝大多数需求。

1、JFinalJson

JFinalJson 是 jfinal 官方最早的一个实现，这个实现最重要一点就是在转换 jfinal 的 Model 时是先获取 Model 中的 Map attrs 属性，然后再去转换这个 Map 对象。即便你的 Model 生成了 getter 方法，也不会被转换时调用。

针对 Model.attrs 属性进行转换而不是利用 getter 方法进行转换有如下几个原因：

A：支持多表关联查询结果的转换

无论是 Model 还是传统 Java Bean，其 getter 方法都是固定的，而多表关联查询的 sql 语句中的 select 中的字段是动态的，通常还包含关联表中的字段，而这些字段值没有相关的 getter 方法，这些字段就无法被转换

B：早期的 jfinal 用户没有为 Model 生成 getter 方法

注意：JFinalJson 只支持对象转 json string，不支持反向的 json string 转对象，可以通过使用 MixedJson 来支持反向转换：me.setJsonFactory(new MixedJsonFactory());

JFinal 4.9 版本对 JFinalJson 进行了彻底的重构与优化，新增了一些功能。

A、Model、Record 字段名转换为驼峰格式

  1. JFinalJson.setModelAndRecordFieldNameToCamelCase();

大量开发者将数据库字段名命名成下划线的格式，如：”user_id”，这就造成了与 java 变量名风格的不统一，对代码质量有一定损害。

上述配置只有在碰到下划线时才会对其进行转换，否则原样保留，而 oracle 用户习惯使用大写的字段名，所以需要使用如下配置： 

  1. JFinalJson.setModelAndRecordFieldNameConverter(fieldName -> {
  2.     return StrKit.toCamelCase(fieldName, true);
  3. });

上述代码中的第二个参数 true 表示将字段名转成小写字母，而无论是否出现下划线。

B、新增 setSkipNullValueField 配置方法

该方法用于去除 null 值字段的转换：

  1. JFinalJson.setSkipNullValueField(true);

C、新增 addToJson 扩展方法

该方法可以细粒度地对任意类型的转换进行扩展：

  1. JFinalJson.addToJson(Timestamp.class, (value, depth, ret) -> {
  2.     ret.addLong(((Timestamp)value).getTime());
  3. });

以上扩展代码，将 Timestamp 类型转换成 long 值。

2、FastJson

FastJson 是对第三方的 fastjson 进行的二次封装，该实现最重要的一点就是转换依赖于 Model、java bean 的 getter 方法。使用 fastjson 可以按照其官方文档去配置 fastjson 的各种转换参数。

使用 FastJson 封装时，需要添加其依赖：

  1. <dependency>
  2.     <groupId>com.alibaba</groupId>
  3.     <artifactId>fastjson</artifactId>
  4.     <version>1.2.68</version>
  5. </dependency>

3、Jackson

该实现与 FastJson 类似，是对第三方的 jackson 的二次封装

使用 Jackson 封装时，需要添加其依赖：

  1. <dependency>
  2.     <groupId>com.fasterxml.jackson.core</groupId>
  3.     <artifactId>jackson-databind</artifactId>
  4.     <version>2.11.0</version>
  5. </dependency>

4、MixedJson

MixedJson 是对 JFinalJson、FastJson 的再一次封装，Object 转 json string 时使用 JFinalJson 的实现，而反向 json string 转 Object 使用 FastJson。

这个实现结合了 JFinalJson 与 FastJson 两者的优势。 前者不支持 json string 到 Object 的转换，后者不支持关联表 sql 查询动态字段的转换。

使用 MixedJson 封装时需要添加 FastJson 封装的依赖：

  1. <dependency>
  2.     <groupId>com.alibaba</groupId>
  3.     <artifactId>fastjson</artifactId>
  4.     <version>1.2.68</version>
  5. </dependency>