零 引子

0 源码

1 开发依赖

Maven : 3.3.9 (主要用作打包工具)

IDE : idea 2018.3

JDK : OpenJDK 11.0.1 (OracleJDK 8 以上即可)

2 写在前头

Litjson 是笔者读了 Gson 源码之后的业余之作，基本思路仿造了 Gson，但是功能上做了不少精简，仅仅能适用于比较标准的 json 字符串和 java 对象的互转。

Litjson 在测试当中兼容性表现良好，但是执行效率不如预期(不及 Gson)，笔者一度想要放弃该项目，但是造轮子不易，既然造了就稍微聊一聊吧，欢迎探讨进步。

一 自定义配置

Litjson 可以使用组件 OptionBox 进行各种参数的修改，OptionBox 由其静态内部类 OptionBoxBuildr 创建：

//创建一个 builder

OptionBox.OptionBoxBuilder boxBuilder = OptionBox.OptionBoxBuilder.builder();

//使用 builder 创建 OptionBox

OptionBox box = boxBuilder

//在 json 字符串反序列化过程中要忽略的字符

//默认会忽略空字符串和换行符等字符类型

.addIgnoreChar('c')

//传入一个 List，批量设置忽略字符

.addIgnoreChars(chars)

//在 json 字符串反序列化过程中需要识别的日期格式，默认仅有一种 yyyy-MM-dd HH:mm:ss

.addReadDateFormat("yyyy-mm-dd")

//传入一个 List，批量设置识别的日期格式

.addReadDateFormats(dateformats)

//TypeHandler 为类型转换器

//使用者可以自定义需要使用的类型转换器，并以 map 的格式传入

//默认只有 Integer/Long/String/Double/Float/Date 这几种类型

.addTypeHandlers(handlerMap)

//在将 java bean 序列化的过程中使用单引号还是双引号

//true 为双引号，false 为单引号，不设置的时候默认为 true

.isQoubleQuotationMarks(true)

//在将 java bean 序列化的过程中需要转的日期格式

//默认为 yyyy-MM-dd HH:mm:ss

.writeDateFormat(dateformat)

//创建 OptionBox

.over();

OptionBox 的功能目前较少，后期补充。

TypeHandler 是一个 Listjson 中的接口，使用者可以自行实现该接口用以解析需要的类型，作用类似 Gson 中的 TypeAdapter：

public interface TypeHandler {

T read(String value);

String write(T t);

}

！！！自定义 TypeHandler 的功能仅为预留，暂未做支持。

二 反序列化

JReader 是 Litjson 中用于读取 json 字符串(反序列化)的组件，提供多种构造器进行创建：

//配置盒

OptionBox box = OptionBox.OptionBoxBuilder.builder().over();

//JReader 的辅助工具类，使用配置盒进行创建

ReadManager readManager = new ReadManager(box);

//第一个参数为 json 字符串

//第二个参数是需要读成的 java class 类型

//第三个参数表示 是否为列表，true 代表是列表，false 代表是 object

//如果第三个参数为 true，则 classType 会表示成列表内的泛型类型

//第四个参数是 readManager

JReader jReader = new JReader(jsonString,classType,true,readManager);

//只传入 json 字符串，会输出一个 map，如果字符串本身是一个列表的话会报错

//不传入 readManager，配置均使用默认

JReader jReader1 = new JReader(jsonString);

//同上，只是会输出成一个 java class 类型

JReader jReader2 = new JReader(jsonString,classType);

//输出成一个列表

JReader jReader3 = new JReader(jsonString,classType,true);

//输出对象，参数设置必须为输出非列表

Object o = jReader.toObj();

//输出列表对象，参数设置必须为输出列表

List list = jReader.toArray();

三 序列化

JWriter 是 Litjson 中用于输出 json 字符串(序列化)的组件，提供多种构造器进行创建：

//配置盒

OptionBox box = OptionBox.OptionBoxBuilder.builder().over();

//JWriter 的辅助工具类，使用配置盒进行创建

WriteManager writeManager = new WriteManager(box);

//第一个参数为要序列化的对象

//第二个参数是 writeManager

JWriter jWriter = new JWriter(object,writeManager);

//只传入对象，不传入 writeManager，配置均使用默认

JWriter jWriter1 = new JWriter(object);

//输出 json 字符串

String json = jWriter.toJson();

四 门面

介于一般情景下快速开发的需求，笔者参考了 Fastjson 的使用之后给 JReader 和 JWriter 整合了一个静态门面类供使用者更加方便的调用：

//json 字符串的反序列化过程

Object obj = JSONBootstrap.read(jsonString);

//加入指定类型的反序列化

T obj = JSONBootstrap.read(jsonString,class);

//java bean 序列化过程

String json = JSONBootstrap.write(obj);

五 一点唠叨

0 截止到 version 0.0.1，使用 IDEA 的 Statistic 插件统计共计约 2400 行 java 代码

1 Litjson 的使用需要使用到 java bean 的无参构造器和参数的 get/set 方法，没有的话在反射创建阶段就会报错

2 现阶段支持的类型还很少，只能支持 java bean/Map/Collection/Integer/Long/Float/Double/String/Date

3 高并发下的 DateFormat 存在线程安全问题

4 笔者对项目整体性把握的功力还太浅，体现在对象封装、错误管理等各方面，有待后期完善

5 春节假期的自 high 作品，随缘维护，谨慎用于生产环境

6 造轮子使我快乐