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 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;
}
} 三、封装数据（关键）
1、其实很好理解，填充模板数据的方式就是用key-value这个格式写的（这个应该好理解吧！freemark），定义一个Map，map 的key就是模板里面的${key}这个属性，一定要跟模板里面的对应起来，value就是你要写的数据；如果你不需要合并单元格，你 就无脑的按照模板里${key}，对应的放数据就行，最后把map给第二步的导出方法；
2、如果你的word里需要循环的，那就再map里放个list，至于模板里怎么循环，这就是涉及到freemarker的知识了，我就不解释 了，自己百度去；（哎，给个例子吧！）
一定要判断你传的这个是否为空，否则要是空的话，会报错（它会用英文提示你，这个是空，你要判断空的情况，利用<#if> <#else>，自己理解去吧！）；
3、哈哈这儿才是重点：
1、其实这个word合并单元格挺简单的，就拿我上图的那个结果来说，1到4（算上 前面的那个序列号）个格子是需要合并的，后面的三个不需要。上图是一个IP对应 后面五个单元格，所以其实它并不是一行，它是5行，（在这里）ip是在第一行， 然后第2到第4行的ip是空的。先理解这个！
2、合并需要的属性值：
这俩才是控制合并单元格的罪魁祸首；
3、怎么用？（看上图）当循环第一行的时候，有IP、地域、重要攻击、单位、时 间；第二行，有空、空、空、单位、时间；第三行。。。。
4、然后在模板里的第一行（也就是循环第一次的时候），添加
简单的解释一下，一行的开始是以
然后再第二行（三行。。。循环）的时候，前面的ip是空的，这个时候要放
这样的话就实现了合并单元格了；这样第一个IP对应的单元格就完成了，第二个IP 就循环着来呗！
4、以上就是一个完整的导出过程了，当然，不管是封装数据，还是合并单元格， 我说的可能更多的只是个思路，具体怎么封装数据，怎么想方设法的把数据放进模 板，仁者见者，智者见智吧！就到此为止吧，希望我说的大家可以看的明白，如果 哪儿不明白的，或者哪儿写的不对的，欢迎吐槽！