For AI agents: the complete documentation index is available at /Practical-Introduction-to-Spring-Boot/llms.txt, the full documentation bundle is available at /Practical-Introduction-to-Spring-Boot/llms-full.txt, and this page is available as Markdown at /Practical-Introduction-to-Spring-Boot/introduction.md.

はじめに

概要

Spring Boot を使った Web アプリケーション開発の基本を、コード例とハンズオンで学ぶ教材です。 普段あまり意識せずに使っている機能について、なぜそう書くのか、どこまで気にすべきかをコード例で整理します。 明日からの実装やレビューが少し楽になることを目指します。

対象者と前提知識

Java のクラス、メソッド、コンストラクタ、例外を理解している方を対象にしています。 HTTP の GET / POST、リクエストとレスポンス、JSON の基本も確認しておくと読み進めやすくなります。 Spring Boot が初めてでも、最初のプロジェクト作成ハンズオンから学べます。

各ハンズオンのサンプルは、教材で指定したパッケージ名と依存関係を使って作成してください。パッケージ名の接頭辞は章によって異なります。 教材ごとに題材が異なるため、原則として別の Java プロジェクトを使います。 Spring Security 第2回は、第1回で作成したプロジェクトを続けて使います。 DB を含む統合テスト入門は、DB アクセス・トランザクション入門の最終段階のプロジェクトを使います。 Spring Security テスト入門は、独立したプロジェクトで進めます。 E2E テスト入門は、Spring Security 第2回の最終段階のプロジェクトを使います。 Actuator 入門は、DB アクセス・トランザクション入門で作った注文 API の完成版を使います。 リトライ入門は、外部 API 連携入門で作った送料照会アプリと模擬配送 API を使います。 Redis キャッシュ入門は、キャッシュ入門の商品価格 API の完成版を使います。

章別の前提

DB マイグレーションでは CREATE TABLE / ALTER TABLE、Spring Security 第2回では SELECT / INSERT の基礎が必要です。

DB アクセス・トランザクションでは SELECT / INSERT / UPDATE / DELETE の基礎が必要です。

Spring Session 入門、DB を含む統合テストの PostgreSQL 編、Actuator 入門、Redis キャッシュ入門では、Linux コンテナーを実行できる Docker 環境が必要です。

E2E テストでは Node.js 24・npm と Playwright 用ブラウザーが必要です。テストは TypeScript で記述します。

学習の進め方

以下の番号は、後の表の「段階」に対応します。複数の章を同じ段階にまとめる場合があります。 コンテンツ一覧の章番号との対応は、段階表の「章番号」で確認してください。

  1. プロジェクト作成で、API の実装・起動・設定・jar の実行を体験する。
  2. バリデーションで、不正な入力を処理の入口で止める方法を学ぶ。
  3. テスト入門でテストを実装し、開発者テスト入門でケースの選び方を整理する。
  4. バリデーションテストで、制約・HTTP・エラー応答を分けて検証する。
  5. ロギングと DB マイグレーションで、実行中の調査とデータベースの変更を学ぶ。
  6. DB アクセス・トランザクションで、CRUD と途中失敗時のロールバックを学ぶ。
  7. 例外処理・エラー応答で、業務上の失敗と想定外の失敗を共通の HTTP 応答にまとめる。
  8. RFC 9457 エラー返却で、独自の type を使って同じ HTTP ステータスでも問題の種類を区別し、複数の入力違反をまとめる方法を学ぶ。
  9. Spring Security 第1回・第2回で、認証・認可から DB を使うユーザー管理へ進む。
  10. Spring Security テストで、アクセスの許可・拒否とログイン・ログアウトを検証する。
  11. Spring Session 入門で、2 つのアプリから Redis に保存した HTTP セッションを参照し、無効化する。
  12. DB を含む統合テストで、API の応答と保存結果を H2・PostgreSQL で確認する。
  13. E2E テストで、ブラウザーからログイン・ユーザー登録・ログアウトを自動検証する。
  14. Actuator 入門で、注文 API の DB 障害をヘルスチェックで検知し、メトリクスとログで影響を調べる。
  15. 定期実行入門で、@Scheduled を使って処理を繰り返し、開始と終了のログで間隔を比べる。
  16. 外部 API 連携入門で、RestClient を使って配送 API を呼び出し、HTTP エラーとタイムアウトを扱う。
  17. リトライ入門で、配送 API を再試行する条件、回数の上限、試行間の待ち時間を確かめる。
  18. キャッシュ入門で、同じ商品の再取得を省き、価格を更新したときに該当するキャッシュを無効化する。
  19. Redis キャッシュ入門で、価格更新によるキーの削除と TTL による期限切れを確認する。

