简介
Fastjson是一个Java语言编写的高性能功能完善的JSON库。
高性能
fastjson采用独创的算法，将parse的速度提升到极致，超过所有json库，包括曾经号称最快的jackson。并且还超越了google的二进制协议protocol buf。
支持标准
Fastjson完全支持的标准，也是收录的参考实现之一。
功能强大
支持各种JDK类型。包括基本类型、JavaBean、Collection、Map、Enum、泛型等。
支持循环引用
无依赖
不需要例外额外的jar，能够直接跑在JDK上。
支持范围广
支持JDK 5、JDK 6、Android、阿里云手机等环境。
开源
Apache License 2.0
代码托管在上，项目地址是 github/AlibabaTech/fastjson
测试充分
fastjson有超过1500个testcase，每次构建都会跑一遍，丰富的测试场景保证了功能稳定。
获得fastjson
下载
code.alibabatech/mvn/releases/com/alibaba/fastjson/
maven
如果你使用了Maven，maven repository配置如下：
<repository>
<id>opensesame</id>
<name>Alibaba OpenSource Repsoitory</name> <url>code.alibabatech/mvn/releases/</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
l文件中加入依赖依赖：
<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 = JSONString(o);
在这个例子中，调用JSONString方法，把对象o转化为JSON格式的文本。
使用单引号
标准的JSON是使用双引号的，javascript支持使用单引号格式的json文本，fastjson也支持这个特性，打开SerializerFeature.UseSingleQuotes这个特性就可以了了，例如：
Object o = ...;
String text = JSONString(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.JSONString(date));
输出的结果是
132********29
fastjson还提供了基于格式化输出的SerializerFeature，例如：
JSONString(date, SerializerFeature.WriteDateUseDateFormat);
输出的结果为：
"2011-12-18 00:23:07"
你可以指定输出日期的格式，比如修改为输出毫秒：
JSONStringWithDateFormat(date, "yyyy-MM-dd HH:mm:ss.SSS");
输出的结果为:
"2011-12-18 00:23:07.429"
使用WriteClassName特性
fastjson支持序列化时写入类型信息，从而使得反序列化时不至于类型信息丢失。例如：
Color color = Color.RED; String text = JSONString(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（绘文字）。
JSONString(o, SerializerFeature.BrowserCompatible);
循环引用
很多场景中，我们需要序列化的对象中存在循环引用，在许多的json库中，这会导致stackoverflow。在功能强大的fastjson中，你不需要担心这个问题。例如：
A a = new A(); B b = new B(a); a.setB(b);
String text = JSONString(a); // {"b":{"a":{"$ref":".."}}}
A a1 = JSON.parseObject(text, A.class);
浏览器json格式化Assert.assertTrue(a1 == a1.getB().getA());
引用是通过"$ref"来表示的
引用 描述
"$ref":".." 上一级
"$ref":"@" 当前对象，也就是自引用
"$ref":"$" 根对象
"$ref":"$.children.0" 基于路径的引用，相当于 Children().get(0)
使用@JSONField Annotation
在某些场景，你可能需要定制序列化输出，比如说，希望序列化采用之后采用"ID"，而不是"id"，你可以使用@JSONField这个Annotation。
public class User {
@JSONField(name="ID")
public int getId() { ... }
}
User user = ...; JSONString(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
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论