如何生成freemarker模板

一、先用word写一份文档模板xx.doc，然后保存成xx.xml文件。

二、下载一个sublime格式化xml（可参考使用sublime一键格式化XML文件），用sublime打开xx.xml文件，把之前模板中的内容替换成代码中的变量，${变量}。

三、把xx.xml另存为xx.ftl。

四、写模板的过程中碰到的问题：

• freemarker中${变量}中的变量为null，模板就会报错。如果为空，就以默认值（“!”后的字符）显示。

可以通过两种方法判空：

<#if ${变量}??>

……

</#if>

也可以通过设置默认值${变量!''}来避免对象为空的错误。（可参考FreeMarker框架）

• 循环遍历list，开始word模板中的内容只是一条，但是有时候需要生成的内容是多条，这时在前面的第二步中的需要填充的内容开始进行循环遍历。

<#if ${userList}??>

<#list userList as user>

  …
</#list>

</#if>

• java程序中的图片属性是个字符串数组的情况，一个单元格中生成多张图片。模板中标明每个属性时都会有id，其中把这个id改成数组的下标。注意这个id不能其他属性的id重复，否则最终生成的word文档打开时会报内容有误，但是打开又有内容。这种情况很难排查出问题，通过把生成的文档再用sublime打开，与最初的模板对比很容易看出问题。