段階 16〜19(コンテンツ一覧の第20〜23章)は クライアントシリーズ です。外部 API 連携からリトライへ進みます。キャッシュ入門と Redis キャッシュ入門は共通のプロジェクトで演習します。

AI に TDD を実践させる進め方を学ぶ場合は、テスト入門の後に おまじないから始める AI 駆動型 TDD 入門 へ進んでください。本編は環境構築なしで読めます。付録の演習では、独立した Java プロジェクトと AI コーディング支援ツールを使います。

テストの目的から知りたい方は、開発者テスト入門をテスト入門より先に読んでも構いません。 例外処理・エラー応答の内容を踏まえ、次の RFC 9457 の章では仕様に沿った応答形式の設計を 90 分で学びます。 AOP、独自制約、構造化ログ、並行開発の運用は発展内容です。まず基本の動作確認まで進めてから戻りましょう。 例外処理・エラー応答は独立したプロジェクトで進めるため、DB の設定なしでも学べます。

コマンドと動作確認の読み方

Maven のコマンドは、各演習用 Java プロジェクトの pom.xml があるディレクトリで実行します。 E2E テストの npm / Playwright コマンドは、同章の手順に沿って作成した e2e ディレクトリで実行します。 シェルの例は Bash を前提にしています。Windows PowerShell では、Maven の ./mvnw を .\mvnw.cmd に読み替えてください。 Maven に渡す -D 引数は、PowerShell では引数全体を引用符で囲みます。例は .\mvnw.cmd '-Dtest=UserUtilTest' test です。 PowerShell で単純な GET リクエストを送る場合は、curl.exe を使います。 JSON を引数として渡す例や、行末に \ を使う複数行のコマンドは、Windows では Git Bash で実行してください。

アプリ起動後は別のターミナルからリクエストを送り、HTTP ステータス・本文・ログを確認します。 停止は Ctrl+C です。設定変更後や再起動の説明がある箇所では、前のプロセスを停止してから起動し直してください。 8080 番ポートを使うアプリを同時に起動すると競合するため、ハンズオンを切り替えるときも停止します。

Spring Boot のハンズオンでは 4.0 系を使います。 Spring Initializr を設定済みリンクから開いた場合も、生成前に Spring Boot の欄を確認してください。 本文の指定版を選べない場合は、利用可能な 4.0 系の安定版を選び、生成された依存関係を確認します。 Security の配布 ZIP は Java 25 指定なので、第1回の手順で pom.xml を Java 21 に変更してから起動します。

勉強会の単位と事前準備

次の時間は、初回説明と動作確認を含む目安です。受講者の経験に合わせて分割してください。 本教材の推奨環境は JDK 21 です。新規プロジェクトを作成するときも、Java は 21 を選択してください。 開始前に JDK 21 の準備と Maven の依存取得を済ませ、新規作成する章では指定のプロジェクトを用意します。前の章を引き継ぐ場合は「対象者と前提知識」の指定に従ってください。 Security は ZIP と Java 設定を確認します。Docker を使う章では、Docker の起動とイメージ取得も事前に確認します。 各章の「講義の区切り」で基本の終了条件を確認し、発展内容は復習や次回へ回せます。

段階番号が同じ行は、同じ学習段階に含まれます。テスト入門と開発者テスト入門は、どちらから始めても構いません。 ロギングと DB マイグレーションは独立した演習です。Spring Security は第1回、第2回の順に進めてください。

