このページは、
https://www.jhipster.tech/entities-filtering/
のgoogle訳を、ほぼそのまま張り付けて、レイアウトを整えて、コメントを付けたものです。
翻訳時点での、JHIPSTERのバージョンは6です。
だれでも、編集可能です。気に入らなかったら修正してください。
基本的なCRUD機能がエンティティに実装された後は、エンティティの属性に対してさまざまなフィルタを作成するという非常に一般的な要求があるため、サーバーをより効果的に使用できます。これらのフィルタはリクエストパラメータとして送信する必要があります。そのため、どのクライアント(およびどのブラウザ)でも簡単に使用できます。さらに、これらのフィルタは、正当で簡潔なパターンに従うべきであり、それらを自由に組み合わせることを許可されなければなりません。
コマンドを使用してエンティティを生成するときは、
※windowsだと、powershellじゃないと、むり
jhipster entity 対象のエンティティ名
とすると、このエンティティでフィルタリングを有効にするためにサービスまたはサービス実装を選択メニューがでてきます。
既存のエンティティのフィルタリングを有効にしたい場合は
.jhipster
ファイルを設定します。
フィルタの設定範囲は、
JDLで使用する場合は次の一文をJDLに記入してください。
filter <entity name>
そして、次のコマンドで、再度jdlをインポートしなおしてください.
jhipster import-jdl 修正したJDLファイル
エンティティごとにエンティティジェネレータでフィルタリングを有効にし、その後、/api/my-entity以下のパラメータを使用してGETエンドポイントを呼び出すことができます。
もちろん、それらは自由に組み合わせることができます。
このフィルタAPIの表現力を体験する良い方法は、あなたのJHipsterアプリケーションのAPIドキュメントページのswagger-uiからそれを使うことです。
この機能を有効にするEntityQueryService?と、and という名前の新しいサービスEntityCriteria?が生成されます。SpringはリクエストパラメータをEntityCriteria?クラスのフィールドに変換します。
では、EntityQueryServicecriteria?オブジェクトを静的でタイプセーフなJPAクエリオブジェクトに変換します。そのためには、ビルドで静的メタモデル生成を有効にする必要があります。詳細は
JPA Static Metamodel Generator
のドキュメントを参照してください。
生成された基準が機能し、Springが適切に設定EntityResourceIntTest?されていることを証明するために、個々のフィルタごとに1つずつ、多数のテストケースが追加されています。
現在サポートされているのは(JPAを使用した)SQLデータベースのみで、個別のサービスまたは個別のサービス実装/インタフェースの組み合わせがあります。
翻訳はここまで、なんか、わかったようなわからないような。
entity BankAccount { name String, amount Double } service BankAccount with serviceClass filter BankAccount
ちなみに、filterは、アスタリスク表記OKみたい
https://github.com/jhipster/jdl-studio/issues/37