关于fastJSON

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

实际上其他的json处理工具都和它差不多，api也有几分相似。

一、JSON规范

JSON是一个标准规范，用于数据交互，规范的中文文档如下：

http://www.json.org/json-zh.html

参看规范，来对比JSON类库处理结果。

二、fastjson的一些简要说明

1、了解fastjson

Fastjson介绍

Fastjson是一个Java语言编写的JSON处理器。
1、遵循 http://json.org标准，为其官方网站收录的参考实现之一。
2、功能qiang打，支持JDK的各种类型，包括基本的JavaBean、Collection、Map、Date、Enum、泛型。
3、无依赖，不需要例外额外的jar，能够直接跑在JDK上。
4、开源，使用Apache License 2.0协议开源。 http://code.alibabatech.com/wiki/display/FastJSON/Home

如果获得Fastjson？
SVN: http://code.alibabatech.com/svn/fastjson/trunk/
WIKI: http://code.alibabatech.com/wiki/display/FastJSON/Home
Issue Tracking: http://code.alibabatech.com/jira/browse/FASTJSON

2、主要的使用入口

Fastjson API入口类是com.alibaba.fastjson.JSON，常用的序列化操作都可以在JSON类上的静态方法直接完成。

@H_404_52@public @H_404_52@static @H_404_52@final Object parse(String text); // 把JSON文本parse为JSONObject或者JSONArray
@H_404_52@public @H_404_52@static @H_404_52@final JSONObject parSEObject(String text)； // 把JSON文本parse成JSONObject
@H_404_52@public @H_404_52@static @H_404_52@final <T> T parSEObject(String text,Class<T> clazz); // 把JSON文本parse为JavaBean
@H_404_52@public @H_404_52@static @H_404_52@final JSONArray parseArray(String text); // 把JSON文本parse成JSONArray
@H_404_52@public @H_404_52@static @H_404_52@final <T> List<T> parseArray(String text,Class<T> clazz); //把JSON文本parse成JavaBean集合
@H_404_52@public @H_404_52@static @H_404_52@final String toJSONString(Object object); // 将JavaBean序列化为JSON文本
@H_404_52@public @H_404_52@static @H_404_52@final String toJSONString(Object object, @H_404_52@boolean prettyFormat); // 将JavaBean序列化为带格式的JSON文本
@H_404_52@public @H_404_52@static @H_404_52@final Object toJSON(Object javaObject); 将JavaBean转换为JSONObject或者JSONArray。

3、有关类库的一些说明

SerializeWriter：相当于StringBuffer

JSONArray：相当于List<Object>

JSONObject：相当于Map<String,Object>

JSON反序列化没有真正数组，本质类型都是List<Object>

4、fastjson还有很多很高级的特性，比如支持注解、支持全类型序列化，这些都是很好的特性，功能强大，不在本次测试范围。

三、测试代码

@H_404_52@package lavasoft.stu.json;

@H_404_52@import com.alibaba.fastjson.JSON;
@H_404_52@import com.alibaba.fastjson.serializer.SerializeConfig;
@H_404_52@import com.alibaba.fastjson.serializer.SimpleDateFormatSerializer;

@H_404_52@import java.util.*;

