Java的JSON转换库GSON的基本使用方法示例

下载和部署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。

<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应用。

示例

下面是一个简单的例子：

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类型的。

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字符串为：

[{"name":"name0","age":0}]

代码:

person person = gson.fromjson(str, person.class);

提供两个参数，分别是json字符串以及需要转换对象的类型。

第二种，转换成列表类型：

代码:

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的同学有所帮助。