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) 嵌套类

简书上有个更好地介绍