Repository<T, ID> class abstract

A generic repository interface providing basic query and type information for entities of type T identified by ID.

This abstract class is meant to be extended by concrete repositories, such as CrudRepository, to provide additional query methods and persistence operations. Queries are delegated to an optional RepositoryExecutor, which can be used to implement database- or memory-backed operations.

Features

• Delegates query execution to a RepositoryExecutor.
• Supports multiple query result types: single entity, Iterable, List, Set.
• Provides type metadata for T and ID.

Usage Example

@Repository()
class UserRepository extends Repository<User, String> {
  Future<User?> getByUsername(String username) async => query();
  Future<List<User>> getAllActive() async => queryList();
}

final repo = UserRepository();
final user = await repo.query<User>();
final users = await repo.queryList<User>();

Design Notes

• This class itself does not implement persistence; it relies on an optional RepositoryExecutor to perform operations.
• All query methods are asynchronous and return Futures.
• Supports Iterable, List, and Set conversions for flexible usage.

See Also

• RepositoryExecutor
• CrudRepository