fastJSON使用

简介Fastjson是一个Java语言编写的高性能功能完善的JSON库。高性能fastjson采用独创的算法，将parse的速度提升到极致，超过所有json库，包括曾经号称最快的jackson。并且还超越了google的二进制协议protocolbuf。支持标准Fastjson完全支持的标准，也是官方网站收录的参考实现之一。功能强大支持各种JDK类型。包括基本类型、JavaBean、Collection、Map、Enum、泛型等。支持循环引用无依赖不需要例外额外的jar，能够直接跑在JDK上。支持范围广支持JDK5、JDK6、Android、阿里云手机等环境。开源ApacheLicense2.0代码托管在github.org上，项目地址是测试充分fastjson有超过1500个testcase，每次构建都会跑一遍，丰富的测试场景保证了功能稳定。获得fastjson下载如果你使用了Maven，mavenrepository配置如下：repositoryidopensesame/idnameAlibabaOpenSourceRepsoitory/nameurl文件中加入依赖依赖：dependencygroupIdcom.alibaba/groupIdartifactIdfastjson/artifactIdversion1.1.14/version/dependency序列化一个JSON库涉及的最基本功能就是序列化和反序列化。Fastjson支持javabean的直接序列化。你可以使用com.alibaba.fastjson.JSON这个类进行序列化和反序列化。基本序列化序列化就是把JavaBean对象转化成JSON格式的文本。Objecto=...;Stringtext=JSON.toJSONString(o);在这个例子中，调用JSON.toJSONString方法，把对象o转化为JSON格式的文本。使用单引号标准的JSON是使用双引号的，javascript支持使用单引号格式的json文本，fastjson也支持这个特性，打开SerializerFeature.UseSingleQuotes这个特性就可以了了，例如：Objecto=...;Stringtext=JSON.toJSONString(o,SerializerFeature.UseSingleQuotes);fastjson序列化时可以选择的SerializerFeature有十几个，你可以按照自己的需要去选择使用。日期格式化fastjson直接支持日期类型数据的格式化，包括java.util.Date、java.sql.Date、java.sql.Timestamp、java.sql.Time。缺省情况下，fastjson将Date类型序列化为long，这个使得序列化和反序列化的过程不会导致时区问题。如：例如：longmillis=1324138987429L;Datedate=newDate(millis);System.out.println(JSON.toJSONString(date));输出的结果是1324138987429输出fastjson还提供了基于格式化的SerializerFeature，例如：JSON.toJSONString(date,SerializerFeature.WriteDateUseDateFormat);输出的结果为：2011-12-1800:23:07你可以指定输出日期的格式，比如修改为输出毫秒：JSON.toJSONStringWithDateFormat(date,yyyy-MM-ddHH:mm:ss.SSS);输出的结果为:2011-12-1800:23:07.429使用WriteClassName特性fastjson支持序列化时写入类型信息，从而使得反序列化时不至于类型信息丢失。例如：Colorcolor=Color.RED;Stringtext=JSON.toJSONString(color,SerializerFeature.WriteClassName);System.out.println(text);输出结果：{@type:java.awt.Color,r:255,g:0,b:0,alpha:255}由于序列化带了类型信息，使得反序列化时能够自动进行类型识别，例如：Stringtext=...;//{@type:java.awt.Color,r:255,g:0,b:0,alpha:255}Colorcolor=(Color)JSON.parse(text);浏览器和设备兼容fastjson缺省的序列化内容，是对序列化结果紧凑做了优化配置，使得序列化之后长度更小，但是这种优化配置是对一些浏览器和设备不兼容的。比如说在iphone上兼容emoji（绘文字）。JSON.toJSONString(o,SerializerFeature.BrowserCompatible);循环引用很多场景中，我们需要序列化的对象中存在循环引用，在许多的json库中，这会导致stackoverflow。在功能强大的fastjson中，你不需要担心这个问题。例如：Aa=newA();Bb=newB(a);a.setB(b);Stringtext=JSON.toJSONString(a);//{b:{a:{$ref:..}}}Aa1=JSON.parseObject(text,A.class);Assert.assertTrue(a1==a1.getB().getA());引用是通过$ref来表示的引用描述$ref:..上一级$ref:@当前对象，也就是自引用$ref:$根对象$ref:$.children.0基于路径的引用，相当于root.getChildren().get(0)使用@JSONFieldAnnotation在某些场景，你可能需要定制序列化输出，比如说，希望序列化采用之后采用ID，而不是id，你可以使用@JSONField这个Annotation。publicclassUser{@JSONField(name=ID)publicintgetId(){...}}Useruser=...;JSON.toJSONString(user);//{ID:234}从json-lib中升级如果你已经使用了json-lib，并且痛恨他蜗牛般的速度和罗嗦的API，建议你升级为fastjson，fastjson可以完全兼容json-lib的序列化格式。importcom.alibaba.fastjson.JSON;importcom.alibaba.fastjson.serializer.JSONLibDataFormatSerializer;importcom.alibaba.fastjson.serializer.JSONSerializerMap;importcom.alibaba.fastjson.serializer.SerializerFeature;privatestaticfinalSerializeConfigconfig;static{config=newSerializeConfig();config.put(java.util.Date.class,newJSONLibDataFormatSerializer());//使用和json-lib兼容的日期输出格式config.put(java.sql.Date.class,newJSONLibDataFormatSerializer());//使用和json-lib兼容的日期输出格式}privatestaticfinalSerializerFeature[]features={SerializerFeature.WriteMapNullValue,//输出空置字段SerializerFeature.WriteNullListAsEmpty,//list字段如果为null，输出为[]，而不是nullSerializerFeature.WriteNullNumberAsZero,//数值字段如果为null，输出为0，而不是nullSerializerFeature.WriteNullBooleanAsFalse,//Boolean字段如果为null，输出为false，而不是nullSerializerFeature.WriteNullStringAsEmpty//字符类型字段如果为null，输出为，而不是null};//序列化为和JSON-LIB兼容的字符串publicstaticStringtoCompatibleJSONString(Objectobject){returnJSON.toJSONString(object,config,features);}通过上面代码中的toCompatibleJSONString方法，你就可以实现完全兼容json-lib了。反序列化反序列化就是把JSON格式的文本转化为JavaBean对象。指定Class信息反序列化通过指定类型信息，可以很方便的将JSON文本反序列化为JavaBean对象，例如：Stringtext=...;//{r:255,g:0,b:0,alpha:255}Colorcolor=JSON.parseObject(text,Color.class);类型集合的反序列化这个接口类似于parseObjectStringtext=...;//[{...},{...}]ListUserusers=JSON.parseArray(text,User.class);泛型的反序列化如果你需要返回一个带泛型的对象，例如ListUser、MapString,User，你可以使用TypeReference来传入类型信息。Stringtext=...;//{name:{name:ljw,age:18}}MapString,UseruserMap=JSON.parseObject(text,newTypeReferenceMapString,User(){});组合类型集合的反序列化比如在网络协议中，经常会存在这样的组合:[{/*header*/},{/*body*/}]fastjson对这种结构的反序列化有专门支持。Stringtext=...;//[{/*header*/},{/*body*/}]Type[]types=newType[]{Header.class,Body.class};ListObjectlist=JSON.parseArray(text,types);Headerheader=(Header)list.get(0);Bodybody=(Body)list.get(1);使用@JSONCreator来指定构造函数来创建对象如果你的JavaBean没有缺省构造函数，可以使用@JSONCreator来指定构造函数publicstaticclassEntity{privatefinalintid;privatefinalStringname;@JSONCreatorpublicEntity(@JSONField(name=id)intid,@JSONField(name=name)Stringname){this.id=id;this.name=name;