Update GradeService.java

src/main/java/com/zsz/service/GradeService.java

@@ -1,15 +1,32 @@
 package com.zsz.service;
 
+// 导入 MyBatis-Plus 提供的分页查询相关的 Page 类，用于处理分页查询结果
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+// 导入 MyBatis-Plus 的通用 Service 接口，该接口提供了常见的增删改查等操作方法
 import com.baomidou.mybatisplus.extension.service.IService;
+// 导入年级实体类，代表数据库中的年级数据
 import com.zsz.pojo.Grade;
-
+// 导入 Java 集合框架中的 List 接口，用于存储多个年级对象
 import java.util.List;
 
+/**
+ * 年级服务接口，继承自 MyBatis-Plus 的 IService 接口，用于定义年级相关的业务逻辑方法。
+ * 提供了分页查询年级数据和获取所有年级列表的方法声明。
+ */
 public interface GradeService extends IService<Grade> {
+
+    /**
+     * 分页查询年级数据
+     * @param gradePage 分页对象，包含页码、每页记录数等分页信息
+     * @param gradeName 年级名称，用于模糊查询条件，可为空。若不为空，则根据该名称模糊查询年级数据
+     * @return 包含分页查询结果的 Page 对象，其中存储了符合条件的年级对象列表
+     */
     Page<Grade> getGradesData(Page<Grade> gradePage, String gradeName);
 
+    /**
+     * 获取所有年级列表
+     * @return 包含所有年级信息的 List 集合
+     */
     List<Grade> getGrades();
 
-}
+}
-