/**
* Created by IntelliJ IDEA.
*
* @author leizhimin 11-11-22 上午9:15
*/
@H_404_52@public @H_404_52@class Foo {
@H_404_52@private String vString = "vStringhehhehe";
@H_404_52@private @H_404_52@char vchar = 'x';

@H_404_52@private @H_404_52@byte vbyte = 64;
@H_404_52@private @H_404_52@short vshort = 128;
@H_404_52@private @H_404_52@int vint = 65535;
@H_404_52@private @H_404_52@long vlong = 9999999L;

@H_404_52@private @H_404_52@float vfloat = 12.1f;
@H_404_52@private @H_404_52@double vdouble = 22.203d;

@H_404_52@private @H_404_52@boolean vboolean = @H_404_52@false;

//private Date vdate = new Date();
@H_404_52@private Date dddd = @H_404_52@new Date();
@H_404_52@private Date vDate = @H_404_52@new Date();
@H_404_52@private Date v_Date = @H_404_52@new Date();
@H_404_52@private Object vnull = @H_404_52@null;

@H_404_52@private String[] avString = { "aaa", "bbb", "ccc"};
@H_404_52@private @H_404_52@int[] avint = {1,2,3,4};
@H_404_52@private @H_404_52@boolean[] avboolean = { @H_404_52@true, @H_404_52@false, @H_404_52@true, @H_404_52@true};

@H_404_52@private List<String> listString = @H_404_52@new ArrayList<String>();
@H_404_52@private Map<String,String> map = @H_404_52@new HashMap<String,String>();

@H_404_52@private Bar bar = @H_404_52@new Bar();
@H_404_52@private Bar[] avBar = { @H_404_52@new Bar(), @H_404_52@new Bar()};
@H_404_52@private List<Bar> listBar = @H_404_52@new ArrayList<Bar>();

{
listString.add( "listString1");
listString.add( "listString2");
listString.add( "listString3");

map.put( "x", "s11111x");
map.put( "y", "s22222y");
map.put( "z", "s33333z");

listBar.add( @H_404_52@new Bar());
listBar.add( @H_404_52@new Bar());
listBar.add( @H_404_52@new Bar());
}



@H_404_52@public String getvString() {
@H_404_52@return vString;
}

@H_404_52@public @H_404_52@void setvString(String vString) {
@H_404_52@this.vString = vString;
}

@H_404_52@public @H_404_52@char getVchar() {
@H_404_52@return vchar;
}

@H_404_52@public @H_404_52@void setVchar( @H_404_52@char vchar) {
@H_404_52@this.vchar = vchar;
}

@H_404_52@public @H_404_52@byte getVbyte() {
@H_404_52@return vbyte;
}

@H_404_52@public @H_404_52@void setVbyte( @H_404_52@byte vbyte) {
@H_404_52@this.vbyte = vbyte;
}

@H_404_52@public @H_404_52@short getVshort() {
@H_404_52@return vshort;
}

@H_404_52@public @H_404_52@void setVshort( @H_404_52@short vshort) {
@H_404_52@this.vshort = vshort;
}

@H_404_52@public @H_404_52@int getVint() {
@H_404_52@return vint;
}

@H_404_52@public @H_404_52@void setVint( @H_404_52@int vint) {
@H_404_52@this.vint = vint;
}

@H_404_52@public @H_404_52@long getVlong() {
@H_404_52@return vlong;
}

@H_404_52@public @H_404_52@void setVlong( @H_404_52@long vlong) {
@H_404_52@this.vlong = vlong;
}

@H_404_52@public @H_404_52@float getVfloat() {
@H_404_52@return vfloat;
}

@H_404_52@public @H_404_52@void setVfloat( @H_404_52@float vfloat) {
@H_404_52@this.vfloat = vfloat;
}

@H_404_52@public @H_404_52@double getVdouble() {
@H_404_52@return vdouble;
}

@H_404_52@public @H_404_52@void setVdouble( @H_404_52@double vdouble) {
@H_404_52@this.vdouble = vdouble;
}

@H_404_52@public @H_404_52@boolean isVboolean() {
@H_404_52@return vboolean;
}

@H_404_52@public @H_404_52@void setVboolean( @H_404_52@boolean vboolean) {
@H_404_52@this.vboolean = vboolean;
}

@H_404_52@public Date getDddd() {
@H_404_52@return dddd;
}

@H_404_52@public @H_404_52@void setDddd(Date dddd) {
@H_404_52@this.dddd = dddd;
}

@H_404_52@public Date getV_Date() {
@H_404_52@return v_Date;
}

@H_404_52@public @H_404_52@void setV_Date(Date v_Date) {
@H_404_52@this.v_Date = v_Date;
}

@H_404_52@public Date getvDate() {
@H_404_52@return vDate;
}

@H_404_52@public @H_404_52@void setvDate(Date vDate) {
@H_404_52@this.vDate = vDate;
}

@H_404_52@public Object getVnull() {
@H_404_52@return vnull;
}

@H_404_52@public @H_404_52@void setVnull(Object vnull) {
@H_404_52@this.vnull = vnull;
}

@H_404_52@public String[] getAvString() {
@H_404_52@return avString;
}

@H_404_52@public @H_404_52@void setAvString(String[] avString) {
@H_404_52@this.avString = avString;
}

@H_404_52@public @H_404_52@int[] getAvint() {
@H_404_52@return avint;
}

@H_404_52@public @H_404_52@void setAvint( @H_404_52@int[] avint) {
@H_404_52@this.avint = avint;
}

@H_404_52@public @H_404_52@boolean[] getAvboolean() {
@H_404_52@return avboolean;
}

@H_404_52@public @H_404_52@void setAvboolean( @H_404_52@boolean[] avboolean) {
@H_404_52@this.avboolean = avboolean;
}

@H_404_52@public List<String> getListString() {
@H_404_52@return listString;
}

@H_404_52@public @H_404_52@void setListString(List<String> listString) {
@H_404_52@this.listString = listString;
}

@H_404_52@public Map<String,String> getMap() {
@H_404_52@return map;
}

@H_404_52@public @H_404_52@void setMap(Map<String,String> map) {
@H_404_52@this.map = map;
}

@H_404_52@public Bar getBar() {
@H_404_52@return bar;
}

@H_404_52@public @H_404_52@void setBar(Bar bar) {
@H_404_52@this.bar = bar;
}

@H_404_52@public Bar[] getAvBar() {
@H_404_52@return avBar;
}

@H_404_52@public @H_404_52@void setAvBar(Bar[] avBar) {
@H_404_52@this.avBar = avBar;
}

@H_404_52@public List<Bar> getListBar() {
@H_404_52@return listBar;
}

@H_404_52@public @H_404_52@void setListBar(List<Bar> listBar) {
@H_404_52@this.listBar = listBar;
}
}

