Gson 的高级使用 GsonBuilder 高级使用

GsonBuilder

目前具有的方法

setFieldNamingPolicy 设置序列字段的命名策略(UPPER_CAMEL_CASE,UPPER_CAMEL_CASE_WITH_SPACES,LOWER_CASE_WITH_UNDERSCORES,LOWER_CASE_WITH_DASHES)
addDeserializationExclusionStrategy 设置反序列化时字段采用策略ExclusionStrategy，如反序列化时不要某字段，当然可以采用@Expore代替。
excludeFieldsWithoutExposeAnnotation 设置没有@Expore则不序列化和反序列化
addSerializationExclusionStrategy 设置序列化时字段采用策略，如序列化时不要某字段，当然可以采用@Expore代替。（上面2-4 这三个方法的设置的为策略，首先需要自定义注解，可用在之后的实体类中用来标识不反序列化/序列化；其次入参的该类需要实习ExclusionStrategy 接口中，两个方法，shouldSkipField()针对属性，shouldSkipClass()针对类）
registerTypeAdapter 为某特定对象设置固定的序列和反序列方式，实现JsonSerializer和JsonDeserializer接口（用来实现某些特定字段的转发，例如 null 转成 “ ” ，需要重写TypeAdapter 接口，write ()序列化；以及read() 反序列化）
setFieldNamingStrategy 设置字段序列和反序列时名称显示，也可以通过@Serializer代替
setPrettyPrinting 设置gson转换后的字符串为一个比较好看的字符串
setDateFormat 设置默认Date解析时对应的format格式

参考：https://rongyao.blog.csdn.net/article/details/89316909

1. 默认排除策略

excludeFieldsWithModifiers(int… modifiers) 序列化或反序列化排除特定修饰语的字段
excludeFieldsWithoutExposeAnnotation()序列化或反序列化排除没有@Expoe的字段前面注解中已经讲述，这边不讲

默认排除static或transient描述的字段

    public class SomeObject {
        private static String field1;
        private transient String field2;
        private String field3;
        private String field4;
    }
    
    public static void main(String[] args) throws Exception {
        SomeObject someObject = new SomeObject();
        someObject.setField1("field1");
        someObject.setField2("field2");
        someObject.setField3("field3");
        someObject.setField4("field4");
        Gson gson = new GsonBuilder().create();
        System.out.println(gson.toJson(someObject));
    }
    // ==>{"field3":"field3","field4":"field4"}

也可以自己指定排除字段

    public static void main(String[] args) throws Exception {
        SomeObject someObject = new SomeObject();
        someObject.setField1("field1");
        someObject.setField2("field2");
        someObject.setField3("field3");
        someObject.setField4("field4");
        Gson gson = new GsonBuilder().excludeFieldsWithModifiers(Modifier.STATIC).create();
        System.out.println(gson.toJson(someObject));
    }
    // ==>{"field2":"field2","field3":"field3","field4":"field4"}

2. 自定义排除策略

方法：

addSerializationExclusionStrategy(ExclusionStrategy strategy) 序列化排除策略
addDeserializationExclusionStrategy(ExclusionStrategy strategy) 反序列化排除策略
setExclusionStrategies(ExclusionStrategy… strategies) 序列化/反序列化排除策略

例子：序列化过程排除不需要字段

a. 前面讲过的@Expose字段已经可以实现，但是@Expose是加在需要序列化的字段上，假设字段需要序列化的字段多，其它少，这种方式比较麻烦；

b. 自己实现注解，排除不必要字段

注解：

    @Retention(RetentionPolicy.RUNTIME)
    @Target({ElementType.FIELD, ElementType.TYPE})
    public @interface GsonTransparent {
    }

策略实现类

   public class GsonTransparentStrategy implements ExclusionStrategy {

   /**
    * 
    *
    * @param f
    * @return
    */
   @Override
   public boolean shouldSkipField(FieldAttributes f) {
       return f.getAnnotation(GsonTransparent.class) != null;
   }

   /**
    *
    *
    * @param clazz
    * @return
    */
   @Override
   public boolean shouldSkipClass(Class<?> clazz) {
       return clazz.getAnnotation(GsonTransparent.class) != null;
   }
}

使用方式

