Spring Boot Sample Application
ローカル環境
開発環境（IntelliJ）
必要なプラグイン・設定
- Lombok pluginをインストールする。
- Settings > Build, Excecution, Deployment > Compiler > Annotation Processor >
Enable Annotation ProcessingをONにする。
- Settings > Build, Excecution, Deployment > Compiler > Annotation Processor >
- bootRunを実行している場合でもビルドされるようにする。
- Intellij > Ctrl+Shift+A > type Registry... >
compiler.automake.allow.when.app.runningをONにする。
- Intellij > Ctrl+Shift+A > type Registry... >
- Windowsの場合は、コンソール出力が文字化けするため、
C:¥Program Files¥JetBrains¥IntelliJ Idea xx.x.x¥binの中にあるidea64.exe.vmoptionsファイルに-Dfile.encoding=UTF-8を追記する。 - ブラウザにLiveReload機能拡張をインストールする。
Dockerの起動
MySQLなどのサーバーを立ち上げる。
$ cd /path/to/spring-boot-doma2-sample
$ ./gradlew composeUpアプリケーションの起動
管理側
$ # admin application
$ cd /path/to/spring-boot-doma2-sample
$ ./gradlew :sample-web-admin:bootRunフロント側
$ # front application
$ cd /path/to/spring-boot-doma2-sample
$ ./gradlew :sample-web-front:bootRunバッチ
$ # 担当者情報取り込みバッチを起動する
$ cd /path/to/spring-boot-doma2-sample
$ ./gradlew :sample-batch:bootRun -Pargs="--job=importStaffJob"接続先情報
テストユーザー [email protected] / passw0rd
| 接続先 | URL |
|---|---|
| 管理側画面 | http://localhost:18081/admin |
| 管理側API | http://localhost:18081/admin/api/v1/users |
| フロント側 | http://localhost:18080/ |
データベース接続先
mysql -h 127.0.0.1 -P 3306 -uroot -ppassw0rd spring-boot-doma2-sampleブラウザを用いた自動テスト（結合テスト）
実行方法
| テスト対象 | 実行方法 |
|---|---|
| 管理側画面 | gradlew :it/sample-web-admin:test |
| フロント側 | gradlew :it/sample-web-front:test |
※ IntelliJから起動する場合は他のテストと同様にテストクラスを選択して実行してください
CIなどで結合テストを行わない場合は以下のようにして対象から外します
$ ./gradlew clean test --info -x :it/sample-web-admin:test -x :it/sample-web-front:testコード自動生成（おまけ）
$ cd /path/to/spring-boot-doma2-sample
$ ./gradlew codegen -PsubSystem=system -Pfunc=client -PfuncStr=取引先 [-Ptarget=dao|dto|repository|service|controller|html]参考
| プロジェクト | 概要 |
|---|---|
| Lombok Project | 定型的なコードを書かなくてもよくする |
| Springframework | Spring Framework |
| Spring Security | セキュリティ対策、認証・認可のフレームワーク |
| Doma2 | O/Rマッパー |
| spring-boot-doma2 | Doma2とSpring Bootを連携する |
| Flyway | DBマイグレーションツール |
| Thymeleaf | テンプレートエンジン |
| Thymeleaf Layout Dialect | テンプレートをレイアウト化する |
| WebJars | jQueryなどのクライアント側ライブラリをJARとして組み込む |
| ModelMapper | Beanマッピングライブラリ |
| Ehcache | キャッシュライブラリ |
| Spock | テストフレームワーク |
| Mockito | モッキングフレームワーク |