使用FreeMarker导出固定格式word文档

一.下载FreeMarker的jar包

下载地址：http://freemarker.org/freemarkerdownload.html，导入项目，报错的自行搜索缺少的jar包。

二.修改word文档

将需要替换的使用freemarker的占位符替换，类似EL表达式，不同是的对于循环遍历，if判断，freemarker有自己的格式。对于需要对list遍历生成的，word文档里使用参变量，后面在xml文件里额外定义参变量。修改后的具体格式如下：

三.将修改后的word文档保存成xml格式

使用word编辑好后，保存文档，将文档另存为xml格式，具体如下图：

四.使用编辑工具打开xml，修改被分割的占位符

使用notepad或者visulcode打开xml文档，将占位符被分割的，删除中间的word标签，只有完整占位符才会被freemarker解析。

五.对于集合元素

首先在xml中，需要确定循环的具体循环体，防止循环结果错误，找到正确循环体后，在头和尾部额外插入标签。<#list 集合 as 参数名> </#list >，具体效果如下：

需要循环生成选出的人员名+空格，而不是一整行。<w:p>代表一行
需要循环一行生成人员名。<w:tr>代表一个表格tr

六.将修改好的xml文档，保存后，直接修改文件名，保存成resume.ftl

需要修改后缀名，window询问是否保存，点击是，即可。

七.创建导出工具类

将上一步生产的resume.ftl文件，复制到工具包下，创建工具类用于导出word，直接复制如下代码：

package com.yh.common.util;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;
import freemarker.template.Configuration;
import freemarker.template.Template;  public class WordGenerator {private static Configuration configuration = null;  private static Map<String, Template> allTemplates = null;  static {  configuration = new Configuration();  configuration.setDefaultEncoding("utf-8");  configuration.setClassForTemplateLoading(WordGenerator.class, "/com/yh/common/util");  allTemplates = new HashMap<>();   // Java 7 钻石语法  try {  allTemplates.put("resume", configuration.getTemplate("resume.ftl"));  } catch (IOException e) {  e.printStackTrace();  throw new RuntimeException(e);  }  }  private WordGenerator() {  throw new AssertionError();  }  public static File createDoc(Map<?, ?> dataMap, String type) {  String name = "temp" + (int) (Math.random() * 100000) + ".doc";  File f = new File(name);  Template t = allTemplates.get(type);  try {  // 这个地方不能使用FileWriter因为需要指定编码类型否则生成的Word文档会因为有无法识别的编码而无法打开  Writer w = new OutputStreamWriter(new FileOutputStream(f), "utf-8");  t.process(dataMap, w);  w.close();  } catch (Exception ex) {  ex.printStackTrace();  throw new RuntimeException(ex);  }  return f;  }
}

八.控制层写法

开发时，使用的struct，提供struct的写法。其中父类中包括了获取response和request的方法，这边可以在方法参数里面添加，读者根据具体情况自行修改。

public String exportWord()  throws ServletException, IOException { HttpServletResponse resp = ServletActionContext.getResponse();request.setCharacterEncoding("utf-8");  Map<String, Object> map = new HashMap<String, Object>(); //查询评审场次信息List list1 = ?;if(!ValidateUtil.isEmpty(list1)){map.put("list1", list1);}//查询轮次信息map.put("round", ?);List list2 = ?;if(!ValidateUtil.isEmpty(list2)){map.put("list2", list2);}List list3 = ?;if(!ValidateUtil.isEmpty(list3)){map.put("list3", list3);}//投票产生的人数String expertNumber= ?;map.put("expertNumber", expertNumber);//总人数String number = ?;map.put("number", number);String filename = ？;//可以是中文// 提示：在调用工具类生成Word文档之前应当检查所有字段是否完整  // 否则Freemarker的模板殷勤在处理时可能会因为找不到值而报错 这里暂时忽略这个步骤了  File file = null;  InputStream fin = null;  ServletOutputStream out = null;  try {  // 调用工具类WordGenerator的createDoc方法生成Word文档  file = WordGenerator.createDoc(map, "resume");  fin = new FileInputStream(file);  resp.setCharacterEncoding("utf-8");  resp.setContentType("application/msword");  // 设置浏览器以下载的方式处理该文件默认名为filename.doc  String fileName = "attachment; filename= "+new String(filename.getBytes(), "ISO-8859-1")+".doc";//转化中文，防止中文文件名导致下载文件文件名异常或者没有后缀名resp.addHeader("Content-Disposition", fileName);  out = resp.getOutputStream();  byte[] buffer = new byte[512];  // 缓冲区  int bytesToRead = -1;  // 通过循环将读入的Word文件的内容输出到浏览器中  while((bytesToRead = fin.read(buffer)) != -1) {  out.write(buffer, 0, bytesToRead);  }  } finally {  if(fin != null) fin.close();  if(out != null) out.close();  if(file != null) file.delete(); // 删除临时文件  }  return SUCCESS;}

九.jsp写法

页面调用一个同步方法，到控制层即可导出文件。

10.生成效果