Kotlinサーバーサイド入門：IntelliJ IDEAとGradleでREST API構築 (2024)

Contents

1 はじめに
2 Kotlin とサーバーサイド開発の特徴
- 2.1 安全性とモダン機能がもたらすメリット
- 2.2 Java 互換と豊富なエコシステム
3 開発環境のセットアップ
- 3.1 JDK と IDE の準備
- 3.2 Gradle Kotlin DSL の基本設定
4 プロジェクト雛形作成と主要ライブラリの導入
5 実装例：REST API・データベース・DI・関数型プログラミング
6 コンテナ化と CI/CD
- 6.1 Dockerfile 作成のポイント
- 6.2 GitHub Actions による簡易 CI
7 デバッグ・運用のコツ
8 学習リソース（公式・汎用）
9 まとめ

スポンサードリンク

はじめに

サーバーサイド開発を初めて触れる方でも、IntelliJ IDEA と Gradle（Kotlin DSL） があれば数時間で動く Kotlin API を作れます。本稿では、Kotlin の安全性・モダン機能と Java 互換エコシステムを活かしながら、実務に近い形で Spring Boot ベースの REST アプリケーションを構築する手順を包括的に解説します。

Kotlin とサーバーサイド開発の特徴

安全性とモダン機能がもたらすメリット

Null安全 – コンパイラが null 参照可能性を検査するため、実行時の NullPointerException が大幅に減ります。
kotlin val name: String = user.name ?: return // 安全に代入
型推論と拡張関数 – 冗長な型宣言が不要になり、コードが簡潔になります。
kotlin fun List<Int>.sumIfPositive() = filter { it > 0 }.sum()
コルーチンによる非同期処理 – スレッドブロッキングを回避しつつ、直感的な記述が可能です。

これらの特性は、エラー検出が早期に行えるだけでなく、保守性の高いサービス実装につながります。

Java 互換と豊富なエコシステム

Kotlin は JVM 上で動作し、既存の Spring Boot・Hibernate といった成熟したライブラリをそのまま利用できます。
依存関係の追加がシンプル – Gradle の implementation に文字列を書くだけで OK。
IDE のサポートが充実 – IntelliJ は Kotlin をネイティブに扱い、コード補完・リファクタリングが高速です。

この相互運用性により、Java で培ったノウハウを活かしつつ Kotlin のモダンさで開発効率を向上させられます。

開発環境のセットアップ

JDK と IDE の準備

項目	手順・ポイント
JDK	LTS 版（現在は 17 系）をインストールし、`JAVA_HOME` を設定。Ubuntu の例: `sudo apt install openjdk-17-jdk`
IntelliJ IDEA	Community Edition でも Kotlin プラグインが組み込まれているので、インストール後に「File → Settings → Plugins」から有効化を確認

Gradle Kotlin DSL の基本設定

プロジェクトの build.gradle.kts は次のように記述します（バージョンは 最新安定版 を使用）。

plugins {
    kotlin(&quot;jvm&quot;)
    id(&quot;org.springframework.boot&quot;)          // Spring Boot 用プラグイン
    id(&quot;io.spring.dependency-management&quot;)  // 依存バージョン管理
}

java.sourceCompatibility = JavaVersion.VERSION_17

repositories {
    mavenCentral()
}

plugins {

kotlin("jvm")

id("org.springframework.boot") // Spring Boot 用プラグイン

id("io.spring.dependency-management") // 依存バージョン管理

}

java.sourceCompatibility = JavaVersion.VERSION_17

repositories {

mavenCentral()

}

このスクリプトを IntelliJ の「New Project」から作成すれば、ビルド環境が自動的に整います。

プロジェクト雛形作成と主要ライブラリの導入

Spring Boot を選択した理由

エコシステムの成熟度 – 多数のスターターパッケージが用意され、設定不要で機能を追加できる。
企業実装例が豊富 – 大規模サービスでも実績があるため、学習コストとリスクが低い。

軽量フレームワーク（Ktor 等）も魅力的ですが、DI やデータアクセスのプラグインが少なく、入門者にはややハードルが高くなります。

