一起读源码 —— Fastjson 的核心方法及其实现原理

news/2024/12/28 2:23:48/

源码介绍

Fastjson 是阿里巴巴开源的一个 Java 工具库，它常常被用来完成 Java 的对象与 JSON 格式的字符串的相互转化。

此文读的源码是撰写此文时 Fastjson 的最新的发布版本，即 1.2.83

下载源码

请前去 github 找到 release 最新版下载后解压，地址为：https://github.com/alibaba/fastjson/releases/tag/1.2.83

项目结构

使用 IDEA 打开 fastjson-1.2.83 文件夹，下载相关依赖后，我们再开始阅读源码，接下来我们分别对 JSON 、JSONArray 与 JSONObject。

在这里插入图片描述

JSON 实现两个接口

JSON 类是实现两个接口 JSONStreamAware 、JSONAware 的抽象类，即
public abstract class JSON implements JSONStreamAware, JSONAware

我们先介绍这两个接口：

JSONStreamAware

方法 writeJSONString 中的参数 Appendable 也是一个接口，也就是可以附加字符序列和值的对象，这个接口的作用是提供一个输出JSON字符串的方法，以便于其他的方法调用。
在这里插入图片描述在这里插入图片描述
接着我们在 JSON 抽象类中寻找用到这个方法的地方，这里主要截图其中两个具体的实现方法，另外还有几个重载方法是通过调用这两个方法的方法，这里不再列举。
在这里插入图片描述
在这里插入图片描述

JSONAware

这个接口更加简单了，实现该接口的类即需要实现 toJSONString 的方法即可。
在这里插入图片描述
在JSON抽象类中，具体实现为：
在这里插入图片描述
这里调用的是 JSONSerializer 类的对象方法，这里我们在后面介绍这个类的时候进一步介绍。

这个相对于 writeJSONString 更加实用。比如重写 toString 方法。
在这里插入图片描述

JSON 类的静态方法

我们常常用到这些方法，并且我们在使用 JSONObject 类方法的时候也经常用得到（JSONObject是JSON类的子类）。这里我们介绍我们最最最常用的，并且在 JSONObject 中不再介绍。

JSON.toString / JSON.toJSONString

这个方法前面关于 JSONAware 接口的实现的时候有提到过，这里就不做介绍了。

这里我们看一下 toJSONString 方法的实现原理。源码比较简单，这里就不逐行介绍了。

方法参数介绍

  • object: Object 待转换的 Java 对象；
  • defaultFeatures: int 后面参数 SerializerFeature 的长度，因为后面是 SerializerFeature... 类型的，所以调用时需要指定它的长度；
  • features: SerializerFeature… 这个地方是指多个 SerializerFeature 类型的对象，调用时可以 toJSONString(obj, 1, feature0) 也可以 toJSONString(obj, 2, feature0, feature1)，也可以 toJSONString(obj, 3, feature0, feature1, feature2) 等等。
    /*** @since 1.2.11*/public static String toJSONString(Object object, int defaultFeatures, SerializerFeature... features) {SerializeWriter out = new SerializeWriter((Writer) null, defaultFeatures, features);try {JSONSerializer serializer = new JSONSerializer(out);serializer.write(object);String outString = out.toString();int len = outString.length();if (len > 0&& outString.charAt(len -1) == '.'&& object instanceof Number&& !out.isEnabled(SerializerFeature.WriteClassName)) {return outString.substring(0, len - 1);}return outString;} finally {out.close();}}

源码中用到了 SerializeWriter 对象以及它的方法，这里我们理一下它的作用与用法。

SerializeWriter 构造函数为

    public SerializeWriter(Writer writer, int defaultFeatures, SerializerFeature... features){this.writer = writer;buf = bufLocal.get();if (buf != null) {bufLocal.set(null);} else {buf = new char[2048];}int featuresValue = defaultFeatures;for (SerializerFeature feature : features) {featuresValue |= feature.getMask();}this.features = featuresValue;computeFeatures();}

