Java灵活文档导出-Freemarker

项目中总是需要生成各种报表和文档，而word文档是我们经常使用的格式，用freemarkerm模板生成是一个比较便捷的方式，现总结一下关键步骤，供大家参考

一、模板的***

先用Word做一个模板，如下图：



（注意，上面是有表格的，我设置了边框不可见）然后另存为XML文件，之后用工具打开这个xml文件，有人用firstobject XML Editor感觉还不如notepad++，我这里用notepad++，主要是有高亮显示，和元素自动配对，效果如下：



上面黑色的地方基本是我们之后要替换的地方，比如xytitle替换为${xytitle}，对已表格要十分注意，比如选择题下面的表格，我们可以通过<w:tr>查找来定位，一对<w:tr></w:tr>代表一行，也就是一条记录（一道题），我们这里要用一对<#list></#list>来将其包括，以便后续填充数据，具体可参照Freemarker页面语法，例如这里选择题，我们是两行为一条记录，所以要<#list></#list>要包括两行，形如：<#list table1 as plan1><w:tr>题号 题目</w:tr><w:tr>选项</w:tr></#list>，然后在这其中找着对应的xzn，xztest，ans1，ans2，ans3，ans4替换为${plan1.xzn}，${plan1.xztest}，${plan1.ans1}，${plan1.ans2}，${plan1.ans3}，${plan1.ans4}，注意这里的table1及plan1命名，table1后续填充数据要用到，其他的替换同理操作，得到效果如下：



保存后，修改后缀名为ftl，至此模板***完毕。

二、编程实现

这里用到了freemarker-2.3.13.jar包，代码如下：

[java] view
plaincopy





package common;



import java.io.BufferedWriter;

import java.io.File;

import java.io.FileNotFoundException;

import java.io.FileOutputStream;

import java.io.IOException;

import java.io.OutputStreamWriter;

import java.io.UnsupportedEncodingException;

import java.io.Writer;

import java.util.Map;



import freemarker.template.Configuration;

import freemarker.template.Template;

import freemarker.template.TemplateException;



public class DocumentHandler {



private Configuration configuration = null;



public DocumentHandler() {

configuration = new Configuration();

configuration.setDefaultEncoding("utf-8");

}



public void createDoc(Map<String,Object> dataMap,String fileName) throws UnsupportedEncodingException {

//dataMap 要填入模本的数据文件

//设置模本装置方法和路径,FreeMarker支持多种模板装载方法。可以重servlet，classpath，数据库装载，

//这里我们的模板是放在template包下面

configuration.setClassForTemplateLoading(this.getClass(), "/template");

Template t=null;

try {

//test.ftl为要装载的模板

t = configuration.getTemplate("fctestpaper.ftl");

} catch (IOException e) {

e.printStackTrace();

}

//输出文档路径及名称

File outFile = new File(fileName);

Writer out = null;

FileOutputStream fos=null;

try {

fos = new FileOutputStream(outFile);

OutputStreamWriter oWriter = new OutputStreamWriter(fos,"UTF-8");

//这个地方对流的编码不可或缺，使用main（）单独调用时，应该可以，但是如果是web请求导出时导出后word文档就会打不开，并且包XML文件错误。主要是编码格式不正确，无法解析。

//out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile)));

out = new BufferedWriter(oWriter);

} catch (FileNotFoundException e1) {

e1.printStackTrace();

}



try {

t.process(dataMap, out);

out.close();

fos.close();

} catch (TemplateException e) {

e.printStackTrace();

} catch (IOException e) {

e.printStackTrace();

}



//System.out.println("---------------------------");

}

}

然后是准备数据调用就行，代码如下：

[java] view
plaincopy





package com.havenliu.document;



import java.io.UnsupportedEncodingException;

import java.util.ArrayList;

import java.util.HashMap;

import java.util.List;

import java.util.Map;



public class Main {



/**

* @param args

* @throws UnsupportedEncodingException

*/

public static void main(String[] args) throws UnsupportedEncodingException {;



Map<String, Object> dataMap = new HashMap<String, Object>();

dataMap.put("xytitle", "试卷");

int index = 1;

// 选择题

List<Map<String, Object>> list1 = new ArrayList<Map<String, Object>>();//题目

List<Map<String, Object>> list11 = new ArrayList<Map<String, Object>>();//答案

index = 1;

for (int i = 0; i < 5; i++) {



Map<String, Object> map = new HashMap<String, Object>();

map.put("xzn", index + ".");

map.put("xztest",

"( )操作系统允许在一台主机上同时连接多台终端，多个用户可以通过各自的终端同时交互地使用计算机。");

map.put("ans1", "A" + index);

map.put("ans2", "B" + index);

map.put("ans3", "C" + index);

map.put("ans4", "D" + index);

list1.add(map);



Map<String, Object> map1 = new HashMap<String, Object>();

map1.put("fuck", index + ".");

map1.put("abc", "A" + index);

list11.add(map1);



index++;

}

dataMap.put("table1", list1);

dataMap.put("table11", list11);



// 填空题

List<Map<String, Object>> list2 = new ArrayList<Map<String, Object>>();

List<Map<String, Object>> list12 = new ArrayList<Map<String, Object>>();

index = 1;

for (int i = 0; i < 5; i++) {



Map<String, Object> map = new HashMap<String, Object>();

map.put("tkn", index + ".");

map.put("tktest",

"操作系统是计算机系统中的一个___系统软件_______，它管理和控制计算机系统中的___资源_________.");

list2.add(map);



Map<String, Object> map1 = new HashMap<String, Object>();

map1.put("fill", index + ".");

map1.put("def", "中级调度" + index);

list12.add(map1);



index++;

}

dataMap.put("table2", list2);

dataMap.put("table12", list12);



// 判断题

List<Map<String, Object>> list3 = new ArrayList<Map<String, Object>>();

List<Map<String, Object>> list13 = new ArrayList<Map<String, Object>>();

index = 1;

for (int i = 0; i < 5; i++) {



Map<String, Object> map = new HashMap<String, Object>();

map.put("pdn", index + ".");

map.put("pdtest",

"复合型防火墙防火墙是内部网与外部网的隔离点，起着监视和隔绝应用层通信流的作用，同时也常结合过滤器的功能。");

list3.add(map);



Map<String, Object> map1 = new HashMap<String, Object>();

map1.put("judge", index + ".");

map1.put("hij", "对" + index);

list13.add(map1);



index++;

}

dataMap.put("table3", list3);

dataMap.put("table13", list13);



// 简答题

List<Map<String, Object>> list4 = new ArrayList<Map<String, Object>>();

List<Map<String, Object>> list14 = new ArrayList<Map<String, Object>>();

index = 1;

for (int i = 0; i < 5; i++) {



Map<String, Object> map = new HashMap<String, Object>();

map.put("jdn", index + ".");

map.put("jdtest", "说明作业调度，中级调度和进程调度的区别，并分析下述问题应由哪一级调度程序负责。");

list4.add(map);



Map<String, Object> map1 = new HashMap<String, Object>();

map1.put("answer", index + ".");

map1.put("xyz", "说明作业调度，中级调度和进程调度的区别，并分析下述问题应由哪一级调度程序负责。");

list14.add(map1);



index++;

}

dataMap.put("table4", list4);

dataMap.put("table14", list14);



MDoc mdoc = new MDoc();

mdoc.createDoc(dataMap, "E:/outFile.doc");

}



}

注意上面map中的key必须和模板中的对应，否则会报错。效果如下：