Room-Datenbank in Kotlin – Entity, DAO und Database in unter 30 Zeilen

Sobald deine App Daten behalten soll, die einen Neustart überleben – Notizen, ein Warenkorb, ein Cache – brauchst du eine lokale Datenbank. Auf Android ist Room dafür der empfohlene Weg: eine Abstraktionsschicht über SQLite, die dir das Zusammenbauen von SQL-Strings abnimmt und Fehler schon zur Compile-Zeit findet. Room besteht aus genau drei Bausteinen.

1. Entity – die Tabelle

Eine data class mit @Entity beschreibt eine Tabelle, jedes Feld ist eine Spalte:

@Entity(tableName = "notes")
data class Note(
    @PrimaryKey(autoGenerate = true) val id: Long = 0,
    val title: String,
    val createdAt: Long,
)

2. DAO – die Zugriffe

Das Data Access Object ist ein Interface mit deinen Abfragen. Room generiert die Implementierung:

@Dao
interface NoteDao {
    @Query("SELECT * FROM notes ORDER BY createdAt DESC")
    fun observeAll(): Flow<List<Note>>          // liefert bei jeder Änderung neu

    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun upsert(note: Note)

    @Delete
    suspend fun delete(note: Note)
}

3. Database – die Klammer

Eine abstrakte Klasse verbindet Entities und DAOs:

@Database(entities = [Note::class], version = 1)
abstract class AppDb : RoomDatabase() {
    abstract fun noteDao(): NoteDao
}

// Einmal bauen (am besten über Dependency Injection als Singleton):
val db = Room.databaseBuilder(context, AppDb::class.java, "app.db").build()
val dao = db.noteDao()

Warum das im Alltag angenehm ist

• Main-sicher von Haus aus. suspend-Funktionen und Flow-Abfragen wechseln intern selbst den Thread – du musst Datenbankzugriffe nicht mehr von Hand in withContext(Dispatchers.IO) wickeln.
• Reaktiv mit Flow. Gibt ein DAO einen Flow zurück, bekommt dein UI bei jeder Änderung automatisch die neue Liste. In Compose liest du das mit collectAsStateWithLifecycle().
• Fehler früh. Room prüft deine @Query-Strings beim Kompilieren gegen das Schema – ein Tippfehler im SQL fällt sofort auf, nicht erst beim Nutzer.
• Migrationen nicht vergessen. Änderst du das Schema, musst du version erhöhen und eine Migration angeben (oder in der Entwicklung fallbackToDestructiveMigration() nutzen – aber niemals in Produktion, das löscht die Daten).

Wenn du eine Android-App brauchst, die Daten sauber und offline-fähig speichert, sprich mich an.

Quellen

• Save data in a local database using Room (developer.android.com)
• Accessing data using Room DAOs (developer.android.com)