add SliceableRepository

[katagiri-kazumune]

概要

#2

内容

Service / Repository 向け
(実際に SQL を意識するのは spring-data-mirage 側の PR を参照)

• SliceableRepository
  • この PR のメイン
  • この interface を implement すると Slice を取得する SQL が発行可能
• Slice
  • Slice 形式の SQL 発行結果を保持する interface
  • 実装は SliceImpl
• Sliceable
  • SQL 発行時のパラメータの interface
  • 実装は SliceRequest

Controller 向け

• SlicedResources
  • Controller 側で意識する Value Object
  • レスポンス JSON の構成情報(Chunk で返す場合の ChunkedResources 相当)
• SliceableDefault
  • Controller のメソッドのパラメータとして設定するアノテーション(Chunk のパラメータを受け取る場合の @ChunkableDefault 相当)
  • デフォルト size=10, direction=ASC, page_number=0
• SliceableHandlerMethodArgumentResolver
  • Controller のリクエストを元に Sliceable インスタンスを生成する
  • WebMvcConfigurer の実装クラスで追加する必要がある
  • SpringDataSliceableAnnotationUtils はその Utils

[katagiri-kazumune]

JSON 文字列の比較で使用

[inabajunmr]

ページングで全部の値が取得できることが保証できない、まで書いちゃってよいかと（ソートにこだわらなければユニークでなくてもよいようにとられそう）

[katagiri-kazumune]

言い切りました。
0f6f479

[inabajunmr]

なんとなくサンプルまでのせちゃってよさそうという気持ちになりました

public class WebMvcConfiguration implements WebMvcConfigurer {

	@Override
	public void addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers) {
		argumentResolvers.add(new ChunkableHandlerMethodArgumentResolver());
		argumentResolvers.add(new SliceableHandlerMethodArgumentResolver());
	}
}	

[katagiri-kazumune]

書きました
0f6f479

[inabajunmr]

これNullのケースないような気がしますがどうでしょうか（コンストラクタ的にも仕様的にも）
https://github.com/classmethod/cmapi-five-rings/blob/24ebeff38f9f8a6ab257b23c30ab44a1f5e0f7f0/content/section2/pagination-offset.md

[katagiri-kazumune]

setter で設定できるからコンパイル的には...と思ったのですが、setter もデフォルトコンストラクタも撲滅で解決。
0f6f479

[katagiri-kazumune]

@inabajunmr
https://github.com/classmethod/cmapi-five-rings/pull/47/files/3eda71a4d1f0cdec945a27cbf7153914492f2e8a#r399915846
の実装が
47dcbd6
になります。

SliceableHandlerMethodArgumentResolver でチェックしても良かったのですが、エラーハンドリングが柔軟にできなさそうだったので(Controller に入る前に throw する)、spring-data-mirage 側で Sliceable#validate を呼び出す想定です。

[inabajunmr]

この観点のバリデーションエラーについては固定で400で良い気がしますが、SliceableHandlerMethodArgumentResolverだと困るのってどういうのを想定してますか？（もしくは実装がしづらい？）

mirageでやるようにするとControllerのハンドリング漏れで500返るとかそういうイベント起きそうだなあと

[katagiri-kazumune]

SliceableHandlerMethodArgumentResolverだと困る

直接 spring-data-mirage を呼んだ時のことを想定したのですが、SliceableHandlerMethodArgumentResolver でもチェックはしておいて良いとも思ったのでチェック処理追加してみました。

bd4bda3