java在word（*.docx）指定地点插入图片

最近因为一个项目需要在已经存在的word模板的指定地点插入图片，而且项目采用的是java，然而我对Java并不太熟，网上的资料大多是在生成模板的时候添加图片，我折腾了挺久才解决这个问题，在此记录下来。

微软在MS Office 2007之后开始推出了.docx格式的word文档，推行ooxml(office open xml)，也就是结合zip技术和xml技术来存储word文档。对docx文档进行操作本质上就是对xml文件在进行操作，这样思路要清晰一点。百度发现大多数资料都是采用POI，然而又有人说POI在插入图片的时候有bug，于是换google，发现了一个叫docx4j的包，但是中文资料较少，作为一个大学四级都考了N次的人来说（泪目）。。。

jdk版本：1.8
docx4j版本：3.3.1
MS Office版本：MS Office 2016 for mac

思路

1. 首先在word模板中需要添加图片的地方添加书签，这个书签就作为定位的依据。
2. 然后在java中找到这个书签，一般来说书签都是处于一个段落中，然后找到这个书签的父级段落，把图片加入到这个段落中就可以了。

代码

    public static void main(String[] args) throws Exception {
        // 模板文件路径
        String templatePath = "template.docx";
        // 生成的文件路径
        String targetPath = "target.docx";
        // 书签名
        String bookmarkName = "bookmark";
        // 图片路径
        String imagePath = "image.jpg";
        
        // 载入模板文件
        WordprocessingMLPackage wPackage = WordprocessingMLPackage.load(new FileInputStream(templatePath));
        // 提取正文
        MainDocumentPart mainDocumentPart = wPackage.getMainDocumentPart();
        Document wmlDoc = (Document) mainDocumentPart.getJaxbElement();
        Body body = wmlDoc.getBody();
        // 提取正文中所有段落
        List<Object> paragraphs = body.getContent();
        // 提取书签并创建书签的游标
        RangeFinder rt = new RangeFinder("CTBookmark", "CTMarkupRange");
        new TraversalUtil(paragraphs, rt);
        
        // 遍历书签
        for (CTBookmark bm:rt.getStarts()) {
            // 这儿可以对单个书签进行操作，也可以用一个map对所有的书签进行处理
            if (bm.getName().equals(bookmarkName)){             
                // 读入图片并转化为字节数组，因为docx4j只能字节数组的方式插入图片
                InputStream is = new FileInputStream(imagePath);
                byte[] bytes = IOUtils.toByteArray(is);
                // 穿件一个行内图片
                BinaryPartAbstractImage imagePart = BinaryPartAbstractImage.createImagePart(wPackage, bytes);
                
                 // createImageInline函数的前四个参数我都没有找到具体啥意思，，，，
                 // 最有一个是限制图片的宽度，缩放的依据
                Inline inline = imagePart.createImageInline(null, null, 0,1, false, 800);
                // 获取该书签的父级段落
                P p = (P)(bm.getParent());
                
                ObjectFactory factory = new ObjectFactory();
                // R对象是匿名的复杂类型，然而我并不知道具体啥意思，估计这个要好好去看看ooxml才知道
                R run = factory.createR();
                // drawing理解为画布？
                Drawing drawing = factory.createDrawing();
                drawing.getAnchorOrInline().add(inline);
                run.getContent().add(drawing);
                p.getContent().add(run);
            }
        }
        wPackage.save(new FileOutputStream(targetPath));
    }   

docx4j的好处在于可以完全跨平台、开源免费、不需要安装office也可用，而且它还支持maven管理：

<dependency>
        <groupId>org.docx4j</groupId>
        <artifactId>docx4j</artifactId>
        <version>3.3.1</version>
</dependency>

docx4j给出了很多例子，很多需求都可以通过阅读示例代码解决。

参考

[简单]docx4j常用方法小结
如何：在字处理文档中插入图片 (Open XML SDK)