java使用freemarker模板导出word（带有合并单元格）文档

前言：最近要做一个导出word功能，其实网上有很多的例子，但是我需要的是合并单元格的，可是查了好久都没有自己想要的。研究了几天其实挺简单的，在这儿我就简单的介绍一下吧！（此方法只是一种思路，借鉴者还有根据需求来具体写代码）

一、准备工作

1、jar包：freemarker-2.3.20.jar

2、模板：word.ftl

2.1:这个word.ftl怎么来？

首先准备一份要导出的word.doc文档；



这是一个事先写好的一个word模板，我们需要做的就是把需要导出的数据相应的插入${}到里面（其实如果你了解
freemarker就会明白的，${}是个占位符，来放数据的，这里不详细介绍）。

如果下面的表格是固定的，比如像我们的课程表，那种是固定的，就特别简单了。我要做的就是下面的表格需要根据
数据的不同，实现合并单元格，先看一下生成以后的效果：



大家可以看一下，前面三个格子是合并以后的，当然，如果后面两个格子的数据只有一行，那么也就是一行就行
了。

2.2 将word.doc 转化成word.xml

个人觉得，其实word就是一个xml文件。打开这个word，然后另存为xml格式，然后你再用office打开这个xml，也是可
打开的。

然后用notepad（其他软件随意，不过最好可以格式化这个xml或者ftl文件，否则你会头炸的，啥都看不清）打开这个

word.xml。然后你会发现，可能解析的时候，会把我们的"${}"这些给分开，没事，你手动再把他们拼好就行了。



切记：拼接的时候，千万要注意不要删除或修改了里面的什么结构，后果自负（呵呵，其实就是格式错误了，就算你
导出成功，也不会打开的，因为你已经损害了这个word）

2.3 完成这个xml以后，把这个word.xml 修改成后缀为.ftl的模板文件，到此，这个模板就算完成了。

二、这里先说根据模板word.ftl将导出新的new.doc

1、其实这一步，网上多的是，我唯一有点不满意的就是，它获取模板的方法好像只有通过路径来获取，也许还有别的方法，欢
迎知情者可以告诉我，哈哈！

2、先创建一个类（个人随意，实现功能就行。）DocmentHandler.class

public class DocumentHandler {

private Configuration configuration = null;

public DocumentHandler(){
configuration = new Configuration();
configuration.setDefaultEncoding("UTF-8");
}

public byte[] createDocArea (Map<String, Object> dataMap ,String outFilePath,String fileName) throws Exception{
//this.configuration.setClassForTemplateLoading(DocumentHandler.class, "D:\\");//第一种模板路径
System.out.println("---进入createDocArea---");
this.configuration.setDirectoryForTemplateLoading(new File("/template/"));//第二种模板路径
Template t = null;
File outFile = null;
byte[] bFile = null;
try {
t = this.configuration.getTemplate(fileName,"UTF-8");
} catch (Exception e) {
e.printStackTrace();
return null;
}

outFile = new File(outFilePath);
Writer w = null;
FileOutputStream fos = null;

try {
fos = new FileOutputStream(outFile);
OutputStreamWriter osw = new OutputStreamWriter(fos,"UTF-8");

w = new BufferedWriter(osw);
} catch (Exception e) {
e.printStackTrace();
return null;
}

try {
t.process(dataMap, w);
if(outFile!=null){
FileInputStream fis = new FileInputStream(outFile);
bFile = new byte[(int) outFile.length()];
fis.read(bFile);
fis.close();
}
System.out.println("--写入完成---");
} catch (Exception e) {
e.printStackTrace();
return null;
}finally{
w.close();
fos.close();
}
return bFile;
}
}
3、简单介绍一下思路：它是通过这个configuration来获取模板的，目前我就知道这两种，一个是通过File，另一个种是通过
Class，不过我试了一下，不过这两种用哪一种，其实都是通过路径来获取的，然后它会根据在这个路径下，来通过你给的模板
名称来找这个模板。所以这里路径下一定要有相应的模板。然后获取模板以后，你再定义一个File，把封装好的Map(这个map就
是你要填充的数据)传过来，它会通过流，结合模板，把数据写入到你的新File中。至于你怎么处理这个File，我就不管了。
三、封装数据（关键）

1、其实很好理解，填充模板数据的方式就是用key-value这个格式写的（这个应该好理解吧！freemark），定义一个Map，map
的key就是模板里面的${key}这个属性，一定要跟模板里面的对应起来，value就是你要写的数据；如果你不需要合并单元格，你
就无脑的按照模板里${key}，对应的放数据就行，最后把map给第二步的导出方法；

2、如果你的word里需要循环的，那就再map里放个list，至于模板里怎么循环，这就是涉及到freemarker的知识了，我就不解释
了，自己百度去；（哎，给个例子吧！）



一定要判断你传的这个是否为空，否则要是空的话，会报错（它会用英文提示你，这个是空，你要判断空的情况，利用<#if>
<#else></#if>，自己理解去吧！）；

3、哈哈这儿才是重点：

        1、其实这个word合并单元格挺简单的，就拿我上图的那个结果来说，1到4（算上
前面的那个序列号）个格子是需要合并的，后面的三个不需要。上图是一个IP对应
后面五个单元格，所以其实它并不是一行，它是5行，（在这里）ip是在第一行， 然后第2到第4行的ip是空的。先理解这个！

2、合并需要的属性值：<w:vMerge w:val='restart'/>和<w:vMerge/>

这俩才是控制合并单元格的罪魁祸首；

3、怎么用？（看上图）当循环第一行的时候，有IP、地域、重要攻击、单位、时
间；第二行，有空、空、空、单位、时间；第三行。。。。

4、然后在模板里的第一行（也就是循环第一次的时候），添加<w:vMerge
w:val='restart'/>（只在需要合并单元格的地方添加，看下图）



简单的解释一下，一行的开始是以<w:tr w:rsidR="00806640"
w:rsidRPr="00914E05" w:rsidTr="00806640">这个开始的，以</w:tr>结束的，这
个是完整的一行，里面的<w:tc>是代表一个格子，算是前面的序列号，我上图也就
是6个<w:tc>放那个合并属性的时候千万别放错地方了，我的是前四个（算上序列
号）需要合并，所以我就在前四个<w:tc>里放了这个；

然后再第二行（三行。。。循环）的时候，前面的ip是空的，这个时候要放
<w:vMerge/>这个属性，放的位置跟第一行的方法一样，只是这个熟悉变了；

这样的话就实现了合并单元格了；这样第一个IP对应的单元格就完成了，第二个IP
就循环着来呗！

4、以上就是一个完整的导出过程了，当然，不管是封装数据，还是合并单元格，
我说的可能更多的只是个思路，具体怎么封装数据，怎么想方设法的把数据放进模
板，仁者见者，智者见智吧！就到此为止吧，希望我说的大家可以看的明白，如果 哪儿不明白的，或者哪儿写的不对的，欢迎吐槽！