<dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.30</version>
        </dependency>

import freemarker.template.Configuration;
import freemarker.template.Template;
 
import javax.servlet.http.HttpServletResponse;
import java.io.BufferedWriter;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.nio.charset.StandardCharsets;
import java.util.Map;
 
/**
 * @version 1.0.0
 * @Date: 2025/2/14 15:05
 * @Author SYG
 * @Description: Freemarker 工具類
 */
public class FreemarkerUtil {
 
    /**
     * 使用 Freemarker 生成 Word 文件并導(dǎo)出
     * @param templateName 模板文件路徑名稱
     * @param fileName 生成的文件路徑以及名稱
     * @param dataModel 填充的數(shù)據(jù)對象
     * @param response HttpServletResponse 對象
     */
    public static void exportWord(String templateName, String fileName, Map<String, Object> dataModel, Object obj, HttpServletResponse response) {
        generateFile(templateName, fileName, dataModel, obj, response);
    }
 
    /**
     * 使用 Freemarker 生成指定文件并導(dǎo)出
     * @param templateName 模板文件路徑名稱
     * @param fileName 生成的文件路徑以及名稱
     * @param dataModel 填充的數(shù)據(jù)對象
     * @param obj 基準(zhǔn)類對象
     * @param response HttpServletResponse 對象
     */
    private static void generateFile(String templateName, String fileName, Map<String, Object> dataModel, Object obj, HttpServletResponse response) {
        try {
            // 1、創(chuàng)建配置對象
            Configuration config = new Configuration(Configuration.VERSION_2_3_30);
            config.setDefaultEncoding("utf-8");
            //設(shè)置了模板文件的加載類和路徑，使得Freemarker可以從指定的類路徑下的/templates目錄中加載模板文件。
            config.setClassForTemplateLoading(obj.getClass(), "/templates");
            // 2、獲取模板文件
            Template template = config.getTemplate(templateName);
            // 3、設(shè)置響應(yīng)頭
            response.setContentType("application/msword");
            response.setHeader("Content-Disposition", "attachment; filename=\"" + fileName + "\"");
            // 4、創(chuàng)建寫入器
            Writer writer = new BufferedWriter(new OutputStreamWriter(response.getOutputStream(), StandardCharsets.UTF_8));
            // 5、渲染模板文件
            template.process(dataModel, writer);
            // 6、關(guān)閉寫入器
            writer.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
 
}

 
public class ExportWordDemo {
    public static void main(String[] args) {
        String templateName = "opinionCollect.ftl";
        String fileName = "opinionCollect.docx";
        Map<String, Object> dataModel = new HashMap<>();
        dataModel.put("orgName", "測試機(jī)構(gòu)02141151");
        dataModel.put("data", "2025-02-14");
        // 執(zhí)行導(dǎo)出
        FreemarkerUtil.exportWord(templateName, fileName, dataModel,this,response);
    }
}

public class ExportWordDemo {
    public static void main(String[] args) {
        String templateName = "opinionCollect.ftl";
        String fileName = "opinionCollect.docx";
        Map<String, Object> dataModel = new HashMap<>();
        dataModel.put("orgName", "測試機(jī)構(gòu)02141151");
        dataModel.put("data", "2025-02-14");
        //? □
        dataModel.put("test1", "□");
        dataModel.put("test2", "?");
        
        // 執(zhí)行導(dǎo)出
        FreemarkerUtil.exportWord(templateName, fileName, dataModel,this,response);
    }
}

//whyc 是集合(collection)的表達(dá)式，yc是循環(huán)變量的名字，不能是表達(dá)式
<#list whyc as yc>
 需要循環(huán)的部分 變量用${(yc.supplierReasonDesc)!}
</#list>

    public void exportWord(@RequestBody OpinionCollectFeedbackQueryVO query, HttpServletResponse response) throws Exception {
        String templateName = "problemSummary.ftl";
        String fileName = "problemSummary.docx";
        Map<String, Object> dataModel = new HashMap<>();
        Map<String, Object> dataModel1 = new HashMap<>();
        Map<String, Object> dataModel2 = new HashMap<>();
        Map<String, Object> dataModel3 = new HashMap<>();
        List<Map<String, Object>> list = new ArrayList<>();
        dataModel.put("aptitudeTaskCode","202502211035");
        dataModel.put("companyName","com20250221");
        dataModel.put("supplierOpinion","供應(yīng)商管理部門審核意見");
        dataModel.put("supplierSituationDesc","供應(yīng)商管理部門情況描述");
 
        dataModel1.put("companyName","com20250221001");
        dataModel1.put("supplierReasonDesc","供應(yīng)商管理部門原因11111");
        dataModel2.put("companyName","com20250221002");
        dataModel2.put("supplierReasonDesc","供應(yīng)商管理部門原因22222");
        dataModel3.put("companyName","com20250221003");
        dataModel3.put("supplierReasonDesc","供應(yīng)商管理部門原因33333");
 
        list.add(dataModel1);
        list.add(dataModel2);
        list.add(dataModel3);
        dataModel.put("whyc",list);
        // 執(zhí)行導(dǎo)出
        FreemarkerUtil.exportWord(templateName, fileName, dataModel,this,response);
    }

    public List<Map<String, Object>> checkList(List<Map<String, Object>> list){
        String start = "<w:vMerge w:val=\"restart\"/>";
        String end = "<w:vMerge w:val=\"continue\"/>";
        list.get(0).put("start",start);
        for (int i = 1; i < list.size(); i++) {
            list.get(i).put("end",end);
        }
        return list;
    }