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

feat(plan): 支持学案文件下载功能

Browse Source 
- 新增 DownLoadLessonPlanReqVO 请求类用于下载请求封装
- 在前端学案列表增加“下载”按钮，支持单条学案下载操作
- 实现前端下载接口，处理后端返回的 Blob 文件流并触发文件保存
- 后端新增下载接口，根据学案 ID 生成对应的 Word 文档并作为附件响应
- WordExportUtil 中新增按模板生成学案 Word 文档方法，支持工作日和周末模板切换
- LessonPlansService 新增根据 ID 查询学案的方法及对应 Mapper 实现
- 修改学案列表中“学案ID”标签为“计划ID”，提升表述准确性
- 下载过程中添加加载状态和错误信息提示，提升用户体验
This commit is contained in:
lbw
2025-12-17 15:56:55 +08:00
parent dbe7312633
commit fd828442b1
9 changed files with 196 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
enlish-service/src/main/java/com/yinlihupo/enlish/service/controller/LessonPlanController.java
View File

@@ -1,16 +1,23 @@
package com.yinlihupo.enlish.service.controller;
import com.yinlihupo.enlish.service.domain.dataobject.LessonPlansDO;
import com.yinlihupo.enlish.service.model.vo.plan.AddLessonPlanReqVO;
import com.yinlihupo.enlish.service.model.vo.plan.DownLoadLessonPlanReqVO;
import com.yinlihupo.enlish.service.service.LessonPlansService;
import com.yinlihupo.enlish.service.utils.WordExportUtil;
import com.yinlihupo.framework.biz.operationlog.aspect.ApiOperationLog;
import com.yinlihupo.framework.common.response.Response;
import com.yinlihupo.framework.common.util.JsonUtils;
import jakarta.annotation.Resource;
import jakarta.servlet.http.HttpServletResponse;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
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.Map;
import java.util.concurrent.Executor;
@RequestMapping("/plan/")
@@ -24,6 +31,11 @@ public class LessonPlanController {
@Resource(name = "taskExecutor")
private Executor taskExecutor;
@Value("${templates.plan.weekday}")
private String planWeekday;
@Value("${templates.plan.weekend}")
private String planWeekend;
@PostMapping("generate")
@ApiOperationLog(description = "生成学案")
public Response<String> generateLessonPlan(@RequestBody AddLessonPlanReqVO addLessonPlanReqVO) {
@@ -38,4 +50,22 @@ public class LessonPlanController {
}
}
@PostMapping("download")
public void downloadLessonPlan(@RequestBody DownLoadLessonPlanReqVO downLoadLessonPlanReqVO, HttpServletResponse response) {
Integer id = downLoadLessonPlanReqVO.getId();
LessonPlansDO lessonPlanById = lessonPlanService.findLessonPlanById(id);
try {
Map<String, Object> map = JsonUtils.parseMap(lessonPlanById.getContentDetails(), String.class, Object.class);
if (!lessonPlanById.getTitle().contains("复习")) {
WordExportUtil.generateLessonPlanDocx(map, lessonPlanById.getTitle(), response, planWeekday, true);
} else {
WordExportUtil.generateLessonPlanDocx(map, lessonPlanById.getTitle(), response, planWeekend, false);
}
} catch (Exception e) {
throw new RuntimeException(e);
}
}
}

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

@@ -12,4 +12,6 @@ public interface LessonPlansDOMapper {
LessonPlansDO selectById(Integer id);
List<LessonPlansDO> findLessonPlansByStudentId(@Param("ids") List<Integer> ids);
LessonPlansDO selectByLessonId(@Param("lessonId") Integer lessonId);
}

15
enlish-service/src/main/java/com/yinlihupo/enlish/service/model/vo/plan/DownLoadLessonPlanReqVO.java Normal file
View File

@@ -0,0 +1,15 @@
package com.yinlihupo.enlish.service.model.vo.plan;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
@AllArgsConstructor
@NoArgsConstructor
@Data
@Builder
public class DownLoadLessonPlanReqVO {
private Integer id;
}

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

@@ -8,4 +8,6 @@ public interface LessonPlansService {
void generateLessonPlans(Integer studentId, Integer unitId);
List<LessonPlansDO> findLessonPlans(List<Integer> ids);
LessonPlansDO findLessonPlanById(Integer id);
}

5
enlish-service/src/main/java/com/yinlihupo/enlish/service/service/plan/LessonPlansServiceImpl.java
View File

@@ -154,6 +154,11 @@ public class LessonPlansServiceImpl implements LessonPlansService {
return lessonPlansDOMapper.findLessonPlansByStudentId(ids);
}
@Override
public LessonPlansDO findLessonPlanById(Integer id) {
return lessonPlansDOMapper.selectByLessonId(id);
}
private Map<String, Object> generateWeekendPlans(List<VocabularyBankDO> checkList,
int day,

44
enlish-service/src/main/java/com/yinlihupo/enlish/service/utils/WordExportUtil.java
View File

@@ -16,6 +16,8 @@ import java.util.zip.ZipOutputStream;
public class WordExportUtil {
private static final Configure config;
private static final Configure configLessonPlanWeekday;
private static final Configure configLessonPlanWeekend;
static {
LoopRowTableRenderPolicy policy = new LoopRowTableRenderPolicy();
@@ -23,6 +25,24 @@ public class WordExportUtil {
.bind("words", policy)
.bind("answer", policy)
.build();
LoopRowTableRenderPolicy policyLessonPlanWeekday = new LoopRowTableRenderPolicy();
configLessonPlanWeekday = Configure.builder()
.bind("syncVocabList", policyLessonPlanWeekday)
.bind("gapVocabList", policyLessonPlanWeekday)
.bind("reviewVocabList", policyLessonPlanWeekday)
.bind("drillRound1", policyLessonPlanWeekday)
.bind("drillRound2", policyLessonPlanWeekday)
.bind("drillRound3", policyLessonPlanWeekday)
.bind("mixedDrill", policyLessonPlanWeekday)
.bind("checkList", policyLessonPlanWeekday)
.bind("checkListAns", policyLessonPlanWeekday)
.build();
LoopRowTableRenderPolicy policyLessonPlan = new LoopRowTableRenderPolicy();
configLessonPlanWeekend = Configure.builder()
.bind("checkList", policyLessonPlan)
.build();
}
/**
@@ -47,6 +67,28 @@ public class WordExportUtil {
}
}
public static void generateLessonPlanDocx(Map<String, Object> map, String fileName, HttpServletResponse response, String templateWordPath, boolean isWeekday) throws IOException {
fileName = URLEncoder.encode(fileName + ".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(templateWordPath)) {
XWPFTemplate template;
if (isWeekday) {
template = XWPFTemplate.compile(inputStream, configLessonPlanWeekday);
} else {
template = XWPFTemplate.compile(inputStream, configLessonPlanWeekend);
}
OutputStream out = response.getOutputStream();
template.render(map);
template.write(out);
template.close();
out.flush();
}
}
/**
* 核心补充：批量渲染并打包为 ZIP
*/
@@ -103,7 +145,7 @@ public class WordExportUtil {
*/
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");
String fileName = URLEncoder.encode("摸底测试" + ".docx", StandardCharsets.UTF_8).replaceAll("\\+", "%20");
// 3. 设置响应头
response.setContentType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");

6
enlish-service/src/main/resources/mapper/LessonPlansDOMapper.xml
View File

@@ -33,4 +33,10 @@
</if>
</select>
<select id="selectByLessonId" resultMap="ResultMapWithBLOBs">
select *
from lesson_plans
where id = #{lessonId}
</select>
</mapper>