Room 개요

Room은 SQLite에 대한 추상화 계층을 제공하여 SQLite의 모든 기능을 활용하면서 쉬운 데이터베이스 접근을 허용한다.

상당한 양의 구조화된 데이터를 처리하는 앱은 데이터를 로컬로 유지하여 대단한 이점을 얻을 수 있습니다

 

 가장 일반적인 사용 사례는 관련 데이터를 캐싱하는 것입니다. 이런 방식으로 기기가 네트워크에 액세스할 수 없을 때 오프라인 상태인 동안에도 사용자가 여전히 콘텐츠를 탐색할 수 있습니다.

나중에 기기가 다시 온라인 상태가 되면 사용자가 시작한 콘텐츠 변경사항이 서버에 동기화됩니다.

 

Room은 이러한 문제를 자동으로 처리하므로 SQLite 대신 Room을 사용할 것을 적극적으로 권장된다.

 

의존성 추가.

dependencies {
      def room_version = "2.2.5"

      implementation "androidx.room:room-runtime:$room_version"
      annotationProcessor "androidx.room:room-compiler:$room_version" // For Kotlin use kapt instead of annotationProcessor

      // optional - Kotlin Extensions and Coroutines support for Room
      implementation "androidx.room:room-ktx:$room_version"

      // optional - RxJava support for Room
      implementation "androidx.room:room-rxjava2:$room_version"

      // optional - Guava support for Room, including Optional and ListenableFuture
      implementation "androidx.room:room-guava:$room_version"

      // Test helpers
      testImplementation "androidx.room:room-testing:$room_version"
    }

 

Room의 구성요소

• DataBase: 데이터베이스 홀더를 포함하며 앱의 지속적인 관계형 데이터의 기본 연결을 위한 기본 액세스 포인트 역할을 합니다.

  @Database로 주석이 지정된 클래스는 다음 조건을 충족해야 합니다.

  • RoomDatabase를 상속하는 추상 클래스여야 합니다.
  • 주석 내에 데이터베이스와 연결된 Entity의 목록을 포함해야 합니다.
  • 인자가 0개이며 @Dao로 주석이 지정된 클래스를 반환하는 추상 메서드를 포함해야 합니다.

  런타임 시 Room.databaseBuilder() 또는 Room.inMemoryDatabaseBuilder()를 호출하여 Database 인스턴스를 가져올 수 있습니다.

• Entity : 데이터베이스 내의 테이블을 나타냅니다.

• DAO: 데이터베이스에 액세스하는 데 사용되는 메서드가 포함되어 있습니다.

앱은 Room 데이터베이스를 사용하여 데이터베이스와 연결된 데이터 액세스 객체 DAO를 가져옵니다.

그런 다음 앱은 각 DAO를 사용하여 데이터베이스에서 Entity 을 가져오고 Entity 의 변경사항을 다시 데이터베이스에 저장합니다. 마지막으로 앱은 Entity 을 사용하여 데이터베이스 내의 테이블 열에 해당하는 값을 가져오고 설정합니다.

 

 

 

 

간단한 예시 

User Entity

@Entity
    data class User(
        @PrimaryKey val uid: Int,
        @ColumnInfo(name = "first_name") val firstName: String?,
        @ColumnInfo(name = "last_name") val lastName: String?
    )

User Dao

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

        @Query("SELECT * FROM user WHERE uid IN (:userIds)")
        fun loadAllByIds(userIds: IntArray): List<User>

        @Query("SELECT * FROM user WHERE first_name LIKE :first AND " +
               "last_name LIKE :last LIMIT 1")
        fun findByName(first: String, last: String): User

        @Insert
        fun insertAll(vararg users: User)

        @Delete
        fun delete(user: User)
    }

database

@Database(entities = arrayOf(User::class), version = 1) // 엔터티 항목 지정
    abstract class AppDatabase : RoomDatabase() {   // 추상 클래스로 생성
    
        abstract fun userDao(): UserDao   // 필수 메서드 설정
    
    }

 

참고: 앱이 단일 프로세스에서 실행되면 AppDatabase 객체를 인스턴스화할 때 싱글톤 디자인 패턴을 따라야 합니다.

 

각 RoomDatabase 인스턴스는 리소스를 상당히 많이 소비합니다.

그리고 단일 프로세스 내에서 여러 RoomDatabase 인스턴스에 액세스할 필요가 거의 없습니다.

 

앱이 여러 프로세스에서 실행되면 데이터베이스 빌더 호출에 enableMultiInstanceInvalidation()을 포함합니다.

이렇게 하면 각 프로세스에 AppDatabase 인스턴스가 있을 때 한 프로세스에서 공유 데이터베이스 파일을 무효화할 수 있으며 이 무효화는 다른 프로세스 내의 AppDatabase 인스턴스로 자동 전파됩니다.