如何为Room数据库中的自定义MyItem列表实现TypeConverter？

Room无法直接存储自定义对象（如MyItem）或其集合（如ArrayList<MyItem>），必须通过TypeConverter将这些类型转换为数据库支持的基础类型（比如String），以下是完整实现步骤：

1. 添加Gson依赖 #

我们借助Gson完成对象与JSON字符串的互转，在Module级别的build.gradle中添加依赖：

dependencies {
    implementation 'com.google.code.gson:gson:2.10.1'
}

2. 编写TypeConverter类 #

创建转换器类，实现ArrayList<MyItem>和String的双向转换：

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.ArrayList;

public class MyItemListConverter {
    private static final Gson gson = new Gson();

    // 把自定义对象集合转成JSON字符串，存入数据库
    @androidx.room.TypeConverter
    public static String fromMyItemList(ArrayList<MyItem> items) {
        return gson.toJson(items);
    }

    // 把数据库读取到的JSON字符串转回自定义对象集合
    @androidx.room.TypeConverter
    public static ArrayList<MyItem> toMyItemList(String itemsJson) {
        Type listType = new TypeToken<ArrayList<MyItem>>() {}.getType();
        return gson.fromJson(itemsJson, listType);
    }
}

如果后续需要单独处理单个MyItem对象，可额外添加这两个方法：

@androidx.room.TypeConverter
public static String fromMyItem(MyItem item) {
    return gson.toJson(item);
}

@androidx.room.TypeConverter
public static MyItem toMyItem(String itemJson) {
    return gson.fromJson(itemJson, MyItem.class);
}

3. 在Room数据库类中注册转换器 #

找到你的Room Database类，用@TypeConverters注解注册刚才的转换器：

import androidx.room.Database;
import androidx.room.RoomDatabase;
import androidx.room.TypeConverters;

@Database(entities = {Checklist.class}, version = 1)
@TypeConverters(MyItemListConverter.class)
public abstract class AppDatabase extends RoomDatabase {
    public abstract ChecklistDao checklistDao();
}

注意事项 #

• MyItem类的私有字段Gson可以通过反射访问，若需指定JSON字段名，可给字段添加@SerializedName注解；
• 不依赖Gson的话，也可以用Jackson等其他JSON库，核心逻辑都是对象/集合与字符串的互转。

内容的提问来源于stack exchange，提问作者Dushyant Kumar Behera