Kotlin Academy · Lektion

Exposed-opsætning: Databaseforbindelse og transaction-DSL

Opret forbindelse til en database, konfigurér Exposed, og udfør kode i transactions.

Lektion 1 af 413 trin

Exposed-opsætning: Databaseforbindelse og transaction-DSL er en gratis Kotlin Academy-lektion på CoddyKit. Dette er lektion 1 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Kotlin Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Kotlin Academy-kurset indeholder 4 lektioner i alt.

Hvad er Exposed

Exposed er JetBrains' letvægts-SQL-framework til Kotlin. Det tilbyder to niveauer: en forespørgsels-DSL (typesikre SQL-udtryk) og et DAO-lag (entiteter i Active Record-stil). Begge kører i eksplicitte transaktioner.

Tilføj Exposed-afhængigheder

Tilføj kernepakken, JDBC-driverbroen og din databasedriver:

dependencies {
    implementation("org.jetbrains.exposed:exposed-core:0.52.0")
    implementation("org.jetbrains.exposed:exposed-jdbc:0.52.0")
    implementation("org.jetbrains.exposed:exposed-dao:0.52.0")
    implementation("com.h2database:h2:2.2.224") // or postgresql driver
    implementation("com.zaxxer:HikariCP:5.1.0")  // connection pooling
}

Opret forbindelse til databasen

Kald Database.connect() én gang ved opstart. I produktion skal du sende en HikariDataSource, mens en enkel JDBC-URL er tilstrækkelig til test:

import org.jetbrains.exposed.sql.Database

// Simple (dev/test)
Database.connect(
    url = "jdbc:h2:mem:test;DB_CLOSE_DELAY=-1",
    driver = "org.h2.Driver"
)

// Production with HikariCP
Database.connect(HikariDataSource(HikariConfig().apply {
    jdbcUrl = "jdbc:postgresql://localhost/mydb"
    username = "user"
    password = "pass"
    maximumPoolSize = 10
}))

Blokken transaction { }

Alle Exposed-operationer skal køre i en transaction { }-blok. Exposed gennemfører transaktionen ved succes og ruller den tilbage ved enhver ikke-fanget undtagelse:

transaction {
    // all DB operations here
    SchemaUtils.create(Users)
}

Koroutinekompatible transaktioner

Brug newSuspendedTransaction { } fra exposed-r2dbc eller exposed-spring-boot-starter til koroutinekompatible transaktioner. I Ktor skal du omslutte blokerende Exposed-kald i withContext(Dispatchers.IO) { transaction { ... } }:

suspend fun findUser(id: Long): User? = withContext(Dispatchers.IO) {
    transaction {
        UserEntity.findById(id)?.toUser()
    }
}

SchemaUtils: Opret og slet tabeller

Brug SchemaUtils.create(Table1, Table2) til at oprette tabeller, hvis de ikke findes, og SchemaUtils.drop() til at slette dem. Kald dette i en transaction { } ved applikationens opstart:

transaction {
    SchemaUtils.create(Users, Posts, Comments)
}

Konfiguration af en forbindelse i Ktor

Initialisér databasen i et Application-modul, så det sker én gang, når serveren starter:

fun Application.configureDatabase() {
    val dbUrl = environment.config.property("ktor.database.url").getString()
    Database.connect(dbUrl, driver = "org.postgresql.Driver",
        user = "...", password = "...")
    transaction { SchemaUtils.create(Users) }
}

Niveauer for transaktionsisolering

Angiv et isoleringsniveau til transaction(), når du har brug for stærkere eller svagere konsistensgarantier:

transaction(Connection.TRANSACTION_SERIALIZABLE) {
    // serializable isolation
}

Indlejrede transaktioner

Som standard tilslutter indlejrede kald af transaction { } sig den ydre transaktion. Brug transaction(db, outerTransactionIsEmpty = false) { } eller et savepoint for at få en uafhængig transaktion.

Logning af SQL

Aktivér SQL-logning for at se genererede forespørgsler under udviklingen. Angiv en StdOutSqlLogger eller en tilpasset logger i transaktionsblokken:

transaction {
    addLogger(StdOutSqlLogger)
    // ...
}

Bedste praksis for forbindelsespooling

Brug altid HikariCP eller noget tilsvarende i produktion. Indstil maximumPoolSize, så den passer til antallet af servertråde, og connectionTimeout, så forbindelsespoolen fejler hurtigt, når den er opbrugt. Overvåg poolens udnyttelse i produktion.

Hurtigt tjek

Hvad sker der, hvis der kastes en ikke-fanget undtagelse i en transaction { }-blok i Exposed?

Opsummering: Exposed-opsætning og transaktions-DSL

Vigtigste pointer:

  • Opret forbindelse med Database.connect() én gang ved opstart (brug HikariCP i produktion)
  • Alle databaseoperationer kører i transaction { } — transaktionen gennemføres ved succes og rulles tilbage ved en undtagelse
  • Opret og slet tabeller med SchemaUtils.create() i en transaktion
  • Omslut blokerende Exposed-kald i withContext(Dispatchers.IO) i koroutinekontekster
  • Aktivér StdOutSqlLogger under udviklingen for at inspicere genereret SQL
Gratis at komme i gang

Lær Kotlin med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser
51
Lektioner
203

Ofte stillede spørgsmål

Er lektionen “Exposed-opsætning: Databaseforbindelse og transaction-DSL” gratis?

Ja — alle 3 lektioner i læringssporet Kotlin Academy, inklusive “Exposed-opsætning: Databaseforbindelse og transaction-DSL”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Kotlin Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Exposed-opsætning: Databaseforbindelse og transaction-DSL”?

Opret forbindelse til en database, konfigurér Exposed, og udfør kode i transactions. Du øver dig i Kotlin Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Kotlin Academy?

Der kræves ingen tidligere erfaring. Kotlin Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 1 af 4.

Hvor lang tid tager lektionen “Exposed-opsætning: Databaseforbindelse og transaction-DSL”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Kotlin Academy-lektion?

Ja. Alle Kotlin Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

  1. Exposed-opsætning: Databaseforbindelse og transaction-DSL
  2. Definition af tabeller med Table-DSL'en
  3. CRUD med Query-DSL'en: insert, select, update, delete
  4. Exposed DAO: Entity-klasser og relationer
← Tilbage til Kotlin Academy