🇬🇧 Read in English: Quick Start: Spring Boot Web with Exposed

개요

Kotlin Exposed 의 세부 내용을 공부하기 전에 간단한 예제를 통해 Exposed 를 어떻게 사용할 수 있는지 알아봅시다.

Kotlin Exposed 는 자체 transaction 함수 뿐 아니라 Spring Framework의 Transaction과 자연스럽게 통합될 수 있도록 @Transactional 을 지원합니다. 이를 활용하면, 아주 쉽게 spring-data-jpa 를 사용하는 것과 유사하게 어플리케이션을 제작할 수 있고, 더 좋은 성능을 갖출 수 있습니다.

특히 Java 21 의 Virtual Threads 를 이용하는 경우에도 두 가지 모두 사용이 가능합니다.

Entity 관계

이 예제에는 영화와 배우 정보를 관리하는 서비스를 제작하려고 합니다. ERD 를 보시면 영화 정보를 나타내는 movies 테이블과 배우 정보를 나타내는 actors 테이블을 정의하고, 영화 출연 관계를 나타내는 actors_in_movies 라는 many-to-many 형태의 매핑 테이블을 정의합니다.

영화, 배우의 출연 또는 프로듀싱 관계를 나타내는 ERD

이번 예제는 spring-mvc-exposed 라는 프로젝트를 기반으로 설명합니다.

exposed-workshop/01-spring-boot/spring-mvc-exposed at main · bluetape4k/exposed-workshop

환경 설정

예제 프로젝트는 다음과 같은 구조를 가집니다. 일반적인 REST API 서비스의 Spring MVC 구조이며, 이번 예제에는 Java 21 의 Virtual Threads 를 지원할 수 있도록 합니다.

프로젝트 구조

이 예제는 다음과 같은 build.gradle.kts 로 참조를 정의합니다.

plugins {
    kotlin("plugin.spring")
    id(Plugins.spring_boot)
    id(Plugins.gatling) version Plugins.Versions.gatling  // 성능 측정을 수행하는 Gatling 
}

springBoot {
    mainClass.set("exposed.workshop.springmvc.SpringMvcApplicationKt")

    buildInfo {
        properties {
            additional.put("name", "Spring MVC with Exposed")
            additional.put("java.version", JavaVersion.current())
        }
    }
}

@Suppress("UnstableApiUsage")
configurations {
    testImplementation.get().extendsFrom(compileOnly.get(), runtimeOnly.get())
}

dependencies {
    testImplementation(project(":exposed-shared-tests"))

    // bluetape4k
    implementation(Libs.bluetape4k_io)
    implementation(Libs.bluetape4k_jdbc)
    testImplementation(Libs.bluetape4k_spring_tests)

    // Exposed
    implementation(Libs.bluetape4k_exposed)
    implementation(Libs.exposed_core)
    implementation(Libs.exposed_jdbc)
    implementation(Libs.exposed_dao)
    implementation(Libs.exposed_java_time)
    implementation(Libs.exposed_spring_boot_starter)

    // Database Drivers
    implementation(Libs.hikaricp)

    // H2
    implementation(Libs.h2_v2)

    // MySQL
    implementation(Libs.bluetape4k_testcontainers)
    implementation(Libs.testcontainers_mysql)
    implementation(Libs.mysql_connector_j)

    // PostgreSQL
    implementation(Libs.bluetape4k_testcontainers)
    implementation(Libs.testcontainers_postgresql)
    implementation(Libs.postgresql_driver)

    // Spring Boot
    implementation(Libs.springBoot("autoconfigure"))
    annotationProcessor(Libs.springBoot("autoconfigure-processor"))
    annotationProcessor(Libs.springBoot("configuration-processor"))
    runtimeOnly(Libs.springBoot("devtools"))

    implementation(Libs.springBootStarter("web"))
    implementation(Libs.springBootStarter("aop"))
    implementation(Libs.springBootStarter("actuator"))
    implementation(Libs.springBootStarter("validation"))

    testImplementation(Libs.bluetape4k_spring_tests)
    testImplementation(Libs.springBootStarter("test")) {
        exclude(group = "junit", module = "junit")
        exclude(group = "org.junit.vintage", module = "junit-vintage-engine")
        exclude(module = "mockito-core")
    }

    // Others
}

build.gradle.kts 에서 bluetape4k-exposed 라는 제가 제작한 라이브러리를 사용하는데, 이 부분은 bluetape4k 소개 및 활용 방법 에서 자세히 설명하겠습니다.

이 프로젝트에서는 SQL DSL (Domain Specific Language) 을 주로 사용할 예정이라 exposed-jdbc 모듈을 주로 사용 것이고, spring boot application 을 만들기 위해서 exposed-spring-boot-starter 모듈을 필수로 참조해야 합니다.