使用 poi-tl 模板生成 MS Word 文档
1、概览 poi-tl 是一个基于 Apache POI 的开源 Java 库,用于简化使用模板生成 Word 文档的过程。它是一个 Word 模板引擎,可根据 Word 模板和数据创建新文档。
我们可以在模板中指定样式。从模板生成的文档将保留指定的样式。模板是声明式的,纯粹基于标签,图片、文本、表格等都有不同的标签模式。poi-tl 库还支持自定义插件,以根据需要构建文档。
本文将带你了解模板中可以使用的不同标签,以及模板中自定义插件的用法。
2、依赖 要使用 poi-tl 库,我们需要在项目中添加其 maven 依赖:
<dependency> <groupId>com.deepoove</groupId> <artifactId>poi-tl</artifactId> <version>1.12.2</version> </dependency> 你在 Maven Central 中找到最新版本的 poi-tl 库。
3、配置 使用 ConfigureBuilder 类来构建配置:
ConfigureBuilder builder = Configure.builder(); ... XWPFTemplate template = XWPFTemplate.compile(...).render(templateData); template.writeAndClose(...); 模板文件是以 Word .docx 文件格式保存的。首先,我们使用 XWPFTemplate 类的 compile 方法对模板进行编译。模板引擎编译模板,并根据 templateData 在新的 docx 文件中进行渲染。在这里,writeAndClose 创建一个新文件,并按照模板中指定的格式写入指定的数据。templateData 是一个 HashMap 的实例,其中 Key 为 String,值为 Object。
我们可以根据自己的需要配置模板引擎。
3.1、标签前缀和后缀 模板引擎使用大括号 {{}} 表示标签。我们可以将其设置为 ${} 或其他任何形式: