码迷,mamicode.com
首页 > 编程语言 > 详细

java使用freemarker 生成word文档

时间:2017-05-24 12:53:12      阅读:460      评论:0      收藏:0      [点我收藏+]

标签:dir   director   detail   uda   bae   常见问题   功能   content   就会   

 
 
 
最近需要做一个导出word的功能, 在网上搜了下, 有用POI,JXL,iText等jar生成一个word文件然后将数据写到该文件中,API非常繁琐而且拼出来的样式也不美观,于是选择了另一种方式----feemarker基于word模板的导出方式, 这种方式非常简单而且导出的样式美观, 其原理就是先做一个word模板, 该模板中变量数据用${xxx}这种方式填写, 然后再导出时只需读取模板然后用相应的数据替换其中的${xxx}即可.
 
一,简单模板导出(不含图片, 不含表格循环)
1, 新建一个word文档, 输入如下类容:
 
技术分享
 
2, 将该word文件另存为xml格式(注意是另存为,不是直接改扩展名)
3, 将xml文件的扩展名直接改为ftl
4, 用java代码完成导出(需要导入freemarker.jar)
 
package test;
 
import java.io.BufferedWriter;
import java.io.File;
import java.io.FileOutputStream;
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 Test {
public static void main(String[] args) throws Exception {
testExportSimpleWord();
}
 
public static void testExportSimpleWord() throws Exception {
// 要填充的数据, 注意map的key要和word中${xxx}的xxx一致
Map<String, String> dataMap = new HashMap<String, String>();
dataMap.put("whb", "汪海波");
 
// Configuration用于读取ftl文件
Configuration configuration = new Configuration();
configuration.setDefaultEncoding("utf-8");
 
/*
* 以下是两种指定ftl文件所在目录路径的方式, 注意这两种方式都是 指定ftl文件所在目录的路径,而不是ftl文件的路径
*/
// 指定路径的第一种方式(根据某个类的相对路径指定)
// configuration.setClassForTemplateLoading(this.getClass(),"");
 
// 指定路径的第二种方式,我的路径是C:/a.ftl
configuration.setDirectoryForTemplateLoading(new File(
"C:/"));
 
// 输出文档路径及名称
File outFile = new File("C:/test.doc");
 
// 以utf-8的编码读取ftl文件
Template t = configuration.getTemplate("test.ftl", "utf-8");
Writer out = new BufferedWriter(new OutputStreamWriter(
new FileOutputStream(outFile), "utf-8"), 10240);
t.process(dataMap, out);
out.close();
}
}
 
 
5, 这时在D盘下就生成了一个test.word, 打开可以看到${xxx}已被替换
技术分享
 
 
二, word文件中导入图片
1, 新建一个word文档, 在要插入图片的地方随便插入一张图片
技术分享
 
2, 将word另存为xml
3, 将xml扩展名改为ftl
4, 打开ftl文件, 搜索w:binData 或者 png可以快速定位图片的位置,图片 已经编码成0-Z的字符串了, 如下:
 
技术分享
 
5, 将上述0-Z的字符串全部删掉,写上${imgStr}(变量名随便写)后保存
6, 导入图片的代码与上述代码是一样的, 也是创建一个Map, 将数据存到map中,只不过我们要把图片用代码进行编码,将其也编成0-Z的字符串:
Map<String,String> dataMap = new HashMap<String,String>();
dataMap.put("imgStr", getImageStr());
 
//....其余省略
 
 
这是对图片进行编码的代码:
public String getImageStr() {
String imgFile = "d:/aa.png";
InputStream in = null;
byte[] data = null;
try {
in = new FileInputStream(imgFile);
data = new byte[in.available()];
in.read(data);
in.close();
} catch (Exception e) {
e.printStackTrace();
}
BASE64Encoder encoder = new BASE64Encoder();
return encoder.encode(data);
}
 
注意: 该代码需要用到 sun.misc.BASE64Encoder 类,这个类就是JDK中的类,但在eclipse中默认是不访问的,需要设置一下,设置方式:
项目上右键-->Build Path-->Configure Build Path...
 
技术分享
 
