Merge pull request '添加注释' (#42) from zhutt into main

Reviewed-on: #42

api/class_api.py

@@ -46,6 +46,23 @@ def get_classes( id:int|None = None                                  # id参数
     else :                                                     # 判断 DAO 层的返回结果，如果为条数为0
         return ClassResponse( code = 404,detail = '没有符合条件的班级，请检查输入是否有误')    # 返回404响应，提示没有符合条件的提示给前端
 
+
+@classes_router.get('/student-count', summary='查询每个班级学生人数')
+def get_class_student_count( class_id:int|None = None
+                           , class_no:str|None = None                            # class_no参数接收前端输入的数据，声明是字符串，可以为空默认为空
+                           , class_name:str|None = None                          # class_name参数接收前端输入的数据，声明是字符串，可以为空默认为空
+                           , page:int = 1                                        # page参数接收前端输入的数据，声明是整数，默认是1
+                           , page_size:int = 5                                   # page参数接收前端输入的数据，声明是整数，默认是5
+                           , db=Depends(get_db)                                  # 参数db依赖于数据库会话的上下文管理器
+                           ):
+    t,r = get_class_student_count_dao(class_id,class_no,class_name,page,page_size,db)
+    if r:
+        return ClassResponse(total=t, data=r)
+    return ClassResponse(code=404, detail='没有班级数据')
+
+
+
+
 # ————定义班级表"删除"信息的接口函数————
 @classes_router.delete('/{id}',response_model=ClassResponse,summary='删除班级信息')   # delete删除请求，指定返回数据格式为 ClassResponse
 def delete_classes(id:int,db=Depends(get_db)):                                           # 定义删除接口函数，id参数接收前端输入的数据，参数db依赖于数据库会话的上下文管理器