Java 将xml模板动态填充数据转换为word文档

https://blog.csdn.net/abc231218/article/details/80512463

需要用到的jar包：

commons-codec-1.10.jar

freemarker-2.3.21.jar

jacob-1.6.jar

实现思路：

    1、先将word文档另存为 : Word 2003 XML文档（*.xml） 格式的模板文件；

    2、通过Java程序，使用freemarker.jar包转换为xml格式的word文档文件

    3、使用jacob包，将xml格式的word文档文件，转换为docx格式的文档文件

具体实现步骤：

一、模板编辑

       1、将word文档另存为xml模板：

    2、模板中需要动态改变的内容，通过freemarker标签：${variableName}

    说明：variableName是需要动态添加内容的一个标志符号，可自由命名

    注意：freemarker标签：${variableName}，不能再word文档中直接输入，需要通过记事本，或者其他notePad++ 文本编辑工具先写好，然后再复制到文档中，否则在转换为xml模板时会出问题。具体问题可百度查找

    模板样式（参考）：

    3、处理将要替换的图片，通过xml编辑工具打开xml模板文件：（可使用notePad++打开）

        两种替换图片方式，一种是直接动态插入一张图片，另一种是从数据库中读取，并循环插入图片

        （1）直接动态插入单张图片：（编辑xml模板文件）

                每个位置在保存模板前，放置一张图片，通过notePad++ 打开xml模板文件，找到对应的图片，在xml模板中，图片会发生转换，以base64的编码形式存在，只要找到一长串的字符就能确定这是一张图片；

        把红框中的内容（后面还有很长），删除掉，直接替换freemarker标签，另外一张图片同样操作，如图所示：

    （2）需要循环插入图片：（编辑xml模板文件）

                循环插图，需要加入freemarker循环标签，xml模板中：一对 ，为一行；我的模板设置了表格，需要循环插入表格，那么需要将循环标签包围到图片所在的 tr 标签：

图片中横线说明：

        （1）图片中因为有两个地方插入图片，所以需要将一个list对象中，要存两张图片的数据，

       （2）<#list loopImageList as imgList> ：loopImageList 可自由命名，但是在Java代码中动态填充的数据对象名要一致，imageList 作为一个遍历的对象名，等于将loopImageList的内容赋值给imageList ,获取对象中的属性值，通过imageList.attr 获取

        （3）上面的 w:name= 后面是图片的名称，不能一致，必须存不同的文件名，所以，这个需要改动，否则一旦所有文件名称一致，则会出现问题。

        （4）如果需要合并第一列的单元格，需要在tr加入标签：

            具体合并方法：<#if imageList_index == 0><#else>

                    a、开始合并的行：

                    b、需要合并的行：

            上面的语句中，_index为imageList 的索引写法，因为需要合并，所以通过判断的方式，将第一个单元格作为合并起始行，其余需要合并的行需要添加结束标签。

        （5）如果不需要合并，则不用添加（4）中的语句

二、Java后台代码实现

    （1）创建一个封装图片对象的ImageBean类：

（由于list遍历中存了两张不同的图片，所以参数设计不太合理，可参考例子，自己进行优化）

package testXML;
/**
 * 图片bean
 */
public class ImageBean {
    // 图片1
    private Integer img1Index;
 
    private String imgName;
 
    private String img1Width;
 
    private String img1Height;
 
    private String img1Base64;
 
    // 图片2
    private Integer img2Index;
 
    private String img2Width;
 
    private String img2Height;
 
    private String img2Base64;
 
 
 
    public ImageBean(Integer img1Index, String imgName, String img1Width,
            String img1Height, String img1Base64, Integer img2Index,
            String img2Width, String img2Height,
            String img2Base64) {
        this.img1Index = img1Index;
        this.imgName = imgName;
        this.img1Width = img1Width;
        this.img1Height = img1Height;
        this.img1Base64 = img1Base64;
        this.img2Index = img2Index;
        this.img2Width = img2Width;
        this.img2Height = img2Height;
        this.img2Base64 = img2Base64;
    }
 
    public Integer getImg1Index() {
        return img1Index;
    }
 
    public void setImg1Index(Integer img1Index) {
        this.img1Index = img1Index;
    }
 
    public String getImgName() {
        return imgName;
    }
 
    public void setImgName(String imgName) {
        this.imgName = imgName;
    }
 
    public String getImg1Width() {
        return img1Width;
    }
 
    public void setImg1Width(String img1Width) {
        this.img1Width = img1Width;
    }
 
    public String getImg1Height() {
        return img1Height;
    }
 
    public void setImg1Height(String img1Height) {
        this.img1Height = img1Height;
    }
 
    public String getImg1Base64() {
        return img1Base64;
    }
 
    public void setImg1Base64(String img1Base64) {
        this.img1Base64 = img1Base64;
    }
 
    public Integer getImg2Index() {
        return img2Index;
    }
 
    public void setImg2Index(Integer img2Index) {
        this.img2Index = img2Index;
    }
 
    public String getImg2Width() {
        return img2Width;
    }
 
    public void setImg2Width(String img2Width) {
        this.img2Width = img2Width;
    }
 
    public String getImg2Height() {
        return img2Height;
    }
 
    public void setImg2Height(String img2Height) {
        this.img2Height = img2Height;
    }
 
    public String getImg2Base64() {
        return img2Base64;
    }
 
    public void setImg2Base64(String img2Base64) {
        this.img2Base64 = img2Base64;
    }
 
 
}
    （2）将xml模板生成word文档（本质是xml）：（代码中存在通用工具处理类）

package testXML;
 
import java.io.BufferedWriter;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
 
import org.apache.commons.codec.binary.Base64;
 
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
 
public class XmlTemplate2Word {
    public static void main(String[] args) throws IOException, TemplateException{
        Map dataMap = new HashMap();
        dataMap.put("title", "测试转换word文档");
        dataMap.put("head", "头部信息");
        dataMap.put("content", "主要内容主要内容主要内容");
        dataMap.put("tableDescription", "表格描述内容");
        // 构造一个list，存放图片相关信息
        List