okjson 更新至 v0.0.9.0，小巧、高效、灵活的 JSON 处理器-CSDN博客

开发四年只会写业务代码，分布式高并发都不会还做程序员？

0.0.9.0       2019-04-12       calvin
           * 静态类OKJSON新增方法objectToFile和fileToObject
           * 新增Demo.java
           * JSON数组简单类型新增支持日期、时间
           * 编写README.md
           * 编写README.zh-CN.md

0.0.8.0       2019-04-11       calvin
           * 支持日期、时间属性的序列化/反序列化
           * 增加注解OkJsonDateTimeFormatter用于格式化日期、时间属性
           * 修正了转义符序列化/反序列化的BUG

0.0.7.0 2019-02-28 calvin
* 增加序列化对象

0.0.6.0       2019-02-28       calvin
           * 增加反序列化子对象的非原始类型属性
           * 增加压测程序

0.0.5.0       2019-02-27       calvin
           * 增加反序列化子对象数组

0.0.4.0       2019-02-26       calvin
           * 增加反序列化对象属性和方法的缓存

0.0.3.0       2019-02-25       calvin
           * 增加反序列化值数组

0.0.2.0       2019-02-24       calvin
           * 增加可选的使用设置器设置属性值

0.0.1.0       2019-02-23       calvin
           * 创建
           * 增加反序列化任意层次的属性

--------------------------------------------------------------------------

1. 概述

okjson是用JAVA编写的JSON处理器（JSON解析器+JSON生成器）。

它能帮助开发者把一段JSON文本中的数据映射到实体类中，或由一个实体类生成一段JSON文本。

它小巧，源码只有一个类文件和一个注解类文件，方便架构师嵌入到项目/框架中去。

它高效，比号称全世界最快的fastjson还要快。

它灵活，不对映射实体类有各种各样约束要求。

一个好工具就是简单、朴素的。

2. 一个示例

来一个简单示例感受一下（所有代码可在源码包src\test\java\xyz\calvinwilliams\okjson里找到）

2.1. 编写JSON文件

demo.json

{
	"userName" : "Calvin" ,
	"email" : "calvinwilliams@163.com" ,
	"userExtInfo" : {
		"gender" : "M" ,
		"age" : 30 ,
		"address" : "I won't tell you"
	} ,
	"interestGroupList" : [
		"Programing", "Playing game", "Reading", "Sleeping"
	] ,
	"borrowDetailList" : [
		{
			"bookName" : "Thinking in JAVA" ,
			"author" : "Bruce Eckel" ,
			"borrowDate" : "2014-01-02" ,
			"borrowTime" : "17:30:00"
		} ,
		{
			"bookName" : "Thinking in C++" ,
			"author" : "Bruce Eckel too" ,
			"borrowDate" : "2014-02-04" ,
			"borrowTime" : "17:35:00"
		} ,
		{
			"bookName" : "Thinking in okjson" ,
			"author" : "It's me !!!" ,
			"borrowDate" : "2014-03-06" ,
			"borrowTime" : "17:40:00"
		}
	]
}

2.2. 编写实体类

DemoUserClass.java

package xyz.calvinwilliams.okjson;

import java.time.LocalDate;
import java.time.LocalTime;
import java.util.LinkedList;

public class DemoUserClass {
	String				userName ;
	String				email ;
	UserExtInfo			userExtInfo ;
	LinkedList<String>			interestGroupList ;
	LinkedList<BorrowDetail>	borrowDetailList ;
}

class UserExtInfo {
	String				gender ;
	int					age ;
	String				address ;
}

class BorrowDetail {
	String				bookName ;
	String				author ;
	@OkJsonDateTimeFormatter(format="yyyy-MM-dd")
	LocalDate			borrowDate ;
	@OkJsonDateTimeFormatter(format="HH??ss")
	LocalTime			borrowTime ;
}

2.3. 编写示例代码

读入JSON文件，映射所有字段数据到实体类属性中去

package xyz.calvinwilliams.okjson;

import java.time.format.DateTimeFormatter;

public class Demo {

	public static void printDemoUser( DemoUserClass demoUser ) {
		...
	}
	
	public static void main(String[] args) {
		DemoUserClass	demoUser = new DemoUserClass() ;
		
		System.out.println( "OKJSON.stringToObject ..." );
		demoUser = OKJSON.fileToObject( "demo.json", DemoUserClass.class, OKJSON.OKJSON_OTIONS_DIRECT_ACCESS_PROPERTY_ENABLE ) ;
		if( demoUser == null ) {
			System.out.println( "OKJSON.stringToObject failed["+OKJSON.getErrorCode()+"]["+OKJSON.getErrorDesc()+"]" );
			return;
		} else {
			System.out.println( "OKJSON.stringToObject ok" );
			printDemoUser( demoUser );
		}
	}
}

调用一个静态方法就能把JSON所有字段数据都映射到实体类属性中去，是不是很简单。

我的其它开源产品都用它装载配置文件，小巧、高效、灵活。

6. 关于本项目

欢迎使用okjson，如果你在使用中碰到了问题请告诉我，谢谢 ^_^

源码托管地址 : Gitee、github

Apache Maven

<dependency>
  <groupId>xyz.calvinwilliams</groupId>
  <artifactId>okjson</artifactId>
  <version>0.0.9.0</version>
</dependency>

Gradle Kotlin DSL

compile("xyz.calvinwilliams:okjson:0.0.9.0")

7. 关于作者

厉华，左手C，右手JAVA，写过小到性能卓越方便快捷的日志库、HTTP解析器、日志采集器等，大到交易平台/中间件等，分布式系统实践者，容器技术专研者，目前在某城商行负责基础架构。

通过邮箱联系我 : 网易、Gmail