freemarker导出富文本到word文档

系统管理员 2023-09-27 13:26 161阅读 0赞

## 1.开发概述 ##

**1.简单概述上传代码**【原本是下载多个章节，然后合并为一个整体word文档】

后续因时间，模板改为含一级+内容、二级标题+内容的。则无需合并工作，直接导出为一个word整体。【**本文导出格式mht非xml**】

> **简述mht与xml的最大区别：**
> 
> **总结**：两者皆为标签组合，mht为html的，xml就是xml格式。但是富文本为你好形式，只有html支持啊！
> 
> **本质区别**：html是用来**显示**数据的;xml是用来**描述**、**存放**数据的
> 
>  
> 
> 
> 	 
> 	 ${item.titleName}
> 
> 
> <w:r>
> <w:rPr>
> <w:b/>
> <w:color w:val="000000"/>
> <w:szCs w:val="24"/>
> </w:rPr>
> <w:t>${sendDateZh}</w:t>
> </w:r>

代码为简单版无需合并的版本

public void exportWordTemplate(HttpServletResponse response, Long templateId) {
 // 模板数据
 XXXDTO= mapper.getTemplateById(templateId);
 if (null == templateDTO) {
 log.info("exportWordTemplate get template is null,templateId {}", templateId);
 return;
 }
 // 标题和内容
 List<XXXRep> list = sumList(templateId);
 Map root = new HashMap();
 //放入模板的数据本质就是个map对象
 root.put("maps", list);
 BufferedWriter writer = null;
 OutputStream os = null;
 try {
 // 初始化配置文件
 Configuration configuration = new Configuration(Configuration.DEFAULT_INCOMPATIBLE_IMPROVEMENTS);
 configuration.setDefaultEncoding(Common.STR_UTF_8);
 configuration.setClassicCompatible(true);
 ClassPathResource classPathResource = new ClassPathResource("/templates/");
 // 加载文件
 configuration.setDirectoryForTemplateLoading(classPathResource.getFile());
 // 加载模板
 Template template = configuration.getTemplate("templateV01.ftl");
 String filename = templateDTO.getTemplateName() + "-" + DateUtils.format(new Date(), DateUtils.YYYYMMDDHHMMSS) + ".doc";
 
 response.setCharacterEncoding(Common.STR_UTF_8);
 //流的形式给前台
 response.setContentType("application/octet-stream");
 //前台下载
 response.setHeader("Content-Disposition", "attachment;fileName=" + URLEncoder.encode(filename, CommonConstant.STR_UTF_8));
 
 os = response.getOutputStream();
 writer = new BufferedWriter(new OutputStreamWriter(os, CommonConstant.STR_UTF_8), 2048);
 
 template.process(root, writer);
 
 } catch (IOException e) {
 log.info("IOException错误！" + e.getMessage());
 } catch (TemplateException e) {
 log.info("TemplateException错误！" + e.getMessage());
 } finally {
 IOUtils.closeQuietly(os);
 IOUtils.closeQuietly(writer);
 }
 
 }

### 2.导出的文档wps、word打开内容乱码 ###

> 中间多次尝试，有转为unicode编码，文档没问题，但是本身看不懂。
> 
> 后续验证不管其他文章怎么说的，一律改为utf-8 （代码中Common.STR\_UTF\_8= "UTF-8"）
> 
> 1.模板处理时 改为Unicode-utf8
> 
> 2. configuration.setDefaultEncoding(Common.STR\_UTF\_8);
> 
> 3.代码中 转换流 也转为 Common.STR\_UTF\_8= "UTF-8"
> 
> 4.导出模板用word最好，wps也可以。但网上多数为word的参考哦！
> 
> 5.java代码导出文档后缀doc. 不要用。docx后缀
> 
> **优点：**模板中汉字开发者能看清！控制台你也能看清！否则只能保佑你做的细心！！

## **3.处理标题时发现无分页，标题文本内容在一体。** ##

