? 优质资源分享 ?

作者：@pdai本文为作者原创，转载请注明出处：https://blog.csdn.net/pengdai/p/16537534.html

内容目录

• 知识准备
  • 什么是poi-tl
  • poi-tl的TDO模式
• 实现案例
  • Pom依赖
  • 导出基于template的word
  • 导出markdown为word
• 示例源码
• 参考文章
• 更多内容

前文我们介绍了通过Apache POI通过来导出word的例子；那如果是word模板方式，有没有开源库通过模板方式导出word呢？poi-tl是一个基于Apache POI的Word模板引擎，也是一个免费开源的Java类库，你可以非常方便的加入到你的项目中，并且拥有着让人喜悦的特性。本文主要介绍通过SpringBoot集成poi-tl实现模板方式的Word导出功能。

• SpringBoot集成文件 - 集成POI-tl之基于模板的Word导出
  • 知识准备
    • 什么是poi-tl
    • poi-tl的TDO模式
      • Template：模板
      • Data-model：数据
      • Output：输出
  • 实现案例
    • Pom依赖
    • 导出基于template的word
    • 导出markdown为word
  • 示例源码
  • 参考文章
  • 更多内容

知识准备

需要理解文件上传和下载的常见场景和技术手段。@pdai

什么是poi-tl

如下内容来源于，poi-tl官网。

poi-tl（poi template language）是Word模板引擎，使用Word模板和数据创建很棒的Word文档。

优势：

它还支持自定义插件，如下是官网代码仓库支持的特性

poi-tl supports custom functions (plug-ins), functions can be executed anywhere in the Word template, do anything anywhere in the document is the goal of poi-tl.

poi-tl的TDO模式

TDO模式：Template + data-model = output

以官网的例子为例：

XWPFTemplate template = XWPFTemplate.compile("template.docx").render(
  new HashMap(){{
 put("title", "Hi, poi-tl Word模板引擎");
}}); 
template.writeAndClose(new FileOutputStream("output.docx")); 

• compile 编译模板 - Template
• render 渲染数据 - data-model
• write 输出到流 - output

Template：模板

模板是Docx格式的Word文档，你可以使用Microsoft office、WPS Office、Pages等任何你喜欢的软件制作模板，也可以使用Apache POI代码来生成模板。

所有的标签都是以{{开头，以}}结尾，标签可以出现在任何位置，包括页眉，页脚，表格内部，文本框等，表格布局可以设计出很多优秀专业的文档，推荐使用表格布局。

poi-tl模板遵循“所见即所得”的设计，模板和标签的样式会被完全保留。

Data-model：数据

数据类似于哈希或者字典，可以是Map结构（key是标签名称）：

Map data = new HashMap<>();
data.put("name", "Sayi");
data.put("start\_time", "2019-08-04");

可以是对象（属性名是标签名称）：

public class Data {
  private String name;
  private String startTime;
  private Author author;
}

数据可以是树结构，每级之间用点来分隔开，比如{ {author.name} }标签对应的数据是author对象的name属性值。

Word模板不是由简单的文本表示，所以在渲染图片、表格等元素时提供了数据模型，它们都实现了接口RenderData，比如图片数据模型PictureRenderData包含图片路径、宽、高三个属性。

Output：输出

以流的方式进行输出：

template.write(OutputStream stream);

可以写到任意输出流中，比如文件流：

template.write(new FileOutputStream("output.docx"));

比如网络流：

response.setContentType("application/octet-stream");
response.setHeader("Content-disposition","attachment;filename=\""+"out\_template.docx"+"\"");

// HttpServletResponse response
OutputStream out = response.getOutputStream();
BufferedOutputStream bos = new BufferedOutputStream(out);
template.write(bos);
bos.flush();
out.flush();
PoitlIOUtils.closeQuietlyMulti(template, bos, out); // 最后不要忘记关闭这些流。

实现案例

这里展示SpringBoot集成poi-tl基于word模板导出Word， 以及导出markdown为word的例子。

Pom依赖

引入poi的依赖包

基础的包：

<dependency>
    <groupId>com.deepoovegroupId>
    <artifactId>poi-tlartifactId>
    <version>1.12.0version>
dependency>

插件的包如下，比如highlight,markdown包

<dependency>
    <groupId>com.deepoovegroupId>
    <artifactId>poi-tl-plugin-highlightartifactId>
    <version>1.0.0version>
dependency>
<dependency>
    <groupId>com.deepoovegroupId>
    <artifactId>poi-tl-plugin-markdownartifactId>
    <version>1.0.3version>
