fastjson簡介:http://code.alibabatech.com/wiki/pages/viewpage.action?pageId=2424946
Fastjson是一個Java語言編寫的高性能功能完善的JSON庫
高性能
fastjson采用獨創的算法，將parse的速度提升到極致，超過所有json庫，包括曾經號稱最快的jackson。並且還超越了google的二進制協議protocol buf。
支持標准
- Fastjson完全支持http://json.org的標准，也是官方網站收錄的參考實現之一。
功能強大
- 支持各種JDK類型。包括基本類型、JavaBean、Collection、Map、Enum、泛型等。
- 支持循環引用
無依賴
- 不需要例外額外的jar，能夠直接跑在JDK上。
支持范圍廣
- 支持JDK 5、JDK 6、Android、阿里雲手機等環境。
開源
- Apache License 2.0
- 代碼托管在github.org上，項目地址是 https://github.com/AlibabaTech/fastjson
獲得fastjson
下載
http://code.alibabatech.com/mvn/releases/com/alibaba/fastjson/
maven
如果你使用了Maven，maven repository配置如下：
<repository>
<id>opensesame</id>
<name>Alibaba OpenSource Repsoitory</name>
<url>http:
//code.alibabatech.com/mvn/releases/</url>
<snapshots>
<enabled>
false
</enabled>
</snapshots>
</repository>
|
pom.xml文件中加入依賴依賴：
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>
1.1
.
23
</version>
</dependency>
|
序列化
一個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，這個使得序列化和反序列化的過程不會導致時區問題。如：
例如：
long
millis = 1324138987429L;
Date date =
new
Date(millis);
System.out.println(JSON.toJSONString(date));
|
輸出的結果是
1324138987429
|
fastjson還提供了基於格式化輸出的SerializerFeature，例如：
JSON.toJSONString(date, SerializerFeature.WriteDateUseDateFormat);
|
輸出的結果為：
"2011-12-18 00:23:07"
|
你可以指定輸出日期的格式，比如修改為輸出毫秒：
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","r":255,"g":0,"b":0,"alpha":255}
Color color = (Color) JSON.parse(text);
|
瀏覽器和設備兼容
fastjson缺省的序列化內容，是對序列化結果緊湊做了優化配置，使得序列化之后長度更小，但是這種優化配置是對一些瀏覽器和設備不兼容的。比如說在iphone上兼容emoji（繪文字）。
JSON.toJSONString(o, SerializerFeature.BrowserCompatible);
|
循環引用
很多場景中，我們需要序列化的對象中存在循環引用，在許多的json庫中，這會導致stackoverflow。在功能強大的fastjson中，你不需要擔心這個問題。例如：
A a =
new
A();
B b =
new
B(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。
public
class
User {
@JSONField
(name=
"ID"
)
public
int
getId() { ... }
}
User user = ...;
JSON.toJSONString(user);
// {"ID":234}
|
從json-lib中升級
如果你已經使用了json-lib，並且痛恨他蝸牛般的速度和羅嗦的API，建議你升級為fastjson，fastjson可以完全兼容json-lib的序列化格式。
import
com.alibaba.fastjson.JSON;
import
com.alibaba.fastjson.serializer.JSONLibDataFormatSerializer;
import
com.alibaba.fastjson.serializer.JSONSerializerMap;
import
com.alibaba.fastjson.serializer.SerializerFeature;
private
static
final
SerializeConfig config;
static
{
config =
new
SerializeConfig();
config.put(java.util.Date.
class
,
new
JSONLibDataFormatSerializer());
// 使用和json-lib兼容的日期輸出格式
config.put(java.sql.Date.
class
,
new
JSONLibDataFormatSerializer());
// 使用和json-lib兼容的日期輸出格式
}
private
static
final
SerializerFeature[] 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兼容的字符串
public
static
String toCompatibleJSONString(Object object) {
return
JSON.toJSONString(object, config, features);
}
|
通過上面代碼中的toCompatibleJSONString方法，你就可以實現完全兼容json-lib了。
反序列化
反序列化就是把JSON格式的文本轉化為Java Bean對象。
指定Class信息反序列化
通過指定類型信息，可以很方便的將"JSON文本"反序列化為"Java Bean"對象，例如：
String text = ...;
// {"r":255,"g":0,"b":0,"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,
new
TypeReference<Map<String, User>>() {});
|
組合類型集合的反序列化
比如在網絡協議中，經常會存在這樣的組合:
[{
/*header*/}, {/*body*/
}]
|
fastjson對這種結構的反序列化有專門支持。
String text = ...;
// [{/* header */}, {/* body */}]
Type[] types =
new
Type[] {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來指定構造函數
public
static
class
Entity {
private
final
int
id;
private
final
String name;
@JSONCreator
public
Entity(
@JSONField
(name =
"id"
)
int
id,
@JSONField
(name =
"name"
) String name){
this
.id = id;
this
.name = name;
}
public
int
getId() {
return
id; }
public
String getName() {
return
name; }
}
|
把JSON文本反序列化為一個原型接口
public
static
interface
Bean {
int
getId();
void
setId(
int
value);
String getName();
void
setName(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());
|