word 文档导出 (freemaker+jacob)--java开发
工作中终于遇到了 需要导出word文旦的需求了。由于以前没有操作过,所以就先百度下了,基本上是:博客园,简书,CDSN,这几大机构的相关帖子比较多,然后花了2周时间 才初步弄懂。
学习顺序:
第一阶段
1,。首先 是 先了解 java 通过什么方式 来操作word的导出工作。就有了下面这个帖子了:
java 操作 word 的方法 :https://www.cnblogs.com/lcngu/p/5247179.html 。新手可以先看看了解下。
2. 根据需求:操作word很复杂: 1.有图片(图片数量 动态变化,可能没有),2.有复选框需要展示 【一个文档里有好几个 复选框。框框打钩还是不打勾,不确定】,3.文档样式和模板客户已经给我们提供好了。
因此; 选着了使用freemaker辅助工具来操作,word文档生成和导出。
整个流程简单来说:
对于支持低版本的ofifce word 文档格式 应该是 doc格式的:
1.先生成模板:就是word文档 先标记好要填充数据的位置,(一般建议用 实体类的属性名 站位 ,可以的话用花括号括起来)。小技巧(对于图片,复选框。这些特别的东西。先不做处理)。
2. 生成 xml文件:word文档 另存为 xml 格式的--(一定要是word.xml,其他格式的不行,这里选着 word-2003.xml)。低版本要求
3. 生成ftl文件: 这个没啥说的,freemaker只能能识别它,因此需要这几个步骤1. 把生成好的xml文件,把后缀名改成 ftl 就可以了;2.所有占位符的地方 加上$标志;
4. 使用freemaker 工具 整合 模板和数据了。
5. 输出生成好的 word文档。
参考教程: java使用freemarker生成word文档步骤 带图片
对于高版本的ofifce word 文档格式 是 docx格式的:
有两种方法:
1.解压--替换--压缩。好处word是原生的不是xml格式的。
2. 和上述doc方式一样,只不不过导出xml 选择 word.xml。 后续操作一模一样。
参考教程 :
第一种方式: JAVA通过模板生成DOCX文档 一般不推荐,除非图片数量固定。
第二种方式:1.使用freemarker导出word并动态插入多张图片。
对于复选框(打钩和不打勾)的操作:请参考这个文档,非常直观的告诉你怎么操作:freemarker导出word文档中的复选框打钩功能
对于图片操作请参考 上面给的教程。 上面的教程主要是图片的处理。
第一阶段到此结束了,然后开始写代码和编程了。下面给的是数据获取的几个操作方法。数据对象Map<string ,object> .
WordPhotoUtil: 对图片的处理
package com.chiyun.peersocialworker.synchroWork.util; import com.chiyun.peersocialworker.files.entity.EmplPictureInforEntity; import com.chiyun.peersocialworker.synchroWork.vo.Picther2Vo; import com.chiyun.peersocialworker.synchroWork.vo.PictherVo; import sun.misc.BASE64Encoder; import java.io.File; import java.io.FileInputStream; import java.io.IOException; import java.io.InputStream; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; /** * word-图片信息处理-工具类 * */ public class WordPhotoUtil { /** * 获得图片的base64码 * @param filepash * @return * @throws Exception */ public static String getImageBase(String filepash) throws Exception { if (filepash == null || filepash == "") { return ""; } System.out.println("图片路径"+filepash); File file = new File(filepash); if (!file.exists()) { System.out.println("图片不存在"); return ""; } InputStream in = null; byte[] data = null; try { in = new FileInputStream(file); data = new byte[in.available()]; in.read(data); in.close(); }catch(IOException e){ e.printStackTrace(); } System.out.println("图片大小:"+data.length); BASE64Encoder encoder = new BASE64Encoder(); return encoder.encode(data); } /** * 图片信息获取 【肯定是偶数个数】 双图片成对保存 * @param images * @return * @throws Exception */ public static List<PictherVo> getImage(List<EmplPictureInforEntity> images ,int numbers,int photosize )throws Exception{ List<PictherVo> pictvoList=new ArrayList<>(); List<EmplPictureInforEntity> List1=new ArrayList<>(); List<EmplPictureInforEntity> List2=new ArrayList<>(); int i=1; for(EmplPictureInforEntity image:images ) { if( i%2==0){ List2.add(image); }else{ List1.add(image); } i++; } int bb=numbers; for(int j=0;j<(images.size()/2);j++){ PictherVo pvo =new PictherVo(); pvo.setTpnr1(getImageBase(List1.get(j).getTpzslj())); pvo.setTphz1(List1.get(j).getTpmc()); pvo.setRidnumber1(String.valueOf(bb)); pvo.setTpgs1(List1.get(j).getTpgslx()); bb++; pvo.setTpnr2(getImageBase(List2.get(j).getTpzslj())); pvo.setTphz2(List2.get(j).getTpmc()); pvo.setRidnumber2(String.valueOf(bb)); pvo.setTpgs2(List2.get(j).getTpgslx()); pictvoList.add(pvo); bb++; } return pictvoList; } /** * 图片信息获取 【不一定是偶数个数】 单图片保存 * @param images * @return numbers * @throws Exception */ public static List<Picther2Vo> getImage2(List<EmplPictureInforEntity> images,int numbers,int photosize )throws Exception{ List<Picther2Vo> pictvoList=new ArrayList<>(); int RidNumber=numbers; for(EmplPictureInforEntity imag:images){ Picther2Vo pvo =new Picther2Vo(); pvo.setTpnr(getImageBase(imag.getTpzslj())); pvo.setTphz(imag.getTpmc()); pvo.setTpgs(imag.getTpgslx()); pvo.setRidnumber(String.valueOf(RidNumber)); pictvoList.add(pvo); RidNumber++; } return pictvoList; } /** * 输出图片信息集合-成双图片信息 * @param images 图片内容 * @param numbers Rid 起始编号 * @return * @throws Exception */ public static List<Map<String, Object>> getphotoInfo( List<EmplPictureInforEntity> images ,int numbers,int photosize )throws Exception{ System.out.println(images.size()); List<Map<String, Object>> info = new ArrayList<>(); List<PictherVo> picvoList=null; if(images.size()==0){ return info; }else {//必须有图片 String str = images.get(0).getTpzslj(); String defoTpPath = str.substring(0, str.indexOf("upload\\")); if ( images.size()% 2 == 0) { //偶数张 picvoList =getImage(images,numbers,photosize); } else { //奇数张 EmplPictureInforEntity defoimage = new EmplPictureInforEntity(); defoimage.setTpmc("back.png"); defoimage.setTpzslj(defoTpPath + "upload\\" + "back.png"); defoimage.setTpgslx("png"); images.add(defoimage); picvoList = getImage(images,numbers,photosize); } for (PictherVo vo : picvoList) { Map<String, Object> map = new HashMap<>(); map.put("photo1", vo.getTpnr1()); map.put("mc1", vo.getTphz1()); map.put("hz1",vo.getTpgs1()); map.put("rId1",vo.getRidnumber1()); map.put("photo2", vo.getTpnr2()); map.put("mc2", vo.getTphz2()); map.put("hz2",vo.getTpgs2()); map.put("rId2",vo.getRidnumber2()); info.add(map); } } return info; } /** * 输出图片信息集合-单张图片信息 * @param images 图片内容 * @param numbers Rid 起始编号 * @param photosize 图片总数 * @return * @throws Exception */ public static List<Map<String, Object>> getphotoInfo2( List<EmplPictureInforEntity> images ,int numbers,int photosize )throws Exception{ List<Map<String, Object>> info = new ArrayList<>(); List<Picther2Vo> picvoList=null; if(images.size()==0){ return info; }else { picvoList = getImage2(images,numbers,photosize); } for(Picther2Vo vo: picvoList){ Map<String, Object> map = new HashMap<>(); map.put("photo",vo.getTpnr()); map.put("tpmc",vo.getTphz()); map.put("hz",vo.getTpgs()); map.put("rId",vo.getRidnumber()); info.add(map); } return info; } }View Code
getObjectToMap(): 把 实体类转换成map
//对象转Map-主表信息排除时间格式的 private static Map<String, Object> getObjectToMap2(Object object)throws Exception{ Map<String, Object> map = new HashMap<>(); for (Field f : object.getClass().getDeclaredFields()) { f.setAccessible(true); if(f.getType().toString().equals("class java.lang.String")){ map.put(f.getName(),StringUtil.getNullorString((String)f.get(object))); }else if(f.getType().toString().equals("class java.util.Date")){ }else if(f.getType().toString().equals("class java.lang.Integer")){ map.put(f.getName(),StringUtil.getNullorString(((String)f.get(object)))); }else{ System.out.println("这是新的属性:"+f.getType().toString()); map.put(f.getName(),StringUtil.getNullorString(((String)f.get(object)))); } } return map; }View Code
WordCheckboxUtil: 操作复选框
package com.chiyun.peersocialworker.synchroWork.util; import com.chiyun.peersocialworker.utils.StringUtil; import java.util.HashMap; import java.util.List; import java.util.Map; /** * word-复选框操作-工具类 * */ public class WordCheckboxUtil { /** * 单选-复选框信息处理 * @param dictdm 打钩值 * @param bjname 标记名称-模板占位符 * @param list 所有词条信息 * @return */ public static Map<String, Object> getCheckbox1(String dictdm,String bjname,List<DictionarylistEntity> list){ Map<String, Object> dataMap = new HashMap<>(); int index =0; for(DictionarylistEntity entity:list){ index=index+1; if(entity.getCtdm().equals(dictdm)){ dataMap.put(bjname+index,true); }else { dataMap.put(bjname+index,false); } } return dataMap; } /** * * 多选-复选框信息处理 * @param dictdm 打钩值 * @param bjname 标记名称-模板占位符 * @param list 所有词条信息 * @return */ public static Map<String, Object> getCheckbox2(String dictdm,String bjname,List<DictionarylistEntity> list){ String[] zsxqdms=null; if(StringUtil.isNull(dictdm)){ }else{ zsxqdms=dictdm.split(","); //用英文逗号分隔 } Map<String, Object> dataMap = new HashMap<>(); int index =0; for(DictionarylistEntity entity:list){ index=index+1; boolean flag=false; if(zsxqdms!=null){ for(String str1 :zsxqdms){ if(entity.getCtdm().equals(str1)) { flag=true; } } }else { } dataMap.put(bjname+index,flag); } return dataMap; } public static void main(String[] args) { String dictdm="123,03,45"; String[] zsxqdms=dictdm.split(","); //用英文逗号分隔 System.out.println(zsxqdms.length); System.out.println(zsxqdms[0]); } }View Code
word 工具类:WordUtil
package com.chiyun.peersocialworker.utils; import freemarker.template.Configuration; import freemarker.template.Template; import java.io.*; import java.util.Map; /** * */ public class WordUtil { /** * 生成word文件 * @param dataMap word中需要展示的动态数据,用map集合来保存 * @param templateName word模板名称,例如:test.ftl * @param filePath 文件生成的目标路径,例如:D:/wordFile/ * @param fileName 生成的文件名称,例如:test.doc */ @SuppressWarnings("unchecked") public static void createWord(Map dataMap,String templateName,String filePath,String fileName){ try { //创建配置实例 Configuration configuration = new Configuration(Configuration.DEFAULT_INCOMPATIBLE_IMPROVEMENTS); //设置编码 configuration.setDefaultEncoding("UTF-8"); //ftl模板文件 configuration.setClassForTemplateLoading(WordUtil.class,"/template/new"); //获取模板 Template template = configuration.getTemplate(templateName); //输出文件 File outFile = new File(filePath+File.separator+fileName); //如果输出目标文件夹不存在,则创建 if (!outFile.getParentFile().exists()){ outFile.getParentFile().mkdirs(); } //将模板和数据模型合并生成文件 Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile),"UTF-8")); //生成文件 template.process(dataMap, out); //关闭流 out.flush(); out.close(); } catch (Exception e) { e.printStackTrace(); } } /** * 生成word文件 * @param dataMap word中需要展示的动态数据,用map集合来保存 * @param templateName word模板名称,例如:test.ftl * @param filePath 文件生成的目标路径,例如:D:/wordFile/ * @param fileName 生成的文件名称,例如:test.doc */ @SuppressWarnings("unchecked") public static void createWord2(Map dataMap,String templateName,String filePath,String fileName){ try { //创建配置实例 Configuration configuration = new Configuration(Configuration.DEFAULT_INCOMPATIBLE_IMPROVEMENTS); //设置编码 configuration.setDefaultEncoding("UTF-8"); //ftl模板文件 configuration.setClassForTemplateLoading(WordUtil.class,"/template/new"); //获取模板 Template template = configuration.getTemplate(templateName); //输出文件 File outFile = new File(filePath+File.separator+fileName); //如果输出目标文件夹不存在,则创建 if (!outFile.getParentFile().exists()){ outFile.getParentFile().mkdirs(); } //将模板和数据模型合并生成文件 Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile),"UTF-8")); //生成文件 template.process(dataMap, out); //关闭流 out.flush(); out.close(); } catch (Exception e) { e.printStackTrace(); } } }View Code
总结:
当然上面的几个方法 肯定不是全部 ,只是其中对数据处理的几个手段而已;值得注意的是:freemaker 操作,不能返回 null ,已返回就报错。需要转化成 “ ”才行。
这里遇到的问题:
可以参考一下帖子:
java使用freemarker动态生成world文档及常见错误解决。
通过freemarker生成一个word 解决生成的word用wps打开有问题的问题,解决出word时中文文件名乱码问题。
上面给的建议,基本上是属于导出前属于执著模板的时候才会出现。
第二阶段: 要兼容 office和 WPS
1.需求变更: 客户 使用群体,有的是office,有的是WPS;PC端。可以不用支持低版本的office (因为他们最低都是用的是office2010版本的)
现在就遇到了问题: 用office 打开能够正常显示 ,而用 WPS打开 ,能容都能出来,就是格式不对,【在office 里方框 和文字不会重叠,而WPS 却会重叠】。这是兼容性问题,还是WPS和office 这个样式的标号不一样。
那么久只能另想其他方法了。
首先分析: 我使用模板格式是: 第一种方式兼容2003版本的也就是 导出xml是 2003word.xml。
然后就会发现: office 有这个格式,而WPS没有,只有一个 word.xml 格式的。 然后百度了下,才知道 word.xml是高版本的,也就是说WPS 不支持低版本的了。
然后尝试完善:
导出文档 名称的后缀改成 docx.。然后神奇的发现 ,导出的文档,office 和WPS 都不能打开了。 这个方式失败,放弃。
第二种方式:
那我就导 docx 格式的吧,使用docx 第一种方式 。我直接放弃了,就是因为那个该死的图片数量不定,以及生成的文档类型多个,而且还要重写调用方式 太费时间了。
就采用第二种方式了,整个过程和doc 一样,只是模板里的排版有些变化,调用方式基本上不变。
当采用 docx的第二种方式时,你会发现,生成的xml文件 几乎一模一样,唯一的区别就是 图片了;word-2003.xml 图片的配置信息就在一个地方。,而word.xml 图片分散开来了,在三个标签里了,一个图片展示位置,一个图片对应映射关系,一个图片内容存放位置。这个也简单,由原来的一个list集合改成 3个list集合 分别处理就行了。(具体操作请看上面提供的帖子)
一番操作后。
导出文件 ,文件后缀 写的是 docx ;然后打开 才发现:office 打不开,但是wps能够正常打开,而且显示正常。
最后卡在这里大概3天 ,网上各种找资料; 结果在无意间 解决了。
这个问题的解决办法:
解决方法 是: 导出文件的后缀名改成 doc 。这样就行了,导出的文档是doc格式的。不论是office还是WPS都能正常打开了。万事大吉了
这就然我们充分认识到了,如果使用的电脑是XP系统的,那么对不起,就不要用WPS了; 如果是高版本的系统,请使用2007版级以上的office吧。这样就不怕兼容性的问题了;
同时也说明了一个问题:模板原文是doc还是docx 都不是问题,只要另存为 word,xml就是一样的了。 生成的文件 格式 是doc还是docx ,取决于你给文件定的后缀。
第三阶段: 要兼容移动端了
后面由于客户觉得我们的系统不错,就叫我们顺便也做个移动端吧,移动端吧。(差价的钱已到位)。 然后拿手机打开生成的word文档。
靠,居然打不开,显示的东西和我们生成的xml模板一模一样的调调。
也就是说我们用freemaker 生成的word文档 (以到xml模板的方式)其实内容是xml格式的,不是标准的word了。【也就是: 生成的模板xml文件 只是从命名一下(把后缀名改成doc或者docx)】?
所以,移动端当然就打不开了啊。
回去试了下,把 xml模板 后缀改成 doc或者docx ,用office和WPS打开,结果也能正常打开和显示;
我有继续试了下这个,把系统生成好的word文档打开另存为 docx或者doc .然后把另存好的文件发到手机上,打开下,结果就能正常显示了。说明,我们的word文档就差一个把非常规word转化成正规的word文档操作了。(也就是像 office 软件那个另存为 的强大功能)。
在这里深深的谴责下那些 :提出相同问题,并解决了的,但就是不告诉你怎么解决的坑爹楼主们了。害的各位同胞在线急等。
解决方法: 使用jacob 插件,把你生成好的word文档转成 正规的wordw文档。
参考文档:
- Java利用freemaker和(excelXML表格或wordXML表格),导出自己任何想要格式的文档
- Java语言结合Freemaker技术导出Word文档
- java开发导出Excel和Word文档
- java freemaker 导出word文档 高逼格教程
- 利用Java-JACOB操作WORD文档2
- Jacob 导出word文档 资源无法正常释放 解决方法
- 如何利用Java-JACOB操作WORD文档
- Java 使用Freemarker导出word 文档,解决当一段内容中既有文字又有图片的问题
- java导出word文档
- Java导出Word文档案例
- java操作word文档(jacob,poi)
- java根据ftl模板导出word文档
- Java导出Word文档使用iText操作
- 使用Java导出word文档
- (Jacob)Java程序把Word文档直接转换成Html文件
- 如何利用Java-JACOB操作WORD文档
- Java导出Word文档
- java jacob 操作word 文档,进行写操作,如生成表格,添加 图片(这个不错,可以拿来直接用,非常好)
- java页面导出excel实例,java页面导出word文档实例
- JAVA Freemarker 导出word文档实例带有图片