使用velocity生成模板化的word文件

需求

用户填写表单内容后需要下载word文档，打印、敲章。选择word的好处是打印前可以修改（pdf无法修改，不同场景不同选择），而且排版比excel灵活。

实现思路

word可以另存为xml，使用模板引擎技术可以非常方便的完成替换，由于本项目中已经使用velocity，因此没有选择freemarker。

遇到的坑

我用的是word2007，制作完模板另存为xml，结果生成的文件中部分中文显示了乱码。各种尝试无果。最终另存为选择 word2003xml文档解决问题。有兴趣的同学请继续研究。

模板制作技巧

听上去另存为xml是不错的思路，但实际上生成的xml结构是比较复杂的，通常大家都不熟悉。

1. 在word中编写velocity的变量。但保存后要用文本编辑器检查一遍变量是否被word劈成多段
2. 使用xml格式化工具美化格式
3. 循环结构的foreach需要使用文本编辑器编写，为了快速定位可以查找 w:tr
4. 编辑完的模板保存到 \WEB-INF\templates 下

java调用

String path = WordHelper.createWord("bond.doc.vm","bond.doc",bondVO);

模板名，word文件名，数据pojo
返回下载用的相对路径，由于下载功能在网页关闭后就没有用了，因此存在了temp目录下，方便定时删除。

发布注意事项

download 目录需要做软连接

改进思路

在实践过程中这个xml太难维护了，第一遍忍了，当要求修改默认内容时就傻了。因此新的思路是写个html 的 模板，依然用 velocity替换变量，然后使用POI生成word。这样对现有的技术调整较小，并且后续模板的维护也变得简单了。