0Pricing
Android Academy · 강의

Room 데이터베이스 클래스

데이터베이스를 만들고 사용해 보세요.

Room 데이터베이스 클래스은(는) CoddyKit의 무료 Android Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Android Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Android Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

모든 요소 연결하기

데이터베이스 클래스는 주요 접근 지점입니다. 엔터티를 나열하고 버전을 선언하며 DAO를 노출합니다.

@Database 주석

RoomDatabase를 상속하는 추상 클래스를 만들고 @Database를 지정합니다.

import androidx.room.Database
import androidx.room.RoomDatabase

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

엔터티와 버전 나열하기

entities 배열은 Room에 생성할 테이블을 알려 줍니다. version 번호는 마이그레이션을 위한 스키마 변경을 추적합니다.

DAO 노출하기

각 DAO에 대해 해당 DAO 타입을 반환하는 추상 함수를 선언합니다. Room이 이를 구현합니다.

abstract fun userDao(): UserDao
abstract fun noteDao(): NoteDao

데이터베이스 빌드하기

Room.databaseBuilder를 사용하여 인스턴스를 생성합니다. 애플리케이션 컨텍스트, 클래스, 데이터베이스 이름이 필요합니다.

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

싱글턴으로 만들기

데이터베이스 생성에는 비용이 많이 들기 때문에 앱 전체에서 사용할 하나의 인스턴스를 생성해야 합니다. 일반적인 방식은 동기화된 접근자를 포함하는 컴패니언 객체를 사용하는 것입니다.

companion object {
    @Volatile private var INSTANCE: AppDatabase? = null
    fun get(context: Context): AppDatabase =
        INSTANCE ?: synchronized(this) {
            INSTANCE ?: build(context).also { INSTANCE = it }
        }
}

싱글턴이 중요한 이유

여러 데이터베이스 인스턴스가 있으면 동일한 파일에 여러 연결을 열게 되어 불일치와 메모리 낭비가 발생합니다. 하나의 공유 인스턴스를 사용하면 단일 진실 공급원을 유지할 수 있습니다.

Hilt로 제공하기

실제 앱에서는 수동 싱글턴 대신 일반적으로 의존성 주입을 통해 데이터베이스를 제공합니다(Hilt 과정에서 다룹니다).

@Provides
@Singleton
fun provideDb(@ApplicationContext ctx: Context) =
    Room.databaseBuilder(ctx, AppDatabase::class.java, "app.db")
        .build()

스키마 변경과 마이그레이션

엔터티를 변경할 때는 version을 증가시키고 기존 데이터를 변환하는 SQL을 설명하는 Migration을 제공하세요.

val MIGRATION_1_2 = object : Migration(1, 2) {
    override fun migrate(db: SupportSQLiteDatabase) {
        db.execSQL("ALTER TABLE users ADD COLUMN age INTEGER NOT NULL DEFAULT 0")
    }
}

파괴적 마이그레이션

초기 개발 중에는 fallbackToDestructiveMigration()을 사용할 수 있습니다. 이 기능은 마이그레이션하는 대신 테이블을 삭제하고 다시 생성합니다. 실제 사용자 데이터가 있는 운영 환경에는 절대 사용하지 마세요.

DAO에 접근하기

데이터베이스 인스턴스를 얻은 후 DAO를 가져와 코루틴 안에서 메서드를 호출합니다.

val dao = db.userDao()
viewModelScope.launch {
    dao.insert(User(1, "Ada", "ada@x.com"))
}

빠른 확인

데이터베이스 클래스를 제대로 이해했는지 확인해 보세요.

복습

다음 내용을 배웠습니다.

  • @Database는 엔터티를 나열하고 버전을 설정하며 DAO를 노출합니다.
  • Room.databaseBuilder를 사용하여 싱글턴으로 빌드합니다.
  • 스키마를 변경하려면 버전을 증가시키고 Migration을 제공해야 합니다.

자주 묻는 질문

“Room 데이터베이스 클래스” 강의는 무료인가요?

네 — “Room 데이터베이스 클래스” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Android Academy 강의 전체를 잠금 해제할 수 있습니다. Android Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“Room 데이터베이스 클래스”에서 뭘 배우나요?

데이터베이스를 만들고 사용해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Android Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Android Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Android Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“Room 데이터베이스 클래스” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Android Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Android Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 엔터티와 DAO
  2. Room 데이터베이스 클래스
  3. 쿼리와 관계
  4. Flow로 데이터 관찰하기
← Android Academy(으)로 돌아가기