LeiBoWen/en-edu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(exam): 实现按学生批量生成并下载试题功能

Browse Source 
- 增加学生多选功能和生成试题按钮，支持批量操作
- 新增ExamGenerateDialog组件，提供选择年级和难度界面
- 设计后端接口支持多个学生ID，生成对应的试题文档
- 在后端实现批量生成Word文档并压缩打包下载
- 新增StudentDetail业务对象，完善学生信息展示
- 优化了Mapper接口及XML，支持批量查询学生和班级数据
- 提供前端API封装用于调用试题生成和下载服务
- 实现下载失败时的错误处理与提示机制
This commit is contained in:
lbw
2025-12-15 14:26:24 +08:00
parent 89df9af8c6
commit e3b993dd27
16 changed files with 406 additions and 47 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -31,7 +31,7 @@ public class ClassController {
int total = classService.getClassCount();
List<ClassDO> classList = classService.findClassList(page, pageSize);
Map<Integer, GradeDO> classId2GradeMap = classService.findClassId2GradeMap(classList.stream().map(ClassDO::getId).toList());
Map<Integer, GradeDO> classId2GradeMap = classService.findClassIds2GradeMap(classList.stream().map(ClassDO::getId).toList());
List<FindClassRspVO> findClassRspVOS = classList.stream().map(classDO -> FindClassRspVO.builder()
.id(classDO.getId())
.title(classDO.getTitle())

61
enlish-service/src/main/java/com/yinlihupo/enlish/service/controller/ExamWordsController.java
View File

@@ -1,17 +1,17 @@
package com.yinlihupo.enlish.service.controller;
import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.config.Configure;
import com.deepoove.poi.plugin.table.LoopRowTableRenderPolicy;
import com.yinlihupo.enlish.service.domain.dataobject.ExamWordsDO;
import com.yinlihupo.enlish.service.domain.dataobject.ExamWordsJudgeResultDO;
import com.yinlihupo.enlish.service.domain.dataobject.VocabularyBankDO;
import com.yinlihupo.enlish.service.model.bo.StudentDetail;
import com.yinlihupo.enlish.service.model.bo.Word;
import com.yinlihupo.enlish.service.model.vo.exam.*;
import com.yinlihupo.enlish.service.service.ExamWordsJudgeService;
import com.yinlihupo.enlish.service.service.ExamWordsService;
import com.yinlihupo.enlish.service.service.StudentService;
import com.yinlihupo.enlish.service.service.VocabularyService;
import com.yinlihupo.enlish.service.utils.WordExportUtil;
import com.yinlihupo.framework.biz.operationlog.aspect.ApiOperationLog;
import com.yinlihupo.framework.common.response.PageResponse;
import com.yinlihupo.framework.common.response.Response;
@@ -22,14 +22,7 @@ import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import java.io.FileInputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.*;
@RequestMapping("/exam/words/")
@RestController
@@ -44,8 +37,10 @@ public class ExamWordsController {
private String templateWordPath;
@Resource
private ExamWordsJudgeService examWordsJudgeService;
@Resource
private StudentService studentService;
@PostMapping("genexam")
@PostMapping("generate")
public void generateFeltExamWords(@RequestBody GenerateExamWordsReqVO generateExamWordsReqVO, HttpServletResponse response) {
Integer gradeId = generateExamWordsReqVO.getGradeId();
Integer level = generateExamWordsReqVO.getLevel();
@@ -56,43 +51,25 @@ public class ExamWordsController {
try {
ExamWordsDO examWordsDO = examWordsService.generateExamWords(gradeId, level, studentIds);
List<VocabularyBankDO> vocabularyBankDOS = vocabularyService.findVocabularyBankDOListById(examWordsDO.getWordIds());
List<Word> assessmentWords = vocabularyBankDOS.stream().map(vocabularyBankDO -> Word.builder()
.id(vocabularyBankDO.getId())
.title(vocabularyBankDO.getWord())
.definition(vocabularyBankDO.getDefinition())
.build()).toList();
// 配置 POI-TL
LoopRowTableRenderPolicy policy = new LoopRowTableRenderPolicy();
Configure config = Configure.builder()
.bind("words", policy)
.bind("answer", policy)
.build();
List<StudentDetail> studentDetailList = studentService.getStudentDetailList(studentIds);
List<Map<String, Object>> maps = studentDetailList.stream().map(studentDetail -> {
Map<String, Object> data = new HashMap<>();
data.put("examId", examWordsDO.getId());
data.put("studentId", studentDetail.getId());
data.put("studentStr", studentDetail.getName() + studentDetail.getClassName() + studentDetail.getGradeName());
data.put("examStr", examWordsDO.getTitle());
data.put("words", assessmentWords);
data.put("answer", assessmentWords);
return data;
}).toList();
Map<String, Object> data = new HashMap<>();
data.put("examId", examWordsDO.getId());
data.put("studentId", studentIds.get(0));
data.put("studentStr","小明三班一年级");
data.put("examStr", examWordsDO.getTitle());
data.put("words", assessmentWords);
data.put("answer", assessmentWords);
// 2. 设置文件名编码
String fileName = URLEncoder.encode(examWordsDO.getId() + "摸底测试.docx", StandardCharsets.UTF_8).replaceAll("\\+", "%20");
// 3. 设置响应头
response.setContentType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
response.setHeader("Content-Disposition", "attachment; filename*=UTF-8''" + fileName);
try (InputStream inputStream = new FileInputStream(this.templateWordPath);
XWPFTemplate template = XWPFTemplate.compile(inputStream, config);
OutputStream out = response.getOutputStream()) {
template.render(data);
template.write(out);
out.flush();
}
WordExportUtil.generateExamWords(maps, response, templateWordPath);
} catch (Exception e) {

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

@@ -12,4 +12,6 @@ public interface ClassDOMapper {
List<ClassDO> selectClassDOList(@Param("startIndex") Integer startIndex, @Param("pageSize") Integer pageSize);
Integer selectClassDOCount();
List<ClassDO> selectClassDOListByIds(@Param("classIds") List<Integer> classIds);
}

2
enlish-service/src/main/java/com/yinlihupo/enlish/service/domain/mapper/StudentDOMapper.java
View File

@@ -12,4 +12,6 @@ public interface StudentDOMapper {
int selectStudentCount();
StudentDO selectStudentById(Integer id);
List<StudentDO> selectStudentDOListByIds(@Param("ids") List<Integer> ids);
}

19
enlish-service/src/main/java/com/yinlihupo/enlish/service/model/bo/StudentDetail.java Normal file
View File

@@ -0,0 +1,19 @@
package com.yinlihupo.enlish.service.model.bo;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
@AllArgsConstructor
@NoArgsConstructor
@Data
@Builder
public class StudentDetail {
private Integer id;
private String name;
private Integer classId;
private String className;
private Integer gradeId;
private String gradeName;
}

2
enlish-service/src/main/java/com/yinlihupo/enlish/service/service/ClassService.java
View File

@@ -14,5 +14,5 @@ public interface ClassService {
int getClassCount();
Map<Integer, GradeDO> findClassId2GradeMap(List<Integer> classIds);
Map<Integer, GradeDO> findClassIds2GradeMap(List<Integer> classIds);
}

3
enlish-service/src/main/java/com/yinlihupo/enlish/service/service/StudentService.java
View File

@@ -2,6 +2,7 @@ package com.yinlihupo.enlish.service.service;
import com.yinlihupo.enlish.service.domain.dataobject.StudentDO;
import com.yinlihupo.enlish.service.model.bo.StudentDetail;
import java.util.List;
@@ -12,4 +13,6 @@ public interface StudentService {
int getAllStudents();
StudentDO getStudentById(Integer studentId);
List<StudentDetail> getStudentDetailList(List<Integer> studentIdList);
}

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

@@ -41,7 +41,7 @@ public class ClassServiceImpl implements ClassService {
}
@Override
public Map<Integer, GradeDO> findClassId2GradeMap(List<Integer> classIds) {
public Map<Integer, GradeDO> findClassIds2GradeMap(List<Integer> classIds) {
List<GradeClassDO> gradeClassDOS = gradeClassDOMapper.selectByClassIds(classIds);
List<GradeDO> gradeDOS = gradeDOMapper.selectByGradeIds(gradeClassDOS.stream().map(GradeClassDO::getGradeId).toList());

2
enlish-service/src/main/java/com/yinlihupo/enlish/service/service/exam/ExamWordsServiceImpl.java
View File

@@ -56,7 +56,7 @@ public class ExamWordsServiceImpl implements ExamWordsService {
ExamWordsDO examWordsDO = ExamWordsDO.builder()
.gradeId(gradeId)
.level(level)
.title("测试")
.title(LocalDateTime.now() + "测试")
.createdAt(LocalDateTime.now())
.wordIds(vocabularyBankDOS.stream().map(VocabularyBankDO::getId).toList())
.build();

36
enlish-service/src/main/java/com/yinlihupo/enlish/service/service/student/StudentServiceImpl.java
View File

@@ -1,19 +1,30 @@
package com.yinlihupo.enlish.service.service.student;
import com.yinlihupo.enlish.service.domain.dataobject.ClassDO;
import com.yinlihupo.enlish.service.domain.dataobject.GradeDO;
import com.yinlihupo.enlish.service.domain.dataobject.StudentDO;
import com.yinlihupo.enlish.service.domain.mapper.ClassDOMapper;
import com.yinlihupo.enlish.service.domain.mapper.GradeDOMapper;
import com.yinlihupo.enlish.service.domain.mapper.StudentDOMapper;
import com.yinlihupo.enlish.service.model.bo.StudentDetail;
import com.yinlihupo.enlish.service.service.StudentService;
import jakarta.annotation.Resource;
import org.springframework.stereotype.Service;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;
@Service
public class StudentServiceImpl implements StudentService {
@Resource
private StudentDOMapper studentDOMapper;
@Resource
private GradeDOMapper gradeDOMapper;
@Resource
private ClassDOMapper classDOMapper;
@Override
public List<StudentDO> getStudentsByClassIdAndGradeId(Integer classId, Integer gradeId, String name, Integer pageNo, Integer pageSize) {
@@ -30,4 +41,29 @@ public class StudentServiceImpl implements StudentService {
public StudentDO getStudentById(Integer studentId) {
return studentDOMapper.selectStudentById(studentId);
}
@Override
public List<StudentDetail> getStudentDetailList(List<Integer> studentIdList) {
List<StudentDO> studentDOS = studentDOMapper.selectStudentDOListByIds(studentIdList);
Map<Integer, GradeDO> gradeId2GradeDO = gradeDOMapper.selectByGradeIds(studentDOS.stream().map(StudentDO::getGradeId).toList()).stream().collect(Collectors.toMap(
GradeDO::getId,
gradeDO -> gradeDO
));
Map<Integer, ClassDO> classId2ClassDO = classDOMapper.selectClassDOListByIds(studentDOS.stream().map(StudentDO::getClassId).toList()).stream().collect(Collectors.toMap(
ClassDO::getId,
classDO -> classDO
));
return studentDOS.stream().map(studentDO -> StudentDetail.builder()
.id(studentDO.getId())
.name(studentDO.getName())
.classId(studentDO.getClassId())
.className(classId2ClassDO.get(studentDO.getClassId()) != null ? classId2ClassDO.get(studentDO.getClassId()).getTitle() : "")
.gradeId(studentDO.getGradeId())
.gradeName(gradeId2GradeDO.get(studentDO.getGradeId()) != null ? gradeId2GradeDO.get(studentDO.getGradeId()).getTitle() : "")
.build()
).toList();
}
}

121
enlish-service/src/main/java/com/yinlihupo/enlish/service/utils/WordExportUtil.java Normal file
View File

@@ -0,0 +1,121 @@
package com.yinlihupo.enlish.service.utils;
import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.config.Configure;
import com.deepoove.poi.plugin.table.LoopRowTableRenderPolicy;
import jakarta.servlet.http.HttpServletResponse;
import java.io.*;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.List;
import java.util.Map;
import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream;
public class WordExportUtil {
private static final Configure config;
static {
LoopRowTableRenderPolicy policy = new LoopRowTableRenderPolicy();
config = Configure.builder()
.bind("words", policy)
.bind("answer", policy)
.build();
}
/**
* 公共入口：根据数据量决定是导出单文件还是压缩包
*/
public static void generateExamWords(List<Map<String, Object>> data, HttpServletResponse response, String templateWordPath) {
if (data == null || data.isEmpty()) {
return;
}
try {
if (data.size() == 1) {
// 如果只有一份数据，直接导出 docx，用户体验更好
generateExamWordsDocx(data.get(0), response, templateWordPath);
} else {
// 如果有多份数据，打包导出
generateExamWordsZip(data, response, templateWordPath);
}
} catch (IOException e) {
e.printStackTrace();
throw new RuntimeException("导出文档失败", e);
}
}
/**
* 核心补充：批量渲染并打包为 ZIP
*/
private static void generateExamWordsZip(List<Map<String, Object>> data, HttpServletResponse response, String templateWordPath) throws IOException {
// 1. 设置响应头为 ZIP
String zipName = URLEncoder.encode("批量导出_摸底测试.zip", StandardCharsets.UTF_8).replaceAll("\\+", "%20");
response.setContentType("application/zip");
response.setHeader("Content-Disposition", "attachment; filename*=UTF-8''" + zipName);
// 2. 创建 ZipOutputStream 包装 Response 输出流
// 使用 try-with-resources 自动关闭 zipOut
try (ZipOutputStream zipOut = new ZipOutputStream(response.getOutputStream())) {
int index = 1;
for (Map<String, Object> itemData : data) {
// 3. 确定压缩包内的文件名
// 优先从 map 中获取 'fileName' 字段，否则使用默认编号
String entryName = (String) itemData.getOrDefault("fileName", "摸底测试_" + index);
// 确保文件名后缀正确
if (!entryName.endsWith(".docx")) {
entryName += ".docx";
}
// 4. 创建 ZIP 条目
ZipEntry zipEntry = new ZipEntry(entryName);
zipOut.putNextEntry(zipEntry);
// 5. 加载模板并渲染
// 注意：每次循环都需要重新读取模板流，因为 poi-tl 渲染会修改文档结构
try (InputStream templateInputStream = new FileInputStream(templateWordPath)) {
XWPFTemplate template = XWPFTemplate.compile(templateInputStream, config);
template.render(itemData);
// 6. 将渲染后的文档直接写入 ZipOutputStream
// template.write 默认不关闭流，所以这里是安全的
template.write(zipOut);
// 显式关闭 template (释放 POI 资源)
template.close();
}
// 7. 关闭当前条目
zipOut.closeEntry();
index++;
}
// 8. 循环结束，zipOut 会在 try 块结束时自动 finish 和 close
response.flushBuffer();
}
}
/**
* 现有的单文件导出逻辑
*/
private static void generateExamWordsDocx(Map<String, Object> data, HttpServletResponse response, String templateWordPath) throws IOException {
String fileName = URLEncoder.encode("摸底测试" + ".docx", StandardCharsets.UTF_8.toString()).replaceAll("\\+", "%20");
// 3. 设置响应头
response.setContentType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
response.setHeader("Content-Disposition", "attachment; filename*=UTF-8''" + fileName);
try (InputStream inputStream = new FileInputStream(templateWordPath)) {
XWPFTemplate template = XWPFTemplate.compile(inputStream, config);
OutputStream out = response.getOutputStream();
template.render(data);
template.write(out);
template.close(); // 最好关闭 template
out.flush();
}
}
}

9
enlish-service/src/main/resources/mapper/ClassDOMapper.xml
View File

@@ -23,5 +23,14 @@
from `class`
</select>
<select id="selectClassDOListByIds" resultType="com.yinlihupo.enlish.service.domain.dataobject.ClassDO">
select *
from `class`
where id in
<foreach collection="classIds" item="classId" separator="," close=")" open="(" index="">
#{classId}
</foreach>
</select>
</mapper>

9
enlish-service/src/main/resources/mapper/StudentDOMapper.xml
View File

@@ -38,4 +38,13 @@
from student
where id = #{id}
</select>
<select id="selectStudentDOListByIds" resultMap="BaseResultMap">
select *
from student
where id in
<foreach item="id" collection="ids" separator="," open="(" close=")" index="index">
#{id}
</foreach>
</select>
</mapper>