在前面初始化JSONSerializer的时候调用SerializeWriter对象，即 JSONSerializer serializer = new JSONSerializer(out); 这个时候的使用方法是：

这里查看 JSONSerializer 对象的构造函数：

    public JSONSerializer(SerializeWriter out){this(out, SerializeConfig.getGlobalInstance());}public JSONSerializer(SerializeWriter out, SerializeConfig config){this.out = out;this.config = config;}

其 write 方法源码为：

    public final void write(Object object) {if (object == null) {out.writeNull();return;}Class<?> clazz = object.getClass();ObjectSerializer writer = getObjectWriter(clazz);try {writer.write(this, object, null, null, 0);} catch (IOException e) {throw new JSONException(e.getMessage(), e);}}

JSONObject

相对而言 JSONObject 用得更多，这里需要介绍的也更多。

无参构造函数

其中 DEFAULT_INITIAL_CAPACITY 默认等于 16，也就是创建 HashMap 或者 LinkedHashMap 对象的时候默认的 initialCapacity 的值，而 order 参数将会指定创建的 map 对象的类型。

    public JSONObject(){this(DEFAULT_INITIAL_CAPACITY, false);}public JSONObject(int initialCapacity, boolean ordered){if (ordered) {map = new LinkedHashMap<String, Object>(initialCapacity);} else {map = new HashMap<String, Object>(initialCapacity);}}public JSONObject(boolean ordered){this(DEFAULT_INITIAL_CAPACITY, ordered);}public JSONObject(int initialCapacity){this(initialCapacity, false);}

有参构函数

    public JSONObject(Map<String, Object> map){if (map == null) {throw new IllegalArgumentException("map is null.");}this.map = map;}

这里相对于前面的无参构造函数而言，map 对象在外界创建与初始化，直接传入 JSONObject 中，作为构造函数。这样做使得我们在反序列化、序列化的方法更加灵活，这里我们在后面介绍。

containsKey / containsValue / get / isEmpty / size 方法

这几个方法都是直接调用 成员变量 map 得以实现的，具体实现代码如下：

	public int size() {return map.size();}public boolean isEmpty() {return map.isEmpty();}public boolean containsKey(Object key) {boolean result = map.containsKey(key);if (!result) {if (key instanceof Number|| key instanceof Character|| key instanceof Boolean|| key instanceof UUID) {result = map.containsKey(key.toString());}}return result;}public boolean containsValue(Object value) {return map.containsValue(value);}public Object get(Object key) {Object val = map.get(key);if (val == null) {if (key instanceof Number|| key instanceof Character|| key instanceof Boolean|| key instanceof UUID) {val = map.get(key.toString());}}return val;}public Object getOrDefault(Object key, Object defaultValue) {Object v;return ((v = get(key)) != null) ? v : defaultValue;}

反序列化方法

首先出场的是最简单的，将 map 中的某个 key 进行反序列化，一般情况下我们会在 这个 key 对应的是 Object 的时候使用它。比如原始的map 是 {"age": 3, "item" : {"color": "black", "length" : 2}} ，我们在反序列化 item 的时候需要调用这个方法，即 getJSONObject("item") 。

    public JSONObject getJSONObject(String key) {Object value = map.get(key);if (value instanceof JSONObject) {return (JSONObject) value;}if (value instanceof Map) {return new JSONObject((Map) value);}if (value instanceof String) {return JSON.parseObject((String) value);}return (JSONObject) toJSON(value);}

类似地如果是 JSON 数组的化，调用 getJSONArray 方法，这里举一个例子为 map 为 {"age": 3, items:[{"color": "red"}, {"color": "black"}]}，我们在反序列 items 的时候会调用这个方法。

    public JSONArray getJSONArray(String key) {Object value = map.get(key);if (value instanceof JSONArray) {return (JSONArray) value;}if (value instanceof List) {return new JSONArray((List) value);}if (value instanceof String) {return (JSONArray) JSON.parse((String) value);}return (JSONArray) toJSON(value);}

