feat(class): 实现班级列表分页查询功能

- 新增班级后端分页接口及相关服务实现
- 实现班级与年级关联数据查询及映射
- 新增分页请求和响应VO类支持前后端数据传输
- 修改前端class.vue，增加班级列表分页展示组件
- 增加前端分页逻辑及状态管理，支持切换页码和页面大小
- 创建GradeClassDO实体及对应Mapper实现关联查询
- 优化数据库Mapper XML，增加分页查询及计数SQL语句
- 调整MyBatis配置生成grade_class表实体类和Mapper接口

enlish-service/src/main/java/com/yinlihupo/enlish/service/controller/ClassController.java

@@ -0,0 +1,44 @@
+package com.yinlihupo.enlish.service.controller;
+
+import com.yinlihupo.enlish.service.domain.dataobject.ClassDO;
+import com.yinlihupo.enlish.service.domain.dataobject.GradeDO;
+import com.yinlihupo.enlish.service.model.vo.classs.FindClassReqVO;
+import com.yinlihupo.enlish.service.model.vo.classs.FindClassRspVO;
+import com.yinlihupo.enlish.service.service.ClassService;
+import com.yinlihupo.framework.biz.operationlog.aspect.ApiOperationLog;
+import com.yinlihupo.framework.common.response.PageResponse;
+import jakarta.annotation.Resource;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+
+@RequestMapping("/class/")
+@RestController
+public class ClassController {
+
+    @Resource
+    private ClassService classService;
+
+    @PostMapping("list")
+    @ApiOperationLog(description = "查询班级列表")
+    public PageResponse<FindClassRspVO> findClasses(@RequestBody FindClassReqVO findClassReqVO) {
+        Integer page = findClassReqVO.getPage();
+        Integer pageSize = findClassReqVO.getPageSize();
+        int total = classService.getClassCount();
+
+        List<ClassDO> classList = classService.findClassList(page, pageSize);
+        Map<Integer, GradeDO> classId2GradeMap = classService.findClassId2GradeMap(classList.stream().map(ClassDO::getId).toList());
+        List<FindClassRspVO> findClassRspVOS = classList.stream().map(classDO -> FindClassRspVO.builder()
+                .id(classDO.getId())
+                .title(classDO.getTitle())
+                .gradeId(classId2GradeMap.get(classDO.getId()) != null ? classId2GradeMap.get(classDO.getId()).getId() : 0)
+                .gradeName(classId2GradeMap.get(classDO.getId()) != null ? classId2GradeMap.get(classDO.getId()).getTitle() : "")
+                .build()).toList();
+
+        return PageResponse.success(findClassRspVOS, page, total, pageSize);
+    }
+}

enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/dataobject/GradeClassDO.java

@@ -0,0 +1,21 @@
+package com.yinlihupo.enlish.service.domain.dataobject;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@AllArgsConstructor
+@NoArgsConstructor
+@Data
+@Builder
+public class GradeClassDO {
+
+    private Integer id;
+
+    private Integer classId;
+
+    private Integer gradeId;
+
+
+}

enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/ClassDOMapper.java

@@ -1,8 +1,15 @@
 package com.yinlihupo.enlish.service.domain.mapper;
 
 import com.yinlihupo.enlish.service.domain.dataobject.ClassDO;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
 
 public interface ClassDOMapper {
 
     ClassDO selectClassDOById(Integer id);
+
+    List<ClassDO> selectClassDOList(@Param("startIndex") Integer startIndex, @Param("pageSize") Integer pageSize);
+
+    Integer selectClassDOCount();
 }

enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/GradeClassDOMapper.java

@@ -0,0 +1,10 @@
+package com.yinlihupo.enlish.service.domain.mapper;
+
+import com.yinlihupo.enlish.service.domain.dataobject.GradeClassDO;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
+
+public interface GradeClassDOMapper {
+    List<GradeClassDO> selectByClassIds(@Param("classIds") List<Integer> classIds);
+}

enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/GradeDOMapper.java

@@ -1,8 +1,13 @@
 package com.yinlihupo.enlish.service.domain.mapper;
 
 import com.yinlihupo.enlish.service.domain.dataobject.GradeDO;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
 
 public interface GradeDOMapper {
 
     GradeDO selectById(Integer id);
+
+    List<GradeDO> selectByGradeIds(@Param("gradeIds") List<Integer> gradeIds);
 }

enlish-service/src/main/java/com/yinlihupo/enlish/service/model/vo/classs/FindClassReqVO.java

@@ -0,0 +1,16 @@
+package com.yinlihupo.enlish.service.model.vo.classs;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@AllArgsConstructor
+@NoArgsConstructor
+@Data
+@Builder
+public class FindClassReqVO {
+
+    Integer page;
+    Integer pageSize;
+}

enlish-service/src/main/java/com/yinlihupo/enlish/service/model/vo/classs/FindClassRspVO.java

