简介
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,每次构建都会跑一遍,丰富的测试场景保证了功能稳定。
获得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 . 23 </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());
|
相关推荐
Fastjson是阿里巴巴开发的一款高性能的Java JSON库,其主要特点是速度极快、API简洁、功能强大且具有良好的扩展性。自发布以来,Fastjson在性能方面一直保持着领先的地位,据第三方测试显示,它是Java语言中最快的...
**FastJson介绍** FastJson是阿里巴巴开发的一款高性能的Java JSON库,它能够快速地进行JSON到Java对象以及Java对象到JSON字符串之间的转换。在Android开发中,由于其轻量级和高效的特性,FastJson常被用于处理...
Fastjson介绍 Fastjson是一个Java语言编写的JSON处理器。 1、遵循http://json.org标准,为其官方网站收录的参考实现之一。 2、功能qiang打,支持JDK的各种类型,包括基本的JavaBean、Collection、Map、Date、Enum、...
1. **Fastjson介绍**:Fastjson是阿里巴巴开源的一款强大的JSON库,它提供了快速的性能,简单易用的API,以及对JSON的各种处理功能,包括解析JSON字符串到Java对象,将Java对象序列化为JSON字符串等。 2. **JSON...
【FastJSON介绍】 FastJSON是阿里巴巴开源的一个高性能的JSON库,主要应用于Java平台,它提供了JSON到Java对象以及Java对象到JSON字符串的快速转换功能。FastJSON在序列化和反序列化速度上表现出色,使得它在处理...
fastJSON 使用介绍 fastJSON 是一个快速的 JSON 组件,可以用于 C# 中对 JSON 数据的序列化和反序列化。下面是关于 fastJSON 的知识点: fastJSON 简介 fastJSON 是一个开源的 JSON 序列化组件,可以用于 C# 中对...
本文将详细介绍如何在Android Studio中使用FastJSON进行JSON解析和生成。 首先,理解JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,它基于ECMAScript的一个子集,采用完全独立于语言的文本格式,...
另一个文件`read.txt`可能是使用说明或版本更新的简要介绍,对于快速理解和应用Fastjson会有所帮助。 总的来说,Fastjson-1.2.47是阿里巴巴为Java开发者提供的一款强大且高效的JSON处理工具,它的性能优势和简洁API...
**Fastjson 1.2.69 反序列化远程代码执行漏洞详解** Fastjson 是阿里巴巴开源的一个高性能的 JSON 库,广泛应用于 Java 开发中,用于 JSON 的序列化和反序列化操作。然而,Fastjson 1.2.69 版本存在一个严重的反序...
- `README.md`是项目的基本介绍,通常包含项目的目的、如何安装和使用、贡献方式等信息。 - `UnitTests.nunit`可能是一个NUnit测试套件文件,用于执行FastJSON的单元测试,确保代码的质量和正确性。 - `fastJSON....
1. **Howto.md**:这是一个指导文档,详细介绍了如何使用FastJSON库进行基本操作,包括如何序列化和反序列化对象,以及如何处理JSON路径表达式。 2. **README.md**:这是项目的基本说明,通常包含快速入门指南、...
3. **官方文档**: [FastJSON详细介绍](http://code.alibabatech.com/wiki/pages/viewpage.action?pageId=2424946) 4. **JSON中文文档**: [JSON官方网站](http://www.json.org/json-zh.html) 以上内容总结了FastJSON...
本篇文章将详细探讨Fastjson的两个版本——1.2.74和1.2.60,并介绍其核心功能和使用方法。 首先,我们来看一下Fastjson的基本概念。Fastjson是基于Java的JSON解析器和生成器,其设计理念是简洁、快速。它提供了流式...
通过以上介绍,我们可以看到Fastjson作为Java开发中的JSON处理工具,具有很多优点,不仅性能优秀,而且使用简单,功能强大,是开发者处理JSON数据的得力助手。FastjsonJar包.zip提供的不同版本文件则为开发者提供了...
下面将详细介绍Fastjson的使用方法以及压缩包中的关键文件。 首先,`fastjson-1.2.9.jar`是Fastjson的库文件,这是我们在Java项目中使用Fastjson进行JSON操作的基础。将其添加到项目的类路径或依赖管理中,便可以...
作为一款广泛应用于大数据处理、Web服务以及Android开发的工具,Fastjson在1.2.70版本中继续提供了高效且稳定的性能,本文将围绕其最新版Fastjson 1.2.70进行详细介绍。 一、Fastjson核心特性 1. **快速解析与生成...
通过以上介绍,我们对Fastjson的基础使用有了深入了解,无论是简单对象还是复杂结构,都能游刃有余地进行序列化和反序列化操作。在实际开发中,掌握Fastjson能极大地提高我们的开发效率和代码质量。请参考提供的`...
本教程将通过实例介绍Fastjson的基本用法,帮助初学者快速上手。 ### 1. JSON对象与Java对象的转换 #### (1) Java对象转JSON ```java import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONObject...
### 使用介绍 FastJson的使用非常直观,主要包括以下几个核心API: 1. **`parse()`**:将JSON字符串转换为JSON对象或JSON数组。 2. **`parseObject()`**:将JSON字符串解析为Java对象,需要指定目标类型。 3. **`...