類型

SQLite 型別

SQLDelight 的欄位定義與一般的 SQLite 欄位定義相同，但支援一項額外欄位約束，用於指定生成介面中該欄位的 Kotlin 型別。

CREATE TABLE some_types (
  some_long INTEGER,           -- 在資料庫中儲存為 INTEGER，取回時為 Long
  some_double REAL,            -- 在資料庫中儲存為 REAL，取回時為 Double
  some_string TEXT,            -- 在資料庫中儲存為 TEXT，取回時為 String
  some_blob BLOB               -- 在資料庫中儲存為 BLOB，取回時為 ByteArray
);

基本型別

一個同級模組，為您的便利提供基本型別的轉換。

Kotlin

dependencies {
  implementation("app.cash.sqldelight:primitive-adapters:2.1.0")
}

Groovy

dependencies {
  implementation "app.cash.sqldelight:primitive-adapters:2.1.0"
}

存在以下轉換器：

• FloatColumnAdapter — 用於 SQL 型別隱式儲存為 kotlin.Double 時，取回 kotlin.Float
• IntColumnAdapter — 用於 SQL 型別隱式儲存為 kotlin.Long 時，取回 kotlin.Int
• ShortColumnAdapter — 用於 SQL 型別隱式儲存為 kotlin.Long 時，取回 kotlin.Short

自訂欄位型別

如果您想將欄位擷取為自訂型別，可以指定一個 Kotlin 型別：

import kotlin.String;
import kotlin.collections.List;

CREATE TABLE hockeyPlayer (
  cup_wins TEXT AS List<String> NOT NULL
);

然而，建立 Database 將需要您提供一個 ColumnAdapter，它知道如何將資料庫型別映射到您的自訂型別：

val listOfStringsAdapter = object : ColumnAdapter<List<String>, String> {
  override fun decode(databaseValue: String) =
    if (databaseValue.isEmpty()) {
      listOf()
    } else {
      databaseValue.split(",")
    }
  override fun encode(value: List<String>) = value.joinToString(separator = ",")
}

val queryWrapper: Database = Database(
  driver = driver,
  hockeyPlayerAdapter = hockeyPlayer.Adapter(
    cup_winsAdapter = listOfStringsAdapter
  )
)

列舉 (Enums)

為方便起見，SQLDelight 執行時 (runtime) 包含一個 ColumnAdapter，用於將列舉 (enum) 儲存為字串資料。

import com.example.hockey.HockeyPlayer;

CREATE TABLE hockeyPlayer (
  position TEXT AS HockeyPlayer.Position
)

val queryWrapper: Database = Database(
  driver = driver,
  hockeyPlayerAdapter = HockeyPlayer.Adapter(
    positionAdapter = EnumColumnAdapter()
  )
)

值型別

如果需要，SQLDelight 可以為欄位生成一個值型別，該型別會包裝底層 (underlying) 資料庫型別：

CREATE TABLE hockeyPlayer (
  id INT AS VALUE
);