@@ -0,0 +1,18 @@
+package com.yinlihupo.enlish.service.model.vo.classs;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@AllArgsConstructor
+@NoArgsConstructor
+@Data
+@Builder
+public class FindClassRspVO {
+
+    private Integer id;
+    private String title;
+    private Integer gradeId;
+    private String gradeName;
+}

enlish-service/src/main/java/com/yinlihupo/enlish/service/service/ClassService.java

@@ -1,8 +1,18 @@
 package com.yinlihupo.enlish.service.service;
 
 import com.yinlihupo.enlish.service.domain.dataobject.ClassDO;
+import com.yinlihupo.enlish.service.domain.dataobject.GradeDO;
+
+import java.util.List;
+import java.util.Map;
 
 public interface ClassService {
 
     ClassDO findClassById(Integer id);
+
+    List<ClassDO> findClassList(Integer page, Integer pageSize);
+
+    int getClassCount();
+
+    Map<Integer, GradeDO> findClassId2GradeMap(List<Integer> classIds);
 }

enlish-service/src/main/java/com/yinlihupo/enlish/service/service/classs/ClassServiceImpl.java

@@ -1,19 +1,73 @@
 package com.yinlihupo.enlish.service.service.classs;
 
 import com.yinlihupo.enlish.service.domain.dataobject.ClassDO;
+import com.yinlihupo.enlish.service.domain.dataobject.GradeClassDO;
+import com.yinlihupo.enlish.service.domain.dataobject.GradeDO;
 import com.yinlihupo.enlish.service.domain.mapper.ClassDOMapper;
+import com.yinlihupo.enlish.service.domain.mapper.GradeClassDOMapper;
+import com.yinlihupo.enlish.service.domain.mapper.GradeDOMapper;
 import com.yinlihupo.enlish.service.service.ClassService;
 import jakarta.annotation.Resource;
 import org.springframework.stereotype.Service;
 
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
 @Service
 public class ClassServiceImpl implements ClassService {
 
     @Resource
     private ClassDOMapper classDOMapper;
+    @Resource
+    private GradeClassDOMapper gradeClassDOMapper;
+    @Resource
+    private GradeDOMapper gradeDOMapper;
 
     @Override
     public ClassDO findClassById(Integer id) {
         return classDOMapper.selectClassDOById(id);
     }
+
+    @Override
+    public List<ClassDO> findClassList(Integer page, Integer pageSize) {
+        return classDOMapper.selectClassDOList((page - 1) * pageSize, pageSize);
+    }
+
+    @Override
+    public int getClassCount() {
+        return classDOMapper.selectClassDOCount();
+    }
+
+    @Override
+    public Map<Integer, GradeDO> findClassId2GradeMap(List<Integer> classIds) {
+
+        List<GradeClassDO> gradeClassDOS = gradeClassDOMapper.selectByClassIds(classIds);
+        List<GradeDO> gradeDOS = gradeDOMapper.selectByGradeIds(gradeClassDOS.stream().map(GradeClassDO::getGradeId).toList());
+        HashMap<Integer, GradeDO> gradeId2GradeDO = gradeDOS.stream().collect(Collectors.toMap(
+                GradeDO::getId,
+                gradeDO -> gradeDO,
+                (oldValue, newValue) -> newValue,  // mergeFunction：处理键冲突（比如重复键时保留新值）
+                HashMap::new           // mapSupplier：指定返回HashMap类型
+        ));
+
+        return gradeClassDOS.stream().collect(Collectors.toMap(
+                GradeClassDO::getClassId,  // key：GradeClassDO的classId
+                // 修正后的valueMapper：lambda表达式处理映射逻辑
+                gradeClassDO -> {
+                    // 可选：处理空值，避免返回null（根据业务需求调整）
+                    Integer gradeId = gradeClassDO.getGradeId();
+                    GradeDO gradeDO = gradeId2GradeDO.get(gradeId);
+                    if (gradeDO == null) {
+                        // 业务上的空值处理，比如抛出异常、返回默认对象等
+                        throw new IllegalArgumentException("未找到gradeId为" + gradeId + "的GradeDO");
+                        // 或者：return new GradeDO(); // 返回默认对象
+                    }
+                    return gradeDO;
+                },
+                (oldValue, newValue) -> newValue, // 键冲突保留新值
+                HashMap::new                     // 指定返回 HashMap
+        ));
+    }
 }

enlish-service/src/main/resources/generatorConfig.xml

@@ -45,7 +45,7 @@
                              targetProject="src/main/java"/>
 
         <!-- 需要生成的表-实体类 -->
-        <table tableName="grade" domainObjectName="GradeDO"
+        <table tableName="grade_class" domainObjectName="GradeClassDO"
                enableCountByExample="false"
                enableUpdateByExample="false"
                enableDeleteByExample="false"

