インターフェース CrudRepository<T,ID>
- すべてのスーパーインターフェース:
Repository<T,ID>
- すべての既知のサブインターフェース:
ListCrudRepository<T,ID>
特定の型のリポジトリに対する汎用 CRUD 操作のためのインターフェースです。このインターフェースを通じて公開されるメソッドにより、エンティティはライフサイクルイベントに参加でき、一部の一括操作メソッドを除き、適用可能な場合は楽観的ロックが適用されます。そのため、モジュールはイベント処理を容易にするために、エンティティを削除または更新する前にロードすることを選択する場合があります。また、変更メソッドの呼び出しは、楽観的ロックの失敗により例外をトリガーする可能性があります。
- 作成者:
- Oliver Gierke, Eberhard Wolff, Jens Schauder
メソッドのサマリー
修飾子と型メソッド説明longcount()利用可能なエンティティの数を返します。void指定されたエンティティを削除します。voidリポジトリによって管理されているすべてのエンティティを削除します。voiddeleteAll(IterableSE<? extends T> entities) 指定されたエンティティを削除します。voiddeleteAllById(IterableSE<? extends ID> ids) 指定された ID を持つ型Tのすべてのインスタンスを削除します。voiddeleteById(ID id) 指定された ID のエンティティを削除します。booleanexistsById(ID id) 指定された ID を持つエンティティが存在するかどうかを返します。findAll()型のすべてのインスタンスを返します。findAllById(IterableSE<ID> ids) 指定された ID を持つ型Tのすべてのインスタンスを返します。ID でエンティティを取得します。<S extends T>
Ssave(S entity) 指定されたエンティティを保存します。<S extends T>
IterableSE<S>saveAll(IterableSE<S> entities) 指定されたすべてのエンティティを保存します。
メソッドの詳細
save
指定されたエンティティを保存します。保存操作によってエンティティインスタンスが完全に変更された可能性があるため、返されたインスタンスをさらなる操作に使用します。- パラメーター:
entity- null であってはなりません。- 戻り値:
- 保存されたエンティティ。null になることはありません。
- 例外:
IllegalArgumentExceptionSE- 指定されたエンティティが null の場合。OptimisticLockingFailureException- エンティティが楽観的ロックを使用し、永続ストアで見つかった値とは異なる値のバージョン属性を持つ場合。エンティティが存在すると想定されているが、データベースに存在しない場合にもスローされます。
saveAll
指定されたすべてのエンティティを保存します。- パラメーター:
entities- null であってはならず、null を含んでもいけません。- 戻り値:
- 保存されたエンティティ。null になることはありません。返された Iterable は、引数として渡された Iterable と同じサイズになります。
- 例外:
IllegalArgumentExceptionSE- 指定されたentitiesSE またはそのエンティティの 1 つが null の場合。OptimisticLockingFailureException- 少なくとも 1 つのエンティティが楽観的ロックを使用し、永続ストアで見つかった値とは異なる値のバージョン属性を持つ場合。少なくとも 1 つのエンティティが存在すると想定されているが、データベースに存在しない場合にもスローされます。
findById
ID でエンティティを取得します。- パラメーター:
id- null であってはなりません。- 戻り値:
- 指定された ID を持つエンティティ、または見つからない場合は Optional#empty()
- 例外:
IllegalArgumentExceptionSE- id が null の場合。
existsById
指定された ID を持つエンティティが存在するかどうかを返します。- パラメーター:
id- null であってはなりません。- 戻り値:
- 指定された ID を持つエンティティが存在する場合は true、そうでない場合は false。
- 例外:
IllegalArgumentExceptionSE- id が null の場合。
findAll
IterableSE<T> findAll()型のすべてのインスタンスを返します。- 戻り値:
- すべてのエンティティ
findAllById
指定された ID を持つ型Tのすべてのインスタンスを返します。一部またはすべての ID が見つからない場合、これらの ID のエンティティは返されません。
結果の要素の順序は保証されないことに注意してください。
- パラメーター:
ids- null または null 値を含めることはできません。- 戻り値:
- null でないことが保証されています。サイズは、指定された ID の数以下にすることができます。
- 例外:
IllegalArgumentExceptionSE- 指定されたidsSE またはそのアイテムの 1 つが null の場合。
count
long count()利用可能なエンティティの数を返します。- 戻り値:
- エンティティの数。
deleteById
指定された ID のエンティティを削除します。永続ストアでエンティティが見つからない場合、エンティティは確認なしで無視されます。
- パラメーター:
id- null であってはなりません。- 例外:
IllegalArgumentExceptionSE- 指定された ID が null の場合OptimisticLockingFailureException- エンティティが楽観的ロックを使用し、永続ストアで見つかった値とは異なる値のバージョン属性を持つ場合。エンティティが存在すると想定されているが、データベースに存在しない場合にもスローされます。
delete
指定されたエンティティを削除します。- パラメーター:
entity- null であってはなりません。- 例外:
IllegalArgumentExceptionSE- 指定されたエンティティが null の場合。OptimisticLockingFailureException- エンティティが楽観的ロックを使用し、永続ストアで見つかった値とは異なる値のバージョン属性を持つ場合。エンティティが存在すると想定されているが、データベースに存在しない場合にもスローされます。
deleteAllById
指定された ID を持つ型Tのすべてのインスタンスを削除します。永続ストアで見つからないエンティティは、確認なしで無視されます。
- パラメーター:
ids- null であってはなりません。null 要素を含めることはできません。- 例外:
IllegalArgumentExceptionSE- 指定された ID またはその要素の 1 つが null の場合。OptimisticLockingFailureException- エンティティが楽観的ロックを使用し、永続ストアで見つかった値とは異なる値のバージョン属性を持つ場合。エンティティが存在すると想定されているが、データベースに存在しない場合にもスローされます。- 導入:
- 2.5
deleteAll
指定されたエンティティを削除します。- パラメーター:
entities- null であってはなりません。null 要素を含めることはできません。- 例外:
IllegalArgumentExceptionSE- 指定されたエンティティまたはそのエンティティの 1 つが null の場合。OptimisticLockingFailureException- 少なくとも 1 つのエンティティが楽観的ロックを使用し、永続ストアで見つかった値とは異なる値のバージョン属性を持つ場合。少なくとも 1 つのエンティティが存在すると想定されているが、データベースに存在しない場合にもスローされます。
deleteAll
void deleteAll()リポジトリによって管理されているすべてのエンティティを削除します。