优化服务器端分页

src/Jiaowu.Api/Controllers/TeacherCourseApplicationsController.cs

@@ -1,4 +1,5 @@
 using System.ComponentModel.DataAnnotations;
+using Jiaowu.Api.Contracts;
 using Jiaowu.Api.Domain.Academic;
 using Jiaowu.Api.Domain.Identity;
 using Jiaowu.Api.Infrastructure.Auth;
@@ -46,17 +47,26 @@ public sealed class TeacherCourseApplicationsController(
     [Authorize(Roles = SystemRoles.Teacher)]
     public async Task<ActionResult> GetMine(
         Guid? academicTermId,
-        CancellationToken cancellationToken)
+        int page = 1,
+        int pageSize = 20,
+        CancellationToken cancellationToken = default)
     {
+        if (page < 1 || pageSize is < 1 or > 100)
+            return ValidationProblem("页码必须大于 0，且每页条数应在 1 至 100 之间。");
+
         var teacher = await CurrentTeacherAsync(cancellationToken);
         if (teacher is null) return ConflictProblem("当前账号尚未关联在职教师档案。");
         var source = db.TeacherCourseApplications.AsNoTracking()
             .Where(x => x.TeacherId == teacher.Id);
         if (academicTermId.HasValue)
             source = source.Where(x => x.AcademicTermId == academicTermId);
-        return Ok(await source
+        var total = await source.CountAsync(cancellationToken);
+        var items = await source
             .OrderByDescending(x => x.AcademicTerm!.StartDate)
             .ThenBy(x => x.Course!.Code)
+            .ThenBy(x => x.Id)
+            .Skip((page - 1) * pageSize)
+            .Take(pageSize)
             .Select(x => new
             {
                 x.Id,
@@ -72,7 +82,8 @@ public sealed class TeacherCourseApplicationsController(
                 x.SubmittedAt,
                 x.ReviewedAt
             })
-            .ToListAsync(cancellationToken));
+            .ToListAsync(cancellationToken);
+        return Ok(new PagedResult<object>(items, total, page, pageSize));
     }
 
     [HttpPost("mine")]
@@ -144,15 +155,24 @@ public sealed class TeacherCourseApplicationsController(
     public async Task<ActionResult> GetReviews(
         Guid? academicTermId,
         TeacherCourseApplicationStatus? status,
-        CancellationToken cancellationToken)
+        int page = 1,
+        int pageSize = 20,
+        CancellationToken cancellationToken = default)
     {
+        if (page < 1 || pageSize is < 1 or > 100)
+            return ValidationProblem("页码必须大于 0，且每页条数应在 1 至 100 之间。");
+
         var source = ScopedApplications().AsNoTracking();
         if (academicTermId.HasValue)
             source = source.Where(x => x.AcademicTermId == academicTermId);
         if (status.HasValue) source = source.Where(x => x.Status == status);
-        return Ok(await source
+        var total = await source.CountAsync(cancellationToken);
+        var items = await source
             .OrderBy(x => x.Status)
             .ThenByDescending(x => x.SubmittedAt)
+            .ThenBy(x => x.Id)
+            .Skip((page - 1) * pageSize)
+            .Take(pageSize)
             .Select(x => new
             {
                 x.Id,
@@ -172,7 +192,8 @@ public sealed class TeacherCourseApplicationsController(
                 x.SubmittedAt,
                 x.ReviewedAt
             })
-            .ToListAsync(cancellationToken));
+            .ToListAsync(cancellationToken);
+        return Ok(new PagedResult<object>(items, total, page, pageSize));
     }
 
     [HttpGet("assignment-options")]