@H_404_52@package lavasoft.stu.json;

@H_404_52@import com.alibaba.fastjson.JSON;
@H_404_52@import com.alibaba.fastjson.serializer.SerializeConfig;
@H_404_52@import com.alibaba.fastjson.serializer.SimpleDateFormatSerializer;

@H_404_52@import java.util.Date;
@H_404_52@import java.util.Random;

/**
* Created by IntelliJ IDEA.
*
* @author leizhimin 11-11-22 上午9:15
*/
@H_404_52@public @H_404_52@class Bar {
@H_404_52@public @H_404_52@static SerializeConfig mapping = @H_404_52@new SerializeConfig();
@H_404_52@private String barName;
@H_404_52@private @H_404_52@int barAge;
@H_404_52@private Date barDate = @H_404_52@new Date();
@H_404_52@static {
mapping.put(Date. @H_404_52@class, @H_404_52@new SimpleDateFormatSerializer( "yyyy-MM-dd"));
}
{
Random r = @H_404_52@new Random();
barName = "sss_"+String.valueOf(r.nextFloat());
barAge = r.nextInt();
}

@H_404_52@public @H_404_52@static @H_404_52@void main(String[] args) {
Object obj = JSON.toJSON( @H_404_52@new Bar());
String x1 = JSON.toJSONString( @H_404_52@new Bar(), @H_404_52@true);
System.out.println(x1);
String x2 = JSON.toJSONString( @H_404_52@new Bar(),mapping);
System.out.println(x2);
}

@H_404_52@public String getBarName() {
@H_404_52@return barName;
}

@H_404_52@public @H_404_52@void setBarName(String barName) {
@H_404_52@this.barName = barName;
}

@H_404_52@public @H_404_52@int getBarAge() {
@H_404_52@return barAge;
}

@H_404_52@public @H_404_52@void setBarAge( @H_404_52@int barAge) {
@H_404_52@this.barAge = barAge;
}

@H_404_52@public Date getBarDate() {
@H_404_52@return barDate;
}

@H_404_52@public @H_404_52@void setBarDate(Date barDate) {
@H_404_52@this.barDate = barDate;
}

@Override
@H_404_52@public String toString() {
@H_404_52@return "Bar{" +
"barName='" + barName + '\'' +
",barAge=" + barAge +
",barDate=" + barDate +
'}';
}
}

@H_404_52@package lavasoft.stu.json;

@H_404_52@import com.alibaba.fastjson.JSON;
@H_404_52@import com.alibaba.fastjson.JSONArray;
@H_404_52@import com.alibaba.fastjson.serializer.SerializeConfig;
@H_404_52@import com.alibaba.fastjson.serializer.SimpleDateFormatSerializer;

@H_404_52@import java.util.*;

