From eb2c0d2f6c451b1dae8d029252cb7fbaa9f38da6 Mon Sep 17 00:00:00 2001
From: lbw <1192299468@qq.com>
Date: Mon, 15 Dec 2025 11:15:47 +0800
Subject: [PATCH] =?UTF-8?q?feat(student):=20=E6=B7=BB=E5=8A=A0=E5=AD=A6?=
 =?UTF-8?q?=E7=94=9F=E6=9F=A5=E8=AF=A2=E5=8A=9F=E8=83=BD=E5=B9=B6=E6=94=AF?=
 =?UTF-8?q?=E6=8C=81=E6=8C=89=E5=A7=93=E5=90=8D=E8=BF=87=E6=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 学生查询页面新增姓名输入框及查询、重置按钮
- 实现学生列表展示与分页功能
- 支持根据选中班级和年级联动查询学生
- 学生接口新增按姓名条件查询支持
- 服务层及Mapper层方法添加姓名参数过滤功能
- Vue页面同步新增学生相关响应式状态与方法
- 优化表格交互，支持点击行选中高亮及联动查询
---
 .../service/controller/StudentController.java |   4 +-
 .../domain/mapper/StudentDOMapper.java        |   3 +-
 .../model/vo/student/FindStudentsReqVO.java   |   1 +
 .../service/service/StudentService.java       |   2 +-
 .../service/student/StudentServiceImpl.java   |   4 +-
 .../main/resources/mapper/StudentDOMapper.xml |   5 +-
 enlish-vue/src/api/student.js                 |   4 +
 enlish-vue/src/pages/class.vue                | 101 +++++++++++++++++-
 8 files changed, 112 insertions(+), 12 deletions(-)