段階章番号章基本の終了条件目安(分)発展・次回
11プロジェクト作成・デプロイ入門API 起動・設定変更・jar 実行60デプロイ環境の比較
22バリデーション入門不正入力を400で拒否90独自制約・多言語対応
33テスト入門Util と Service のテストを実行90Repository・Controller(60 分)、章内のテスト設計演習(20〜30 分)
34開発者テスト入門 - テストとは編同値分割と境界値でケースを選ぶ60状態遷移・Pairwise
35おまじないから始める AI 駆動型 TDD 入門AI に TDD を実践させるメリットと確認ポイントを説明する30付録:送料計算の TDD 演習(60〜90 分)
46バリデーションテストDTO の境界値と Web の400を検証90Advice の独立テスト
57ロギング入門アクセスログ・MDC・業務ログを確認90AOP・構造化ログ
58DB マイグレーション入門2本のマイグレーションと履歴を確認60並行開発・outOfOrder
69DB アクセス・トランザクション入門CRUD と登録失敗時のロールバックを確認120プロキシ境界、削除失敗は DB 統合テスト章で検証
710例外処理・エラー応答入門404・409・400・500の契約を確認90その他 MVC 例外・MockMvc の契約テスト
811RFC 9457 エラー返却入門同じ 409 の応答を比較し、入力違反をまとめる条件を説明90(API は事前準備)MockMvc・問題種別の登録と契約管理・メディアタイプ交渉
912Spring Security 入門 Vol.1ログイン・ログアウトとページの保護90認証の内部構成
913Spring Security 入門 Vol.2DB認証と管理者だけの登録を確認120本番運用と入力検証
1014Spring Security テスト入門許可・拒否・CSRF、ログイン・ログアウトを検証90存在しないユーザー、CSRF なしのログアウト、認可ルール変更
1115Spring Session 入門HTTP セッションを 2 つのアプリで共有し、無効化を確認60〜90アプリ再起動後のセッション参照
1216DB を含む統合テスト入門H2で保存と登録・削除失敗を検証(DB アクセス章の完成版が前提)90PostgreSQL 編(追加で 60 分)
1317E2E テスト入門ブラウザーでログイン・ユーザー登録・ログアウトを自動検証90権限差の検証・CIでの実行
1418Spring Boot Actuator 入門DB の停止・復旧を検知し、注文取得の件数と処理時間をステータス別に確認60〜90管理用エンドポイントの認証・認可
1519定期実行入門fixedRate と fixedDelay の実行間隔をログで比較45処理時間が設定間隔を超える場合
1620外部 API 連携入門配送 API から送料を取得し、HTTP エラーとタイムアウトを区別60〜90接続拒否の確認
1721リトライ入門配送 API の 503 を再試行し、回数の上限と待ち時間の影響を確認60
1822キャッシュ入門再取得の省略と、価格更新後のキャッシュの無効化を確認60別商品のキャッシュを確認
1923Redis キャッシュ入門更新による削除と TTL による期限切れを Redis のキーで確認60

全23章の基本編の目安を合計すると29時間15分〜30時間45分です。事前準備と発展演習の時間は別に確保してください。

テスト入門の発展演習では、実装したコードを使ってテストケースを選びます。開発者テスト入門では、同値分割や境界値分析の考え方を詳しく学びます。

コンテンツ一覧

  1. プロジェクト作成・デプロイ入門
  2. バリデーション入門
  3. テスト入門
  4. 開発者テスト入門 - テストとは編
  5. おまじないから始める AI 駆動型 TDD 入門
  6. バリデーションテスト
  7. ロギング入門
  8. DB マイグレーション入門
  9. DB アクセス・トランザクション入門
  10. 例外処理・エラー応答入門
  11. RFC 9457 エラー返却入門
  12. Spring Security 入門 Vol.1
  13. Spring Security 入門 Vol.2
  14. Spring Security テスト入門
  15. Spring Session 入門
  16. DB を含む統合テスト入門
  17. E2E テスト入門
  18. Spring Boot Actuator 入門
  19. 定期実行入門

クライアントシリーズ

  1. 外部 API 連携入門
  2. リトライ入門
  3. キャッシュ入門
  4. Redis キャッシュ入門