/**
* Created by 2IntelliJ IDEA.
*
* @author leizhimin 11-11-22 上午9:45
*/
@H_404_52@public @H_404_52@class Test {
@H_404_52@private @H_404_52@static SerializeConfig mapping = @H_404_52@new SerializeConfig(); @H_404_52@static {
mapping.put(Date. @H_404_52@class, @H_404_52@new SimpleDateFormatSerializer( "yyyy-MM-dd HH:mm:ss"));
}

@H_404_52@public @H_404_52@static @H_404_52@void main(String[] args) {
Foo f1 = @H_404_52@new Foo();
Date date = @H_404_52@new Date();
String text = JSON.toJSONString(date,mapping);
System.out.println(text);
System.out.println(JSON.toJSONString(f1, @H_404_52@true));
String x2 =JSON.toJSONString(f1,mapping);
System.out.println(x2);
}

@H_404_52@public @H_404_52@static @H_404_52@void json2List(){
//List -> JSON array
List<Bar> barList = @H_404_52@new ArrayList<Bar>();
barList.add( @H_404_52@new Bar());
barList.add( @H_404_52@new Bar());
barList.add( @H_404_52@new Bar());
String json= JSON.toJSONString(barList, @H_404_52@true);
System.out.println(json);
//JSON array -> List
List<Bar> barList1 = JSON.parseArray(json,Bar. @H_404_52@class);
@H_404_52@for (Bar bar : barList1) {
System.out.println(bar.toString());
}
}

@H_404_52@public @H_404_52@static @H_404_52@void json2Map(){
//Map -> JSON
Map<String,Bar> map = @H_404_52@new HashMap<String,Bar>();
map.put( "a",@H_404_52@new Bar());
map.put( "b",@H_404_52@new Bar());
map.put( "c",@H_404_52@new Bar());
String json = JSON.toJSONString(map,@H_404_52@true);
System.out.println(json);
//JSON -> Map
Map<String,Bar> map1 = (Map<String,Bar>)JSON.parse(json);
@H_404_52@for (String key : map1.keySet()) {
System.out.println(key+ ":"+map1.get(key));
}
}

@H_404_52@public @H_404_52@static @H_404_52@void array2JSON(){
String[] arr_String= { "a","b","c"};
String json_arr_String = JSON.toJSONString(arr_String,@H_404_52@true);
System.out.println(json_arr_String);
JSONArray jsonArray = JSON.parseArray(json_arr_String);
@H_404_52@for (Object o : jsonArray) {
System.out.println(o);
}
System.out.println(jsonArray);
}
@H_404_52@public @H_404_52@static @H_404_52@void array2JSON2(){
Bar[] arr_Bar= { @H_404_52@new Bar(),@H_404_52@new Bar(),@H_404_52@new Bar()};
String json_arr_Bar = JSON.toJSONString(arr_Bar,@H_404_52@true);
System.out.println(json_arr_Bar);
JSONArray jsonArray = JSON.parseArray(json_arr_Bar);
@H_404_52@for (Object o : jsonArray) {
System.out.println(o);
}
System.out.println(jsonArray);
}

@H_404_52@public @H_404_52@static @H_404_52@void map2JSON(){
Map map = @H_404_52@new HashMap();
map.put( "a","aaa");
map.put( "b","bbb");
map.put( "c","ccc");
String json=JSON.toJSONString(map);
System.out.println(json);
Map map1 = JSON.parSEObject(json);
@H_404_52@for (Object o : map.entrySet()) {
Map.Entry<String,String> entry = (Map.Entry<String,String>)o;
System.out.println(entry.getKey()+ "--->"+entry.getValue());
}
}
}

说明：

SerializeConfig：是对序列化过程中一些序列化过程的特殊配置，这里用作日期格式的定义。

有关需要带类型的全类型序列化过程，需要调用JSON.toJSONStringZ()方法。

需要美化输出时候，需要打开序列化美化开关，在方法中true那个参数。

输出结果：

"2011-11-23 23:30:33"
{
"avBar":[{
"barAge":174398800,
"barDate":1322062233062,
"barName":"sss_0.62378174"
},{
"barAge":38938962,
"barName":"sss_0.36014742"
}],
"avString":["aaa","bbb","ccc"],
"avboolean":[true,false,true,true],
"avint":[1,4],
"bar":{
"barAge":1601495948,
"barName":"sss_0.46644872"
},
"dddd":1322062233046,
"listBar":[
{
"barAge":-1090113522,
"barName":"sss_0.83562374"
},
{
"barAge":478603194,
"barName":"sss_0.59483266"
},
{
"barAge":1118357669,
"barName":"sss_0.9961642"
}
],
"listString":[
"listString1",
"listString2",
"listString3"
],
"map":{"x":"s11111x","y":"s22222y","z":"s33333z"},
"v_Date":1322062233046,
"vboolean":false,
"vbyte":64,
"vchar":"x",
"vdouble":22.203,
"vfloat":12.1,
"vint":65535,
"vlong":9999999,
"vshort":128
}
{"avBar":[{"barAge":174398800,"barDate":"2011-11-23 23:30:33","barName":"sss_0.62378174"},{"barAge":38938962,"barName":"sss_0.36014742"}],"avString":["aaa","avboolean":[true,"avint":[1,"bar":{"barAge":1601495948,"barName":"sss_0.46644872"},"dddd":"2011-11-23 23:30:33","listBar":[{"barAge":-1090113522,"barName":"sss_0.83562374"},{"barAge":478603194,"barName":"sss_0.59483266"},{"barAge":1118357669,"barName":"sss_0.9961642"}],"listString":["listString1","listString2","listString3"],"map":{"x":"s11111x","v_Date":"2011-11-23 23:30:33","vboolean":false,"vbyte":64,"vchar":"x","vdouble":22.203,"vfloat":12.1,"vint":65535,"vlong":9999999,"vshort":128}

Process finished with exit code 0

fastjson通过各方面测试都很好，功能性能都是No.1，喜欢，它的源代码质量很高，作者也煞费苦心，将性能做到了最好，全免超越其他的json类库。

从其中的源代码中，可以学到很多东西，在阅读源码后，不得不佩服作者高超的程序设计水平，和高质量的编码。