Android开发新手求助：如何将JSON用户数据存入Room数据库

步骤1：添加依赖 #

在你的build.gradle(Module level)中引入Room和Gson的依赖：

// Room相关
implementation "androidx.room:room-runtime:2.5.0"
kapt "androidx.room:room-compiler:2.5.0"
implementation "androidx.room:room-ktx:2.5.0" // Kotlin协程适配

// Gson
implementation "com.google.code.gson:gson:2.10.1"

步骤2：定义Room实体类 #

创建与JSON字段一一对应的User实体，适配Room数据库表结构：

import androidx.room.Entity
import androidx.room.PrimaryKey

@Entity(tableName = "users")
data class User(
    @PrimaryKey val id: String,
    val name: String,
    val profilepic: String
)

步骤3：创建Gson解析包装类 #

由于你的JSON根节点是"users"，对应一个用户数组，需要用包装类完成映射：

import com.google.gson.annotations.SerializedName

data class UsersResponse(
    @SerializedName("users") val users: List<User>
)

步骤4：定义Room DAO接口 #

创建数据访问对象，声明批量插入的方法：

import androidx.room.Dao
import androidx.room.Insert
import androidx.room.OnConflictStrategy

@Dao
interface UserDao {
    @Insert(onConflict = OnConflictStrategy.REPLACE) // 重复ID时自动替换
    suspend fun insertAll(users: List<User>)
}

步骤5：构建Room数据库实例 #

创建数据库类，关联实体与DAO，实现单例模式：

import androidx.room.Database
import androidx.room.Room
import androidx.room.RoomDatabase
import android.content.Context

@Database(entities = [User::class], version = 1, exportSchema = false)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao

    companion object {
        @Volatile
        private var INSTANCE: AppDatabase? = null

        fun getDatabase(context: Context): AppDatabase {
            return INSTANCE ?: synchronized(this) {
                val instance = Room.databaseBuilder(
                    context.applicationContext,
                    AppDatabase::class.java,
                    "app_database"
                ).build()
                INSTANCE = instance
                instance
            }
        }
    }
}

步骤6：解析JSON并插入Room #

假设你的JSON文件放在assets目录下（命名为users.json），读取后解析插入：

import android.content.Context
import com.google.gson.Gson
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
import kotlinx.coroutines.GlobalScope

fun loadUsersIntoRoom(context: Context) {
    // 1. 读取assets中的JSON文件
    val jsonString = context.assets.open("users.json").bufferedReader().use { it.readText() }

    // 2. Gson解析为用户列表
    val gson = Gson()
    val usersResponse = gson.fromJson(jsonString, UsersResponse::class.java)
    val userList = usersResponse.users

    // 3. 获取数据库与DAO实例
    val db = AppDatabase.getDatabase(context)
    val userDao = db.userDao()

    // 4. 后台线程执行插入（Room禁止主线程操作数据库）
    GlobalScope.launch(Dispatchers.IO) {
        userDao.insertAll(userList)
    }
}

注意事项 #

• 如果JSON来自网络接口，直接将接口返回的字符串替换jsonString即可。
• 实际项目中建议用viewModelScope或lifecycleScope替代GlobalScope，更好管理协程生命周期。
• 若JSON字段名与实体属性名不一致，需用@SerializedName指定映射关系。

内容的提问来源于stack exchange，提问作者1dll