Fastjson是一个Java语言编写的高性能功能完好的JSON库。
fastjson採用独创的算法,将parse的速度提升到极致,超过全部json库,包含以前号称最快的jackson。而且还超越了google的二进制协议protocol buf。
http://code.alibabatech.com/mvn/releases/com/alibaba/fastjson/
假设你使用了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这个特性就能够了了,比如:
Object
o = ...; 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" |
fastjson支持序列化时写入类型信息,从而使得反序列化时不至于类型信息丢失。比如:
Color
color = Color.RED; String
text = JSON.toJSONString(color, SerializerFeature.WriteClassName); System.out.println(text); |
输出结果:
{ "@type" : "java.awt.Color" , "r" : 255 , "g" : 0 , "b" : 0 , "alpha" : 255 } |
因为序列化带了类型信息,使得反序列化时可以自己主动进行类型识别,比如:
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 = new
A(); B
b = new
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"来表示的
引用 | 描写叙述 |
---|---|
"$ref":".." | 上一级 |
"$ref":"@" | 当前对象,也就是自引用 |
"$ref":"$" | 根对象 |
"$ref":"$.children.0" | 基于路径的引用,相当于 root.getChildren().get(0) |
在某些场景,你可能须要定制序列化输出,比方说,希望序列化採用之后採用"ID",而不是"id",你能够使用@JSONField这个Annotation。
public
class
User { @JSONField (name= "ID" ) public
int
getId() { ... } } User
user = ...; JSON.toJSONString(user);
//
{"ID":234} |
假设你已经使用了json-lib,而且痛恨他蜗牛般的速度和罗嗦的API,建议你升级为fastjson,fastjson能够全然兼容json-lib的序列化格式。
import
com.alibaba.fastjson.JSON; import
com.alibaba.fastjson.serializer.JSONLibDataFormatSerializer; import
com.alibaba.fastjson.serializer.JSONSerializerMap; import
com.alibaba.fastjson.serializer.SerializerFeature; private
static
final
SerializeConfig config; static
{ config
= new
SerializeConfig(); config.put(java.util.Date. class ,
new
JSONLibDataFormatSerializer()); //
使用和json-lib兼容的日期输出格式 config.put(java.sql.Date. class ,
new
JSONLibDataFormatSerializer()); //
使用和json-lib兼容的日期输出格式 } private
static
final
SerializerFeature[] features = { SerializerFeature.WriteMapNullValue, //
输出空置字段 SerializerFeature.WriteNullListAsEmpty,
//
list字段假设为null,输出为[],而不是null SerializerFeature.WriteNullNumberAsZero,
//
数值字段假设为null,输出为0,而不是null SerializerFeature.WriteNullBooleanAsFalse,
//
Boolean字段假设为null,输出为false,而不是null SerializerFeature.WriteNullStringAsEmpty
//
字符类型字段假设为null,输出为"",而不是null }; //
序列化为和JSON-LIB兼容的字符串 public
static
String toCompatibleJSONString(Object object) { return
JSON.toJSONString(object, config, features); } |
通过上面代码中的toCompatibleJSONString方法,你就能够实现全然兼容json-lib了。
反序列化就是把JSON格式的文本转化为Java Bean对象。
通过指定类型信息,能够非常方便的将"JSON文本"反序列化为"Java Bean"对象,比如:
String
text = ...; //
{"r":255,"g":0,"b":0,"alpha":255} Color
color = JSON.parseObject(text, Color. class ); |
这个接口类似于parseObject
String
text = ...; //
[{ ... }, { ... }] List<User>
users = JSON.parseArray(text, User. class ); |
假设你须要返回一个带泛型的对象,比如List<User>、Map<String, User>,你能够使用TypeReference来传入类型信息。
String
text = ...; //
{"name":{"name":"ljw",age:18}} Map<String,
User> userMap = JSON.parseObject(text, new
TypeReference<Map<String, User>>() {}); |
比方在网络协议中,常常会存在这种组合:
[{ /*header*/},
{/*body*/ }] |
fastjson对这样的结构的反序列化有专门支持。
String
text = ...; //
[{/* header */}, {/* body */}] Type[]
types = new
Type[] {Header. class ,
Body. class }; List<Object>
list = JSON.parseArray(text, types); Header
header = (Header) list.get( 0 ); Body
body = (Body) list.get( 1 ); |
假设你的JavaBean没有缺省构造函数,能够使用@JSONCreator来指定构造函数
public
static
class
Entity { private
final
int
id; private
final
String name; @JSONCreator public
Entity( @JSONField (name
= "id" )
int
id, @JSONField (name
= "name" )
String name){ this .id
= id; this .name
= name; } public
int
getId() { return
id; } public
String getName() { return
name; } } |
public
static
interface
Bean { int
getId(); void
setId( int
value); String
getName(); void
setName(String value); } String
text = "{\"id\":123,
\"name\":\"chris\"}" ; Bean
bean = JSON.parseObject(text, Bean. class ); //
按接口调用 Assert.assertEquals( 123 ,
bean.getId()); Assert.assertEquals( "chris" ,
bean.getName()); bean.setId( 234 ); Assert.assertEquals( 234 ,
bean.getId());
出自:
|
原文:http://www.cnblogs.com/mengfanrong/p/3839799.html