首页 > 代码库 > fastJson API

fastJson API

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类上的静态方法直接完成。
public static final Object parse(String text); // 把JSON文本parse为JSONObject或者JSONArray 
public static final JSONObject parseObject(String text); // 把JSON文本parse成JSONObject    
public static final <T> T parseObject(String text, Class<T> clazz); // 把JSON文本parse为JavaBean 
public static final JSONArray parseArray(String text); // 把JSON文本parse成JSONArray 
public static final <T> List<T> parseArray(String text, Class<T> clazz); //把JSON文本parse成JavaBean集合 
public static final String toJSONString(Object object); // 将JavaBean序列化为JSON文本 
public static final String toJSONString(Object object, boolean prettyFormat); // 将JavaBean序列化为带格式的JSON文本 
public static final Object toJSON(Object javaObject); 将JavaBean转换为JSONObject或者JSONArray。
 
 
3、有关类库的一些说明
 
SerializeWriter:相当于StringBuffer
JSONArray:相当于List<Object>
JSONObject:相当于Map<String, Object>
 
JSON反序列化没有真正数组,本质类型都是List<Object>
 
4、fastjson还有很多很高级的特性,比如支持注解、支持全类型序列化,这些都是很好的特性,功能强大,不在本次测试范围。
 
三、测试代码
 
package lavasoft.stu.json; 

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

import java.util.*; 

/** 
* Created by IntelliJ IDEA. 

* @author leizhimin 11-11-22 上午9:15 
*/ 
public class Foo { 
        private String vString = "vStringhehhehe"; 
        private char vchar = ‘x‘; 

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

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

        private boolean vboolean = false; 

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

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

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

        private Bar bar = new Bar(); 
        private Bar[] avBar = {new Bar(), new Bar()}; 
        private List<Bar> listBar = 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(new Bar()); 
                listBar.add(new Bar()); 
                listBar.add(new Bar()); 
        } 



        public String getvString() { 
                return vString; 
        } 

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

        public char getVchar() { 
                return vchar; 
        } 

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

        public byte getVbyte() { 
                return vbyte; 
        } 

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

        public short getVshort() { 
                return vshort; 
        } 

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

        public int getVint() { 
                return vint; 
        } 

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

        public long getVlong() { 
                return vlong; 
        } 

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

        public float getVfloat() { 
                return vfloat; 
        } 

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

        public double getVdouble() { 
                return vdouble; 
        } 

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

        public boolean isVboolean() { 
                return vboolean; 
        } 

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

        public Date getDddd() { 
                return dddd; 
        } 

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

        public Date getV_Date() { 
                return v_Date; 
        } 

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

        public Date getvDate() { 
                return vDate; 
        } 

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

        public Object getVnull() { 
                return vnull; 
        } 

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

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

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

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

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

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

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

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

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

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

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

        public Bar getBar() { 
                return bar; 
        } 

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

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

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

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

        public void setListBar(List<Bar> listBar) { 
                this.listBar = listBar; 
        } 
}
 
package lavasoft.stu.json; 

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

import java.util.Date; 
import java.util.Random; 

/** 
* Created by IntelliJ IDEA. 

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

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

        public String getBarName() { 
                return barName; 
        } 

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

        public int getBarAge() { 
                return barAge; 
        } 

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

        public Date getBarDate() { 
                return barDate; 
        } 

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

        @Override 
        public String toString() { 
                return "Bar{" + 
                                "barName=‘" + barName + ‘\‘‘ + 
                                ", barAge=" + barAge + 
                                ", barDate=" + barDate + 
                                ‘}‘; 
        } 
}
 
 
package lavasoft.stu.json; 

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

import java.util.*; 

/** 
* Created by 2IntelliJ IDEA. 

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

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

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

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

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

        public static void map2JSON(){ 
                Map map = 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); 
                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, 
    "barDate":1322062233062, 
    "barName":"sss_0.36014742" 
  }], 
  "avString":["aaa","bbb","ccc"], 
  "avboolean":[true,false,true,true], 
  "avint":[1,2,3,4], 
  "bar":{ 
    "barAge":1601495948, 
    "barDate":1322062233062, 
    "barName":"sss_0.46644872" 
  }, 
  "dddd":1322062233046, 
  "listBar":[ 
    { 
      "barAge":-1090113522, 
      "barDate":1322062233062, 
      "barName":"sss_0.83562374" 
    }, 
    { 
      "barAge":478603194, 
      "barDate":1322062233062, 
      "barName":"sss_0.59483266" 
    }, 
    { 
      "barAge":1118357669, 
      "barDate":1322062233062, 
      "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,"barDate":"2011-11-23 23:30:33","barName":"sss_0.36014742"}],"avString":["aaa","bbb","ccc"],"avboolean":[true,false,true,true],"avint":[1,2,3,4],"bar":{"barAge":1601495948,"barDate":"2011-11-23 23:30:33","barName":"sss_0.46644872"},"dddd":"2011-11-23 23:30:33","listBar":[{"barAge":-1090113522,"barDate":"2011-11-23 23:30:33","barName":"sss_0.83562374"},{"barAge":478603194,"barDate":"2011-11-23 23:30:33","barName":"sss_0.59483266"},{"barAge":1118357669,"barDate":"2011-11-23 23:30:33","barName":"sss_0.9961642"}],"listString":["listString1","listString2","listString3"],"map":{"x":"s11111x","y":"s22222y","z":"s33333z"},"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类库。
从其中的源代码中,可以学到很多东西,在阅读源码后,不得不佩服作者高超的程序设计水平,和高质量的编码。

fastJson API