실습 예제 on Advanced Beginner

환경 설정 심화

d8lzz1gpw@mozmail.com (kimbenji) — Wed, 13 May 2026 00:00:00 +0000

소요 시간: 약 10분

TL;DR

build.gradle.kts의 핵심 블록(plugins, dependencies, kotlin, application) 의미 정리

jvmToolchain(17) vs sourceCompatibility 차이 이해

IntelliJ IDEA 단축키와 ktlint 통합으로 협업 환경 정비

트러블슈팅 패턴(클래스 버전, 의존성 갱신, 캐시 무효화)

대상 독자: Kotlin 환경 설정의 기본을 끝낸 개발자 선수 지식: Quick Start 완료 (JDK 17 설치, gradle init, 첫 ./gradlew run 실행까지)

기본 설치는 Quick Start에서
JDK 17 설치, gradle init으로 Kotlin DSL 프로젝트 생성, IntelliJ IDEA 처음 열기 등 첫 환경 구축은 Quick Start에서 다룹니다. 이 페이지는 그 다음 단계 — 빌드 스크립트의 핵심 옵션과 협업에 필요한 추가 설정을 정리합니다.

Step 1 — build.gradle.kts 핵심 설정#

Kotlin DSL로 작성된 빌드 스크립트입니다. 핵심 옵션을 이해합니다.

기본 예제

d8lzz1gpw@mozmail.com (kimbenji) — Wed, 13 May 2026 00:00:00 +0000

소요 시간: 약 15분

TL;DR

data class로 간결한 데이터 모델 정의

filter, map, sortedBy 등 컬렉션 처리 함수 활용

확장 함수로 기존 타입에 도메인 특화 기능 추가

when, ?:, ?. 등 Kotlin 표현식 적극 활용

대상 독자: Kotlin 환경 설정을 마친 개발자 선수 지식: 환경 설정

설치된 환경에서 Kotlin의 핵심 기능을 직접 실행하며 익힙니다. 각 예제는 src/main/kotlin/ 아래에 파일을 만들어 실행합니다.

Step 1 — Hello Kotlin#

가장 간단한 Kotlin 프로그램부터 시작합니다.

Spring Boot 연동

d8lzz1gpw@mozmail.com (kimbenji) — Wed, 13 May 2026 00:00:00 +0000

소요 시간: 약 20분

TL;DR

start.spring.io에서 Kotlin + Spring Web + Spring Data JPA 선택

build.gradle.kts에 kotlin-spring, kotlin-jpa 플러그인 필수

JPA 엔티티에 open 클래스 이슈 → kotlin-jpa 플러그인이 자동 해결

@RestController, @Service, @Entity 모두 Kotlin 방식으로 작성 가능

대상 독자: Kotlin 기초와 Spring Boot 경험이 있는 개발자 선수 지식: 환경 설정, Spring Boot 기초

Kotlin과 Spring Boot 3.2.x를 연동하여 간단한 사용자 관리 REST API를 구축합니다.

Step 1 — 프로젝트 생성#

start.spring.io에서 프로젝트를 생성합니다.

Kafka 연동

d8lzz1gpw@mozmail.com (kimbenji) — Wed, 13 May 2026 00:00:00 +0000

소요 시간: 약 25분

TL;DR

spring-kafka 의존성 추가 후 application.yml 설정

KafkaTemplate<String, String>으로 메시지 발행

@KafkaListener(topics = ["..."], groupId = "...")로 메시지 수신

Consumer Group 네이밍 규칙: {app-name}-group

대상 독자: Kotlin + Spring Boot 기초를 이해한 개발자 선수 지식: Spring Boot 연동, Kafka 기초

Kotlin과 Spring Kafka를 사용하여 메시지를 발행하고 수신하는 예제를 구현합니다. 이 예제는 사이트의 docker/ 디렉토리에 있는 Kafka(KRaft 모드, 포트 9092)를 사용합니다.

Step 1 — Kafka 브로커 실행#

# 프로젝트 루트에서
cd docker
docker-compose up -d

# 상태 확인
docker-compose ps

정상 실행 시 kafka 컨테이너가 Up 상태여야 합니다.

코루틴 실무 사용

d8lzz1gpw@mozmail.com (kimbenji) — Wed, 13 May 2026 00:00:00 +0000

소요 시간: 약 30분

TL;DR

async { } + await() — 두 API를 병렬 호출, 직렬 대비 속도 향상

suspend fun을 @GetMapping에 사용하면 Spring MVC에서 코루틴 컨트롤러 동작

withTimeout(ms) { } — 타임아웃 지정, 초과 시 TimeoutCancellationException

구조화된 동시성 — 부모 코루틴이 취소되면 자식 코루틴도 자동 취소

대상 독자: Kotlin 기초와 Spring Boot 경험이 있는 개발자 선수 지식: Spring Boot 연동, 코루틴 기초 개념

코루틴을 실무 시나리오에 적용합니다. 두 외부 API를 병렬 호출하고, Spring MVC 컨트롤러에서 suspend fun을 사용하며, 타임아웃과 취소 전파를 다룹니다.

Multiplatform 시작

d8lzz1gpw@mozmail.com (kimbenji) — Wed, 13 May 2026 00:00:00 +0000

소요 시간: 약 30분

TL;DR

commonMain — 모든 플랫폼에서 공유하는 Kotlin 코드

expect — 공통 모듈에서 선언, actual — 각 플랫폼에서 구현

jvmMain, jsMain — 플랫폼 특화 코드

한 번 작성한 비즈니스 로직을 JVM(백엔드/Android)과 JS(프론트엔드)에서 재사용

대상 독자: Kotlin 중급 이상의 개발자 선수 지식: 환경 설정, 기본 Kotlin 문법

Kotlin Multiplatform(KMP)으로 비즈니스 로직을 여러 플랫폼에서 공유합니다. 날짜 포매터를 공통 모듈로 작성하고, JVM과 JS에서 각각 구현하는 미니 프로젝트를 진행합니다.

Step 1 — 프로젝트 구조 이해#

KMP 프로젝트에서 코드는 소스 세트(source set)로 구성됩니다.