對這文章發表回應
發表限制: 非會員 可以發表
簡介
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有超過1500個testcase，每次構建都會跑一遍，豐富的測試場景保證了功能穩定。
獲得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 . 14 </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); |
輸出的結果為：
你可以指定輸出日期的格式，比如修改為輸出毫秒：
JSON.toJSONStringWithDateFormat(date, ); |
輸出的結果為:
使用WriteClassName特性
fastjson支持序列化時寫入類型信息，從而使得反序列化時不至於類型信息丟失。例如：
Color color = Color.RED;String text = JSON.toJSONString(color, SerializerFeature.WriteClassName);System.out.println(text); |
輸出結果：
{ : , : 255 , : 0 , : 0 , : 255 } |
由於序列化帶了類型信息，使得反序列化時能夠自動進行類型識別，例如：
String text = ...; 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); A a1 = JSON.parseObject(text, A. class );Assert.assertTrue(a1 == a1.getB().getA()); |
| 上一級 | |
| 當前對象，也就是自引用 | |
| 根對像 | |
| 基於路徑的引用，相當於 root.getChildren().get(0) |
A8@JSONFieldAnnotation">使用@JSONField Annotation
public class User {@JSONField (name= )public int getId() { ... }}User user = ...;JSON.toJSONString(user); |
從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，輸出為[]，而不是nullSerializerFeature.WriteNullNumberAsZero, // 數值字段如果為null，輸出為0，而不是nullSerializerFeature.WriteNullBooleanAsFalse, // Boolean字段如果為null，輸出為false，而不是nullSerializerFeature.WriteNullStringAsEmpty };// 序列化為和JSON-LIB兼容的字符串public static String toCompatibleJSONString(Object object) {return JSON.toJSONString(object, config, features);} |
通過上面代碼中的toCompatibleJSONString方法，你就可以實現完全兼容json-lib了。
反序列化
反序列化就是把JSON格式的文本轉化為Java Bean對象。
指定Class信息反序列化
String text = ...; 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 = ...; 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 ); |
A8@JSONCreator%E6%9D%A5%E6%8C%87%E5%AE%9A%E6%9E%84%E9%80%A0%E5%87%BD%E6%95%B0%E6%9D%A5%E5%88%9B%E5%BB%BA%E5%AF%B9%E8%B1%A1">使用@JSONCreator來指定構造函數來創建對像
如果你的JavaBean沒有缺省構造函數，可以使用@JSONCreator來指定構造函數
public static class Entity {private final int id;private final String name;@JSONCreatorpublic Entity( @JSONField (name = ) int id, @JSONField (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 = ;Bean bean = JSON.parseObject(text, Bean. class );// 按接口調用Assert.assertEquals( 123 , bean.getId());Assert.assertEquals( , bean.getName());bean.setId( 234 );Assert.assertEquals( 234 , bean.getId());出自： |
原文出處： Json解析教程（四.FastJson 的使用） - - ITeye博客