注解在字段上，该字段不被序列化或反序列化
注解在类上，该类不被序列化或反序列化

    // 实体类
    @GsonTransparent
    public class SomeObject {
        @GsonTransparent
        private String field1;
        private String field2;
        private String field3;
        private String field4;
    }
    
    // 测试
    public static void main(String[] args) throws Exception {
        SomeObject someObject = new SomeObject();
        someObject.setField1("field1");
        someObject.setField2("field2");
        someObject.setField3("field3");
        someObject.setField4("field4");
        // 序列化和反序列化注解都生效
        // 其它两个方法分别对应序列化和反序列化
        Gson gson = new GsonBuilder().setExclusionStrategies(new GsonTransparentStrategy()).create();
        System.out.println(gson.toJson(someObject));
    }
    // ==>{"field2":"field2","field3":"field3","field4":"field4"}

3. 序列化空字段

方法：

serializeNulls()

例子：

    public static void main(String[] args) throws Exception {
        SomeObject someObject = new SomeObject();
        someObject.setField1("field1");
        someObject.setField2("field2");
        someObject.setField3("field3");
        Gson gson = new GsonBuilder().serializeNulls().create();
        System.out.println(gson.toJson(someObject));
    }

4. 类型适配器

方法：

registerTypeAdapter(java.lang.reflect.Type type, java.lang.Object typeAdapter) 为type类型字段，指定特殊的类型适配器

例子01：格式化日期类型

@JsonAdapter 一样的方式
可以支持 JsonDeserializer,JsonSerializer,InstanceCreator,TypeAdapter四种适配器类型

// 适配器类

public class DateAdapter extends TypeAdapter<Date> {
    SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");

    /**
     * 序列化
     *
     * @param out   输出流
     * @param value 值
     * @throws IOException
     */
    @Override
    public void write(JsonWriter out, Date value) throws IOException {
        if (value != null) {
            out.value(simpleDateFormat.format(value));
        } else {
            out.value("");
        }
    }

    /**
     * 反序列化
     *
     * @param in 输入流
     * @return
     * @throws IOException
     */
    @Override
    public Date read(JsonReader in) throws IOException {
        String str = in.nextString();
        Date date = null;
        try {
            date = simpleDateFormat.parse(str);
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return date;
    }
}

// 测试类

public class Test {
    public static void main(String[] args) throws Exception {
        SomeObject someObject = new SomeObject();
        someObject.setField1("field1");
        someObject.setField2("field2");
        someObject.setField3("field3");
        someObject.setDate(new Date());
        Gson gson = new GsonBuilder().registerTypeAdapter(Date.class, new DateAdapter()).serializeNulls().create();
        System.out.println(gson.toJson(someObject));
    }
}

注：如果只是要格式化日期，可以通过
setDateFormat(java.lang.String pattern)设置格式

例子02：String为null转为""输出
// String类型适配器

public class StringAdapter extends TypeAdapter<String> {
    @Override
    public void write(JsonWriter out, String value) throws IOException {
        if (value == null) {
            out.value("");
        } else {
            out.value(value);
        }
    }

    @Override
    public String read(JsonReader in) throws IOException {
        return in.nextString();
    }
}

// 测试类

public class Test0020 {
    public static void main(String[] args) throws Exception {
        SomeObject someObject = new SomeObject();
        someObject.setField1("field1");
        someObject.setField2("field2");
        someObject.setField3("field3");
        someObject.setDate(new Date());
        Gson gson = new GsonBuilder().registerTypeAdapter(Date.class, new DateAdapter()).registerTypeAdapter(String.class, new StringAdapter()).serializeNulls().create();
        System.out.println(gson.toJson(someObject));
    }
}
// ==> {"field1":"field1","field2":"field2","field3":"field3","field4":"","date":"2019-04-15 04:03:53"}

5. 字段命名策略

方法：

setFieldNamingStrategy(FieldNamingStrategy fieldNamingStrategy)

例子：驼峰转下划线

    public class SomeObject {
        private String helloWord;
    
        public String getHelloWord() {
            return helloWord;
        }
    
        public void setHelloWord(String helloWord) {
            this.helloWord = helloWord;
        }
    }

    public static void main(String[] args) throws Exception {
        SomeObject someObject = new SomeObject();
        someObject.setHelloWord("hello world");
        Gson gson = new GsonBuilder().setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES).create();
        System.out.println(gson.toJson(someObject));
    }
    // ==>{"hello_word":"hello world"}

原文链接：https://blog.csdn.net/jieandan/article/details/109774650