fastjson 介绍

前端之家收集整理的这篇文章主要介绍了fastjson 介绍前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

简介

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

性能

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

支持标准

功能强大

  • 支持各种JDK类型。包括基本类型、JavaBean、Collection、Map、Enum、泛型等。
  • 支持循环引用

无依赖

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

支持范围广

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

开源

测试充分

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

获得fastjson

下载

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

maven

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

<repository>
<id>opensesame</id>
<name>Alibaba OpenSource Repsoitory</name>
<url>http: //code.alibabatech.com/mvn/releases/</url>
<snapshots>
<enabled> false </enabled>
</snapshots>
</repository>

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

<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version> 1.1 . 14 </version>
</dependency>

序列化

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

基本序列化

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

Object o = ...;
String text = JSON.toJSONString(o);

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

使用单引号

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

String text = JSON.toJSONString(o,SerializerFeature.UseSingleQuotes);

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

日期格式化

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

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

long millis = 1324138987429L;
Date date = new Date(millis);
System.out.println(JSON.toJSONString(date));

输出的结果是

1324138987429

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

JSON.toJSONString(date,SerializerFeature.WriteDateUseDateFormat);

输出的结果为:

"2011-12-18 00:23:07"

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

JSON.toJSONStringWithDateFormat(date,"yyyy-MM-dd HH:mm:ss.SSS");

输出的结果为:

"2011-12-18 00:23:07.429"

使用WriteClassName特性

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

Color color = Color.RED;
String text = JSON.toJSONString(color,SerializerFeature.WriteClassName);
System.out.println(text);

输出结果:

{"@type":"java.awt.Color",102)!important; font-size:1em!important; vertical-align:baseline!important; border-left-width:0px!important; top:auto!important; right:auto!important; padding-top:0px!important; left:auto!important">"r":255"g"0"b""alpha"}

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

String text = ...; // {"@type":"java.awt.Color","r":255,"g":0,"b":0,"alpha":255}
Color color = (Color) JSON.parse(text);

浏览器和设备兼容

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

JSON.toJSONString(o,SerializerFeature.BrowserCompatible);

循环引用

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

A a = A();
B b = B(a);
a.setB(b);
String text = JSON.toJSONString(a); // {"b":{"a":{"$ref":".."}}}
A a1 = JSON.parSEObject(text,A. class );
Assert.assertTrue(a1 == a1.getB().getA());

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

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

使用@JSONField Annotation

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

public User {
@JSONField (name= "ID" )
int getId() { ... }
}
User user = ...;
JSON.toJSONString(user); // {"ID":234}

从json-lib中升级

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

importcom.alibaba.fastjson.JSON;
com.alibaba.fastjson.serializer.JSONLibDataFormatSerializer;
com.alibaba.fastjson.serializer.JSONSerializerMap;
com.alibaba.fastjson.serializer.SerializerFeature;
private static final SerializeConfig config;
static {
config = SerializeConfig();
config.put(java.util.Date. JSONLibDataFormatSerializer()); // 使用和json-lib兼容的日期输出格式
config.put(java.sql.Date. // 使用和json-lib兼容的日期输出格式
}
SerializerFeature[] features = { SerializerFeature.WriteMapNullValue, // 输出空置字段
SerializerFeature.WriteNullListAsEmpty,0)!important; font-size:1em!important; vertical-align:baseline!important; border-left-width:0px!important; top:auto!important; right:auto!important; padding-top:0px!important; left:auto!important">// list字段如果为null,输出为[],而不是null
SerializerFeature.WriteNullNumberAsZero,0)!important; font-size:1em!important; vertical-align:baseline!important; border-left-width:0px!important; top:auto!important; right:auto!important; padding-top:0px!important; left:auto!important">// 数值字段如果为null,输出为0,而不是null
SerializerFeature.WriteNullBooleanAsFalse,0)!important; font-size:1em!important; vertical-align:baseline!important; border-left-width:0px!important; top:auto!important; right:auto!important; padding-top:0px!important; left:auto!important">// Boolean字段如果为null,输出为false,而不是null
SerializerFeature.WriteNullStringAsEmpty // 字符类型字段如果为null,输出为"",而不是null
};
// 序列化为和JSON-LIB兼容的字符串
String toCompatibleJSONString(Object object) {
return JSON.toJSONString(object,config,features);
通过上面代码中的toCompatibleJSONString方法,你就可以实现完全兼容json-lib了。

反序列化

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

指定Class信息反序列化

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

// {"r":255,0)!important; font-size:1em!important; vertical-align:baseline!important; border-left-width:0px!important; top:auto!important; right:auto!important; padding-top:0px!important; left:auto!important">Color color = JSON.parSEObject(text,Color.);

类型集合的反序列化

这个接口类似于parSEObject

// [{ ... },{ ... }]
List<User> users = JSON.parseArray(text,User. 泛型的反序列化

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

// {"name":{"name":"ljw",age:18}}
Map<String,User> userMap = JSON.parSEObject(text,0)!important; font-size:1em!important; vertical-align:baseline!important; border-left-width:0px!important; top:auto!important; right:auto!important; padding-top:0px!important; left:auto!important">TypeReference<Map<String,User>>() {});

组合类型集合的反序列化

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

[{/*header*/},{/*body*/}]

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

// [{/* header */},{/* body */}]
Type[] types = Type[] {Header. };
List<Object> list = JSON.parseArray(text,types);
Header header = (Header) list.get( );
Body body = (Body) list.get( 1 使用@JSONCreator来指定构造函数来创建对象

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

class Entity {
final int id;
final String name;
@JSONCreator
public Entity( (name = "id" ) id, "name" ) String name){
this .id = id;
.name = name;
}
getId() { id; }
String getName() { name; }
}

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

interface Bean {
getId();
void setId( value);
String getName();
setName(String value);
}
String text = "{\"id\":123,\"name\":\"chris\"}" ;
Bean bean = JSON.parSEObject(text,Bean. );
// 按接口调用
Assert.assertEquals( 123 Assert.assertEquals( "chris" bean.setId( 234 );

出自:

猜你在找的Json相关文章