poi-tl——Word模板引擎应用

poi-tl（poi template language）是基于Apache POI的Word模板引擎。纯Java组件，跨平台，代码短小精悍，通过插件机制使其具有高度扩展性。支持DOCX格式的Word模板。

关于poi-tl的入门介绍在官网比较清晰，http://deepoove.com/poi-tl/

下面介绍poi-tl一些其他的需求处理

1，在Word中生成的图片固定原图片比例，防止图片变形

图片模板{{@var}}，PictureRenderData 数据模型。

下面使用到生成图片方法的是官方的 // 本地图片byte数据，http://deepoove.com/poi-tl/#_图片模板var

// 本地图片byte数据
byte[] localByteArray = BytePictureUtils.getLocalByteArray(new File("./logo.png"));
put("localBytePicture", new PictureRenderData(100, 120, ".png", localByteArray));

按原图片比例生成图片，用到ImageIO工具类，https://blog.csdn.net/weixin_41888813/article/details/85043969

File picture = new File(myPath);
byte[] TestPic = BytePictureUtils.getLocalByteArray(picture);
// 获取图片比例
BufferedImage sourceImg = ImageIO.read(new FileInputStream(picture));
params.put("myImg", new PictureRenderData(600, ((sourceImg.getHeight()*600)/sourceImg.getWidth()), ".png", TestPic));
}

2，同一行左右各分布一张图片

文档模板{{+var}}，DocxRenderData 数据模型，可以是另一个docx文档的合并，或者是数据集合针对同一个模板的多个渲染结果的合并。也就是子模板可用于在主模板中循环，但每一次循环的子模板会自动换行，要实现左右分布，需要改动子模板。

子模板（zi.docx），这里是一个隐藏了边框的一行两列的表格

主模板中{{+zi}}即可嵌入子模板

SegmentData实体类

@Data
public class SegmentData {private String imgName;private PictureRenderData img;private String imgName1;private PictureRenderData img1;
}

核心代码

注：

本地测试没问题，打包后应该会有问题，会出现文件找不到，因为classPathResource.getFile()方法会出问题
可以尝试使用临时文件，用于参数传入到DocxRenderData数据模型

                    SegmentData s = new SegmentData();for(int i=1; i<=附件图片的List.size(); i++){File picture = new File(文件的本地保存路径);byte[] localByteArray = BytePictureUtils.getLocalByteArray(picture);// 获取图片比例BufferedImage sourceImg =ImageIO.read(new FileInputStream(picture));PictureRenderData prd = new PictureRenderData(250, (sourceImg.getHeight()*250)/sourceImg.getWidth(), ".png", localByteArray);if(i%2 != 0){s.setImgName(附件图片的List.get(i-1).getFilename());s.setMicroscopeImg(prd);} else{s.setImgName1(附件图片的List.get(i-1).getFilename());s.setMicroscopeImg1(prd);}if(i%2 == 0){segments.add(s);s = new SegmentData();}else if(i == 附件图片的List.size() && 附件图片的List.size()%2 != 0){segments.add(s);}}ClassPathResource classPathResource  = new ClassPathResource("./template/word/zi.docx");DocxRenderData segment = new DocxRenderData(classPathResource.getFile(), segments);params.put("zi", segment);