Java通过freemarker生成Word文档导出的方式详解

        <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 文件并导出
     * @param templateName 模板文件路径名称
     * @param fileName 生成的文件路径以及名称
     * @param dataModel 填充的数据对象
     * @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 生成指定文件并导出
     * @param templateName 模板文件路径名称
     * @param fileName 生成的文件路径以及名称
     * @param dataModel 填充的数据对象
     * @param obj 基准类对象
     * @param response HttpServletResponse 对象
     */
    private static void generateFile(String templateName, String fileName, Map<String, Object> dataModel, Object obj, HttpServletResponse response) {
        try {
            // 1、创建配置对象
            Configuration config = new Configuration(Configuration.VERSION_2_3_30);
            config.setDefaultEncoding("utf-8");
            //设置了模板文件的加载类和路径，使得Freemarker可以从指定的类路径下的/templates目录中加载模板文件。
            config.setClassForTemplateLoading(obj.getClass(), "/templates");
            // 2、获取模板文件
            Template template = config.getTemplate(templateName);
            // 3、设置响应头
            response.setContentType("application/msword");
            response.setHeader("Content-Disposition", "attachment; filename=\"" + fileName + "\"");
            // 4、创建写入器
            Writer writer = new BufferedWriter(new OutputStreamWriter(response.getOutputStream(), StandardCharsets.UTF_8));
            // 5、渲染模板文件
            template.process(dataModel, writer);
            // 6、关闭写入器
            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", "测试机构02141151");
        dataModel.put("data", "2025-02-14");
        // 执行导出
        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", "测试机构02141151");
        dataModel.put("data", "2025-02-14");
        //☑ □
        dataModel.put("test1", "□");
        dataModel.put("test2", "☑");
        
        // 执行导出
        FreemarkerUtil.exportWord(templateName, fileName, dataModel,this,response);
    }
}

//whyc 是集合(collection)的表达式，yc是循环变量的名字，不能是表达式
<#list whyc as yc>
 需要循环的部分 变量用${(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","供应商管理部门审核意见");
        dataModel.put("supplierSituationDesc","供应商管理部门情况描述");
 
        dataModel1.put("companyName","com20250221001");
        dataModel1.put("supplierReasonDesc","供应商管理部门原因11111");
        dataModel2.put("companyName","com20250221002");
        dataModel2.put("supplierReasonDesc","供应商管理部门原因22222");
        dataModel3.put("companyName","com20250221003");
        dataModel3.put("supplierReasonDesc","供应商管理部门原因33333");
 
        list.add(dataModel1);
        list.add(dataModel2);
        list.add(dataModel3);
        dataModel.put("whyc",list);
        // 执行导出
        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;
    }