使用xdocreport和Freemarker生成word

如何使用Java生成Word文档呢？基本的想法就是使用一个现成的Word作为模版，需要用变量替换的地方，在word中使用一种模版语言来标记，然后再使用模版引擎把它替换掉。

在这里笔者找到了xdocreport 和 freemarker

具体的思路如图：

Free Marker处理模版的方式

Java的code就不贴在这里了，xdocreport中介绍的很详细。然而在word中添加freemarker的地方介绍的好像不是很清楚。笔者经过多次的尝试，总结如下：

1.简单的变量替换

首先要做的是要插入一个域，这个东西不是很常用。在word文档的这个地方。

插入域

点击插入域以后，word会弹出一个框来，这里需要选择MERGEFIELD

选择MERGEFIELD

现在就可以在域代码提示符**MERGEFILED **后面填写所需的Freemarker标记例如:

MERGEFIELD  ${d.lastName}

在Word上面会插入一个标记，如下图所示：

在word里面显示的域标记

修改它的时候，需要右键这个域，选择更换域代码，这个时候，这个域会变成这样：

{MERGEFIELD ${d.lastName} \*MERGEFILED}

两边的标记不用管它，我们关注的地方就在中间的这个地方，后面提到的标记都是写在中间的，修改之后，再右键点击更新域。这个域就算更新完成了。

Word中的这些域都会被当成freemarker替换掉，如果语法不对，整个word生成都会失败。

2. 使用Hash表

---

所需的freemarker标记为:

${d["lastName"]}

所以生成的域代码就是:

{MERGEFIELD ${d["lastName"]} \*MERGEFILED}

3. 数组

---

这个地方需要几个标记，一个是循环开始，一个循环中的内容，一个循环结束。最终的标记效果如下：

遍历一个数组，并显示数组中元素的某些属性

其中前面的标记如下，注意是有双引号的。

 "[#list developers as developer]"

后面的标记是：

[/#list]

4. IF

---

基本跟Freemarker的相同。也有两个标记。

[#if holder_has_next]

[/#if]

这个IF是判断list中是否还有下一个元素。

5. 一个复杂的例子

---

例如，我们要实现一个效果，遍历某个对象(agreement)的一个数组属性(holders)，数组中的元素是一个Hash表，显示这个Hash表中的某个key值。每个值使用顿号隔开。最终的效果如下：

生成的域

每个域代码如下:

"[#list agreement.holders as holder]"

${holder["fullName"]}

[#if holder_has_next]

[/#if]

[/#list]

6. 表格

---

表格是word里面较为特殊的结构，xdocreport提供了一些方法可以较为简单的生成表格，其中一种方法使用metadata在java中标记某些某些变量是数组，然而这样降低了java code的复用度，对于对象的某些数组属性，还要再将变量注册到freemarker的context中，非常不灵活，所以决定使用不含metadata的方法。

表格

需要注意的地方是在表格第一列前后各有一个标记，他们分别是:

"@before-row[#list agreement.holders as h]"

@after-row[/#list]