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，每次构建都会跑一遍，丰富的測试场景保证了功能稳定。
下载
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这个特性就能够了了，比如：
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" |
使用WriteClassName特性
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) |
使用@JSONField Annotation
在某些场景，你可能须要定制序列化输出，比方说，希望序列化採用之后採用"ID"，而不是"id"，你能够使用@JSONField这个Annotation。
public class User { @JSONField(name="ID") public int getId() { ... }}User user = ...;JSON.toJSONString(user); // {"ID":234} |
从json-lib中升级
假设你已经使用了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对象。
指定Class信息反序列化
通过指定类型信息，能够非常方便的将"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); |
使用@JSONCreator来指定构造函数来创建对象
假设你的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; }} |
把JSON文本反序列化为一个原型接口
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());出自： |