在TypeAdapterConfig中使用映射器从平面模型映射到具有嵌套属性的模型

在软件开发中，特别是在使用像Gson这样的库进行JSON序列化和反序列化时，TypeAdapterConfig通常用于配置自定义的类型适配器。这些适配器允许开发者定义如何将简单的平面数据结构（如JSON对象）映射到更复杂的嵌套数据模型。

基础概念

TypeAdapterConfig: 这是一个配置类，用于设置自定义的类型适配器。它允许开发者指定如何将JSON数据转换为Java对象，反之亦然。

映射器: 在这个上下文中，映射器是一个工具或函数，它定义了如何将一个数据结构的属性映射到另一个数据结构的相应属性。

平面模型: 这通常指的是一个简单的键值对集合，例如一个JSON对象，其中所有数据都是平铺的，没有嵌套结构。

嵌套属性模型: 这是指一个更复杂的模型，其中的属性可以是其他对象的实例，形成层次结构或嵌套结构。

类型

在Gson中，TypeAdapterConfig通常与TypeAdapter一起使用，后者是一个抽象类，开发者需要继承它并实现read和write方法来定义读写逻辑。

应用场景

这种配置在以下场景中非常有用：

当JSON结构与Java类的结构不完全匹配时。
当需要对数据进行特殊的处理或转换时，例如日期格式化、枚举转换等。
当性能是一个关键因素，需要优化序列化和反序列化的过程时。

示例代码

假设我们有一个平面JSON模型和一个嵌套的Java模型，我们可以创建一个自定义的TypeAdapter来处理它们之间的映射。

// 平面模型
class FlatModel {
    String name;
    int age;
    String address;
}

// 嵌套模型
class NestedModel {
    String name;
    int age;
    Address address;

    static class Address {
        String street;
        String city;
    }
}

// 自定义TypeAdapter
class NestedModelAdapter extends TypeAdapter<NestedModel> {
    @Override
    public void write(JsonWriter out, NestedModel value) throws IOException {
        // 序列化逻辑
    }

    @Override
    public NestedModel read(JsonReader in) throws IOException {
        FlatModel flatModel = new Gson().fromJson(in, FlatModel.class);
        NestedModel nestedModel = new NestedModel();
        nestedModel.name = flatModel.name;
        nestedModel.age = flatModel.age;

        // 假设地址格式为 "street, city"
        String[] addressParts = flatModel.address.split(",");
        nestedModel.address = new NestedModel.Address();
        nestedModel.address.street = addressParts[0].trim();
        nestedModel.address.city = addressParts[1].trim();

        return nestedModel;
    }
}

// 使用TypeAdapterConfig配置Gson
Gson gson = new GsonBuilder()
    .registerTypeAdapter(NestedModel.class, new NestedModelAdapter())
    .create();