如果不是前面两种，我们需要获取的只是简单的 item 对象，比如 age = 3，那么就调用 getObject 方法即可，注意这里有几个重载方法。

    public <T> T getObject(String key, Class<T> clazz) {Object obj = map.get(key);return TypeUtils.castToJavaBean(obj, clazz);}public <T> T getObject(String key, Type type) {Object obj = map.get(key);return TypeUtils.cast(obj, type, ParserConfig.getGlobalInstance());}public <T> T getObject(String key, TypeReference typeReference) {Object obj = map.get(key);if (typeReference == null) {return (T) obj;}return TypeUtils.cast(obj, typeReference.getType(), ParserConfig.getGlobalInstance());}

这个时候我们不得不介绍一下 TypeUtils 类了，毕竟出场率这么高，这里只介绍 cast 与 castToJavaBean 两个静态方法。

    private static BiFunction<Object, Class, Object> castFunction = new BiFunction<Object, Class, Object>() {public Object apply(Object obj, Class clazz) {if (clazz == java.sql.Date.class) {return castToSqlDate(obj);}if (clazz == java.sql.Time.class) {return castToSqlTime(obj);}if (clazz == java.sql.Timestamp.class) {return castToTimestamp(obj);}return null;}};

这里实现了接口 BiFunction 的 apply 方法，实现方法也非常简单粗暴，三个 if 对应三个方法 castToSql / castToSqlTime / castToTimestamp 。

这个时候可能大家会疑惑，这个跟 sql 有什么关系？其实确实没什么关系，但是毕竟 java 提供的现有的可用方法，不用白不用，这里也给大家做个广告，这里面的 java.sql.Timestamp 与 java.sql.Time 以及 java.sql.Date 确实很好用，这里以 java.sql.Timestamp 为例，它提供13位时间戳的构造方法 public Timestamp(long time) 以及常用的 compareTo 、before 、after 方法，需要的小伙伴可以自取使用。

而 cast 方法 居然都有 @SuppressWarnings("unchecked") 标注，着实让人多少有点不放心，难道一定要去使用 Fastjson2 ？

