MultiplatformでのSQLiteの開始方法
まず、プロジェクトにGradleプラグインを適用します。
plugins {
id("app.cash.sqldelight") version "2.4.0"
}
repositories {
google()
mavenCentral()
}
sqldelight {
databases {
register("Database") {
packageName.set("com.example")
}
}
}plugins {
id "app.cash.sqldelight" version "2.4.0"
}
repositories {
google()
mavenCentral()
}
sqldelight {
databases {
register("Database") { // これは生成されるデータベースクラスの名前になります。
packageName = "com.example"
}
}
}スキーマの定義
SQLステートメントを src/commonMain/sqldelight 配下の .sq ファイルに記述します。 通常、.sq ファイルの最初のステートメントでテーブルを作成しますが、インデックスの作成やデフォルトコンテンツのセットアップを行うことも可能です。
CREATE TABLE hockeyPlayer (
player_number INTEGER PRIMARY KEY NOT NULL,
full_name TEXT NOT NULL
);
CREATE INDEX hockeyPlayer_full_name ON hockeyPlayer(full_name);
INSERT INTO hockeyPlayer (player_number, full_name)
VALUES (15, 'Ryan Getzlaf');これらのステートメントから、SQLDelightは、データベースの作成やその上でのステートメントの実行に使用できる、関連する Schema オブジェクトを持つ Database クラスを生成します。Database クラスは generateSqlDelightInterface Gradleタスクによって生成されます。このタスクは、.sq ファイルを編集した際に SQLDelight IDE プラグインによって自動的に実行されるほか、通常の Gradle ビルドの一部としても実行されます。
生成されたデータベースをコードで使用するには、プロジェクトにSQLDelightのドライバー依存関係を追加する必要があります。 各ターゲットプラットフォームには、独自のドライバー実装があります。
kotlin {
sourceSets.androidMain.dependencies {
implementation("app.cash.sqldelight:android-driver:2.4.0")
}
// または iosMain、windowsMain など
sourceSets.nativeMain.dependencies {
implementation("app.cash.sqldelight:native-driver:2.4.0")
}
sourceSets.jvmMain.dependencies {
implementation("app.cash.sqldelight:sqlite-driver:2.4.0")
}
}kotlin {
sourceSets.androidMain.dependencies {
implementation "app.cash.sqldelight:android-driver:2.4.0"
}
// または iosMain、windowsMain など
sourceSets.nativeMain.dependencies {
implementation "app.cash.sqldelight:native-driver:2.4.0"
}
sourceSets.jvmMain.dependencies {
implementation "app.cash.sqldelight:sqlite-driver:2.4.0"
}
}ドライバーインスタンスの構築
SqlDriverインスタンスを取得するための共通のファクトリクラスまたはメソッドを作成します。
import com.example.Database
expect class DriverFactory {
fun createDriver(): SqlDriver
}
fun createDatabase(driverFactory: DriverFactory): Database {
val driver = driverFactory.createDriver()
val database = Database(driver)
// データベースを使用してさらに作業を行います(以下を参照)。
}次に、ターゲットプラットフォームごとにこれを実装します。
actual class DriverFactory(private val context: Context) {
actual fun createDriver(): SqlDriver {
return AndroidSqliteDriver(Database.Schema, context, "test.db")
}
}actual class DriverFactory {
actual fun createDriver(): SqlDriver {
return NativeSqliteDriver(Database.Schema, "test.db")
}
}actual class DriverFactory {
actual fun createDriver(): SqlDriver {
val driver: SqlDriver = JdbcSqliteDriver("jdbc:sqlite:test.db", Properties(), Database.Schema)
return driver
}
}Kotlin/JSでの使用については、こちらをご覧ください。
型安全なクエリの定義
SQLDelightは、.sq ファイル内のラベル付きSQLステートメントに対して、型安全な関数を生成します。
selectAll:
SELECT *
FROM hockeyPlayer;
insert:
INSERT INTO hockeyPlayer(player_number, full_name)
VALUES (?, ?);
insertFullPlayerObject:
INSERT INTO hockeyPlayer(player_number, full_name)
VALUES ?;ラベル付きステートメントを含む各 .sq ファイルに対して、「Queries」オブジェクトが生成されます。 例えば、上記の Player.sq ファイルに対しては、PlayerQueries オブジェクトが生成されます。 このオブジェクトを使用して生成された型安全な関数を呼び出すことで、実際のSQLステートメントを実行できます。
fun doDatabaseThings(driver: SqlDriver) {
val database = Database(driver)
val playerQueries: PlayerQueries = database.playerQueries
println(playerQueries.selectAll().executeAsList())
// [HockeyPlayer(15, "Ryan Getzlaf")]
playerQueries.insert(player_number = 10, full_name = "Corey Perry")
println(playerQueries.selectAll().executeAsList())
// [HockeyPlayer(15, "Ryan Getzlaf"), HockeyPlayer(10, "Corey Perry")]
val player = HockeyPlayer(10, "Ronald McDonald")
playerQueries.insertFullPlayerObject(player)
}以上です!その他の機能については、サイドバーの他のページを確認してください。
