WEB+DB PRESS Vol.106の「速習 Spring Boot」を読んだ

Spring Framework に入門2日め、という位置づけ。
前回

の最後にもあった通り、最近の WEB+DB PRESS でちょうど Spring Boot 特集があったようなので読んだ。

感想

前回、Spring Framework や Spring Boot について苦労しながら公式ドキュメントを漁った経験からすると
これから Spring Framework に入門する人が最初に目を通しておく本としてとても良いのではないかと思いました。

第1章では Spring Framework とはなにか、から始まり、Spring Boot の特徴や Spring Framework との関係性について順を追って説明されています。

第2章では Spring Boot の基本的な構成や各用語の説明があり、第3, 4章で2つのサンプルアプリを実際に作ります。

最後の第5章では作成したアプリを本番環境で運用するための Tips として、Vagrant による仮想環境を使ったアプリ構築手順や、本番稼働しているアプリのヘルスチェック、バージョン管理方法などが紹介されています。

ソースコード

本書のサポートページからダウンロードできるほか、自分でも写経したものを前回と同じリポジトリに上げておきます。

https://github.com/zaki-yama/spring-framework-study/tree/master/wdpress106-spring-boot

この書籍で学べること／学べないこと

学べること

Spring Framework, Spring Boot とはなにか
Spring Boot の全体構成
以下の用語に対するざっくりとした理解
- テンプレートエンジン Thymeleaf
- Lombok
- H2 Database
- JPA (Java Persistance API), Spring Data
基本的なアプリの作り方
ビルドしたアプリの起動方法、実際のサーバーで運用するために必要な手順

学べないこと

Maven, Gradle の使い方、設定ファイルの書き方

サンプルアプリは Maven で書かれています。
私は Gradle で書いたので、同じように Gradle でやりたいという方は ↑の GitHub のコードが参考になれば。

また、今回は STS (Spring Tool Suite) という IDE を使って開発を進める想定で、新規プロジェクトのひな形に Maven の設定ファイルも含まれるため、中身について詳しい説明はありません。 (なお、Spring Initializr というツールを使えば IDE を使わなくてもひな形を生成できるため、好きなエディタで開発することは可能です)

Spring Boot の各アノテーションが何をやっているかの詳細

一部を除いて、各アノテーションの実際の処理までは説明されていません。
「こういう責務のクラスに対してこういうアノテーションをつけるんだー」とおまじない的に覚える感じです。

実際のデータベースを使ってデータを永続化する方法

サンプルでは H2 というデータベースを使い、アプリをシャットダウンするとデータは削除されます。
データベースにデータを保存するために必要な手順については触れられていませんでした。

学習メモ

第1章

Spring Boot の特徴
- 実装はコンポーネント
  - DDD の影響を受けており、コンポーネントを意識した実装を行う
- 設定はアノテーション
  - 従来は XML
- 成果物はワンバイナリ
  - ビルドした成果物は1つのJARとしてアーカイブされる
  - ファイルサイズが大きくなるが、可搬性が高い

第2章

コントローラー、サービス、リポジトリなどを「コンポーネント」とみなし、これらコンポーネントを組み合わせてアプリを作るイメージ
Spring Data: データベース(Spring Boot では「データストア」として扱う) を操作するためのプロジェクト
H2 Database(H2DB): MySQL, PostgreSQL などと同じく RDB 系のデータベース
JPA: Java Persistence API の略。永続化に関する仕様
Spring Data JPA: JPA の仕様をサポートした O/R マッピングフレームワーク
ドメイン
- DBとのやりとりを行うために用意するデータモデル
- RDB 系のDBの場合、テーブルごとにクラスを用意し、 @Entity のアノテーションをクラスに付与する
- コメント：「エンティティ」という言葉の方が直感的では？
リポジトリ
- ドメインをデータベースに永続化する処理を制御する
サービス
- ビジネスロジックを処理し、処理した結果を次に出てくるコントローラに届ける
コントローラ
- ユーザーのリクエストに応じてルーティングを行う

リポジトリ、サービス、コントローラは対応するアノテーションが提供されている。クラスに対してアノテーションを付与することで、Spring Boot が自動的に Bean として登録する。 (従来の Spring Framework ではXML で行っていた部分)

テンプレートエンジン(Thymeleaf)
- ビュー機能を実現するテンプレートエンジンとして FreeMaker/Groovy/Thymeleaf/Mustache をサポートしている。

第3, 4章

Gradle で依存追加

org.webjars とは
- クライアントサイドのライブラリを依存解決できるようにしたもの
  - WebJars 使い方メモ - Qiita
- ので、バージョンの指定が必須

dependencies {
    implementation('org.webjars:bootstrap:4.1.0')
}

指定しないと以下のエラーが出る。

> Could not find org.webjars:bootstrap:.
  Required by:
      project :

@SpringBootApplication の内部は以下の3つのアノテーションを持っている

@EnableAutoConfiguration
- Spring Boot の自動設定項目を行うアノテーション
@ComponentScan
- @Component ( @Controller / @Service / @Repository など) の読み取りを行うアノテーション
@Configuration
- 設定を許可し、Bean を登録できるようにするアノテーション