enlish-service/src/main/resources/mapper/ClassDOMapper.xml

@@ -12,5 +12,16 @@
         where id = #{id}
     </select>
 
+    <select id="selectClassDOList" resultMap="BaseResultMap">
+        select *
+        from `class`
+        limit #{startIndex}, #{pageSize}
+    </select>
+
+    <select id="selectClassDOCount" resultType="java.lang.Integer">
+        select count(1)
+        from `class`
+    </select>
+
 
 </mapper>

enlish-service/src/main/resources/mapper/GradeClassDOMapper.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.yinlihupo.enlish.service.domain.mapper.GradeClassDOMapper">
+    <resultMap id="BaseResultMap" type="com.yinlihupo.enlish.service.domain.dataobject.GradeClassDO">
+        <id column="id" jdbcType="INTEGER" property="id" />
+        <result column="class_id" jdbcType="INTEGER" property="classId" />
+        <result column="grade_id" jdbcType="INTEGER" property="gradeId" />
+    </resultMap>
+    
+    <select id="selectByClassIds" resultMap="BaseResultMap">
+        select * from grade_class where class_id in
+        <foreach collection="classIds" item="classId" separator="," open="(" close=")">
+            #{classId}
+        </foreach>
+    </select>
+
+</mapper>

enlish-service/src/main/resources/mapper/GradeDOMapper.xml

@@ -12,5 +12,13 @@
         from grade
         where id = #{id}
     </select>
+    <select id="selectByGradeIds" resultMap="BaseResultMap">
+        select *
+        from grade
+        where id in
+        <foreach collection="gradeIds" item="gradeId" separator="," open="(" close=")">
+            #{gradeId}
+        </foreach>
+    </select>
 
 </mapper>

enlish-vue/src/api/class.js

@@ -0,0 +1,8 @@
+import axios from "@/axios";
+
+export function getClassList(page, size) {
+    return axios.post('/class/list', {
+        page: page,
+        pageSize: size
+    })
+}

enlish-vue/src/pages/class.vue

@@ -5,15 +5,38 @@
                 <Header></Header>
             </el-header>
 
-            <el-main>
+            <el-main class="p-4">
-                <div class="flex">
+                <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
-                    <div>
+                    <div class="lg:col-span-1 flex flex-col gap-6">
-                        班级
+                        <div class="bg-white dark:bg-gray-800 rounded-lg shadow p-6">
+                            <div class="text-lg font-semibold mb-4">班级列表</div>
+
+                            <el-table :data="classes" border class="w-full" v-loading="loading">
+                                <el-table-column prop="id" label="ID" width="80" />
+                                <el-table-column prop="title" label="班级名称" min-width="120" />
+                                <el-table-column prop="gradeName" label="年级" min-width="120" />
+                            </el-table>
+
+                            <div class="mt-4 flex justify-end">
+                                <el-pagination background layout="prev, pager, next, sizes, total" :total="totalCount"
+                                    :page-size="pageSize" :current-page="pageNo" @current-change="handlePageChange"
+                                    @size-change="handleSizeChange" />
+                            </div>
+
+                        </div>
+
                     </div>
 
-                    <div>
+                    <div class="bg-white dark:bg-gray-800 rounded-lg shadow p-6 lg:col-span-1 lg:row-span-2">
-                        hellow
+                        <div class="text-lg font-semibold mb-4">右侧卡片</div>
+                        <div class="text-gray-500">内容待完善</div>
                     </div>
+
+                    <div class="bg-white dark:bg-gray-800 rounded-lg shadow p-6">
+                        <div class="text-lg font-semibold mb-4">左下卡片</div>
+                        <div class="text-gray-500">内容待完善</div>
+                    </div>
+                    
                 </div>
             </el-main>
 
@@ -23,4 +46,40 @@
 
 <script setup>
 import Header from '@/layouts/components/Header.vue'
-</script>
+import { ref, onMounted } from 'vue'
+import { getClassList } from '@/api/class'
+
+const classes = ref([])
+const pageNo = ref(1)
+const pageSize = ref(10)
+const totalCount = ref(0)
+const loading = ref(false)
+
+async function fetchClasses() {
+    loading.value = true
+    try {
+        const res = await getClassList(pageNo.value, pageSize.value)
+        const d = res.data
+        classes.value = Array.isArray(d.data) ? d.data : []
+        totalCount.value = d.totalCount || 0
+        pageNo.value = d.pageNo || pageNo.value
+        pageSize.value = d.pageSize || pageSize.value
+    } finally {
+        loading.value = false
+    }
+}
+
+function handlePageChange(p) {
+    pageNo.value = p
+    fetchClasses()
+}
+function handleSizeChange(s) {
+    pageSize.value = s
+    pageNo.value = 1
+    fetchClasses()
+}
+
+onMounted(() => {
+    fetchClasses()
+})
+</script>