初期化コマンドとディレクトリ構成

gradle init --type kotlin-application   # Kotlin DSL プロジェクト作成

1 2	gradle init --type kotlin-application # Kotlin DSL プロジェクト作成

生成された src/main/kotlin 配下に以下のパッケージ構造を作ります。

com.example.demo
 ├─ Application.kt        // エントリポイント
 ├─ controller/
 ├─ repository/
 └─ service/

com.example.demo

├─ Application.kt // エントリポイント

├─ controller/

├─ repository/

└─ service/

主なライブラリの追加例（バージョンは最新）

dependencies {
    implementation(&quot;org.springframework.boot:spring-boot-starter-web&quot;)
    implementation(&quot;com.fasterxml.jackson.module:jackson-module-kotlin&quot;)
    implementation(&quot;org.jetbrains.kotlin:kotlin-reflect&quot;)

    // DI (Koin または Dagger)
    implementation(&quot;io.insert-koin:koin-core&quot;)          // Koin
    // implementation(&quot;com.google.dagger:dagger&quot;)      // Dagger2（別途 kapt が必要）

    // 関数型プログラミング支援
    implementation(&quot;io.arrow-kt:arrow-core&quot;)

    // コンパイル時処理 (KSP)
    ksp(&quot;io.arrow-kt:arrow-optics-ksp-plugin&quot;)

    testImplementation(&quot;org.springframework.boot:spring-boot-starter-test&quot;)
}

dependencies {

implementation("org.springframework.boot:spring-boot-starter-web")

implementation("com.fasterxml.jackson.module:jackson-module-kotlin")

implementation("org.jetbrains.kotlin:kotlin-reflect")

// DI (Koin または Dagger)

implementation("io.insert-koin:koin-core") // Koin

// implementation("com.google.dagger:dagger") // Dagger2（別途 kapt が必要）

// 関数型プログラミング支援

implementation("io.arrow-kt:arrow-core")

// コンパイル時処理 (KSP)

ksp("io.arrow-kt:arrow-optics-ksp-plugin")

testImplementation("org.springframework.boot:spring-boot-starter-test")

}

ksp や kapt を使用する場合は、プラグインブロックに対応エントリを追加してください。

実装例：REST API・データベース・DI・関数型プログラミング

Hello World API とテスト

@RestController
@RequestMapping(&quot;/api&quot;)
class HelloController {
    @GetMapping(&quot;/hello&quot;)
    fun hello(@RequestParam name: String = &quot;World&quot;): Map&lt;String, String&gt; =
        mapOf(&quot;message&quot; to &quot;Hello, $name!&quot;)
}

@RestController

@RequestMapping("/api")

class HelloController {

@GetMapping("/hello")

fun hello(@RequestParam name: String = "World"): Map<String, String> =

mapOf("message" to "Hello, $name!")

}

テストは Kotest の ShouldSpec で記述し、./gradlew test で実行できます。

class HelloControllerTest : ShouldSpec({
    val client = TestRestTemplate()
    should(&quot;return greeting&quot;) {
        val response = client.getForEntity(&quot;/api/hello?name=Kotlin&quot;, String::class.java)
        response.statusCodeValue shouldBe 200
        response.body?.shouldContain(&quot;Hello, Kotlin&quot;)
    }
})

class HelloControllerTest : ShouldSpec({

val client = TestRestTemplate()

should("return greeting") {

val response = client.getForEntity("/api/hello?name=Kotlin", String::class.java)

response.statusCodeValue shouldBe 200

response.body?.shouldContain("Hello, Kotlin")

}

})

JPA + H2 での CRUD 実装

@Entity
data class Todo(
    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    val id: Long = 0,
    var title: String,
    var completed: Boolean = false
)

interface TodoRepository : JpaRepository&lt;Todo, Long&gt;

@Entity

data class Todo(

@Id @GeneratedValue(strategy = GenerationType.IDENTITY)

val id: Long = 0,

var title: String,

var completed: Boolean = false

)

interface TodoRepository : JpaRepository<Todo, Long>

コントローラはシンプルな CRUD を提供します。