diff --git a/enlish-service/src/main/java/com/yinlihupo/enlish/service/controller/StudentController.java b/enlish-service/src/main/java/com/yinlihupo/enlish/service/controller/StudentController.java
index 64935e0..e2b37d9 100644
--- a/enlish-service/src/main/java/com/yinlihupo/enlish/service/controller/StudentController.java
+++ b/enlish-service/src/main/java/com/yinlihupo/enlish/service/controller/StudentController.java
@@ -41,8 +41,8 @@ public class StudentController {
         Integer gradeId = findStudentsReqVO.getGradeId();
         Integer pageNo = findStudentsReqVO.getPageNo();
         Integer pageSize = findStudentsReqVO.getPageSize();
-
-        List<StudentDO> students = studentService.getStudentsByClassIdAndGradeId(classId, gradeId, pageNo, pageSize);
+        String name = findStudentsReqVO.getName();
+        List<StudentDO> students = studentService.getStudentsByClassIdAndGradeId(classId, gradeId, name, pageNo, pageSize);
         int allStudents = studentService.getAllStudents();
 
         List<StudentItemRspVO> studentItemRspVOS = students.stream().map(studentDO -> StudentItemRspVO.builder()
diff --git a/enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/StudentDOMapper.java b/enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/StudentDOMapper.java
index 6e33489..829d3ef 100644
--- a/enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/StudentDOMapper.java
+++ b/enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/StudentDOMapper.java
@@ -1,12 +1,13 @@
 package com.yinlihupo.enlish.service.domain.mapper;
 
 import com.yinlihupo.enlish.service.domain.dataobject.StudentDO;
+import org.apache.ibatis.annotations.Param;
 
 import java.util.List;
 
 public interface StudentDOMapper {
 
-    List<StudentDO> selectStudentDOListByClassIdAndGradeId(Integer classId, Integer gradeId, Integer pageSize, Integer offset);
+    List<StudentDO> selectStudentDOListByClassIdAndGradeId(@Param("classId") Integer classId, @Param("gradeId") Integer gradeId, @Param("name") String name, @Param("startIndex") Integer startIndex, @Param("pageSize") Integer pageSize);
 
     int selectStudentCount();
 
diff --git a/enlish-service/src/main/java/com/yinlihupo/enlish/service/model/vo/student/FindStudentsReqVO.java b/enlish-service/src/main/java/com/yinlihupo/enlish/service/model/vo/student/FindStudentsReqVO.java
index 1b1afb7..7c057d8 100644
--- a/enlish-service/src/main/java/com/yinlihupo/enlish/service/model/vo/student/FindStudentsReqVO.java
+++ b/enlish-service/src/main/java/com/yinlihupo/enlish/service/model/vo/student/FindStudentsReqVO.java
@@ -11,6 +11,7 @@ import lombok.NoArgsConstructor;
 @Builder
 public class FindStudentsReqVO {
 
+    private String name;
     private Integer classId;
     private Integer gradeId;
 
diff --git a/enlish-service/src/main/java/com/yinlihupo/enlish/service/service/StudentService.java b/enlish-service/src/main/java/com/yinlihupo/enlish/service/service/StudentService.java
index dbc1637..34e7575 100644
--- a/enlish-service/src/main/java/com/yinlihupo/enlish/service/service/StudentService.java
+++ b/enlish-service/src/main/java/com/yinlihupo/enlish/service/service/StudentService.java
@@ -7,7 +7,7 @@ import java.util.List;
 
 public interface StudentService {
 
-    List<StudentDO> getStudentsByClassIdAndGradeId(Integer classId, Integer gradeId, Integer pageNo, Integer pageSize);
+    List<StudentDO> getStudentsByClassIdAndGradeId(Integer classId, Integer gradeId, String name, Integer pageNo, Integer pageSize);
 
     int getAllStudents();
 
diff --git a/enlish-service/src/main/java/com/yinlihupo/enlish/service/service/student/StudentServiceImpl.java b/enlish-service/src/main/java/com/yinlihupo/enlish/service/service/student/StudentServiceImpl.java
index e8d3aeb..def873a 100644
--- a/enlish-service/src/main/java/com/yinlihupo/enlish/service/service/student/StudentServiceImpl.java
+++ b/enlish-service/src/main/java/com/yinlihupo/enlish/service/service/student/StudentServiceImpl.java
@@ -16,9 +16,9 @@ public class StudentServiceImpl implements StudentService {
     private StudentDOMapper studentDOMapper;
 
     @Override
-    public List<StudentDO> getStudentsByClassIdAndGradeId(Integer classId, Integer gradeId, Integer pageNo, Integer pageSize) {
+    public List<StudentDO> getStudentsByClassIdAndGradeId(Integer classId, Integer gradeId, String name, Integer pageNo, Integer pageSize) {
 
-        return studentDOMapper.selectStudentDOListByClassIdAndGradeId(classId, gradeId, pageSize, (pageNo - 1) * pageSize);
+        return studentDOMapper.selectStudentDOListByClassIdAndGradeId(classId, gradeId, name, (pageNo - 1) * pageSize, pageSize);
     }
 
     @Override
diff --git a/enlish-service/src/main/resources/mapper/StudentDOMapper.xml b/enlish-service/src/main/resources/mapper/StudentDOMapper.xml
index c86b656..7cda7a5 100644
--- a/enlish-service/src/main/resources/mapper/StudentDOMapper.xml
+++ b/enlish-service/src/main/resources/mapper/StudentDOMapper.xml
@@ -22,7 +22,10 @@
         <if test="gradeId != null">
             AND grade_id = #{gradeId}
         </if>
-        LIMIT #{offset}, #{pageSize}
+        <if test="name != null">
+            AND name like concat('%', #{name}, '%')
+        </if>
+        LIMIT #{startIndex}, #{pageSize}
     </select>
 
     <select id="selectStudentCount">
diff --git a/enlish-vue/src/api/student.js b/enlish-vue/src/api/student.js
index 7e0015f..ba7e87e 100644
--- a/enlish-vue/src/api/student.js
+++ b/enlish-vue/src/api/student.js
@@ -4,4 +4,8 @@ export function getStudentDetail(id) {
     return axios.post('/student/detail', {
         studentId: id
     })
+}
+
+export function getStudentList(data) {
+    return axios.post('/student/list', data)
 }
\ No newline at end of file
diff --git a/enlish-vue/src/pages/class.vue b/enlish-vue/src/pages/class.vue
index e3e2c9d..6b7a0ba 100644
--- a/enlish-vue/src/pages/class.vue
+++ b/enlish-vue/src/pages/class.vue
@@ -7,11 +7,12 @@
 
             <el-main class="p-4">
                 <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
-                    
+
                     <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 ref="classTableRef" :data="classes" border class="w-full" v-loading="loading" highlight-current-row
+                                row-key="id" :current-row-key="selectedClassId" @row-click="onClassRowClick">
                                 <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" />
@@ -25,13 +26,33 @@
                     </div>
 
                     <div class="bg-white dark:bg-gray-800 rounded-lg shadow p-6 lg:col-span-1 lg:row-span-2">
-                        <div class="text-lg font-semibold mb-4">右侧卡片</div>
-                        <div class="text-gray-500">内容待完善</div>
+                        <div class="text-lg font-semibold mb-4">学生查询</div>
+                        <div class="flex flex-wrap items-center gap-3 mb-4">
+                            <el-input v-model="studentName" placeholder="按姓名查询" clearable style="max-width: 220px" />
+                            <el-tag v-if="selectedClassId" effect="plain">班级：{{ selectedClassTitle }} (ID: {{
+                                selectedClassId }})</el-tag>
+                            <el-tag v-if="selectedGradeId" effect="plain">年级：{{ selectedGradeTitle }} (ID: {{
+                                selectedGradeId }})</el-tag>
+                            <el-button type="primary" @click="fetchStudents">查询</el-button>
+                            <el-button @click="resetStudentFilters">重置</el-button>
+                        </div>
+                        <el-table :data="students" border class="w-full" v-loading="studentLoading">
+                            <el-table-column prop="id" label="ID" width="80" />
+                            <el-table-column prop="name" label="姓名" min-width="120" />
+                            <el-table-column prop="classId" label="班级ID" width="100" />
+                            <el-table-column prop="gradeId" label="年级ID" width="100" />
+                        </el-table>
+                        <div class="mt-4 flex justify-end">
+                            <el-pagination background layout="prev, pager, next, sizes, total"
+                                :total="studentTotalCount" :page-size="studentPageSize" :current-page="studentPageNo"
+                                @current-change="handleStudentPageChange" @size-change="handleStudentSizeChange" />
+                        </div>
                     </div>
 
                     <div class="bg-white dark:bg-gray-800 rounded-lg shadow p-6" v-loading="gradeLoading">
                         <div class="text-lg font-semibold mb-4">年级列表</div>
-                        <el-table :data="grades" border class="w-full">
+                        <el-table ref="gradeTableRef" :data="grades" border class="w-full" highlight-current-row row-key="id"
+                            :current-row-key="selectedGradeId" @row-click="onGradeRowClick">
                             <el-table-column prop="id" label="ID" width="80" />
                             <el-table-column prop="title" label="年级名称" min-width="160" />
                         </el-table>
@@ -54,17 +75,30 @@ import Header from '@/layouts/components/Header.vue'
 import { ref, onMounted } from 'vue'
 import { getClassList } from '@/api/class'
 import { getGradeList } from '@/api/grade'
+import { getStudentList } from '@/api/student'
 
 const classes = ref([])
 const pageNo = ref(1)
 const pageSize = ref(10)
 const totalCount = ref(0)
 const loading = ref(false)
+const classTableRef = ref(null)
+const selectedClassId = ref(null)
+const selectedClassTitle = ref('')
 const grades = ref([])
 const gradePageNo = ref(1)
 const gradePageSize = ref(10)
 const gradeTotalCount = ref(0)
 const gradeLoading = ref(false)
+const gradeTableRef = ref(null)
+const selectedGradeId = ref(null)
+const selectedGradeTitle = ref('')
+const students = ref([])
+const studentPageNo = ref(1)
+const studentPageSize = ref(10)
+const studentTotalCount = ref(0)
+const studentLoading = ref(false)
+const studentName = ref('')
 
 async function fetchClasses() {
     loading.value = true
@@ -94,6 +128,27 @@ async function fetchGrades() {
     }
 }
 
+async function fetchStudents() {
+    studentLoading.value = true
+    try {
+        const payload = {
+            name: studentName.value || null,
+            classId: selectedClassId.value ?? null,
+            gradeId: selectedGradeId.value ?? null,
+            pageNo: studentPageNo.value,
+            pageSize: studentPageSize.value
+        }
+        const res = await getStudentList(payload)
+        const d = res.data
+        students.value = Array.isArray(d.data) ? d.data : []
+        studentTotalCount.value = d.totalCount || 0
+        studentPageNo.value = d.pageNo || studentPageNo.value
+        studentPageSize.value = d.pageSize || studentPageSize.value
+    } finally {
+        studentLoading.value = false
+    }
+}
+
 function handlePageChange(p) {
     pageNo.value = p
     fetchClasses()
@@ -114,8 +169,44 @@ function handleGradeSizeChange(s) {
     fetchGrades()
 }
 
+function handleStudentPageChange(p) {
+    studentPageNo.value = p
+    fetchStudents()
+}
+function handleStudentSizeChange(s) {
+    studentPageSize.value = s
+    studentPageNo.value = 1
+    fetchStudents()
+}
+function onClassRowClick(row) {
+    selectedClassId.value = row.id
+    selectedClassTitle.value = row.title
+    classTableRef.value?.setCurrentRow(row)
+    studentPageNo.value = 1
+    fetchStudents()
+}
+function onGradeRowClick(row) {
+    selectedGradeId.value = row.id
+    selectedGradeTitle.value = row.title
+    gradeTableRef.value?.setCurrentRow(row)
+    studentPageNo.value = 1
+    fetchStudents()
+}
+function resetStudentFilters() {
+    studentName.value = ''
+    selectedClassId.value = null
+    selectedClassTitle.value = ''
+    selectedGradeId.value = null
+    selectedGradeTitle.value = ''
+    classTableRef.value?.setCurrentRow()
+    gradeTableRef.value?.setCurrentRow()
+    studentPageNo.value = 1
+    fetchStudents()
+}
+
 onMounted(() => {
     fetchClasses()
     fetchGrades()
+    fetchStudents()
 })
 </script>