Gson-更新中

概述

通用框架-网络编程-Gson



Gson 是 Google 提供的用来在 Java 对象和 JSON 数据之间进行映射的 Java 类库。可以使 JSON 字符串 和 Java 对象之间相互转换。

官方文档

Gson目前托管在 github， https://github.com/google/gson

Gson Goals

提供简单的的toJSON（）和fromJson（）方法，将Java对象到JSON，反之亦然

允许预先存在的不可修改的对象和JSON之间相互转换

广泛支持Java的泛型的

允许对对象的自定义交涉

支持任意复杂的对象（深继承层次和广泛使用泛型）

Gson Download

目前最新的版本为 2.6.2

Gson Download downloads at Maven Central



各种引用，按需使用。

比如，我在android studio中使用Gson

在项目的build.gradle中加入

compile 'com.google.code.gson:gson:2.6.2'

然后同步即可自动下载Gson库，即可在你的项目中使用Gson啦。

Gson Documentation

Gson API: Javadocs for the current Gson release

我们可以下载到本地，方便查看



Gson user guide: This guide contains examples on how to use Gson in your code.

等等…..

我们比较关心的就是这个API 了，入门最好的教程当然是官方提供的user guide了，下面我们就一步一步的来学习使用Gson。

User Guide

https://github.com/google/gson/blob/master/UserGuide.md

Primitives Examples基本使用

//  Serialization 序列化
Gson gson = new Gson() ;

System.out.println(gson.toJson(1));//  1
System.out.println(gson.toJson("abc")); // "abc"
System.out.println(gson.toJson(new Long(10))); // 10

int[]  values = {1 ,2,3};
String  array2Gson = gson.toJson(values);
System.out.println(array2Gson); // [1,2,3]

// Deserialization 发序列化
int one = gson.fromJson("1", int.class);
System.out.println(one); //  1

Integer one1 = gson.fromJson("1", Integer.class);
System.out.println(one1);//  1

Long one2 = gson.fromJson("1", Long.class);
System.out.println(one2);//  1

Boolean flag = gson.fromJson("false", Boolean.class);
System.out.println(flag); // false

String str = gson.fromJson("\"abc\"", String.class);
System.out.println(str);// abc

String[]  arr =gson.fromJson("[\"abc\"]", String[].class);
System.out.println(arr); // [Ljava.lang.String;@704d4834

Object Examples 对象示例

import com.google.gson.Gson;

public class ObjectExamples {

public static void main(String[] args) {

BagOfPrimitives  bagOfPrimitives = new BagOfPrimitives();
Gson gson = new Gson();
String result = gson.toJson(bagOfPrimitives);
System.out.println(result); // {"value1":1,"value2":"abc","value3":["1","2","3","4"]}
}

static class BagOfPrimitives {
private int value1 = 1;
private String value2 = "abc";
private String[] value3 = { "1", "2", "3", "4" };
//当对象被序列化时（写入字节序列到目标文件）时，transient阻止实例中那些用此关键字声明的变量持久化；
//当对象被反序列化时（从源文件读取字节序列进行重构），这样的实例变量值不会被持久化和恢复
private transient int value4 = 666; // 加了transient关键字不会被持久化，查看上面的输出结果

public BagOfPrimitives() {
super();
// no-args constructor
}
}

}

Note that you can not serialize objects with circular references since that will result in infinite recursion.

请注意，您不能序列化循环引用的对象，因为这将导致无限递归。

// Deserialization
BagOfPrimitives obj2 = gson.fromJson(json, BagOfPrimitives.class);
// ==> obj2 is just like obj

注意事项：

推荐使用私有字段

没有必要使用任何注解以指示字段是被包含用于序列化和反序列化。在当前的类（和所有超类）的所有字段默认包含。

如果一个字段被标记为transient，（默认的），它被忽略，不包括在JSON序列化和反序列化

实现能够正确处理空值

序列化时，如果是个空字段,不会输出

在反序列化JSON的结果，缺少条目中的对象设置相应字段为空

如果一个字段是合成的，它被忽略，不包括在JSON序列化和反序列化

对应于内部类，匿名类和局部类外类的字段被忽略，并且不包括在序列化和反序列化

Nested Classes (including Inner Classes) 嵌套类

简书上有个更好地介绍