freemarker根据模板生成word文件实现导出功能

Posted 2021-01-17 zblwyj

一、准备工作

1.创建一个03的word文档，动态的数据用占位符标志占位（如testname）。然后另存为word2003的xml文件。

2.格式化xml文件，占位符的位置用${testname}代替，若有多行格式相同数据等，用List循环。

　　注意：不要用Eclipse工具去格式化xml文件(会导致导出的word文件不能用office软件打开，但是PDF能打开，估计是pdf的容错率高于office)，推荐使用firstObject工具格式化xml文件。

3.将xml文件（也可以改成ftl格式）存放到项目中指定位置。

3.下载freemarker的jar包。  

　　　　

二、前端

前端页面添加一个导出按钮，然后按钮添加点击事件,事件中跳转到所请求的Controller层即可：

window.location.href=‘XXXController/XXXMethod‘;

如有参数，直接添加到后边即可。

三、后台

1.编写工具类

　　

package io.renren.common.utils;

import java.io.BufferedWriter;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.net.URLEncoder;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Map;
import java.util.Random;

import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import freemarker.template.Configuration;
import freemarker.template.Template;

/**
* 文件导出工具类
*
* @author zblwj
* @email [email protected]
* @date 2018年11月1日下午2:40:42
*/
public class WordUtils {
/**
* 生成word文档
*/
@SuppressWarnings("unchecked")
public static File createWord(Map dataMap,String templateName,String filePath,String fileName){

try {
//创建配置实例
Configuration configuration = new Configuration();

//设置编码
configuration.setDefaultEncoding("UTF-8");

//ftl模板文件
configuration.setClassForTemplateLoading(WordUtils.class,"/template");

//获取模板
Template template = configuration.getTemplate(templateName);

//输出文件
File outFile = new File(filePath+File.separator+fileName);
//如果输出目标文件夹不存在，则创建
if (!outFile.getParentFile().exists()){
outFile.getParentFile().mkdirs();
}
//将模板和数据模型合并生成文件
Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile),"UTF-8"));
//生成文件
template.process(dataMap, out);
//关闭流
out.flush();
out.close();
return outFile;
} catch (Exception e) {
e.printStackTrace();
return null;
}
}

/**
* 生成文件名字
* @return
*/
public static String creatFileName() {
/** 文件名称，唯一字符串 */
Random r = new Random();
SimpleDateFormat sdf1 = new SimpleDateFormat("yyyyMMdd");
StringBuffer sb = new StringBuffer();
sb.append(sdf1.format(new Date()));
sb.append("_");
sb.append(r.nextInt(100));
//文件唯一名称
String fileOnlyName = "机关党支部党员积分申报表" + sb + ".doc";
return fileOnlyName;
}

/**
* 导出文件
* @throws IOException
*/
public static void exportMillCertificateWord( HttpServletResponse response, Map map,String filePath,String templateName) throws IOException {
File file = null;
InputStream fin = null;
ServletOutputStream out = null;
try {
String fileName = WordUtils.creatFileName();
file = WordUtils.createWord(map, templateName, filePath,fileName);
fin = new FileInputStream(file);
response.setCharacterEncoding("utf-8");
response.setContentType("application/msword");
response.setHeader("Content-Disposition", "attachment;filename=".concat(String.valueOf(URLEncoder.encode(fileName, "UTF-8"))));
out = response.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(); // 删除临时文件
}

}
}

2.Controller层

3.Server层

 

 三、最终结果

 四、个人总结

     此方法还是很简单，但是由于第一次使用，废了不少功夫。导出过程中会生成一个临时的文件，然后利用response的输出流将文件读取到浏览器客户端，读取完成后将会删除生成的临时文件。个人踩坑的地方是用Eclipse格式化了xml文件，导致了导出的word文件不能用office工具打开。