diff --git a/src/main/java/com/zsz/service/impl/ClazzServiceImpl.java b/src/main/java/com/zsz/service/impl/ClazzServiceImpl.java index baa0c95..da3541b 100644 --- a/src/main/java/com/zsz/service/impl/ClazzServiceImpl.java +++ b/src/main/java/com/zsz/service/impl/ClazzServiceImpl.java @@ -1,37 +1,74 @@ 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.ClazzMapper; +// 导入班级实体类 import com.zsz.pojo.Clazz; +// 导入班级服务层接口 import com.zsz.service.ClazzService; +// 导入 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 类,实现了 ClazzService 接口。 + * 该类负责处理与班级相关的业务逻辑,如分页查询班级数据和获取所有班级列表。 + */ +// 将该类标记为服务层组件,指定名称为 "clazzServiceImpl" @Service("clazzServiceImpl") +// 开启事务支持,确保业务操作的原子性 @Transactional public class ClazzServiceImpl extends ServiceImpl implements ClazzService { + + /** + * 分页查询班级数据 + * @param clazzPage 分页对象,包含页码、每页记录数等信息 + * @param clazz 班级实体对象,用于构建查询条件,如年级名称、班级名称等 + * @return 包含分页查询结果的 Page 对象 + */ @Override public Page getClazzData(Page clazzPage, Clazz clazz) { + // 创建 QueryWrapper 对象,用于构建数据库查询条件 QueryWrapper clazzQueryWrapper = new QueryWrapper<>(); - if (!StringUtils.isEmpty(clazz.getGradeName())){ - clazzQueryWrapper.like("grade_name",clazz.getGradeName()); + + // 判断班级对象中的年级名称是否为空,如果不为空,则添加模糊查询条件 + if (!StringUtils.isEmpty(clazz.getGradeName())) { + // 添加年级名称的模糊查询条件,对应数据库表中的 grade_name 字段 + clazzQueryWrapper.like("grade_name", clazz.getGradeName()); } - if (!StringUtils.isEmpty(clazz.getName())){ - clazzQueryWrapper.like("name",clazz.getName()); + + // 判断班级对象中的班级名称是否为空,如果不为空,则添加模糊查询条件 + if (!StringUtils.isEmpty(clazz.getName())) { + // 添加班级名称的模糊查询条件,对应数据库表中的 name 字段 + clazzQueryWrapper.like("name", clazz.getName()); } + + // 调用 BaseMapper 的 selectPage 方法,根据分页信息和查询条件进行分页查询 Page selectPage = baseMapper.selectPage(clazzPage, clazzQueryWrapper); return selectPage; } + /** + * 获取所有班级列表 + * @return 包含所有班级信息的列表 + */ @Override public List getClazzs() { + // 创建 QueryWrapper 对象,由于要查询所有班级,这里不添加额外的查询条件 QueryWrapper clazzQueryWrapper = new QueryWrapper<>(); + // 调用 BaseMapper 的 selectList 方法,查询所有班级信息 return baseMapper.selectList(clazzQueryWrapper); } -} +} \ No newline at end of file