您的位置:首页 > Web前端 > JavaScript

Fastjson详细介绍 !!!!

2014-06-08 00:04 316 查看


简介

Fastjson是一个Java语言编写的高性能功能完善的JSON库。


高性能

fastjson采用独创的算法,将parse的速度提升到极致,超过所有json库,包括曾经号称最快的jackson。并且还超越了google的二进制协议protocol buf。


支持标准

Fastjson完全支持http://json.org的标准,也是官方网站收录的参考实现之一。


功能强大

支持各种JDK类型。包括基本类型、JavaBean、Collection、Map、Enum、泛型等。

支持循环引用


无依赖

不需要例外额外的jar,能够直接跑在JDK上。


支持范围广

支持JDK 5、JDK 6、Android、阿里云手机等环境。


开源

Apache License 2.0

代码托管在github.org上,项目地址是 https://github.com/AlibabaTech/fastjson


测试充分

fastjson有超过1500个testcase,每次构建都会跑一遍,丰富的测试场景保证了功能稳定。


获得fastjson


下载

http://code.alibabatech.com/mvn/releases/com/alibaba/fastjson/


maven

如果你使用了Maven,maven repository配置如下:

pom.xml文件中加入依赖依赖:


序列化

一个JSON库涉及的最基本功能就是序列化和反序列化。Fastjson支持java bean的直接序列化。你可以使用com.alibaba.fastjson.JSON这个类进行序列化和反序列化。


基本序列化

序列化就是把JavaBean对象转化成JSON格式的文本。

在这个例子中,调用JSON.toJSONString方法,把对象o转化为JSON格式的文本。


使用单引号

标准的JSON是使用双引号的,javascript支持使用单引号格式的json文本,fastjson也支持这个特性,打开SerializerFeature.UseSingleQuotes这个特性就可以了了,例如:

fastjson序列化时可以选择的SerializerFeature有十几个,你可以按照自己的需要去选择使用。


日期格式化

fastjson直接支持日期类型数据的格式化,包括java.util.Date、java.sql.Date、java.sql.Timestamp、java.sql.Time。

缺省情况下,fastjson将Date类型序列化为long,这个使得序列化和反序列化的过程不会导致时区问题。如:

例如:

输出的结果是

fastjson还提供了基于格式化输出的SerializerFeature,例如:

输出的结果为:

你可以指定输出日期的格式,比如修改为输出毫秒:

输出的结果为:


使用WriteClassName特性

fastjson支持序列化时写入类型信息,从而使得反序列化时不至于类型信息丢失。例如:

输出结果:

由于序列化带了类型信息,使得反序列化时能够自动进行类型识别,例如:


浏览器和设备兼容

fastjson缺省的序列化内容,是对序列化结果紧凑做了优化配置,使得序列化之后长度更小,但是这种优化配置是对一些浏览器和设备不兼容的。比如说在iphone上兼容emoji(绘文字)。


循环引用

很多场景中,我们需要序列化的对象中存在循环引用,在许多的json库中,这会导致stackoverflow。在功能强大的fastjson中,你不需要担心这个问题。例如:

引用是通过"$ref"来表示的

引用描述
"$ref":".."上一级
"$ref":"@"当前对象,也就是自引用
"$ref":"$"根对象
"$ref":"$.children.0"基于路径的引用,相当于 root.getChildren().get(0)


使用@JSONField Annotation

在某些场景,你可能需要定制序列化输出,比如说,希望序列化采用之后采用"ID",而不是"id",你可以使用@JSONField这个Annotation。


从json-lib中升级

如果你已经使用了json-lib,并且痛恨他蜗牛般的速度和罗嗦的API,建议你升级为fastjson,fastjson可以完全兼容json-lib的序列化格式。

通过上面代码中的toCompatibleJSONString方法,你就可以实现完全兼容json-lib了。


反序列化

反序列化就是把JSON格式的文本转化为Java Bean对象。


指定Class信息反序列化

通过指定类型信息,可以很方便的将"JSON文本"反序列化为"Java Bean"对象,例如:


类型集合的反序列化

这个接口类似于parseObject


泛型的反序列化

如果你需要返回一个带泛型的对象,例如List<User>、Map<String, User>,你可以使用TypeReference来传入类型信息。


组合类型集合的反序列化

比如在网络协议中,经常会存在这样的组合:

fastjson对这种结构的反序列化有专门支持。


使用@JSONCreator来指定构造函数来创建对象

如果你的JavaBean没有缺省构造函数,可以使用@JSONCreator来指定构造函数


把JSON文本反序列化为一个原型接口

内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: