KotlinのRoomでデータ追加・更新・削除を完全マスター！初心者にもわかるデータ操作の基本

KotlinのRoomでデータの追加・更新・削除を行う方法

先生と生徒の会話形式で理解しよう

生徒

「Kotlinでデータベースの中身を追加したり、変更したり、消したりするにはどうすればいいんですか？」

先生

「それにはRoomというライブラリを使って、データを操作する専用のインターフェースを作るんだよ。」

生徒

「インターフェースって何ですか？難しそうです…」

先生

「インターフェースは、“やることの説明書”みたいなものなんだ。Roomでは、この説明書通りにメソッドを書くと、自動でデータベースとやりとりしてくれるんだよ！」

1. Roomでデータ操作するにはDAOが必要

Kotlinでデータベース操作をするには、Roomライブラリを使います。その中でもデータの「追加」「更新」「削除」を行うには、DAO（Data Access Object）というインターフェースが必要です。

DAOは、データベースとやりとりするための「命令書」のようなものです。「データを追加したい」「この情報を更新したい」「削除してほしい」という内容を、Kotlinのコードで書きます。

2. データの追加：@Insertアノテーションを使う

まずはデータを追加（INSERT）する方法から。Roomでは、@Insertというアノテーションを使うだけで、データの登録ができます。


import androidx.room.Dao
import androidx.room.Insert

@Dao
interface UserDao {
    @Insert
    fun insertUser(user: User)
}

@Daoは「これはデータ操作用のインターフェースですよ」とRoomに教えるマークです。

@Insertは、データを追加するときに使うRoom専用の命令です。

3. データの更新：@Updateアノテーションを使う

次は、既に登録されているデータの情報を変更（UPDATE）する方法です。Roomでは@Updateを使います。


import androidx.room.Update

@Dao
interface UserDao {
    @Update
    fun updateUser(user: User)
}

updateUserに渡されたUserのidが一致するレコードを見つけて、その内容を上書きしてくれます。

注意点として、idなどの主キー（Primary Key）が設定されていないと、更新は正しく動きません。

4. データの削除：@Deleteアノテーションを使う

最後に、データの削除（DELETE）です。これもRoomでは@Deleteというアノテーションを使って簡単に実装できます。


import androidx.room.Delete

@Dao
interface UserDao {
    @Delete
    fun deleteUser(user: User)
}

deleteUserに渡されたオブジェクトの主キーが一致するデータを削除します。データを削除したいときは、まずそのデータを取得してから渡します。

5. まとめて複数データの操作も可能

@Insert、@Update、@Deleteでは、1つだけでなく複数のデータも同時に扱うことができます。Kotlinのリスト（List）を引数に渡せばOKです。


@Insert
fun insertAll(users: List<User>)

@Update
fun updateAll(users: List<User>)

@Delete
fun deleteAll(users: List<User>)

これにより、たくさんのデータを一気に追加・更新・削除できてとても便利です。

6. 実際に使うときのイメージ

では、これまでのDAOを使って、実際にデータを追加してみるイメージを紹介します。

たとえば、Userというデータクラスを登録したいときは、次のように使います。


val newUser = User(id = 1, name = "太郎", email = "taro@example.com")
userDao.insertUser(newUser)

このコードを使うと、データベースに新しい「太郎さん」の情報が保存されます。

7. データ操作でエラーが出たときの確認ポイント

データ追加や更新がうまくいかないときは、以下のポイントを見直しましょう。

エンティティクラス（@Entity）が正しく作られているか？
主キー（@PrimaryKey）が設定されているか？
データベース（RoomDatabase）が正しく初期化されているか？
関数名のスペルミスがないか？

Roomは少しでも設定が間違っているとエラーになりますが、逆に正しく書けばとても強力です。

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

8. Roomのデータ操作は簡単で安全！

Roomの魅力は、SQLを書かなくてもデータ操作ができる点です。「追加」「更新」「削除」といった操作を、アノテーションと関数で表現できるので、初心者にもわかりやすく、安全性も高いです。

初めてKotlinでデータベースを扱う方も、このように丁寧に設計されたRoomを使えば、直感的にデータ操作ができるようになります。

【未経験OK】Kotlinで始めるプログラミング入門｜ゼロから「動く喜び」を体験する60分

「プログラミングを始めたい」を形にする。最新言語Kotlinで楽しむ、ものづくりの第一歩。

本講座は、プログラミング経験が全くない方のためのエントリー講座です。「コードを書くってどういうこと？」という基本から、世界中で使われている最新言語Kotlin（コトリン）を使って、実際にプログラムを動かすまでを体験します。難しい理屈よりも、まずは「自分の手で動かす楽しさ」を最短距離で実感していただきます。