双击Access rules,点击add, 选择Accessible,下方输入**, OK , 这样就可以访问sun.misc.BASE64Encoder 类了
 
 
三, 导出循环的表格
1, 新建一个word文档, 插入如下表格:
 
技术分享
 
2, 另存为xml, 将扩展名改为ftl
3, 搜索 w:tr 可以找到行的起点与结束点(注意第一对w:tr 是表头,应找第二对 w:tr), 如图:
 
技术分享
 
 
 
4, 用<#list userList as user> </#list>标签将第二对 w:tr 标签包围起来(userList是集合的key, user是集合中的每个元素, 类似<c:forEach items=‘userList‘ var=‘user‘>), 如图:
 
技术分享
 
5, 解析该ftl文件
 
这是User类
Java代码
技术分享
  1. public class User {
  2. private String a;
  3. private String b;
  4. private String c;
  5. //生成set和get方法,此处省略
  6. }
 
 
这是解析ftl文件的代码,跟上面一样,只是Map的value是一个集合而已
 
public void exportListWord() throws Exception{
//构造数据
Map<String,List> dataMap = new HashMap<String,List>();
List<User> list = new ArrayList<User>();
for(int i=0;i<10;i++){
User user = new User();
user.setA("a"+(i+1));
user.setB("b"+(i+1));
user.setC("c"+(i+1));
list.add(user);
}
dataMap.put("userList", list);
 
Configuration configuration = new Configuration();
configuration.setDefaultEncoding("utf-8");
configuration.setDirectoryForTemplateLoading(new File("C:/"));
File outFile = new File("D:/test.doc");
Template t = configuration.getTemplate("c.ftl","utf-8");
Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile), "utf-8"),10240);
t.process(dataMap, out);
out.close();
}
 
如果你需要输出集合的索引, 用${user_index}即可.
 
四, 常见问题解决方案
4.1, 异常信息如下:
Xml代码
技术分享
  1. freemarker.core.ParseException: Encountered "<" at line 3, column 28888 in test.ftl.
  2. Was expecting one of:
  3. <STRING_LITERAL> ...
  4. <RAW_STRING> ...
  5. "false" ...
  6. "true" ...
  7. <INTEGER> ...
  8. <DECIMAL> ...
  9. "." ...
  10. "+" ...
  11. "-" ...
  12. "!" ...
  13. "[" ...
  14. "(" ...
 
 
这是由于在写${xxx}表达式的时候, xxx与其前方的文字样式不一致, 在另存为xml后你可以搜索一下 "${" , 会发现如下图这种情况:
 
技术分享
 
 
由于${xxx}中的xxx格式与其前方的文字不一致, 那么在生成xml时,就会有一些修饰xxx样式的标签,例如修饰xxx的字体,颜色等的标签, 所以在word中看似写的是${xxx}实际上转为xml后变成了${<w:color ...>xxx</w:color>},这样这个el表达式中的标签就解析不了报错了, 可以去掉${}内部的标签只留下xxx或者删掉 "${" 和 "}"然后给xxx加上el表达式都可以解决此问题.
 
五, javaWeb中利用response导出(注意编码问题,防止中文乱码)
Map<String,String> dataMap = new HashMap<String,String>();
dataMap.put("username", "张三");
dataMap.put("sex", "男");
 
Configuration configuration = new Configuration();
configuration.setDefaultEncoding("utf-8");
configuration.setDirectoryForTemplateLoading(new File(request.getRealPath("/")+"/templete"));//指定ftl所在目录,根据自己的改
response.setContentType("application/msword");
response.setHeader("Content-Disposition", "attachment;filename=\"" + new String("文件名.doc".getBytes("GBK"), "iso8859-1") + "\"");
response.setCharacterEncoding("utf-8");//此句非常关键,不然word文档全是乱码
PrintWriter out = response.getWriter();
Template t = configuration.getTemplate("test.ftl","utf-8");//以utf-8的编码读取ftl文件
t.process(dataMap, out);
out.close();

java使用freemarker 生成word文档

标签:dir   director   detail   uda   bae   常见问题   功能   content   就会   

原文地址:http://www.cnblogs.com/weiyi1314/p/6898007.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!