Add GetAllPagingAsync method to IRepository and Repository

Updated the `IRepository<TEntity, TKey>` interface to include a new method `GetAllPagingAsync` for asynchronous retrieval of paginated results with optional filtering, ordering, and related entity inclusion.

Implemented the `GetAllPagingAsync` method in the `Repository<TEntity, TKey>` class, allowing for flexible querying and pagination. Added XML documentation comments for clarity on method functionality and parameters.

Author: AngeloDotNet

src/ClassLibrary.EFCore/Interfaces/IRepository.cs

@@ -57,4 +57,22 @@ Task<IQueryable<TEntity>> GetAllAsync(Func<IQueryable<TEntity>,
     /// <param name="pageSize">The size of the page.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a PaginatedResult of TEntity.</returns>
     Task<PaginatedResult<TEntity>> GetPaginatedAsync(IQueryable<TEntity> query, int pageNumber, int pageSize);
+
+    /// <summary>
+    /// Retrieves a paginated result of entities asynchronously with optional filtering, ordering, and including related entities.
+    /// </summary>
+    /// <param name="pageNumber">The page number to retrieve.</param>
+    /// <param name="pageSize">The size of the page.</param>
+    /// <param name="includes">A function to include related entities in the query.</param>
+    /// <param name="filter">A filter expression to apply to the entities.</param>
+    /// <param name="orderBy">An expression to order the results.</param>
+    /// <param name="ascending">A boolean indicating whether the order should be ascending.</param>
+    /// <returns>
+    /// A task that represents the asynchronous operation. The task result contains a <see cref="PaginatedResult{TEntity}"/>
+    /// with the paginated entities.
+    /// </returns>
+    Task<PaginatedResult<TEntity>> GetAllPagingAsync(int pageNumber, int pageSize,
+        Func<IQueryable<TEntity>, IIncludableQueryable<TEntity, object>> includes = null!,
+        Expression<Func<TEntity, bool>> filter = null!,
+        Expression<Func<TEntity, object>> orderBy = null!, bool ascending = true);
 }

src/ClassLibrary.EFCore/Repository.cs

@@ -133,4 +133,49 @@ public async Task<PaginatedResult<TEntity>> GetPaginatedAsync(IQueryable<TEntity
 
         return result;
     }
+
+    /// <summary>
+    /// Retrieves a paginated list of entities asynchronously with optional filtering, ordering, and including related entities.
+    /// </summary>
+    /// <param name="pageNumber">The page number to retrieve.</param>
+    /// <param name="pageSize">The number of items per page.</param>
+    /// <param name="includes">A function to include related entities in the query.</param>
+    /// <param name="filter">A filter expression to apply to the entities.</param>
+    /// <param name="orderBy">An expression to order the results.</param>
+    /// <param name="ascending">A boolean indicating whether the order should be ascending.</param>
+    /// <returns>
+    /// A task that represents the asynchronous operation. The task result contains a <see cref="PaginatedResult{TEntity}"/> with the paginated entities.
+    /// </returns>
+    public async Task<PaginatedResult<TEntity>> GetAllPagingAsync(int pageNumber, int pageSize,
+        Func<IQueryable<TEntity>, IIncludableQueryable<TEntity, object>> includes = null!, Expression<Func<TEntity, bool>> filter = null!,
+        Expression<Func<TEntity, object>> orderBy = null!, bool ascending = true)
+    {
+        var query = DbContext.Set<TEntity>().AsNoTracking();
+
+        if (includes != null)
+        {
+            query = includes(query);
+        }
+
+        if (filter != null)
+        {
+            query = query.Where(filter);
+        }
+
+        if (orderBy != null)
+        {
+            query = ascending ? query.OrderBy(orderBy) : query.OrderByDescending(orderBy);
+        }
+
+        var totalItems = await query.CountAsync();
+        var items = await query.Skip((pageNumber - 1) * pageSize).Take(pageSize).ToListAsync();
+
+        return new PaginatedResult<TEntity>
+        {
+            CurrentPage = pageNumber,
+            PageSize = pageSize,
+            TotalItems = totalItems,
+            Items = items
+        };
+    }
 }