dependency>

导出基于template的word

controller中的方法

@ApiOperation("Download Word")
@GetMapping("/word/download")
public void download(HttpServletResponse response) {
    try {
        XWPFTemplate document = userService.generateWordXWPFTemplate();
        response.reset();
        response.setContentType("application/octet-stream");
        response.setHeader("Content-disposition",
                "attachment;filename=user\_word\_" + System.currentTimeMillis() + ".docx");
        OutputStream os = response.getOutputStream();
        document.write(os);
        os.close();
    } catch (Exception e) {
        e.printStackTrace();
    }
}

Service中的实际方法

@Override
public XWPFTemplate generateWordXWPFTemplate() throws IOException {
    Map content = new HashMap<>();
 content.put("title", "Java 全栈知识体系");
 content.put("author", "pdai");
 content.put("site", new HyperlinkTextRenderData("https://pdai.tech", "https://pdai.tech"));

 content.put("poiText", "Apache POI 是创建和维护操作各种符合Office Open XML（OOXML）标准和微软的OLE 2复合文档格式（OLE2）的Java API。用它可以使用Java读取和创建,修改MS Excel文件.而且,还可以使用Java读取和创建MS Word和MSPowerPoint文件。更多请参考[官方文档](https://poi.apache.org/index.html)");

 content.put("poiText2", "生成xls和xlsx有什么区别？POI对Excel中的对象的封装对应关系？");
 content.put("poiList", Numberings.create("excel03只能打开xls格式，无法直接打开xlsx格式",
 "xls只有65536行、256列; xlsx可以有1048576行、16384列",
 "xls占用空间大, xlsx占用空间小，运算速度也会快一点"));

 RowRenderData headRow = Rows.of("ID", "Name", "Email", "TEL", "Description").textColor("FFFFFF")
 .bgColor("4472C4").center().create();
 TableRenderData table = Tables.create(headRow);
 getUserList()
 .forEach(a -> table.addRow(Rows.create(a.getId() + "", a.getUserName(), a.getEmail(), a.getPhoneNumber() + "", a.getDescription())));
 content.put("poiTable", table);

 Resource resource = new ClassPathResource("pdai-guli.png");
 content.put("poiImage", Pictures.ofStream(new FileInputStream(resource.getFile())).create());

 return XWPFTemplate.compile(new ClassPathResource("poi-tl-template.docx").getFile()).render(content);
}

private List getUserList() {
 List userList = new ArrayList<>();
 for (int i = 0; i < 5; i++) {
 userList.add(User.builder()
 .id(Long.parseLong(i + "")).userName("pdai" + i).email("pdai@pdai.tech" + i).phoneNumber(121231231231L)
 .description("hello world" + i)
 .build());
 }
 return userList;
}

准备模板

导出word

导出markdown为word

controller中的方法

@ApiOperation("Download Word based on markdown")
@GetMapping("/word/downloadMD")
public void downloadMD(HttpServletResponse response) {
    try {
        XWPFTemplate document = userService.generateWordXWPFTemplateMD();
        response.reset();
        response.setContentType("application/octet-stream");
        response.setHeader("Content-disposition",
                "attachment;filename=user\_word\_" + System.currentTimeMillis() + ".docx");
        OutputStream os = response.getOutputStream();
        document.write(os);
        os.close();
    } catch (Exception e) {
        e.printStackTrace();
    }
}

Service中实现的方法

@Override
public XWPFTemplate generateWordXWPFTemplateMD() throws IOException {
    MarkdownRenderData code = new MarkdownRenderData();

    Resource resource = new ClassPathResource("test.md");
    code.setMarkdown(new String(Files.readAllBytes(resource.getFile().toPath())));
    code.setStyle(MarkdownStyle.newStyle());

    Map data = new HashMap<>();
 data.put("md", code);

 Configure config = Configure.builder().bind("md", new MarkdownRenderPolicy()).build();

 return XWPFTemplate.compile(new ClassPathResource("markdown\_template.docx").getFile(), config).render(data);
}

准备模板

导出word

示例源码

https://github.com/realpdai/tech-pdai-spring-demos

参考文章

http://deepoove.com/poi-tl/

更多内容

告别碎片化学习，无套路一站式体系化学习后端开发: Java 全栈知识体系(https://pdai.tech)

转载请注明：xuhss » SpringBoot集成文件 – 如何基于POI-tl和word模板导出庞大的Word文件？