poi-tl word模板 图片

### poi-tl Word 模板 示例 图片 下载 poi-tl 是一种强大的Word模板引擎，能够通过模板和数据生成高质量的Word文档[^1]。对于包含图片在内的复杂模板需求，poi-tl同样提供了良好的支持。 #### 创建带有图片的Word模板 为了在Word模板中嵌入图片，可以使用特定占位符语法来指定图片的位置以及如何加载这些资源。通常情况下，在模板内定义如下形式的标签： ```html <w:p> <w:r> <w:drawing> <wp:inline> <a:graphic> <a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/picture"> <pic:pic> <pic:nvPicPr> <pic:cNvPr id="0" name="${imageName}" /> </pic:nvPicPr> <pic:blipFill> <a:blip r:embed="${imageId}"/> </pic:blipFill> </pic:pic> </a:graphicData> </a:graphic> </wp:inline> </w:drawing> </w:r> </w:p> ``` 上述代码片段展示了如何在一个Word文档中预留位置用于后续插入图像，并利用`${}`表达式绑定实际的数据源[^3]。 #### 实现图片下载并填充到模板 当处理含有外部链接指向网络上的图片时，可以通过Java程序先将目标图片保存至本地临时目录下，再将其作为二进制流注入到最终输出的DOCX文件里。具体实现方式取决于所使用的POI-TL版本及其配套API设计[^4]。 ```java import cn.afterturn.easypoi.word.WordExportUtil; import org.apache.poi.xwpf.usermodel.XWPFDocument; // ...其他必要的包导入... Map<String, Object> data = new HashMap<>(); data.put("imageName", "Sample Image"); File imageFile = downloadImageFromUrl("https://example.com/path/to/image.png"); try (InputStream inputStream = new FileInputStream(imageFile)) { XWPFDocument doc = WordExportUtil.exportAsDocx(templatePath, data); // 将输入流中的图片加入到document对象中 String relationshipId = doc.addPictureData(inputStream, Document.PICTURE_TYPE_PNG); data.put("imageId", relationshipId); // 继续完成导出流程... } catch (IOException e) { throw new RuntimeException(e.getMessage(), e); } private static File downloadImageFromUrl(String imageUrl){ try{ URL url = new URL(imageUrl); ReadableByteChannel readableByteChannel = Channels.newChannel(url.openStream()); File tempFile = File.createTempFile("temp-", ".png"); FileOutputStream fileOutputStream = new FileOutputStream(tempFile); fileOutputStream.getChannel().transferFrom(readableByteChannel, 0, Long.MAX_VALUE); return tempFile; } catch(Exception ex){ throw new RuntimeException(ex.getMessage(),ex); } } ``` 这段示例代码说明了怎样获取远程服务器上存储的一张PNG格式图片，并把它转换成适合于Word文档内部引用的形式[^2]。