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

• Z时代
• 2024-01-10
• 分类：综合

来自:https://blog.csdn.net/qq_33195578/article/details/73790283

前言：最近要做一个导出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

[java] view plain copy print?

1. public class DocumentHandler {  
2.   
3.     private Configuration configuration = null;  
4.       
5.     public DocumentHandler(){  
6.         configuration = new Configuration();  
7.         configuration.setDefaultEncoding("UTF-8");  
8.     }  
9.       
10.     public byte[] createDocArea (Map<String, Object> dataMap ,String outFilePath,String fileName) throws Exception{  
11.         //this.configuration.setClassForTemplateLoading(DocumentHandler.class, "D:\\");//第一种模板路径  
12.         System.out.println("---进入createDocArea---");  
13.         this.configuration.setDirectoryForTemplateLoading(new File("/template/"));//第二种模板路径  
14.         Template t = null;  
15.         File outFile = null;  
16.         byte[] bFile = null;  
17.         try {  
18.             t = this.configuration.getTemplate(fileName,"UTF-8");  
19.         } catch (Exception e) {  
20.             e.printStackTrace();  
21.             return null;  
22.         }  
23.           
24.         outFile = new File(outFilePath);  
25.         Writer w = null;  
26.         FileOutputStream fos = null;  
27.           
28.         try {  
29.             fos = new FileOutputStream(outFile);  
30.             OutputStreamWriter osw = new OutputStreamWriter(fos,"UTF-8");  
31.               
32.             w = new BufferedWriter(osw);  
33.         } catch (Exception e) {  
34.             e.printStackTrace();  
35.             return null;  
36.         }  
37.           
38.         try {  
39.             t.process(dataMap, w);  
40.             if(outFile!=null){  
41.                 FileInputStream fis = new FileInputStream(outFile);  
42.                  bFile = new byte[(int) outFile.length()];  
43.                  fis.read(bFile);  
44.                  fis.close();  
45.             }  
46.             System.out.println("--写入完成---");  
47.         } catch (Exception e) {  
48.             e.printStackTrace();  
49.             return null;  
50.         }finally{  
51.             w.close();  
52.             fos.close();  
53.         }  
54.         return bFile;  
55.     }  
56. }  

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、以上就是一个完整的导出过程了，当然，不管是封装数据，还是合并单元格，

我说的可能更多的只是个思路，具体怎么封装数据，怎么想方设法的把数据放进模

板，仁者见者，智者见智吧！就到此为止吧，希望我说的大家可以看的明白，如果 哪儿不明白的，或者哪儿写的不对的，欢迎吐槽！