REST API サンプル

gradle based Spring Boot & @RestController & Swagger2 & Rest-Assured & MyBatis template project

2016-5-7 リリースノート

• Jackson ObjectMapper フィールドアクセスに設定

2016-5-1 リリースノート

• パッケージの意図を明確に
• パッケージ構造の整理と package-info.java の加筆修正
• 未使用でも、標準的なパッケージを追加

2016-4-29 リリースノート

• Swaggerを使った API ドキュメント生成／画面からのテストツールを組み込み
• API ドキュメントの表示 http://localhost:8080/swagger_ui.html

2016-4-27 リリース

概要

• JSONベースの REST API サンプル using Spring Boot @RestController
• 挨拶(greeting)の REQUESTとRESPONSE
• greeting の REQUEST の記録と、履歴(history)の参照

ビューモデル 層

モデル層とは別にビューモデル層を用意する。

• JSON <--> オブジェクトの変換用のクラス群
• モデル層は、ドメインの表現手段に専念する（JSONの構造から分離する）
• ビューモデルのオブジェクトのフィールドは、原則 public 宣言（jackson用）
• ビューモデルからモデルへの変換は、ビューモデルが責任を持つ
• モデルからビューモデルへの変換も、ビューモデルが責任を持つ

End to End integration test

Spring の @WebIntegrationTest を使い End to End のAPI テストを組み込む。

gradle test タスクまたは、IntelliJ Idea の Run テスト

REST-Assured

テストは、REST-Assured を使って記述する。 (Java DSL for easy testing of REST services)

###参考ドキュメント REST Assured Usage

##実行方法 ###アプリケーション起動 ./gradlew clean bootRun

http://localhost:8080/greeting?name=masuda JSON POST での実行方法は、API ドキュメントを参照 ###テスト ./gradlew test