Skip to content

트랜잭션

API

단일 트랜잭션으로 여러 구문을 실행하고 싶다면 transaction 함수를 사용하세요.

kotlin
val players = listOf<Player>()
database.playerQueries.transaction {
  players.forEach { player ->
    database.playerQueries.insert(
      player_number = player.number,
      full_name = player.fullName
    )
  }
}

트랜잭션에서 값을 반환하려면 transactionWithResult 함수를 사용하세요.

kotlin
val players: List<Player> = database.playerQueries.transactionWithResult {
  database.playerQueries.selectAll().executeAsList()
}

Rollback

트랜잭션 내부 어디에서든 예외가 발생하면 롤백됩니다. 트랜잭션 내부 어디에서든 수동으로 롤백할 수 있지만, 트랜잭션이 값을 반환하는 경우 트랜잭션이 반환할 값을 지정해야 합니다.

kotlin
database.playerQueries.transaction {
  players.forEach { player ->
    if (player.number == 0) rollback()
    database.playerQueries.insert(
      player_number = player.number,
      full_name = player.fullName
    )
  }
}
kotlin
val numberInserted: Int = database.playerQueries.transactionWithResult {
  players.forEach { player ->
    if (player.number == 0) rollback(0)
    database.playerQueries.insert(
      player_number = player.number,
      full_name = player.fullName
    )
  }
  players.size
}

Callbacks

트랜잭션이 완료되거나 롤백된 후에 발생하도록 콜백을 등록할 수 있습니다.

kotlin
database.playerQueries.transaction {
  afterRollback { log("No players were inserted.") }
  afterCommit { log("${players.size} players were inserted.") }

  players.forEach { player ->
    database.playerQueries.insert(
      player_number = player.number,
      full_name = player.fullName
    )
  }
}