Android Room库中Song与Playlist多对多关系实现方案咨询

我刚好之前做过类似的媒体播放器项目，Room本身确实没有直接给出多对多的官方示例，但其实用**关联表（Join Table）**就能完美解决——这也是关系型数据库处理多对多关系的标准方案。我给你一步步拆解实现步骤：

1. 定义基础实体类 #

先把Song和Playlist这两个核心实体写好，用@Entity注解标记为Room可识别的数据库表：

Song实体 #

@Entity(tableName = "songs")
data class Song(
    @PrimaryKey(autoGenerate = true) val songId: Long = 0,
    val title: String,
    val artist: String,
    val duration: Int // 单位：秒
)

Playlist实体 #

@Entity(tableName = "playlists")
data class Playlist(
    @PrimaryKey(autoGenerate = true) val playlistId: Long = 0,
    val name: String,
    val description: String? // 可选描述字段
)

2. 创建关联表（Join Table） #

多对多关系需要一个中间表来存储Song和Playlist的对应关系，每条记录代表某首歌属于某个播放列表。这里我们用复合主键（songId + playlistId）确保不会出现重复的关联记录：

@Entity(
    tableName = "song_playlist_join",
    primaryKeys = ["songId", "playlistId"],
    foreignKeys = [
        ForeignKey(
            entity = Song::class,
            parentColumns = ["songId"],
            childColumns = ["songId"],
            onDelete = ForeignKey.CASCADE // 删除歌曲时自动清理关联记录
        ),
        ForeignKey(
            entity = Playlist::class,
            parentColumns = ["playlistId"],
            childColumns = ["playlistId"],
            onDelete = ForeignKey.CASCADE // 删除播放列表时自动清理关联记录
        )
    ]
)
data class SongPlaylistJoin(
    val songId: Long,
    val playlistId: Long
)

这里的onDelete = ForeignKey.CASCADE是个实用配置，能避免数据冗余——当你删除一首歌曲或一个播放列表时，关联表中对应的记录会自动被删除，不用手动处理。

3. 定义关联查询的数据类 #

要一次性查询出「某首歌所属的所有播放列表」或「某个播放列表包含的所有歌曲」，需要用Room的@Embedded和@Relation注解组合实体，让Room自动处理关联逻辑：

查询歌曲+关联的播放列表 #

data class SongWithPlaylists(
    @Embedded val song: Song,
    @Relation(
        parentColumn = "songId",
        entityColumn = "playlistId",
        associateBy = Junction(
            value = SongPlaylistJoin::class,
            parentColumn = "songId",
            entityColumn = "playlistId"
        )
    )
    val playlists: List<Playlist>
)

查询播放列表+关联的歌曲 #

data class PlaylistWithSongs(
    @Embedded val playlist: Playlist,
    @Relation(
        parentColumn = "playlistId",
        entityColumn = "songId",
        associateBy = Junction(
            value = SongPlaylistJoin::class,
            parentColumn = "playlistId",
            entityColumn = "songId"
        )
    )
    val songs: List<Song>
)

这里的Junction就是指定我们刚才创建的关联表，告诉Room如何通过中间表关联两个实体。

4. 编写DAO（数据访问对象） #

最后在DAO里实现插入、删除和关联查询的方法，记得给关联查询加上@Transaction注解，确保多表操作的原子性：

@Dao
interface MediaDao {
    // 插入基础实体
    @Insert
    suspend fun insertSong(song: Song): Long // 返回插入后的songId

    @Insert
    suspend fun insertPlaylist(playlist: Playlist): Long // 返回插入后的playlistId

    // 插入单条关联关系
    @Insert
    suspend fun insertSongPlaylistJoin(join: SongPlaylistJoin)

    // 批量插入关联关系（比如一次性把多首歌加入播放列表）
    @Insert
    suspend fun insertSongPlaylistJoins(joins: List<SongPlaylistJoin>)

    // 查询某首歌的所有播放列表
    @Transaction
    @Query("SELECT * FROM songs WHERE songId = :songId")
    suspend fun getSongWithPlaylists(songId: Long): SongWithPlaylists?

    // 查询某个播放列表的所有歌曲
    @Transaction
    @Query("SELECT * FROM playlists WHERE playlistId = :playlistId")
    suspend fun getPlaylistWithSongs(playlistId: Long): PlaylistWithSongs?

    // 删除歌曲与播放列表的关联
    @Query("DELETE FROM song_playlist_join WHERE songId = :songId AND playlistId = :playlistId")
    suspend fun deleteSongPlaylistJoin(songId: Long, playlistId: Long)
}

实用小提示 #

• 如果需要给关联关系加额外属性（比如歌曲在播放列表中的排序位置），直接在SongPlaylistJoin实体里添加字段即可，比如sortOrder: Int，这样就能实现播放列表的自定义排序。
• 批量操作优先用批量插入/删除方法，比循环单条操作效率高很多。

内容的提问来源于stack exchange，提问作者Ofek Regev