简单介绍

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、阿里云手机等环境。

开源

測试充分

  • 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.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());




















出自:


















Fastjson介绍的更多相关文章

  1. FastJson 介绍

    Json详解 Json是一种轻量级的数据交换格式,采用一种“键:值”对的文本格式来存储和表示数据,在系统交换数据过程中常常被使用,是一种理想的数据交换语言.在使用 Java 做 Web 开发时,不可避 ...

  2. Java FastJson 介绍

    1.前言 1.1.FastJson的介绍: JSON协议使用方便,越来越流行,JSON的处理器有很多,这里我介绍一下FastJson,FastJson是阿里的开源框架,被不少企业使用,是一个极其优秀的 ...

  3. [转]fastjson

    原文地址:http://www.cnblogs.com/zhenmingliu/archive/2011/12/29/2305775.html FastJSON是一个很好的java开源json工具类库 ...

  4. FastJSON 简介及其Map/JSON/String 互转

    在日志解析,前后端数据传输交互中,经常会遇到 String 与 map.json.xml 等格式相互转换与解析的场景,其中 json 基本成为了跨语言.跨前后端的事实上的标准数据交互格式.应该来说各个 ...

  5. fastjson 使用方法

    Fastjson介绍 Fastjson是一个Java语言编写的JSON处理器. 1.遵循http://json.org标准,为其官方网站收录的参考实现之一. 2.功能qiang打,支持JDK的各种类型 ...

  6. FastJson的使用方法总结

    本文参考:http://www.tuicool.com/articles/zUbQfa 还可参考:https://www.iflym.com/index.php/code/alibaba-fastjs ...

  7. FastJSON应用前测试--转载

    FastJSON 应用前测试   FastJSON是一个很好的java开源json工具类库,相比其他同类的json类库,它的速度的确是fast,最快!但是文档做得不好,在应用前不得不亲测一些功能.   ...

  8. 8 fastJson的使用

    Fastjson介绍 Fastjson是一个Java语言编写的JSON处理器,由阿里巴巴公司开发. 1.遵循http://json.org标准,为其官方网站收录的参考实现之一. 2.功能qiang打, ...

  9. FastJSON应用前测试

    FastJSON 应用前测试 FastJSON是一个很好的java开源json工具类库,相比其他同类的json类库,它的速度的确是fast,最快!但是文档做得不好,在应用前不得不亲测一些功能.\ 实际 ...

随机推荐

  1. ALV 行列 颜色

    1)颜色含义 1:海蓝:2:浅清:3:黄色:4:浅蓝:5:青色:6:红色:7:橙色.(1)首位为主颜色:(2)次位为辅助颜色:(3)末位为0时,表示首位数字表为表格的底色:末位为1时,则表示以1为底色 ...

  2. Class类文件结构、类加载机制以及字节码执行

    一.Class类文件结构 Class类文件严格按照顺序紧凑的排列,由无符号数和表构成,表是由多个无符号数或其他数据项构成的符合数据结构. Class类文件格式按如下顺序排列:   类型 名称 数量 u ...

  3. init进程 && 解析Android启动脚本init.rc && 修改它使不启动android && init.rc中启动一个sh文件

    Android启动后,系统执行的第一个进程是一个名称为init 的可执行程序.提供了以下的功能:设备管理.解析启动脚本.执行基本的功能.启动各种服务.代码的路径:system/core/init,编译 ...

  4. 【HDOJ】2707 Steganography

    简单字符串,读懂题,很容易AC. #include <stdio.h> #include <string.h> ], line[], des[]; int main() { i ...

  5. ssh 登录出现的几种错误以及解决办法

    首先.确保server端的ssh服务是开的(service shhd start) 然后在client端输入: ssh usrname@serverip (远程登录) scp filename usr ...

  6. Maven学习一:用Maven创建Java Project

    转自:http://blog.csdn.net/lfsfxy9/article/details/9399093  Maven环境配置只是入门的基础,现在要通过Maven基本命令生成一个Java Pro ...

  7. 设置Div多行文本超出时,以省略号代替

    这个文章不错 http://www.css88.com/archives/5206 css中有一个属性: text-overflow,可以设置文本超出指定长度后的文本截取样式. 下面是从 w3shco ...

  8. 很反感Java Web 三层框架

    为什么反感,大家 看图就知道了.一层一层的框架叠加,要达到精通就要一个一个框架的去深入了解,谁有这个精力?PHP没有这么多框架,为何依然能开发大型网站呢? 不过此图的原文却在推销使用Java,原文点此 ...

  9. 我的第一篇Markdown博客

    我的第一篇Markdown博客 这是我第一次用Markdown写博客,发现还是比较好用的,加上Marsedit也支持了Markdown的博客预览,博客园也加了Markdown的格式支持,就更加方便了, ...

  10. HTML5 UTF-8 中文乱码

    <!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title> ...