はじめに

JavaのSpringフレームワークはちょこちょこ触ってきた。
途中でPythonにどっぷり浮気して、FastAPIやFlaskでAPI作ったりもした。
でも「Spring Boot」は、なんとなく後回しにしてきた。

理由は正直シンプルで、「設定多そう」「重そう」というイメージ。
ですが、最近のJava案件では、Spring Bootが多いイメージになりました。
これはやらねば…と重い腰を上げました。

この記事は、「Javaは知ってるけどSpring Bootはほぼ初めて」なエンジニアのメモです。
環境はMac M1 Pro。まずはローカルで動かすところまでをまとめます。

対象読者

Java（Spring含む）は触ったことがある
PythonやFastAPIなど他言語のフレームワーク経験あり
Spring Bootはほぼ未経験
Mac M1 Pro使用中

環境

項目	バージョン
macOS	Sonoma 14.x（M1 Pro）
Java	21（LTS）
Spring Boot	4.0.6
ビルドツール	Maven
IDE	IntelliJ IDEA Community / VS Code

なぜJava 21？
Spring Boot 4.x系はJava 17以上が必須です。17・21どちらでも動きますが、安定したLTSバージョンとして広く普及している21を選択しました。

1. Javaのインストール

M1 MacではHomebrewで入れるのが最も楽です。

Homebrewがない場合はまず導入

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

SDKMANで管理する（おすすめ）

複数バージョンを切り替えたい場合はSDKMANが便利です。Pythonでいうpyenvのようなものです。

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# 利用可能なJavaを確認
sdk list java

# Java 21（Temurin）をインストール
# ※ sdk list java で表示される最新の21系パッチバージョンを選んでください
sdk install java 21.0.7-tem

# バージョン確認
java -version

openjdk version "21.0.7" 2025-04-15
OpenJDK Runtime Environment Temurin-21.0.7+6 (build 21.0.7+6)
OpenJDK 64-Bit Server VM Temurin-21.0.7+6 (build 21.0.7+6, mixed mode)

Homebrewで入れる場合

brew install openjdk@21
echo 'export PATH="/opt/homebrew/opt/openjdk@21/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. プロジェクトの雛形を作成する

Spring BootにはSpring Initializrというプロジェクト生成ツールがあります。
FastAPIのpip install fastapiしてサクッと書き始めるのと違い、Spring Bootはまず「プロジェクトの雛形」を作るところから始まります。

ブラウザから生成する場合

👉 https://start.spring.io にアクセス

以下のように設定します。

項目	設定値
Project	Maven
Language	Java
Spring Boot	4.0.6
Group	com.example
Artifact	demo
Packaging	Jar
Java	21

**Dependencies（依存関係）**に以下を追加：

Spring Web　← REST APIを作るのに必要
Spring Boot DevTools　← ホットリロード用（開発中に便利）
Lombok　← ボイラープレートコードを削減

「GENERATE」ボタンでzipをダウンロード → 任意の場所に展開。

CLIから生成する場合（Spring CLI）

# Spring CLIをSDKMANでインストール
sdk install springboot

# プロジェクト生成
spring init \
  --dependencies=web,devtools,lombok \
  --java-version=21 \
  --build=maven \
  --name=demo \
  demo

3. プロジェクト構成を確認する

demo/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/demo/
│   │   │       └── DemoApplication.java   ← エントリポイント
│   │   └── resources/
│   │       ├── application.properties     ← 設定ファイル
│   │       ├── static/
│   │       └── templates/
│   └── test/
│       └── java/
│           └── com/example/demo/
│               └── DemoApplicationTests.java
└── pom.xml                                ← 依存関係の定義（Mavenの場合）

Pythonとの比較で言うと：

Spring Boot	Python（FastAPI）
`pom.xml`	`pyproject.toml` / `requirements.txt`
`DemoApplication.java`	`main.py`
`application.properties`	`.env` / `config.py`

4. アプリを起動してみる

IDEで起動

IntelliJ IDEAなら DemoApplication.java を開いて、main メソッド左の▶ボタンをクリックするだけです。

ターミナルから起動

cd demo
./mvnw spring-boot:run

初回はMavenが依存関係をダウンロードするのでしばらくかかります（2〜3分程度）。

起動すると以下のようなログが流れます：

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_|_|_|_|_|\__, | / / / /
 =========|_|==============|___/=/_/_/_/

 :: Spring Boot ::                (v4.0.6)

... Started DemoApplication in 2.345 seconds (process running for 2.6)

http://localhost:8080 にアクセスして「Whitelabel Error Page」が表示されればOK！
（エンドポイントを何も定義していないので404相当のエラーページが出ますが、起動はできています）

5. はじめてのREST API

せっかくなのでシンプルなエンドポイントを作ってみましょう。

src/main/java/com/example/demo/ に HelloController.java を作成します。

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
public class HelloController {

    @GetMapping("/hello")
    public String hello(@RequestParam(defaultValue = "World") String name) {
        return "Hello, " + name + "!";
    }
}

アプリを再起動（DevToolsがあれば自動リロード）して：

curl http://localhost:8080/hello
# Hello, World!

curl "http://localhost:8080/hello?name=Taro"
# Hello, Taro!

Pythonで書くとこんな感じ（FastAPI）：

from fastapi import FastAPI

app = FastAPI()

@app.get("/hello")
def hello(name: str = "World"):
    return f"Hello, {name}!"

アノテーションの思想はほぼ同じですね。@RestController が app = FastAPI() に相当し、@GetMapping が @app.get() に相当するイメージです。

M1 Pro特有の注意点

アーキテクチャについて

M1 MacはARM64アーキテクチャです。Java 21（Temurin）はApple Silicon対応ビルドが提供されているので、上記の手順通りに入れれば問題なく動きます。

Dockerを使う場合

今後Docker上でSpring Bootを動かす場合、イメージのアーキテクチャに注意が必要です。

# docker-compose.yml
services:
  app:
    platform: linux/arm64   # M1の場合はこれを明示
    build: .

linux/amd64 のイメージを使うとRosetta 2経由になり、起動が遅くなります。

まとめ

やったこと	内容
Java 21インストール	SDKMANを使ってM1対応ビルドを導入
プロジェクト生成	Spring Initializrで雛形作成
アプリ起動	`./mvnw spring-boot:run` でローカル起動
REST API作成	`@RestController` でHello Worldエンドポイント

「設定多そう」「重そう」というイメージを持っていましたが、Spring Initializrのおかげでプロジェクト作成は拍子抜けするくらいシンプルでした。

Pythonと比べると型が明示的な分、コードが冗長に見えますが、Lombokを使うとだいぶスッキリするらしいので次回以降で試していきます。

次回は Spring Data JPAとPostgreSQLでDB連携 をやる予定です。