Java中使用freemarker导出word文档（详细案例，含图片和表格）

桃扇骨 2022-03-21 02:54 1165阅读 0赞

**(学习留存，如有侵权，请告知，立刻删除！)**

Java中使用freemarker导出word文档（自己真实项目案例）  
最近做了一个项目，有一个需求是要将职员的一些数据按照指定的样式导出成一个word文档出来，由于自己是一个Java小白，不懂，于是便在网上找方法，网上介绍的有很多，因为原来用poi导出过ppt，于是便想用poi来做，但是由于时间不够，最终选择了用freemarker来做，在做的过程中遇到了一些问题，但最终还是完成了。于是把自己完成这个功能所做的一切从头到尾的记录一编，希望能对其他人有帮助。

1.项目需要导出图片和表格  
可以看出在这个样式中，需要导出图片和循环表格。

2.开始制作模板  
在制作模板时，用office word 2003或以上的版本来制作，不要用wps做。在画模板遇到一些问题，我的解决如下：   
1.关于图片，我画了一个文本框来放图片，然后随便放了一个图片进去（一定要插入一张图片，方便后面找到图片的位置好 进行替换）。   
2.一些需要动态生成的数据写如个人信息用personInfo来代替，注意，单词要先用一个文本框写好，再复制黏贴过来，不要再word上手动敲，不然再转成xml时单词会被拆散。也不要直接黏贴过来一个$\{personInfo\}，我发现还是会被拆散，最好直接黏贴一个单词过来，在xml中再找到这个单词再添加$\{\}。   
3.表格只需要画一行，循环在xml中配置。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70][]

模板画好之后，直接将word另存为xml格式，保存完后将word关掉。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 1][]

用notepad++打开你保存的xml格式的文档找到你写的单词如stdName

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 2][]

在单词前后加上$\{\}，所有你写的单词都加上。

![20190130105735898.png][]

搜索w:tr找到表格

![20190130105753146.png][]

在表格标签<w:tr>的首尾分别加上<\#list expList as exp> 和</\#list> 标签，并且标签里的单词要改成$\{exp.time\}这种形式。解释一下：list标签可以使标签内的表格自动循环生成相应的行数，expList是自己命名的，是表格的数据来源，是一个list集合。exp是别名。

![2019013010580445.png][]

搜索<pkg:binaryData>,你会发现这个标签里的内容特别多，这就是你画模板时插入的图片的BASE64字符串。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 3][]

将<pkg:binaryData>标签里的内容删完，替换为$\{images\},这样就可以在代码中设置，然后导出自己获取的图片了，当然名字自己取，叫img也可以，只要在代码中和这对应就好了。

![20190130105835640.png][]

3.完成模板  
将上面修改好的xml文档保存好，点击重命名将其类型修改为ftl。我的是将template.xml改为template.ftl。   
好了，至此，模板就制作好了，在后面代码中你要用的模板就是template.ftl。我是直接将template.ftl文档复制到我的项目中，当然，你放本地也可以，只是引用时方法和路径不一样而已。

![2019013010584685.png][]

4.Java代码  
创建项目之类的就不说了，然后给你的项目到导freemarker的包。freemarker.jar包下载：   
https://download.csdn.net/download/weixin\_42142057/10651828   
下面便是核心代码了：

private void exportWord(String ssdw, String image64Str, String stdName, String personInfo, List<FamilyInfo> familyInfos,  
            Map<String, String> maps) \{  
    Map<String, Object> dataMap = new HashMap<String, Object>();  
    //ssdw 是我前面获取的职员信息  
    dataMap.put("orgName", ssdw);  
    //image64Str 是职员的照片转换后的BASE64字符串  
    dataMap.put("images", image64Str);  
    //stdName 是我前面获取的职员信息  
    dataMap.put("stdName", stdName);  
    //personInfo 是我前面获取的职员信息  
    dataMap.put("personInfo", personInfo);

//familyList 是职员的家庭信息的集合，对应模板中的表格  
    List<Map<String, Object>> familyList = new ArrayList<Map<String, Object>>();  
    for (int i = 0; i < familyInfos.size(); i++) \{  
        Map<String, Object> map = new HashMap<String, Object>();  
        map.put("gx", familyInfos.get(i).getYbrgx());  
        map.put("xm", familyInfos.get(i).getCyxm());  
        map.put("dwjzw", familyInfos.get(i).getDwjzw());  
        familyList.add(map);  
    \}  
    dataMap.put("familyList", familyList);

//expList 是职员的工作经历信息的集合，对应模板中的表格  
    List<Map<String, Object>> expList = new ArrayList<Map<String, Object>>();  
    Iterator<Entry<String, String>> it = maps.entrySet().iterator();  
    while (it.hasNext()) \{  
        Map<String, Object> map = new HashMap<String, Object>();  
        Map.Entry<String, String> entity = (Entry<String, String>) it.next();  
        map.put("time", entity.getKey());  
        map.put("experience", entity.getValue());  
        expList.add(map);  
    \}  
    dataMap.put("expList", expList);

@SuppressWarnings("deprecation")  
    Configuration configuration = new Configuration();  
    configuration.setDefaultEncoding("utf-8");  
    //有两种方式获取你的模板，模板在项目中时用第一个，模板在本地时用第二个。  
    //注意：两种方式的路径都只需要写到模板的上一级目录  
    configuration.setClassForTemplateLoading(this.getClass(), "/tem");  
//  configuration.setDirectoryForTemplateLoading(new File("C:/"));

File outFile = new File("D:/outFilessa"+Math.random()\*10000+".doc");//输出路径  
    Template t=null;    
    Writer out = null;  
    try \{  
        t = configuration.getTemplate("template.ftl", "utf-8"); //文件名，获取模板  
        out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile), "utf-8"));    
        t.process(dataMap, out);  
    \} catch (Exception e) \{  
        e.printStackTrace();    
    \} finally \{  
        try \{  
            out.close();  
        \} catch (IOException  e1) \{  
            e.printStackTrace();   
        \}  
    \}

\}  
  
将获取的图片转换为BASE64字符串

![20190130105954597.png][]  
要使用BASE64Encoder还得有如下操作：   
点击你的项目名右键，选择Properties,进去后选择Java Build Path,然后如图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 4][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 5][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 6][]  
   
操作完成，应用并OK。

Over 使用freemarker导出word完成

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70]: /images/20220321/ec2830a8a1024c2fb8925c17440ea2fb.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 1]: /images/20220321/6834dd58d5a8407c8416bb0eaeef8b1f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 2]: /images/20220321/9c48709f0e3e4789b59d05bbef87867d.png
[20190130105735898.png]: /images/20220321/9e6425f8142f46ddbe20c7f91a1721b7.png
[20190130105753146.png]: /images/20220321/bfbffdf0b99e4f00ac9b4560d99101e7.png
[2019013010580445.png]: /images/20220321/06f3b55dad284484b35d8a6472558320.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 3]: /images/20220321/f547d067387d4f57a9c5fc8d228e75bb.png
[20190130105835640.png]: /images/20220321/59aaa4252d094fe59946a130cf0999d5.png
[2019013010584685.png]: /images/20220321/e3713dc76c2f4beaaa79239cfe07e8d8.png
[20190130105954597.png]: /images/20220321/cf4b0753fc24407890b326cd87644816.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 4]: /images/20220321/ed7f057659ec4685ab09ecd87776f1f2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 5]: /images/20220321/346a355f25c84a69939f1b5380f48d08.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW95YW5taQ_size_16_color_FFFFFF_t_70 6]: /images/20220321/e6333be49722461298a380ba3c88fbca.png