@RestController
@RequestMapping(&quot;/todos&quot;)
class TodoController(private val repo: TodoRepository) {

    @GetMapping fun list() = repo.findAll()

    @PostMapping fun create(@RequestBody dto: TodoDto) =
        repo.save(Todo(title = dto.title))

    @PutMapping(&quot;/{id}&quot;) fun update(
        @PathVariable id: Long,
        @RequestBody dto: TodoDto
    ) = repo.findById(id).map {
        it.title = dto.title
        it.completed = dto.completed
        repo.save(it)
    }.orElseThrow { ResponseStatusException(HttpStatus.NOT_FOUND) }
}

@RestController

@RequestMapping("/todos")

class TodoController(private val repo: TodoRepository) {

@GetMapping fun list() = repo.findAll()

@PostMapping fun create(@RequestBody dto: TodoDto) =

repo.save(Todo(title = dto.title))

@PutMapping("/{id}") fun update(

@PathVariable id: Long,

@RequestBody dto: TodoDto

) = repo.findById(id).map {

it.title = dto.title

it.completed = dto.completed

repo.save(it)

}.orElseThrow { ResponseStatusException(HttpStatus.NOT_FOUND) }

}

application.yml に H2 設定を入れれば、起動時にコンソールで DB コンテンツが確認できます。

DI コンテナの比較と設定例

項目	Koin	Dagger 2
学習コスト	DSL が直感的で初心者向き	アノテーション中心でややハードル高め
ランタイムオーバーヘッド	ほぼなし（軽量）	コンパイル時解決のため実質ゼロ
ビルド時間への影響	小さい	`kapt` が走る分、若干長くなる

Koin の設定例

val appModule = module {
    single&lt;TodoRepository&gt; { TodoRepositoryImpl() }
    factory { TodoService(get()) }
}

val appModule = module {

single<TodoRepository> { TodoRepositoryImpl() }

factory { TodoService(get()) }

}

Application.kt で起動します。

fun main(args: Array&lt;String&gt;) {
    startKoin { modules(appModule) }
    runApplication&lt;DemoApplication&gt;(*args)
}

fun main(args: Array<String>) {

startKoin { modules(appModule) }

runApplication<DemoApplication>(*args)

}

Dagger 2 の設定例（概略）

@Singleton
@Component(modules = [AppModule::class])
interface AppComponent {
    fun inject(controller: TodoController)
}

@Module
object AppModule {
    @Provides @Singleton
    fun provideTodoRepository(): TodoRepository = TodoRepositoryImpl()
}

@Singleton

@Component(modules = [AppModule::class])

interface AppComponent {

fun inject(controller: TodoController)

}

@Module

object AppModule {

@Provides @Singleton

fun provideTodoRepository(): TodoRepository = TodoRepositoryImpl()

}

@Inject コンストラクタを利用すれば、DI が自動的に解決されます。

Arrow を使った関数型エラーハンドリング

fun findTodo(id: Long): Either&lt;NotFoundError, Todo&gt; =
    repo.findById(id).toOption()
        .toEither { NotFoundError(&quot;Todo $id not found&quot;) }

data class NotFoundError(val message: String) : Throwable(message)

fun findTodo(id: Long): Either<NotFoundError, Todo> =

repo.findById(id).toOption()

.toEither { NotFoundError("Todo $id not found") }

data class NotFoundError(val message: String) : Throwable(message)

コントローラ側での利用例

@GetMapping(&quot;/{id}&quot;)
fun get(@PathVariable id: Long): ResponseEntity&lt;Any&gt; =
    findTodo(id).fold(
        { ResponseEntity.status(HttpStatus.NOT_FOUND).body(it.message) },
        { ResponseEntity.ok(it) }
    )

@GetMapping("/{id}")

fun get(@PathVariable id: Long): ResponseEntity<Any> =

findTodo(id).fold(

{ ResponseEntity.status(HttpStatus.NOT_FOUND).body(it.message) },

{ ResponseEntity.ok(it) }

)

Either により例外が排除され、呼び出し側は必ず成功・失敗を明示的に扱うことになります。

コンテナ化と CI/CD

