Package io.micronaut.data.repository.async

Interface AsyncCrudRepository<E,ID>

Type Parameters:
E - The entity type
ID - The ID type
All Superinterfaces:
GenericRepository<E,ID>
All Known Subinterfaces:
AsyncPageableRepository<E,ID>
public interface AsyncCrudRepository<E,ID> extends GenericRepository<E,ID>
Asynchronous variation of CrudRepository.
Since:
1.0.0
Author:
graemerocher

  • Method Details

    • save

      @NonNull <S extends E> @NonNull CompletableFuture<S> save(@NonNull S entity)
      Saves the given valid entity, returning a possibly new entity representing the saved state.
      Type Parameters:
      S - The generic type
      Parameters:
      entity - The entity to save. Must not be null.
      Returns:
      The saved entity will never be null.

    • update

      @NonNull <S extends E> @NonNull CompletableFuture<S> update(@NonNull S entity)
      This method issues an explicit update for the given entity. The method differs from save(Object) in that an update will be generated regardless if the entity has been saved previously or not. If the entity has no assigned ID then an exception will be thrown.
      Type Parameters:
      S - The generic type
      Parameters:
      entity - The entity to updated. Must not be null.
      Returns:
      The updated entity will never be null.

    • updateAll

      @NonNull <S extends E> @NonNull CompletableFuture<? extends Iterable<S>> updateAll(@NonNull @NonNull Iterable<S> entities)
      This method issues an explicit update for the given entities. The method differs from saveAll(Iterable) in that an update will be generated regardless if the entity has been saved previously or not. If the entity has no assigned ID then an exception will be thrown.
      Type Parameters:
      S - The generic type
      Parameters:
      entities - The entities to update. Must not be null.
      Returns:
      The updating entity will never be null.

    • saveAll

      @NonNull <S extends E> @NonNull CompletableFuture<? extends Iterable<S>> saveAll(@NonNull @NonNull Iterable<S> entities)
      Saves all given entities, possibly returning new instances representing the saved state.
      Type Parameters:
      S - The generic type
      Parameters:
      entities - The entities to saved. Must not be null.
      Returns:
      The saved entities objects. will never be null.

    • findById

      @NonNull @NonNull CompletableFuture<E> findById(@NonNull ID id)
      Retrieves an entity by its id.
      Parameters:
      id - The ID of the entity to retrieve. Must not be null.
      Returns:
      the entity with the given id or null
      Throws:
      EmptyResultException - if no entity exists for the ID

    • existsById

      @NonNull @NonNull CompletableFuture<Boolean> existsById(@NonNull ID id)
      Returns whether an entity with the given id exists.
      Parameters:
      id - must not be null.
      Returns:
      true if an entity with the given id exists, false otherwise.

    • findAll

      @NonNull @NonNull CompletableFuture<? extends Iterable<E>> findAll()
      Returns all instances of the type.
      Returns:
      all entities

    • count

      @NonNull @NonNull CompletableFuture<Long> count()
      Returns the number of entities available.
      Returns:
      the number of entities

    • deleteById

      @NonNull @NonNull CompletableFuture<Void> deleteById(@NonNull ID id)
      Deletes the entity with the given id.
      Parameters:
      id - must not be null.
      Returns:
      A future that executes the delete operation

    • delete

      @NonNull @NonNull CompletableFuture<Void> delete(@NonNull E entity)
      Deletes a given entity.
      Parameters:
      entity - The entity to delete
      Returns:
      A future that executes the delete operation

    • deleteAll

      @NonNull @NonNull CompletableFuture<Void> deleteAll(@NonNull @NonNull Iterable<? extends E> entities)
      Deletes the given entities.
      Parameters:
      entities - The entities to delete
      Returns:
      A future that executes the delete operation

    • deleteAll

      @NonNull @NonNull CompletableFuture<Void> deleteAll()
      Deletes all entities managed by the repository.
      Returns:
      A future that executes the delete operation