这里我们查看其中一个方法的实现，看完了你大概就会产生一种 “就这？我上我也行” 的感觉：

    @SuppressWarnings("unchecked")public static <T> T cast(Object obj, Type type, ParserConfig mapping) {if (obj == null) {return null;}if (type instanceof Class) {return cast(obj, (Class<T>) type, mapping);}if (type instanceof ParameterizedType) {return (T) cast(obj, (ParameterizedType) type, mapping);}if (obj instanceof String) {String strVal = (String) obj;if (strVal.length() == 0 //|| "null".equals(strVal) //|| "NULL".equals(strVal)) {return null;}}if (type instanceof TypeVariable) {return (T) obj;}throw new JSONException("can not cast to : " + type);}

事实也确实如此，充其量就是用了点反射技术，首先判断数据类型属于哪个小可爱的子类，然后再使用放射和传过来的 clazz 创建对象，而建立其中的映射关系的，就是其中的 mapping 参数对象，仅此而已。

JSON 与 JSONObject 的区别与联系

能够用 JSON 的地方，基本上都能用 JSONObject，不同之处在于一般直接 JSON 的静态方法，因为它是抽象类，不能直接 new 出对象的。而 JSONObject 名字中就强调了 Object 的概念，所以一般直接就用它的对象的方法。

灵活使用 JSONObject

总体来说最经常用到的就是 toString 与 toJSONObject 以及 JSONObject 对象的 getInteger / getLong / getJSONObject 等等方法，这些方法都应该基于 map 联想记忆，都是比较容易理解的。

总结

Fastjson 中存在很多地方都属于让人看了就 “恍然大悟” 之处，也推荐大家去阅读，同时不得不说，阿里巴巴能够有支团队开发并不断完善Fastjson，也是挺值得前去 github 点颗星星。

最后吐槽一下 Fastjson 的实现部分有明显的 “不遵守 《JAVA 规范手册》” 的，请以后的开发人员注意多多参考 Java开发手册（嵩山版） ，多写一些些注释，成为一本与 手册 配套的代码示例，也是非常不错的 ~ 此致，敬上 ~

Smileyan
2023.04.13 00:44


http://www.ppmy.cn/news/46188.html

相关文章

JUC源码系列-ReentrantLock独占锁的释放

JUC源码系列-ReentrantLock独占锁的释放

前言 开始之前先提一句, JAVA的内置锁在退出临界区之后是会自动释放锁的, 但是ReentrantLock这样的显式锁是需要自己显式的释放的, 所以在加锁之后一定不要忘记在finally块中进行显式的锁释放: Lock lock new ReentrantLock(); ... lock.lock(); try {// 更新对象//捕获异常…
阅读更多...
IOC容器——Bean

IOC容器——Bean

IOC容器——Bean Bean配置name别名属性Bean作用范围scopeBean的实例化构造方法示例化静态工厂实例化实例工厂与FactoryBean实例工厂FactoryBean bean的生命周期 Bean配置 name别名属性 Bean ID 唯一&#xff0c;而关于Spring别名&#xff0c;我们可以在配置文件中使用name来定…
阅读更多...
《高等工程数学》各知识点解题思路梳理（基于AI模型）

《高等工程数学》各知识点解题思路梳理（基于AI模型）

《高等工程数学》各知识点解题思路梳理 **一、填空题****1.给定线性空间的一个基&#xff0c;求一给定向量在该基下的坐标****2. 给定欧氏空间的标准正交基&#xff0c;求一给定向量的长度****3.求给定矩阵的2-范数、无穷范数&#xff0c;1-范数****4.确定方阵幂级数收敛的条件…
阅读更多...
COMSOL锂离子电池仿真技术与应用

COMSOL锂离子电池仿真技术与应用

背景&#xff1a; 随着各国燃油车禁售时间表的推出&#xff0c;新能源汽车的地位愈发稳固。而锂离子电池作为电动车的核心动力源&#xff0c;也越来越受到市场的追捧。锂离子电池在制作过程中涉及正极、电解液、负极、隔膜等材料的选取与匹配&#xff0c;极片设计参数的选择等…
阅读更多...
Docker容器---网络、容器操作

Docker容器---网络、容器操作

Docker容器---网络、容器操作 一、docker实现原理二、docker网路模式1、Host模式2、container模式3、none模式4、bridge模式 三、自定义网络1、查看网络模式列表2、查看容器信息3、指定分配IP地址4、自定义网络固定IP 四、暴露端口五、容器端口映射1、创建端口映射 六、资源控制…
阅读更多...
深度学习快速参考：11~13

深度学习快速参考：11~13

原文&#xff1a;Deep Learning Quick Reference 协议&#xff1a;CC BY-NC-SA 4.0 译者&#xff1a;飞龙 本文来自【ApacheCN 深度学习 译文集】&#xff0c;采用译后编辑&#xff08;MTPE&#xff09;流程来尽可能提升效率。 不要担心自己的形象&#xff0c;只关心如何实现目…
阅读更多...
【React】React-router路由

【React】React-router路由

React路由 路由的定义路由安装路由的使用导入路由定义路由Switch的使用Rediret的使用嵌套路由路由跳转模式路由传参路由拦截 反向代理css module 路由的定义 路由是根据不同的url地址展示不同的内容或页面 注&#xff1a; 一个针对react设计的路由解决方案&#xff0c;可以友…
阅读更多...
2023年超实用的27个VSCode插件推荐

2023年超实用的27个VSCode插件推荐

Visual Studio Code&#xff0c;或者称作VS Code&#xff0c;是一个广为人知且评价很高的代码编辑器&#xff0c;它有许多特性和扩展功能&#xff0c;以增强开发体验。使用VS Code的主要好处之一是它的灵活性&#xff0c;允许开发人员根据自己的特定需求进行自定义。 此外&…
阅读更多...
最新文章

Copyright @ 2022~2023