Dockerfile 作成のポイント

FROM eclipse-temurin:17-jdk-alpine   # 軽量かつ JDK 17 が標準装備
VOLUME /tmp
ARG JAR_FILE=build/libs/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT [&quot;java&quot;,&quot;-Dspring.profiles.active=prod&quot;,&quot;-jar&quot;,&quot;/app.jar&quot;]

FROM eclipse-temurin:17-jdk-alpine # 軽量かつ JDK 17 が標準装備

VOLUME /tmp

ARG JAR_FILE=build/libs/*.jar

COPY ${JAR_FILE} app.jar

ENTRYPOINT ["java","-Dspring.profiles.active=prod","-jar","/app.jar"]

ベースイメージは Alpine 系でサイズを抑える。
-Dspring.profiles.active で環境切替が可能。

ビルド・実行手順

./gradlew bootJar            # jar を生成
docker build -t kotlin-demo .
docker run -p 8080:8080 kotlin-demo

./gradlew bootJar # jar を生成

docker build -t kotlin-demo .

docker run -p 8080:8080 kotlin-demo

GitHub Actions による簡易 CI

name: CI

on:
  push:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Set up JDK 17
        uses: actions/setup-java@v3
        with:
          distribution: temurin
          java-version: '17'
      - name: Build &amp; Test
        run: ./gradlew clean build
      - name: Build Docker image
        run: docker build -t ghcr.io/${{ github.repository }}:${{ github.sha }} .

name: CI

on:

push:

branches: [ main ]

jobs:

build:

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v3

- name: Set up JDK 17

uses: actions/setup-java@v3

with:

distribution: temurin

java-version: '17'

- name: Build & Test

run: ./gradlew clean build

- name: Build Docker image

run: docker build -t ghcr.io/${{ github.repository }}:${{ github.sha }} .

ビルド → テスト → Docker イメージ作成 の流れが自動化され、プッシュごとに品質が担保されます。

デバッグ・運用のコツ

項目	推奨設定
IntelliJ のデバッグ構成	「Run/Debug Configurations」→「Spring Boot」テンプレートを選択し、`-Dspring.profiles.active=dev` を付与
インクリメンタルコンパイル	`Preferences > Build, Execution, Deployment > Compiler > Kotlin` で有効化するとビルドが高速化
典型的なエラー対策	NoSuchBeanDefinitionException → DI モジュール／Component のスキャン漏れを確認 ClassNotFoundException → 依存バージョンの不整合を `dependencyManagement` で統一

学習リソース（公式・汎用）

カテゴリ	推奨リンク
公式ドキュメント	Kotlin 公式サイト – Kotlin Language Documentation Spring Boot 公式 – Spring Boot Reference Guide
チュートリアル	JetBrains が提供する「Getting Started with Kotlin and Spring」 Arrow のガイド – Arrow Docs
書籍・ハンズオン	「Kotlin実践入門」（技術評論社）「Spring Bootで学ぶサーバーサイド開発」
動画・スライド	KotlinConf 公式 YouTube チャンネル（最新セッション）

まとめ

安全性とモダン機能 が Kotlin の最大の魅力。Null 安全や型推論、コルーチンでバグを減らしつつ開発効率が向上します。
Java エコシステムとの高い互換性 により、既存の Spring Boot 等のフレームワークをそのまま活用でき、学習コストが抑えられます。
環境構築は JDK 17 + IntelliJ IDEA + Gradle Kotlin DSL の組み合わせだけで完結。数ステップでプロジェクト雛形が作成できます。
DI（Koin / Dagger2）・関数型プログラミング（Arrow）・コンパイル時処理（KSP） を組み込めば、実務レベルのコードベースが構築可能です。
REST API → データベース CRUD → Docker コンテナ化 → CI/CD までを一連のフローとして示したので、手順どおりに進めれば本格的なサーバーサイドアプリが完成します。

この記事を参考に実際に手を動かすことで、Kotlin を用いたサーバーサイド開発の基礎と、現場で求められる技術スタック全体像を身につけることができます。ぜひ自分のプロジェクトで試してみてください。