Open AIDoc

한국어

简体中文
繁體中文
日本語

한국어

简体中文
繁體中文
日本語

Appearance

Kotlin으로 Spring Boot 프로젝트 생성하기 ​

이것은 Spring Boot와 Kotlin 시작하기 튜토리얼의 첫 번째 부분입니다:


첫 번째 단계 Kotlin으로 Spring Boot 프로젝트 생성하기
두 번째 단계 Spring Boot 프로젝트에 데이터 클래스 추가하기
세 번째 단계 Spring Boot 프로젝트에 데이터베이스 지원 추가하기
네 번째 단계 데이터베이스 액세스를 위해 Spring Data CrudRepository 사용하기

이 튜토리얼의 첫 번째 부분에서는 IntelliJ IDEA의 프로젝트 위저드(Project Wizard)를 사용하여 Gradle 기반의 Spring Boot 프로젝트를 생성하는 방법을 설명합니다.

이 튜토리얼에서 빌드 시스템으로 Gradle을 반드시 사용할 필요는 없습니다. Maven을 사용하는 경우에도 동일한 단계를 따를 수 있습니다.

시작하기 전에 ​

최신 버전의 IntelliJ IDEA Ultimate Edition을 다운로드하고 설치하세요.

IntelliJ IDEA Community Edition이나 다른 IDE를 사용하는 경우, 웹 기반 프로젝트 생성기를 사용하여 Spring Boot 프로젝트를 생성할 수 있습니다.

Spring Boot 프로젝트 생성하기 ​

IntelliJ IDEA Ultimate Edition의 프로젝트 위저드를 사용하여 Kotlin으로 새로운 Spring Boot 프로젝트를 생성하세요:

  1. IntelliJ IDEA에서 File | New | Project를 선택합니다.

  2. 왼쪽 패널의 Generators 섹션에서 Spring Boot를 선택합니다.

  3. New Project 창에서 다음 필드와 옵션을 지정합니다:

    • Name: demo

    • Language: Kotlin

    • Type: Gradle - Kotlin

      이 옵션은 빌드 시스템과 DSL을 지정합니다.

    • Package name: com.example.demo

    • JDK: Java JDK

      이 튜토리얼에서는 Amazon Corretto 버전 23을 사용합니다. JDK가 설치되어 있지 않다면 드롭다운 목록에서 다운로드할 수 있습니다.

    • Java: 17

      Java 17이 설치되어 있지 않다면 JDK 드롭다운 목록에서 다운로드할 수 있습니다.

    Spring Boot 프로젝트 생성

  4. 모든 필드를 지정했는지 확인하고 Next를 클릭합니다.

  5. 튜토리얼에 필요한 다음 의존성(dependencies)을 선택합니다:

    • Web | Spring Web
    • SQL | Spring Data JDBC
    • SQL | H2 Database

    Spring Boot 프로젝트 설정

  6. Create를 클릭하여 프로젝트를 생성하고 설정합니다.

    IDE가 새로운 프로젝트를 생성하고 엽니다. 프로젝트 의존성을 다운로드하고 임포트하는 데 시간이 다소 걸릴 수 있습니다.

  7. 완료 후 Project 뷰에서 다음과 같은 구조를 확인할 수 있습니다:

    Spring Boot 프로젝트 뷰 설정

    생성된 Gradle 프로젝트는 Maven의 표준 디렉터리 레이아웃을 따릅니다:

    • main/kotlin 폴더 아래에는 애플리케이션에 속하는 패키지와 클래스들이 있습니다.
    • 애플리케이션의 진입점(entry point)은 DemoApplication.kt 파일의 main() 메서드입니다.

프로젝트 Gradle 빌드 파일 살펴보기 ​

build.gradle.kts 파일을 엽니다. 이 파일은 Gradle Kotlin 빌드 스크립트로, 애플리케이션에 필요한 의존성 목록이 포함되어 있습니다.

이 Gradle 파일은 Spring Boot의 표준 형식이지만, Kotlin-Spring Gradle 플러그인인 kotlin("plugin.spring")을 포함하여 필요한 Kotlin 의존성도 포함하고 있습니다.

다음은 모든 부분과 의존성에 대한 설명이 포함된 전체 스크립트입니다:

kotlin
// build.gradle.kts
plugins {
    kotlin("jvm") version "1.9.25" // 사용할 Kotlin 버전
    kotlin("plugin.spring") version "1.9.25" // Kotlin Spring 플러그인
    id("org.springframework.boot") version "3.4.5"
    id("io.spring.dependency-management") version "1.1.7"
}

group = "com.example"
version = "0.0.1-SNAPSHOT"

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.springframework.boot:spring-boot-h2console")
    implementation("org.springframework.boot:spring-boot-starter-data-jdbc")
    implementation("org.springframework.boot:spring-boot-starter-webmvc")
    implementation("org.jetbrains.kotlin:kotlin-reflect") // Spring과 함께 작업하는 데 필요한 Kotlin 리플렉션 라이브러리
    implementation("tools.jackson.module:jackson-module-kotlin") // JSON 작업을 위한 Kotlin용 Jackson 확장
    runtimeOnly("com.h2database:h2")
    testImplementation("org.springframework.boot:spring-boot-starter-data-jdbc-test")
    testImplementation("org.springframework.boot:spring-boot-starter-webmvc-test")
    testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

kotlin {
    compilerOptions {
        freeCompilerArgs.addAll("-Xjsr305=strict", "-Xannotation-default-target=param-property") // `-Xjsr305=strict`는 JSR-305 어노테이션에 대한 엄격 모드를 활성화합니다.
    }
}

tasks.withType<Test> {
    useJUnitPlatform()
}

보시는 바와 같이 Gradle 빌드 파일에 몇 가지 Kotlin 관련 아티팩트가 추가되었습니다:

  1. plugins 블록에는 두 가지 Kotlin 아티팩트가 있습니다:

    • kotlin("jvm") 플러그인은 프로젝트에서 사용할 Kotlin 버전을 정의합니다.
    • Kotlin Spring 컴파일러 플러그인인 kotlin("plugin.spring")은 Kotlin 클래스에 open 변경자를 추가하여 Spring Framework 기능과 호환되도록 만듭니다.

  2. dependencies 블록에는 몇 가지 Kotlin 관련 모듈이 나열되어 있습니다:

    • tools.jackson.module:jackson-module-kotlin 모듈은 Kotlin 클래스 및 데이터 클래스의 직렬화 및 역직렬화 지원을 추가합니다.
    • org.jetbrains.kotlin:kotlin-reflect는 Kotlin 리플렉션 라이브러리로, 리플렉션 기능을 완벽하게 지원합니다.

  3. 의존성 섹션 다음에는 kotlin 플러그인 설정 블록을 볼 수 있습니다. 여기에서 다양한 언어 기능을 활성화하거나 비활성화하기 위한 추가 컴파일러 인자를 추가할 수 있습니다.

Kotlin 컴파일러 옵션에 대한 자세한 내용은 에서 확인할 수 있습니다.

생성된 Spring Boot 애플리케이션 살펴보기 ​

DemoApplication.kt 파일을 엽니다:

kotlin
// DemoApplication.kt
package com.example.demo

import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication

@SpringBootApplication
class DemoApplication

fun main(args: Array<String>) {
    runApplication<DemoApplication>(*args)
}
클래스 선언 – class DemoApplication

패키지 선언과 import 문 바로 다음에 첫 번째 클래스 선언인 class DemoApplication을 볼 수 있습니다.

Kotlin에서는 클래스에 멤버(프로퍼티나 함수)가 포함되지 않은 경우 클래스 본문({})을 완전히 생략할 수 있습니다.

@SpringBootApplication 어노테이션

@SpringBootApplication 어노테이션은 Spring Boot 애플리케이션의 편의를 위한 어노테이션입니다. 이것은 Spring Boot의 자동 구성(auto-configuration), 컴포넌트 스캔(component scan)을 활성화하며, "애플리케이션 클래스"에 추가 구성을 정의할 수 있게 해줍니다.

프로그램 진입점 – main()

main() 함수는 애플리케이션의 진입점입니다.

이 함수는 DemoApplication 클래스 외부의 최상위 함수(top-level function)로 선언되었습니다. main() 함수는 Spring의 runApplication(*args) 함수를 호출하여 Spring Framework로 애플리케이션을 시작합니다.

