poi-tl二次開發

時間 2020-05-08

標籤 poi 二次開發欄目 Apache 简体版

原文原文鏈接

poi-tl二次開發

poi-tl是一款很是好用的word模板生成庫，更新響應快、文檔demo齊全。堪稱word模板界的小軍刀！html

寫在前面

若是你對word模板技術有了解、或者有興趣，更甚者工做中接觸過，那麼接下來的內容應該會讓你有所收穫。java

介紹poi-tl

功能以下：git

文本 {{var}}
表格 {{#var}}
圖片 {{@var}}
列表 {{*var}}
嵌套 {{+var}}

更多文檔參考以下：poi-tlgithub

這裏再也不更多的贅述poi-tl的功能了，很是優秀的一個word模板庫。spring

二次開發

若是你還沒使用過poi-tl，那麼接下來的內容，你應該不太會感同身受。express

poi-tl使用一段時間後會發現仍存在一些問題，好比行列表格須要本身寫代碼指定樣式、圖片須要寫代碼指定高度寬度、列表也寫代碼指定樣式。數組

爲最大化利用word的樣式，減小代碼量，這裏在v1.6.0之上進行源碼擴展。測試

加入模板語法：name|attr:var。加密

name 爲功能名稱
attr 爲屬性
var 爲數據變量名稱

fork地址：githubspa

表格

語法：{{table|limit:var}}

table 說明是表格
limit 爲數據填充的行數，數據不足補空
var 爲填充數據（JSON）的 key，能夠是一個對象或者對象數組。

模板：

其中：

姓名的前面出現的{{table|5:[users]}}，表明了這是一個表格模板（能夠出如今表格的任意位置，建議在表頭），users則說明數據中存在一個 users 的 key 。
表格的第二行變量會根據傳遞的值動態替換，{name}、{age} 等模板，則說明 users 這個 key 中的對象或對象數組存在 name、age 這兩個key。
因爲數據只有2條，限制5條，所以補空行3條

測試代碼：

@Test
public void run() {
  Path path = Paths.get("src/test/resources", "table_pattern.docx");
  XWPFTemplate template = XWPFTemplate.compile(path.toFile())
    // 數據
    .render(new HashMap<String, Object>() {{
      put("users", Arrays.asList(new User("張三", 1), new User("李四", 2)));
    }});
  // 輸出
  Path outPath = Paths.get("src/test/resources", "table_pattern_out.docx");
  try (OutputStream os = new BufferedOutputStream(new FileOutputStream(outPath.toFile()))) {
    template.write(os);
  } catch (IOException e) {
    LOG.error("render tpl error", e);
  } finally {
    try {
      template.close();
    } catch (IOException e) {
      LOG.error("close template error", e);
    }
  }
}

能夠看到這裏的 map 中存在 users 這個 key，且存在 2 條數據。User 這個對象有兩個屬性 name、age ，模板在解析時，會自動取值。

輸出：

總結：表格正常渲染，並且樣式也正常保留，原來的數據也會保留下來，數據不足補空行。

圖片

語法：{{image|height*width:var}}

image 說明是圖片
height*width 表明圖片的高度和寬度，單位爲釐米
var 爲填充數據的 key，是一個圖片字節經過base64加密的字符串

模板：

測試代碼：

@Test
public void run() throws IOException {
  Path logoPath = Paths.get("src/test/resources", "logo.png");
  byte[] bytes = Files.readAllBytes(logoPath);
  byte[] encode = Base64.getEncoder().encode(bytes);

  Path path = Paths.get("src/test/resources", "image_pattern.docx");
  XWPFTemplate template = XWPFTemplate.compile(path.toFile())
    // 數據
    .render(new HashMap<String, Object>() {{
      put("logo", new String(encode));
    }});
  // 輸出
  Path outPath = Paths.get("src/test/resources", "image_pattern_out.docx");
  try (OutputStream os = new BufferedOutputStream(new FileOutputStream(outPath.toFile()))) {
    template.write(os);
  } catch (IOException e) {
    LOG.error("render tpl error", e);
  } finally {
    try {
      template.close();
    } catch (IOException e) {
      LOG.error("close template error", e);
    }
  }
}

輸出：

總結：圖片能正常根據高度寬度渲染出來

列表

語法：list|limit:var

list 說明是列表
limit 爲數據填充的行數，數據不足補空
var 爲填充數據的 key，值能夠是一個字符串或者一個字符串數組。

模板：

測試代碼：

@Test
public void run() {
  Path inPath = Paths.get("src/test/resources", "list_pattern.docx");
  Path outPath = Paths.get("src/test/resources", "list_pattern_out.docx");
  Map<String, Object> model = new HashMap<String, Object>() {{
    put("items", Arrays.asList("張三", "李四", "王五"));
  }};
  try (InputStream is = Files.newInputStream(inPath); OutputStream os = Files.newOutputStream(outPath)) {
    Tpl.render(is, model).out(os);
  } catch (IOException e) {
    LOG.info("render tpl failed", e);
  }
}

輸出：

總結：列表也能正常渲染，保證原有的格式。