Add Sample Api

[miyasama]

概要

サンプルとして、商品の検索APIと、ID指定の1件取得APIを追加しました。

詳細

以下の２つのサンプル相当のものを実装しました。

o LidoProductListAction.java
https://github.com/lastaflute/lastaflute-example-harbor/blob/master/src/main/java/org/docksidestage/app/web/lido/product/LidoProductListAction.java

o LidoProductDetailAction.java
https://github.com/lastaflute/lastaflute-example-harbor/blob/master/src/main/java/org/docksidestage/app/web/lido/product/LidoProductDetailAction.java

動作確認方法

以下のREADMEに記載の方法で、起動とSwaggerUIからの確認ができます。

https://github.com/dbflute-example/dbflute-example-on-quarkus/blob/master/README.md?plain=1#L38-L40

[jflute]

技術的な質問だけー

[jflute]

純粋な技術の質問。LastaFluteのexampleだと、@Validは変数自体に付けてるけど、Genericの方に付けても挙動って同じってことなのかな？

LastaFluteのexample:

@Valid
public final List<BEAN> rows;

[miyasama]

@jflute
試してみたところ、以下のどちらも同じ結果でした。

@Valid
public final List<BEAN> rows;

public final List<@Valid BEAN> rows;

ので、Lastaに合わせるように修正しました。
f9c2071

あと、Contollerのメソッドの戻り値にも @Validを付けないと、
レスポンスがバリデーションされなかったので、そちらも合わせて追加しました。

public @Valid SearchPagingResult<ProductRowResult> search(@BeanParam @Valid ProductSearchBody form) {

[jflute]

なるほど、LastaのExampleに合わせるで嬉しい、ありがとうー！
Genericにアノテーション付けられるって知らない人も多いだろうから、
挙動が同じであれば、変数自体に付けるほうが馴染みやすいかなとも思う。

一方で、レスポンスのBeanにもバリデーションできるんだ！？
こうできると便利って思ってるの自分だけかもしれない...とか思ってたので、
Quarkusも採用しているのは嬉しいね。

ただ、@Validを付けないとチェックされないってことで強制力は低めではあるんだの。
(Lastaはデフォルトで強制チェックなので)

[jflute]

publicフィールドスタイルなのは、Quarkusのスタンダードなのかな？

[miyasama]

@jflute
Quarkusの公式サイトの実装例とかを見ている感じだと、publicフィールドスタイルです。

Quarkusを使っている現場のスタンダードなのかは不明ですが、
うちのチームだとpublicフィールドスタイルにしています。

[jflute]

publicフィールドスタイルはSeasar文化みたいな認識の人もよくいるんだけど、
んなこたないよってことだね笑、よかったよかった（＾＾

[jflute]

あぷるーゔ、thanks