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 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 엔터티와 DAO
- Room 데이터베이스 클래스
- 쿼리와 관계
- Flow로 데이터 관찰하기