<#if item_index!=0>
 <#-- 多次尝试，此为分页符。pdf时br改为div标签-->
 
 
 <#-- -->
 </#if>

**重点就是 换行标签。 为了防止第一个大标题就分页，故做了判断 看下 下列的入门教程**

[Freemarker使用教程——入门篇\_东天里的冬天的博客-CSDN博客\_freemarker使用教程][Freemarker_-CSDN_freemarker]

**导出格式为xml 也有人用这种方式分页**

![在这里插入图片描述][a5053d2eaffa497e863f83c6025f5640.png]

## 4.导出源代码时，会出现换行符变成 ”=“ 需要手动删除一下 ##

> **word转格式**
> 
> ss=3DSpellE> style=3D'mso-bidi-font-weight:normal'> ze:9.0pt; 
> **<\#-- 如图：doc变为mht格式，class变为cla=ss-->**
> 
> **wps转格式 =反而在前面**
> 
> =20margin-bottom:72.0000pt;
> 
> =20margin-left:90.0000pt;
> 
> =20margin-right:90.0000pt;
> 
> =20size:595.3000pt 841.9000pt;
> 
> =20layout-grid:15.6000pt;
> 
> **总结：手动的那都是老实人！！！用这个！！方便处理\[先净化、再美化！\]**[xml格式化，xml压缩 - 在线工具][xml_xml_ -]

## 5.含压缩文件参考下述内容就不一一列举 ##

> [基于freemarker(mht)方式导出带图片的富文本word - 灰信网（软件开发博客聚合）][freemarker_mht_word -]

## 6.既要word支持又要wps支持！ ##

原因第一看模板，第二是前台给的富文本中标签

> 前台给的
> 
> 自己要的理想效果！

/**
    	 * 替换3D不转码
    	 * @return String
    	 */
    	public String getRawHandledDocBodyBlock() {
    		String raw = doc.getElementsByTag("body").html();
    		return raw.replace("=3D", "=").replace("=", "=3D");
    	}

**参考资料：**

[java生成word文档 - 走看看][java_word_ -][基于freemarker(mht)方式导出带图片的富文本word\_HashMap黑龙江分Map的博客-CSDN博客\_richhtmlhandler][freemarker_mht_word_HashMap_Map_-CSDN_richhtmlhandler]

## 7.业务要自动更换基础数据—卒！改为xml格式 ##

开发完初版,-【之前是给了个页面就叫参照开发。本身想得是简单点-分为多个章节，选完富文本填入，再导出完整word】

后总算跟业务讨论，1.想要富文本对比，页面上明显看出哪里修改，并记录

2.基础数据变动，word中自动替换\[功能做了，但是太low了。需要手动维护下变更参数\]抛弃

3.word多个章节，但是哪些章节动态会变动，哪些不会变动。。没人组织或者一句话这些基本不变。。。 理想是能变得就给他变，不理想的就是他自己手动更改

4.新开发功能，但是之前数据要迁移过来。保持之前的word文档也会变更。跟其他对接的属于xml格式，所以我们也要做个存储xml数据【那就应该先查看之前功能！了解数据存储结构、模板等细节。】

5.之前的word做个导入功能，这个讲真心态崩。模板**不是固定的一个**，又不是xml的标签之间存值容易获取

6.幸运--多个同事帮忙搞哈哈！

[Freemarker_-CSDN_freemarker]: https://blog.csdn.net/gwd1154978352/article/details/76087436
[a5053d2eaffa497e863f83c6025f5640.png]: https://img-blog.csdnimg.cn/a5053d2eaffa497e863f83c6025f5640.png
[xml_xml_ -]: https://tool.lu/xml/
[freemarker_mht_word -]: https://www.freesion.com/article/2125158639/
[java_word_ -]: http://t.zoukankan.com/hooly-p-9242105.html
[freemarker_mht_word_HashMap_Map_-CSDN_richhtmlhandler]: https://blog.csdn.net/yz357823669/article/details/80840855