Room database setup in Android Kotlin - UI Render Trace

Component - Room database setup

This UI component shows a simple Android screen that interacts with a Room database. It allows users to add and display a list of items stored locally on the device using Room, which is a database library that helps save data easily and safely.

Widget Tree

Activity > ConstraintLayout > [EditText, Button, RecyclerView]

The root is an Activity hosting a ConstraintLayout. Inside the layout, there is an EditText for input, a Button to add the input to the database, and a RecyclerView to display the list of saved items.

Render Trace - 5 Steps

Step 1: Activity

Step 2: EditText

Step 3: Button

Step 4: RecyclerView

Step 5: Room Database

State Change - Re-render

Trigger:User types an item name and taps 'Add Item' button

Before

RecyclerView shows current list of items from database

→

After

New item is saved in Room database and RecyclerView updates to show the new item

Re-renders:RecyclerView and underlying adapter rebind to show updated list

UI Quiz - 3 Questions

What happens when the user taps the 'Add Item' button?

A The app closes immediately

B The typed item is saved to the Room database and the list updates

C The input text is cleared but nothing is saved

D The button changes color but no data is saved

Key Insight

Using Room database in Android apps allows you to save data locally in a structured way. The UI components like EditText, Button, and RecyclerView work together to let users add and see data easily. When data changes, updating the RecyclerView ensures the UI always shows the latest information.

Practice

1. What is the main purpose of the @Entity annotation in Room database setup?

easy

A. To define a table in the database

B. To create a database instance

C. To write SQL queries

D. To start a database transaction

Solution

1. Step 1: Understand the role of @Entity

   The @Entity annotation marks a Kotlin data class as a table in the Room database.

2. Step 2: Differentiate from other annotations

   Other annotations like @Dao define data access objects, not tables.

3. Final Answer:

   To define a table in the database -> Option A

4. Quick Check:

   @Entity = Table definition [OK]

Hint: Remember: @Entity means table in Room [OK]

Common Mistakes:

• Confusing @Entity with @Dao
• Thinking @Entity creates the database
• Mixing @Entity with SQL query annotations

2. Which of the following is the correct way to declare a Room database class in Kotlin?

easy

A. @Dao(entities = [User::class], version = 1)\ninterface AppDatabase {\n fun userDao(): UserDao\n}

B. @Database(entities = [User::class], version = 1)\nabstract class AppDatabase : RoomDatabase() {\n abstract fun userDao(): UserDao\n}

C. @Entity(entities = [User::class], version = 1)\nclass AppDatabase : RoomDatabase() {\n fun userDao(): UserDao\n}

D. @Database(entities = User, version = 1)\nclass AppDatabase() {\n fun userDao(): UserDao\n}

Solution

1. Step 1: Identify correct annotation and class type

   The Room database class must be annotated with @Database and extend RoomDatabase.

2. Step 2: Check syntax for entities and abstract DAO method

   The entities list must be an array of classes, and DAO methods must be abstract.

3. Final Answer:

   @Database(entities = [User::class], version = 1)\nabstract class AppDatabase : RoomDatabase() {\n abstract fun userDao(): UserDao\n} -> Option B

4. Quick Check:

   @Database + abstract class + extends RoomDatabase = correct [OK]

Hint: Database class is abstract and annotated @Database [OK]

Common Mistakes:

• Using @Entity instead of @Database
• Not making the class abstract
• Forgetting to extend RoomDatabase

3. Given the following code snippet, what will be the result of calling db.userDao().getAllUsers()?

@Dao
interface UserDao {
  @Query("SELECT * FROM user")
  fun getAllUsers(): List<User>
}

@Entity
data class User(
  @PrimaryKey val id: Int,
  val name: String
)

// Assume database is properly created and contains 3 users

medium

A. A runtime error because of missing suspend keyword

B. An empty list

C. A list of 3 User objects from the database

D. A compilation error due to missing @Insert method

Solution

1. Step 1: Understand the DAO query

   The @Query("SELECT * FROM user") fetches all rows from the user table.

2. Step 2: Check the database state

   The question states the database contains 3 users, so the query returns 3 User objects.

3. Final Answer:

   A list of 3 User objects from the database -> Option C

4. Quick Check:

   Query returns all users = 3 users [OK]

Hint: Query returns all rows; count matches stored data [OK]

Common Mistakes:

• Assuming empty list without data check
• Confusing suspend functions with normal DAO methods
• Expecting errors without code context

4. Identify the error in this Room database builder code snippet:

val db = Room.databaseBuilder(
  context,
  AppDatabase::class.java,
  "app_db"
).build()

medium

A. Missing fallbackToDestructiveMigration() causing crash on schema change

B. Incorrect database name format, should be a URI

C. AppDatabase must be an interface, not a class

D. databaseBuilder requires a coroutine scope parameter

Solution

1. Step 1: Review databaseBuilder usage

   The code correctly builds the database but lacks migration strategy.

2. Step 2: Understand migration impact

   Without fallbackToDestructiveMigration(), schema changes cause runtime crashes.

3. Final Answer:

   Missing fallbackToDestructiveMigration() causing crash on schema change -> Option A

4. Quick Check:

   Missing migration fallback = crash risk [OK]

Hint: Add fallbackToDestructiveMigration() to avoid crashes [OK]

Common Mistakes:

• Thinking database name must be URI
• Confusing class vs interface for database
• Expecting coroutine scope in builder

5. You want to add a new column age to your existing User entity without losing existing data. Which approach correctly updates the Room database?

hard

A. Change the database name to force a new database creation

B. Just add the new field in the User class and keep the same database version

C. Delete the app data and reinstall to reset the database

D. Increase database version and provide a migration object with SQL to add the new column

Solution

1. Step 1: Understand schema changes in Room

   Adding a new column changes the database schema, so version must increase.

2. Step 2: Provide migration to preserve data

   Migration object with SQL ALTER TABLE adds the column without losing data.

3. Final Answer:

   Increase database version and provide a migration object with SQL to add the new column -> Option D

4. Quick Check:

   Schema change needs version bump + migration [OK]

Hint: Always migrate with version bump to keep data safe [OK]

Common Mistakes:

• Changing entity without version update
• Deleting app data instead of migrating
• Changing database name to avoid migration