fastjson的使用

前言

整理转载自 https://zyjustin9.iteye.com/blog/2020533
主要对项目地址、下载链接等进行了更新,对某些操作进行了修订

fastjson 简介

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

高性能

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

支持标准

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

功能强大

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

无依赖

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

支持范围广

  • 支持JDK5,JDK 6,Android,阿里云手机等环境。

开源

  • Apache 2.0 license
  • 代码托管在 Github 上,项目地址是 fastjson

测试充分

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

下载 fastjson

更详细情况可以参考 fastjson 项目在 Github 上的 Wiki 文档

  1. 下载最新版 jar 包 the latest JAR
  2. 使用 Maven ,在 pom.xml 文件中加入依赖:
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>1.2.58</version>
    </dependency>
    

序列化

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

基本序列化

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

// 调用JSON.toJSONString方法,把对象o转化为JSON格式的文本
Object o = ...;
String text = JSON.toJSONString(o);

使用单引号

标准的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”:"@"当前对象,也就是自引用
r e f &quot; : &quot; ref&quot;:&quot; ref":"根对象
r e f &quot; : &quot; ref&quot;:&quot; 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、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());
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值