原来 Java 项目中用的 JSON 组件库主要是 Gson 和 json-lib，Gson 算是很错的库，json-lib 略显寒碜。好啦，最近 Play 2.x 中弃用了 Gson 而采纳了 Jackson，所以现在就来打探一下 Jackson，踩个点吧。
Jackson 号称非常高的性能，听说比另两位兄弟 Gson 和 json-lib 高出一大截，我没有亲测，可是有心人做了，看这个链接 两款JSON类库Jackson与JSON-lib的性能对比(新增第三款测试) 中的数据。2010 年 8 月份的测试结果，不知现在随着版本的变更是否仍然保持着这种悬殊。
通常我会在把文章开头塞丰满，做足前戏，并不是因为在天涯混习惯了的缘故，况且我在天涯总是讷于言的; 在这里，自己的地盘自己作主，不会有要求码足多少字才能发表的自虐性需求，仅仅是让本文在主页上显示时的的概要不空洞而已，可以简单粗暴的称之为废话。
了了，先了解 Jacson 最贴近实际应用场景的应用，即 Jackson 怎么把一个 Java 生成对应的 JSON 字符串，看看前面的文字有这么多了，直接上一段代码吧，而后再慢慢假设与分解：
|
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
package
cc.unmi.testjackson;
import
org.codehaus.jackson.annotate.JsonAutoDetect.Visibility;
import
org.codehaus.jackson.annotate.JsonMethod;
import
org.codehaus.jackson.map.ObjectMapper;
import
org.codehaus.jackson.map.SerializationConfig;
/**
* @author Unmi
*/
public
class
TestClient {
/**
* @param args
* @throws Exception
*/
public
static
void
main(String[] args)
throws
Exception {
ObjectMapper mapper =
new
ObjectMapper();
mapper.setVisibility(JsonMethod.FIELD, Visibility.ANY);
mapper.configure(SerializationConfig.Feature.INDENT_OUTPUT,
true
);
Person person =
new
Person(
"Unmi"
,
new
Address(
"JiangXi"
));
String json = mapper.writeValueAsString(person);
System.out.println(json);
}
}
class
Person {
private
String name;
private
Address address;
public
Person(String name, Address address){
this
.name = name;
this
.address = address;
}
}
class
Address {
private
String province;
public
Address(String province){
this
.province = province;
}
public
String getProvince(){
return
this
.province;
}
}
|
要使用 Jackson，自然要引入相应的 jar 包，用 Maven 管理依赖的在 pom.xml 中加上：
|
1
2
3
4
5
|
<
dependency
>
<
groupId
>org.codehaus.jackson</
groupId
>
<
artifactId
>jackson-mapper-asl</
artifactId
>
<
version
>1.9.11</
version
>
</
dependency
>
|
这样在项目中就会有了 jackson-mapper-asl-1.9.11.jar 和 jackson-core-asl-1.9.11.jar 这两个 jar 包，其实当前版本是 2.1.0，只是 Maven 中央库中还没有。
上面代码结果是可预测了，就是：
|
1
2
3
4
5
6
|
{
"name"
:
"Unmi"
,
"address"
: {
"province"
:
"JiangXi"
}
}
|
Jackson 提供了 ObjectMapper 和 JsonGenerator 两个 API 让你去玩转 JSON，其实内部实现肯定汇合在一起了，别让两个选择就使你不会选择了。
如果把第一段代码中的第 20 行拿掉，运行会抛出异常：
Exception in thread "main" org.codehaus.jackson.map.JsonMappingException: No serializer found for class cc.unmi.testjackson.Person and no properties discovered to create BeanSerializer (to avoid exception, disable SerializationConfig.Feature.FAIL_ON_EMPTY_BEANS) )
at org.codehaus.jackson.map.ser.impl.UnknownSerializer.failForEmpty(UnknownSerializer.java:52)
at org.codehaus.jackson.map.ser.impl.UnknownSerializer.serialize(UnknownSerializer.java:25)
at org.codehaus.jackson.map.ser.StdSerializerProvider._serializeValue(StdSerializerProvider.java:610)
at org.codehaus.jackson.map.ser.StdSerializerProvider.serializeValue(StdSerializerProvider.java:256)
at org.codehaus.jackson.map.ObjectMapper._configAndWriteValue(ObjectMapper.java:2575)
at org.codehaus.jackson.map.ObjectMapper.writeValueAsString(ObjectMapper.java:2097)
原因是 Jackson 默认情况下不知道怎么去序列化，解决办法是:
1. 用上面的第 20 行代码，setVisibility，这个属性也可以通过 SerializationConfig 来设置
2. 或是给你要转换 Json 的类加上注解 @JsonAutoDetect(fieldVisibility=JsonAutoDetect.Visibility.ANY)3. 也可以给字段或 getter 上加上 @JsonProperty 注解，还能用它指定序列化时的属性名
第 21 行是辅助设置，对格式的控制等，比要不要输出 null 值的，数字日期怎么显示，多瞧瞧那些 Feature:
org.codehaus.jackson.map.SerializationConfig.Feature.*
org.codehaus.jackson.JsonGenerator.Feature.*
org.codehaus.jackson.JsonParser.Feature.*
Jackson 的定制性还是很强的。再来想像这么一个需求，想输出的 JSON 属性也可定制，比如不想 {"name": "Unmi"}，想要属性的第一个字母是大写的，{"Name": "Unmi"}。没问题，用 ObjectMapper 的
setPropertyNamingStrategy(PropertyNamingStrategy s) 方法
定义自己的 PropertyNamingStrategry, 可以继承自 PropertyNamingStrategy 或 PropertyNamingStrategyBase，显然继承自 PropertyNamingStrategyBase 来简单，因为它帮你适配了，只需覆写它的一个方法，如：
|
01
02
03
04
05
06
07
08
09
10
11
|
import
org.codehaus.jackson.map.PropertyNamingStrategy.PropertyNamingStrategyBase;
public
class
CapitalizedPropertyNamingStrategy
extends
PropertyNamingStrategyBase {
@Override
public
String translate(String propertyName) {
String name = propertyName.replaceAll(
"^\\w"
, propertyName.toUpperCase().substring(
0
,
1
));
return
name;
}
}
|
然后对 mapper 调用
|
1
|
mapper.setPropertyNamingStrategy(
new
CapitalizedPropertyNamingStrategy());
|
再次运行代码，结果就变成了：
|
1
2
3
4
5
6
|
{
"Name"
:
"Unmi"
,
"Address"
: {
"Province"
:
"JiangXi"
}
}
|
还有什么需求，混迹代码中，最不能缺的就是想像力了。
小结一下：
1. ObjectMapper 可用来序列化和反序列化对象，而 JsonParser 是用来反序列化的，JsonGenerator 是序列化的。若想让代码职责分明，就用 JsonParser 或 JsonGenerator 代替 ObjectMapper 来用
2. ObjectMapper 和 JsonGenerator 有各种各样的 writeXxx() 方法，可以让结果输出到不同的目的地; 同样 ObjectMapper 和 JsonParser 也有各色 readXxx() 方法，方便你从不同的源获得数据
3. 多看看 Jackson 为我们提供了注释 Annotation，留意上面那几个 Feature 中有些什么枚举值，这里面也是我们的扩展点。
参考： 1. JacksonInFiveMinutes