가변 인자 – args: Array<String>

runApplication() 함수의 선언을 확인해 보면, 함수의 파라미터가 vararg 변경자로 표시된 것을 볼 수 있습니다: vararg args: String. 이는 함수에 가변적인 개수의 String 인자를 전달할 수 있음을 의미합니다.

스프레드 연산자 – (*args)

args는 main() 함수의 파라미터로, String 배열로 선언되어 있습니다. 이 String 배열의 내용을 함수에 전달하고 싶으므로, 스프레드(spread) 연산자(배열 앞에 별표 * 기호)를 사용합니다.

컨트롤러 생성하기 ​

애플리케이션을 실행할 준비가 되었지만, 먼저 로직을 업데이트해 보겠습니다.

Spring 애플리케이션에서 컨트롤러는 웹 요청을 처리하는 데 사용됩니다. 동일한 패키지 내 DemoApplication.kt 파일 옆에 다음과 같이 MessageController 클래스가 포함된 MessageController.kt 파일을 생성합니다:

kotlin
// MessageController.kt
package com.example.demo

import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.RequestParam
import org.springframework.web.bind.annotation.RestController

@RestController
class MessageController {
    @GetMapping("/")
    fun index(@RequestParam("name") name: String) = "Hello, $name!"
}
@RestController 어노테이션

Spring에게 MessageController가 REST 컨트롤러임을 알려야 하므로, @RestController 어노테이션을 지정해야 합니다.

이 어노테이션은 이 클래스가 DemoApplication 클래스와 동일한 패키지에 있기 때문에 컴포넌트 스캔에 의해 감지됨을 의미합니다.

@GetMapping 어노테이션

@GetMapping은 HTTP GET 호출에 해당하는 엔드포인트를 구현하는 REST 컨트롤러의 함수를 나타냅니다:

kotlin
@RequestParam 어노테이션

함수 파라미터 name은 @RequestParam 어노테이션으로 표시되어 있습니다. 이 어노테이션은 메서드 파라미터가 웹 요청 파라미터에 바인딩되어야 함을 나타냅니다.

따라서 애플리케이션의 루트 경로에 접속하고 /?name=<값>과 같이 "name"이라는 요청 파라미터를 제공하면, 해당 파라미터 값이 index() 함수를 호출하는 인자로 사용됩니다.

단일 표현식 함수 – index()

index() 함수는 하나의 문장만 포함하고 있으므로 단일 표현식 함수(single-expression function)로 선언할 수 있습니다.

즉, 중괄호를 생략할 수 있으며 본문은 등호 = 다음에 지정됩니다.

함수 반환 타입에 대한 타입 추론

index() 함수는 반환 타입을 명시적으로 선언하지 않습니다. 대신 컴파일러가 등호 = 오른쪽 문장의 결과를 보고 반환 타입을 추론합니다.

Hello, $name! 표현식의 타입은 String이므로, 함수의 반환 타입도 String이 됩니다.

문자열 템플릿 – $name

Hello, $name! 표현식은 Kotlin에서 문자열 템플릿(String template)이라고 불립니다.

문자열 템플릿은 표현식이 포함된 문자열 리터럴입니다.

이는 문자열 연결(concatenation) 작업을 편리하게 대체합니다.

애플리케이션 실행하기 ​

이제 Spring 애플리케이션을 실행할 준비가 되었습니다:

  1. DemoApplication.kt 파일에서 main() 메서드 옆의 거터(gutter)에 있는 녹색 Run 아이콘을 클릭합니다:

    Spring Boot 애플리케이션 실행

    터미널에서 ./gradlew bootRun 명령을 실행할 수도 있습니다.

    이렇게 하면 컴퓨터에서 로컬 서버가 시작됩니다.

  2. 애플리케이션이 시작되면 다음 URL을 엽니다:

    text
    http://localhost:8080?name=John

    응답으로 "Hello, John!"이 출력되는 것을 볼 수 있습니다:

    Spring 애플리케이션 응답

다음 단계 ​

튜토리얼의 다음 부분에서는 Kotlin 데이터 클래스와 이를 애플리케이션에서 사용하는 방법에 대해 알아봅니다.

다음 장으로 진행하기

Copyright © 2026 Open AIDoc.