java根据模板导出数据到word文档中（表格，自定义标签等）

---

1、制作模板

1.1 创建docx文档，并且创建表格

1.2 配置模板信息

将鼠标的光标移到要输入数据的地方，点击“插入”，点击“文档部件”，点击“域”；选择“邮件合并”，在域代码的函数后加入自定义的字段名“${字段名}”。如果不用循环的话，直接字段名字节定义名称就可以了，如果需要循环，字段名设置为【${对象.属性}】


若需要循环表格内的内容时，处理如下，“域”中“邮件合并”的域代码使用“${对象.属性}”格式，自此，一个简单的模板制作完成

2、代码实现

2.1 pom.xml引入依赖

XDocReport +FreeMarker，该技术组合既简单又高效可实现word模板的编辑，docx和doc均可处理

<dependency>
    <groupId>fr.opensagres.xdocreport</groupId>
    <artifactId>fr.opensagres.xdocreport.core</artifactId>
    <version>2.0.2</version>
</dependency>
<dependency>
    <groupId>fr.opensagres.xdocreport</groupId>
    <artifactId>fr.opensagres.xdocreport.document</artifactId>
    <version>2.0.2</version>
</dependency>
<dependency>
    <groupId>fr.opensagres.xdocreport</groupId>
    <artifactId>fr.opensagres.xdocreport.template</artifactId>
    <version>2.0.2</version>
</dependency>
<dependency>
    <groupId>fr.opensagres.xdocreport</groupId>
    <artifactId>fr.opensagres.xdocreport.document.docx</artifactId>
    <version>2.0.2</version>
</dependency>
<dependency>
    <groupId>fr.opensagres.xdocreport</groupId>
    <artifactId>fr.opensagres.xdocreport.template.freemarker</artifactId>
    <version>2.0.2</version>
</dependency>
<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.23</version>
</dependency>

2.2 创建接收表格内容的对象（也可以没必要，在下面封装中，也可以用map封装）

package com.yhgc.domain;
import lombok.Data;

@Data
public class UserInfo {
	/** 姓名 */
    public String name;
    
	/** 性别 */
    public String sex;
    
	/** 年龄*/
    public String age;
}

2.3 调用的实现

@Test
public void testWord(){
    InputStream ins = null;
    OutputStream out = null;
    try {
        //获取Word模板，模板存放路径
        ins = new FileInputStream("E:\\export\\template\\模板1.docx");
        //注册xdocreport实例并加载FreeMarker模板引擎
        IXDocReport report = XDocReportRegistry.getRegistry().loadReport(ins, TemplateEngineKind.Freemarker);
        //创建xdocreport上下文对象，用于存放具体数据
        IContext context = report.createContext();
        //创建要替换的文本变量
        List<UserInfo> userInfos = new ArrayList<>(); // 这里也可以使用Map集合
        UserInfo userInfo = new UserInfo();
        userInfo.setName("张三");
        userInfo.setAge("15");
        userInfo.setSex("男");
        userInfos.add(userInfo);
        UserInfo userInfo1 = new UserInfo();
        userInfo1.setName("李四");
        userInfo1.setAge("14");
        userInfo1.setSex("男");
        userInfos.add(userInfo1);
        UserInfo userInfo2 = new UserInfo();
        userInfo2.setName("李梅");
        userInfo2.setAge("16");
        userInfo2.setSex("女");
        userInfos.add(userInfo2);

        //此处的userInfo是word中命名的列表名
        context.put("userInfo", userInfos);
        context.put("title", "测试的标题");
        //创建字段元数据
        FieldsMetadata fm = report.createFieldsMetadata();
        //Word模板中的表格数据对应的集合类型
        fm.load("userInfo", UserInfo.class, true);
        //输出到本地目录
        String filePath = "e:\\export\\结果.docx";
        out = new FileOutputStream(new File(filePath));
        report.process(context, out);
    } catch (Exception e) {
        System.out.println("生成word发生异常"+e);
    }finally {
        try {
            if (ins != null){
                ins.close();
            }
            if (out != null){
                out.close();
            }
        } catch (IOException e) {
            System.out.println("文件流关闭失败"+e);
        }
    }
}

2.4 实现效果