序列化
一个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，这个使得序列化和反序列化的过程不会导致时区问题。如：
例如：
longmillis = 1324138987429L;
Date date =newDate(millis);
System.out.println(JSON.toJSONString(date));
输出的结果是
fastjson还提供了基于格式化输出的SerializerFeature，例如：
JSON.toJSONString(date,SerializerFeature.WriteDateUseDateFormat);
输出的结果为：
你可以指定输出日期的格式，比如修改为输出毫秒：
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","alpha":255}
Color color = (Color) JSON.parse(text);
浏览器和设备兼容
fastjson缺省的序列化内容，是对序列化结果紧凑做了优化配置，使得序列化之后长度更小，但是这种优化配置是对一些浏览器和设备不兼容的。比如说在iphone上兼容emoji（绘文字）。
JSON.toJSONString(o,SerializerFeature.BrowserCompatible);
循环引用
很多场景中，我们需要序列化的对象中存在循环引用，在许多的json库中，这会导致stackoverflow。在功能强大的fastjson中，你不需要担心这个问题。例如：
A a =newA();
B b =newB(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。
publicclassUser {
@JSONField(name="ID")
publicintgetId() { ... }
}
User user = ...;
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;
privatestaticfinalSerializeConfig config;
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，输出为[]，而不是null
SerializerFeature.WriteNullNumberAsZero,// 数值字段如果为null，输出为0，而不是null
SerializerFeature.WriteNullBooleanAsFalse,// Boolean字段如果为null，输出为false，而不是null
SerializerFeature.WriteNullStringAsEmpty// 字符类型字段如果为null，输出为""，而不是null
};
// 序列化为和JSON-LIB兼容的字符串
publicstaticString toCompatibleJSONString(Object object) {
returnJSON.toJSONString(object,config,features);
}
通过上面代码中的toCompatibleJSONString方法，你就可以实现完全兼容json-lib了。
反序列化
反序列化就是把JSON格式的文本转化为Java Bean对象。
指定Class信息反序列化
通过指定类型信息，可以很方便的将"JSON文本"反序列化为"Java Bean"对象，例如：
String text = ...;// {"r":255,"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,newTypeReference<Map<String,User>>() {});
组合类型集合的反序列化
比如在网络协议中，经常会存在这样的组合:
[{/*header*/},{/*body*/}]
fastjson对这种结构的反序列化有专门支持。
String text = ...;// [{/* header */},{/* body */}]
Type[] types =newType[] {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来指定构造函数
publicstaticclassEntity {
privatefinalintid;
privatefinalString name;
@JSONCreator
publicEntity(@JSONField(name ="id")intid,@JSONField(name ="name") String name){
this.id = id;
this.name = name;
}
publicintgetId() {returnid; }
publicString getName() {returnname; }
}
把JSON文本反序列化为一个原型接口
publicstaticinterfaceBean {
intgetId();
voidsetId(intvalue);
String getName();
voidsetName(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());
（编辑：李大同）
【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!
|
