如何使用Java生成Word文档呢？基本的想法就是使用一个现成的Word作为模版，需要用变量替换的地方，在word中使用一种模版语言来标记，然后再使用模版引擎把它替换掉。
在这里笔者找到了xdocreport 和 freemarker
具体的思路如图：
Java的code就不贴在这里了，xdocreport中介绍的很详细。然而在word中添加freemarker的地方介绍的好像不是很清楚。笔者经过多次的尝试，总结如下：
1.简单的变量替换
首先要做的是要插入一个域，这个东西不是很常用。在word文档的这个地方。
点击插入域以后，word会弹出一个框来，这里需要选择MERGEFIELD
现在就可以在域代码提示符**MERGEFILED **后面填写所需的Freemarker标记例如:
MERGEFIELD ${d.lastName}
在Word上面会插入一个标记，如下图所示：
修改它的时候，需要右键这个域，选择更换域代码，这个时候，这个域会变成这样：
{MERGEFIELD ${d.lastName} \*MERGEFILED}
两边的标记不用管它，我们关注的地方就在中间的这个地方，后面提到的标记都是写在中间的，修改之后，再右键点击更新域。这个域就算更新完成了。
Word中的这些域都会被当成freemarker替换掉，如果语法不对，整个word生成都会失败。
- 使用Hash表
所需的freemarker标记为:
${d["lastName"]}
所以生成的域代码就是:
{MERGEFIELD ${d["lastName"]} \*MERGEFILED}
- 数组
这个地方需要几个标记，一个是循环开始，一个循环中的内容，一个循环结束。最终的标记效果如下：
其中前面的标记如下，注意是有双引号的。
"[#list developers as developer]"
后面的标记是：
[/#list]
- IF
基本跟Freemarker的相同。也有两个标记。
[#if holder_has_next]
[/#if]
这个IF是判断list中是否还有下一个元素。
- 一个复杂的例子
例如，我们要实现一个效果，遍历某个对象(agreement)的一个数组属性(holders)，数组中的元素是一个Hash表，显示这个Hash表中的某个key值。每个值使用顿号隔开。最终的效果如下：
每个域代码如下:
"[#list agreement.holders as holder]"
${holder["fullName"]}
[#if holder_has_next]
[/#if]
[/#list]
- 表格
表格是word里面较为特殊的结构，xdocreport提供了一些方法可以较为简单的生成表格，其中一种方法使用metadata在java中标记某些某些变量是数组，然而这样降低了java code的复用度，对于对象的某些数组属性，还要再将变量注册到freemarker的context中，非常不灵活，所以决定使用不含metadata的方法。
需要注意的地方是在表格第一列前后各有一个标记，他们分别是:
"@before-row[#list agreement.holders as h]"
@after-row[/#list]
