From 2436048a063e88a961330e472d9ce4fe43b6c653 Mon Sep 17 00:00:00 2001
From: pveayojnc <3273195329@qq.com>
Date: Tue, 29 Apr 2025 18:05:29 +0800
Subject: [PATCH] Update GradeServiceImpl.java

---
 .../zsz/service/impl/GradeServiceImpl.java    | 41 +++++++++++++++++--
 1 file changed, 38 insertions(+), 3 deletions(-)

diff --git a/src/main/java/com/zsz/service/impl/GradeServiceImpl.java b/src/main/java/com/zsz/service/impl/GradeServiceImpl.java
index 5e4bd70..37323fd 100644
--- a/src/main/java/com/zsz/service/impl/GradeServiceImpl.java
+++ b/src/main/java/com/zsz/service/impl/GradeServiceImpl.java
@@ -1,33 +1,68 @@
 package com.zsz.service.impl;
 
+// 导入 MyBatis-Plus 用于构建查询条件的 QueryWrapper 类
 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
+// 导入 MyBatis-Plus 用于实现分页查询的 Page 类
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+// 导入 MyBatis-Plus 提供的通用 Service 实现类
 import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+// 导入年级数据访问层的 Mapper 接口
 import com.zsz.mapper.GradeMapper;
+// 导入年级实体类
 import com.zsz.pojo.Grade;
+// 导入年级服务层接口
 import com.zsz.service.GradeService;
+// 导入 Spring 框架的 Service 注解，用于将该类标记为服务层组件
 import org.springframework.stereotype.Service;
+// 导入 Spring 框架的事务管理注解，用于开启事务支持
 import org.springframework.transaction.annotation.Transactional;
+// 导入 Spring 框架的工具类，用于字符串操作
 import org.springframework.util.StringUtils;
 
 import java.util.List;
 
+/**
+ * 年级服务实现类，继承自 MyBatis-Plus 的 ServiceImpl 类，实现了 GradeService 接口。
+ * 该类负责处理与年级相关的业务逻辑，如分页查询年级数据和获取所有年级列表。
+ */
+// 将该类标记为服务层组件，指定名称为 "gradeServiceImpl"
 @Service("gradeServiceImpl")
+// 开启事务支持，确保业务操作的原子性
 @Transactional
 public class GradeServiceImpl extends ServiceImpl<GradeMapper, Grade> implements GradeService {
+
+    /**
+     * 分页查询年级数据
+     * @param gradePage 分页对象，包含页码、每页记录数等信息
+     * @param gradeName 年级名称，用于模糊查询条件，可为空
+     * @return 包含分页查询结果的 Page 对象
+     */
     @Override
     public Page<Grade> getGradesData(Page<Grade> gradePage, String gradeName) {
+        // 创建 QueryWrapper 对象，用于构建数据库查询条件
         QueryWrapper<Grade> gradeQueryWrapper = new QueryWrapper<>();
-        if (!StringUtils.isEmpty(gradeName)){
-            gradeQueryWrapper.like("name",gradeName);
+
+        // 判断年级名称是否为空，如果不为空，则添加模糊查询条件
+        if (!StringUtils.isEmpty(gradeName)) {
+            // 添加年级名称的模糊查询条件，对应数据库表中的 name 字段
+            gradeQueryWrapper.like("name", gradeName);
         }
+
+        // 按照年级 ID 降序排序，确保新添加的年级记录排在前面
         gradeQueryWrapper.orderByDesc("id");
+
+        // 调用 BaseMapper 的 selectPage 方法，根据分页信息和查询条件进行分页查询
         Page<Grade> page = baseMapper.selectPage(gradePage, gradeQueryWrapper);
         return page;
     }
 
+    /**
+     * 获取所有年级列表
+     * @return 包含所有年级信息的列表
+     */
     @Override
     public List<Grade> getGrades() {
+        // 调用 BaseMapper 的 selectList 方法，传入 null 表示不添加额外的查询条件，即查询所有年级信息
         return baseMapper.selectList(null);
     }
-}
+}
\ No newline at end of file