Junction

Declares a junction to be used for joining a relationship.

If a Relation should use an associative table (also know as junction table or join table) then you can use this annotation to reference such table. This is useful for fetching many-to-many relations.

@Entity(primaryKeys = {"pId", "sId"})
public class PlaylistSongXRef {
    val pId: Int,
    val sId: Int
}
public class PlaylistWithSongs {
    @Embedded
    val playlist: Playlist
    @Relation(
            parentColumn = "playlistId",
            entity = Song::class,
            entityColumn = "songId",
            associateBy = Junction(
                    value = PlaylistSongXRef::class,
                    parentColumn = "pId",
                    entityColumn = "sId")
    )
    val songs: List<String>
}

@Dao
public interface MusicDao {
    @Query("SELECT * FROM Playlist")
    val getAllPlaylistsWithSongs(): List<PlaylistWithSongs>
}

In the above example the many-to-many relationship between a Song and a Playlist has an associative table defined by the entity PlaylistSongXRef.

Summary

Junction(value: KClass<*>, parentColumn: String = "", entityColumn: String = "")

val entityColumn: String

val parentColumn: String

val value: KClass<*>