下載和部署GSON
GSON的GitHub頁面地址：https://github.com/google/gson
在使用GSON API工作之前，你需要下載庫(jar文件)，并將其包含到類路徑中。庫，連同源代碼和Java文檔，都可以從http://code.google.com/p/google-gson/downloads/list下載。下載完畢后，添加gson-<version>.jar到類路徑。對于那些偏好使用Maven管理依賴(JAR文件)的讀者，添加如下依賴到pom.xml。
|
1
2
3
4
5
|
<dependency> <groupId>com.google.code.gson</groupId> <artifactId>gson</artifactId> <version>2.2.4</version></dependency> |
需要修改 <version>2.2.4</version>。本文所有代碼示例使用上面列出的版本。pom.xml文件拷貝可以在這里找到。
如果這個庫用于web應用，請確保在WEB-INF/lib文件夾中保持一份拷貝。或者，GSON庫可以放到應用服務器提供給web應用。
示例
下面是一個簡單的例子：
|
1
2
3
4
5
6
7
8
9
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
|
public class Person { private String name; private int age; /** * @return the name */ public String getName() { return name; } /** * @param name the name to set */ public void setName(String name) { this.name = name; } /** * @return the age */ public int getAge() { return age; } /** * @param age the age to set */ public void setAge(int age) { this.age = age; } @Override public String toString() { return name + ":" +age; }} |
實體很簡單，兩個字段，當然實體中的字段也可以是List或者Set類型的。
|
1
2
3
4
5
6
7
8
9
|
Gson gson = new Gson();List<Person> persons = new ArrayList<Person>();for (int i = 0; i < 10; i++) { Person p = new Person(); p.setName("name" + i); p.setAge(i * 5); persons.add(p);}String str = gson.toJson(persons); |
上面的代碼重點是Gson對象，它提供了toJason()方法將對象轉換成Json字符串，上面代碼的str對象值為：
[{"name":"name0","age":0},{"name":"name1","age":5},{"name":"name2","age":10},{"name":"name3","age":15},{"name":"name4","age":20},{"name":"name5","age":25},{"name":"name6","age":30},{"name":"name7","age":35},{"name":"name8","age":40},{"name":"name9","age":45}]
很標準的json數據，很簡單吧，呵呵。
下面來看看gson的反序列化，Gson提供了fromJson()方法來實現從Json相關對象到java實體的方法。
在日常應用中，我們一般都會碰到兩種情況，轉成單一實體對象和轉換成對象列表或者其他結構。
先來看第一種：
比如json字符串為：
|
1
|
[{"name":"name0","age":0}] |
代碼:
|
1
|
Person person = gson.fromJson(str, Person.class); |
提供兩個參數，分別是json字符串以及需要轉換對象的類型。
第二種，轉換成列表類型：
代碼:
|
1
2
3
4
5
6
|
List<Person> ps = gson.fromJson(str, new TypeToken<List<Person>>(){}.getType());for(int i = 0; i < ps.size() ; i++){ Person p = ps.get(i); System.out.println(p.toString());} |
可以看到上面的代碼使用了TypeToken，它是gson提供的數據類型轉換器，可以支持各種數據集合類型轉換。
Gson的基本使用就是這么多，至于annotation方面可以參考gson的官方文檔，希望能對初學java和gson的同學有所幫助。
