Open AIDoc

한국어

简体中文
繁體中文
日本語

한국어

简体中文
繁體中文
日本語

Appearance

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

이 문서는 Spring Boot 및 Kotlin 시작하기 튜토리얼의 첫 번째 부분입니다.


First step Kotlin으로 Spring Boot 프로젝트 생성하기
Second step Spring Boot 프로젝트에 데이터 클래스 추가하기
Third step Spring Boot 프로젝트에 데이터베이스 지원 추가하기
Fourth step 데이터베이스 액세스를 위해 Spring Data CrudRepository 사용하기

튜토리얼의 첫 번째 부분에서는 IntelliJ IDEA의 프로젝트 마법사(Project Wizard)를 사용하여 Gradle로 Spring Boot 프로젝트를 생성하는 방법을 보여줍니다.

NOTE

이 튜토리얼은 빌드 시스템으로 Gradle을 사용하도록 요구하지 않습니다. Maven을 사용하더라도 동일한 단계를 따를 수 있습니다.

시작하기 전에 ​

IntelliJ IDEA Ultimate Edition의 최신 버전을 다운로드하여 설치합니다.

TIP

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

Spring Boot 프로젝트 생성하기 ​

IntelliJ IDEA Ultimate Edition의 프로젝트 마법사(Project Wizard)를 사용하여 Kotlin으로 새로운 Spring Boot 프로젝트를 생성합니다.

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

  2. 왼쪽 패널에서 New Project | Spring Boot를 선택합니다.

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

    • Name: demo

    • Language: Kotlin

    • Type: Gradle - Kotlin

      TIP

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

    • Package name: com.example.demo

    • JDK: Java JDK

      NOTE

      이 튜토리얼은 Amazon Corretto 버전 23을 사용합니다.

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

    • Java: 17

    Create Spring Boot project

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

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

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

    Set up Spring Boot project

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

    TIP

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

  7. 이후 Project view에서 다음 구조를 확인할 수 있습니다.

    Set up Spring Boot project

    생성된 Gradle 프로젝트는 Maven의 표준 디렉터리 레이아웃에 해당합니다.

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

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

build.gradle.kts 파일을 엽니다. 이는 애플리케이션에 필요한 의존성 목록을 포함하는 Gradle Kotlin 빌드 스크립트입니다.

이 Gradle 파일은 Spring Boot의 표준이지만, kotlin("plugin.spring")과 같은 Kotlin Spring Gradle 플러그인을 포함하여 필요한 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-starter-data-jdbc")
    implementation("org.springframework.boot:spring-boot-starter-web")
    implementation("com.fasterxml.jackson.module:jackson-module-kotlin") // JSON 작업 시 Kotlin용 Jackson 확장 기능
    implementation("org.jetbrains.kotlin:kotlin-reflect") // Kotlin 리플렉션 라이브러리 (Spring 작업에 필요)
    runtimeOnly("com.h2database:h2")
    testImplementation("org.springframework.boot:spring-boot-starter-test")
    testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

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

tasks.withType<Test> {
    useJUnitPlatform()
}

보시다시피, Gradle 빌드 파일에 몇 가지 Kotlin 관련 아티팩트가 추가되었습니다.

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

    • kotlin("jvm") – 프로젝트에서 사용할 Kotlin 버전을 정의하는 플러그인
    • kotlin("plugin.spring") – Spring Framework 기능과 호환되도록 Kotlin 클래스에 open 한정자(modifier)를 추가하기 위한 Kotlin Spring 컴파일러 플러그인

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

    • com.fasterxml.jackson.module:jackson-module-kotlin – Kotlin 클래스 및 데이터 클래스(data class)의 직렬화(serialization) 및 역직렬화(deserialization) 지원을 추가하는 모듈
    • org.jetbrains.kotlin:kotlin-reflect – Kotlin 리플렉션 라이브러리

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

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&lt;String&gt;

runApplication() 함수의 선언을 확인해 보면, 함수의 매개변수가 vararg 한정자(modifier)로 표시되어 있는 것을 볼 수 있습니다: vararg args: String. 이는 함수에 가변 개수의 문자열 인자를 전달할 수 있음을 의미합니다.

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

args는 문자열 배열로 선언된 main() 함수의 매개변수입니다. 문자열 배열이 있고, 그 내용을 함수에 전달하려면 스프레드 연산자(배열 앞에 별표 *를 붙임)를 사용합니다.

컨트롤러 생성하기 ​

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

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 어노테이션

MessageController가 REST 컨트롤러임을 Spring에 알려주기 위해 @RestController 어노테이션으로 표시해야 합니다.

이 어노테이션은 이 클래스가 DemoApplication 클래스와 같은 패키지에 있기 때문에 컴포넌트 스캔에 의해 선택될 것임을 의미합니다.

@GetMapping 어노테이션

@GetMapping은 HTTP GET 호출에 해당하는 엔드포인트를 구현하는 REST 컨트롤러의 함수들을 표시합니다.

kotlin
@GetMapping("/")
fun index(@RequestParam("name") name: String) = "Hello, $name!"
@RequestParam 어노테이션

함수 매개변수 name은 @RequestParam 어노테이션으로 표시됩니다. 이 어노테이션은 메서드 매개변수가 웹 요청 매개변수에 바인딩되어야 함을 나타냅니다.

따라서, 애플리케이션의 루트에 접근하여 `name`이라는 요청 매개변수를 /?name=<your-value>와 같이 제공하면, 해당 매개변수 값이 `index()` 함수를 호출하는 인자로 사용될 것입니다.

단일 표현식 함수 – index()

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

이는 중괄호를 생략할 수 있고, 본문은 등호(=) 뒤에 지정됨을 의미합니다.

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

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

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

문자열 템플릿 – $name

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

문자열 템플릿은 내장된 표현식을 포함하는 문자열 리터럴입니다.

이는 문자열 연결(String concatenation) 작업에 대한 편리한 대체 수단입니다.

애플리케이션 실행하기 ​

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

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

    Run Spring Boot application

    TIP

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

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

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

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

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

    Spring Application response

다음 단계 ​

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

다음 장으로 진행하기

Copyright © 2025 Open AIDoc.