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>

61
enlish-vue/src/api/plan.js
View File

@@ -6,3 +6,64 @@ export function generateLessonPlan(studentId, unitId) {
unitId: unitId
})
}
export function downloadLessonPlan(data) {
return axios.post('/plan/download', data, {
// 1. 重要：必须指定响应类型为 blob，否则下载的文件会损坏（乱码）
responseType: 'blob',
headers: {
'Content-Type': 'application/json; application/octet-stream' // 根据需要调整
}
}).then(response => {
// 2. 提取文件名 (处理后端设置的 Content-Disposition)
// 后端示例: header("Content-Disposition", "attachment; filename*=UTF-8''" + fileName)
let fileName = 'download.zip'; // 默认兜底文件名
const contentDisposition = response.headers['content-disposition'];
if (contentDisposition) {
// 正则提取 filename*=utf-8''xxx.zip 或 filename="xxx.zip"
const fileNameMatch = contentDisposition.match(/filename\*?=['"]?(?:UTF-\d['"]*)?([^;\r\n"']*)['"]?;?/);
if (fileNameMatch && fileNameMatch[1]) {
// 后端如果用了 URLEncoder，这里需要 decode
fileName = decodeURIComponent(fileNameMatch[1]);
}
}
// 3. 开始下载流程
resolveBlob(response.data, fileName);
}).catch(error => {
console.error('下载失败', error);
showMessage('下载失败' + error, 'error');
// 注意：如果后端报错返回 JSON，因为 responseType 是 blob，
// 这里看到的 error.response.data 也是 blob，需要转回文本才能看到错误信息
const reader = new FileReader();
reader.readAsText(error.response.data);
reader.onload = () => {
console.log(JSON.parse(reader.result)); // 打印后端实际报错
}
});
}
const resolveBlob = (res, fileName) => {
// 创建 Blob 对象，可以指定 type，也可以让浏览器自动推断
const blob = new Blob([res], { type: 'application/octet-stream' });
// 兼容 IE/Edge (虽然现在很少用了)
if (window.navigator.msSaveOrOpenBlob) {
navigator.msSaveBlob(blob, fileName);
} else {
// 创建一个临时的 URL 指向 Blob
const link = document.createElement('a');
link.href = window.URL.createObjectURL(blob);
link.download = fileName;
// 触发点击
link.style.display = 'none';
document.body.appendChild(link);
link.click();
// 清理资源
document.body.removeChild(link);
window.URL.revokeObjectURL(link.href);
}
};

34
enlish-vue/src/pages/LearningPlan.vue
View File

@@ -19,16 +19,25 @@
<div class="p-3">
<div class="text-sm font-semibold mb-2">学案</div>
<el-table :data="row.plans || []" size="small" border>
<el-table-column prop="id" label="学案ID" width="100" />
<el-table-column prop="id" label="计划ID" width="100" />
<el-table-column prop="title" label="标题" min-width="280" />
<el-table-column label="状态" width="120">
<template #default="{ row: plan }">
<el-tag :type="plan.isFinished === 1 ? 'success' : 'info'"
effect="plain">
<el-tag :type="plan.isFinished === 1 ? 'success' : 'info'" effect="plain">
{{ plan.isFinished === 1 ? '已完成' : '未完成' }}
</el-tag>
</template>
</el-table-column>
<el-table-column label="操作" width="120" fixed="right">
<template #default="{ row: plan }">
<el-button
type="primary"
size="small"
:loading="downloadingIds.includes(plan.id)"
@click="onDownload(plan)"
>下载</el-button>
</template>
</el-table-column>
</el-table>
</div>
</template>
@@ -54,6 +63,8 @@
import Header from '@/layouts/components/Header.vue'
import { ref, onMounted } from 'vue'
import { findStudentLessonPlans } from '@/api/studentLessonPlans'
import { downloadLessonPlan } from '@/api/plan'
import { showMessage } from '@/composables/util'
const rows = ref([])
const loading = ref(false)
@@ -62,6 +73,7 @@ const pageSize = ref(10)
const totalCount = ref(0)
const searchName = ref('')
const tableRef = ref(null)
const downloadingIds = ref([])
async function fetchLessonPlans() {
loading.value = true
@@ -96,6 +108,22 @@ function onReset() {
fetchLessonPlans()
}
async function onDownload(plan) {
if (!plan?.id) {
showMessage('无效的计划ID', 'error')
return
}
if (!downloadingIds.value.includes(plan.id)) {
downloadingIds.value = [...downloadingIds.value, plan.id]
}
try {
await downloadLessonPlan({ id: plan.id })
showMessage('开始下载', 'success')
} finally {
downloadingIds.value = downloadingIds.value.filter(id => id !== plan.id)
}
}
onMounted(() => {
fetchLessonPlans()
})