0Pricing
Kotlin Academy · Lekcja

Konfiguracja Exposed: połączenie z bazą danych i DSL transakcji

Połącz się z bazą danych, skonfiguruj Exposed i wykonuj kod wewnątrz transakcji.

Konfiguracja Exposed: połączenie z bazą danych i DSL transakcji to bezpłatna lekcja Kotlin Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Kotlin Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Kotlin Academy zawiera 4 lekcji w sumie.

Czym jest Exposed?

Exposed to lekki framework SQL firmy JetBrains dla Kotlina. Oferuje dwa poziomy: DSL zapytań (bezpieczne typowo wyrażenia SQL) oraz warstwę DAO (encje w stylu Active Record). Oba działają wewnątrz jawnie określonych transakcji.

Dodawanie zależności Exposed

Dodaj rdzeń, most JDBC oraz sterownik używanej bazy danych:

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
}

Łączenie z bazą danych

Wywołaj Database.connect() raz podczas uruchamiania aplikacji. W środowisku produkcyjnym przekaż obiekt HikariDataSource, a w testach wystarczy prosty adres URL JDBC:

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
}))

Blok transaction { }

Wszystkie operacje Exposed muszą być wykonywane wewnątrz bloku transaction { }. Exposed zatwierdza transakcję po pomyślnym zakończeniu i wycofuje ją w przypadku każdego nieobsłużonego wyjątku:

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

Transakcje zgodne z korutynami

Użyj newSuspendedTransaction { } z exposed-r2dbc lub exposed-spring-boot-starter, aby korzystać z transakcji zgodnych z korutynami. W Ktorze opakuj blokujące wywołania Exposed w withContext(Dispatchers.IO) { transaction { ... } }:

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

SchemaUtils: tworzenie i usuwanie tabel

Użyj SchemaUtils.create(Table1, Table2), aby utworzyć nieistniejące tabele, oraz SchemaUtils.drop(), aby je usunąć. Wywołaj te funkcje wewnątrz transaction { } podczas uruchamiania aplikacji:

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

Konfigurowanie połączenia w Ktorze

Zainicjalizuj bazę danych w module Application, aby inicjalizacja wykonała się raz podczas uruchamiania serwera:

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) }
}

Poziomy izolacji transakcji

Przekaż poziom izolacji do transaction(), gdy potrzebujesz silniejszych lub słabszych gwarancji spójności:

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

Transakcje zagnieżdżone

Domyślnie zagnieżdżone wywołania transaction { } dołączają do transakcji zewnętrznej. Aby uzyskać niezależną transakcję, użyj transaction(db, outerTransactionIsEmpty = false) { } lub punktu zapisu.

Rejestrowanie zapytań SQL

Włącz rejestrowanie SQL, aby podczas tworzenia aplikacji wyświetlać generowane zapytania. Ustaw StdOutSqlLogger lub własny rejestrator wewnątrz bloku transakcji:

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

Najlepsze praktyki dotyczące puli połączeń

W środowisku produkcyjnym zawsze używaj HikariCP lub podobnego rozwiązania. Ustaw maximumPoolSize zgodnie z liczbą wątków serwera, a connectionTimeout tak, aby szybko zgłaszać błąd po wyczerpaniu puli. Monitoruj wykorzystanie puli w środowisku produkcyjnym.

Szybkie sprawdzenie

Co się dzieje, gdy wewnątrz bloku transaction { } w Exposed zostanie rzucony nieobsłużony wyjątek?

Podsumowanie: konfiguracja Exposed i DSL transakcji

Najważniejsze informacje:

  • Połącz się za pomocą Database.connect() raz podczas uruchamiania aplikacji (w środowisku produkcyjnym używaj HikariCP)
  • Wszystkie operacje na bazie danych wykonuj wewnątrz transaction { } — po pomyślnym zakończeniu transakcja jest zatwierdzana, a po wyjątku wycofywana
  • Twórz i usuwaj tabele za pomocą SchemaUtils.create() wewnątrz transakcji
  • W kontekście korutyn opakowuj blokujące wywołania Exposed w withContext(Dispatchers.IO)
  • Podczas tworzenia aplikacji włącz StdOutSqlLogger, aby sprawdzać generowany SQL

Często zadawane pytania

Czy lekcja „Konfiguracja Exposed: połączenie z bazą danych i DSL transakcji” jest bezpłatna?

Tak — pełny tekst „Konfiguracja Exposed: połączenie z bazą danych i DSL transakcji” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Kotlin Academy, przejdź na CoddyKit PRO. Kurs Kotlin Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Konfiguracja Exposed: połączenie z bazą danych i DSL transakcji”?

Połącz się z bazą danych, skonfiguruj Exposed i wykonuj kod wewnątrz transakcji. Ćwiczysz Kotlin Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Kotlin Academy?

Nie wymagamy żadnego doświadczenia. Kotlin Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Konfiguracja Exposed: połączenie z bazą danych i DSL transakcji”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Kotlin Academy?

Tak. Każda lekcja Kotlin Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Konfiguracja Exposed: połączenie z bazą danych i DSL transakcji
  2. Definiowanie tabel za pomocą DSL Table
  3. CRUD z DSL zapytań: insert, select, update, delete
  4. Exposed DAO: klasy encji i relacje
← Powrót do Kotlin Academy