freemarker导出word文档

最新推荐文章于 2025-06-06 12:26:13 发布

下半夜的雨

最新推荐文章于 2025-06-06 12:26:13 发布

阅读量1k

点赞数

CC 4.0 BY-SA版权

分类专栏：平时积累文章标签： freemarker word 文档 office

本文链接：https://blog.youkuaiyun.com/fancheng614/article/details/78358060

平时积累专栏收录该内容

12 篇文章

订阅专栏

本文档介绍了如何使用Freemarker导出Word文档的简单步骤。首先，利用Office创建Word模板，用${id}等表示要替换的内容。接着，将Word另存为XML并改名为.ftl。在工程中加入freemarker.jar，将.ftl文件引入。最后，编写Java代码实现导出，提供了一个工具类供web项目使用。在操作过程中要注意${}内的占位符不能有额外代码。

很多web项目需要添加导出word文档的功能，使用POI似乎比freemarker麻烦一些，事实上POI导出word文档我还没有学习，这里记录一下使用freemarker导出word文档。

查询了很多资料，也查询了很多方法，大神们的方法都比较高级，我先记录一下比较简单的使用方法吧！

一、使用office新建一个word文档：

这里如果想导出的是表格，可以画出word版本的表格，需要导出的内容使用下图类似 ${id} 表示即可！

二、将新建的word文档另存为xml，修改 xml 文件的后缀名为 ftl 。

三、新建工程，将freemarker.jar复制到工程目录的lib目录下

四、将第二步的 ftl 文件拷贝到项目中。

工程目录：

五、开始写java代码：

工具类：

package TestDoc;

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;  
  
/** 
 * 使用freemark生成word 
 */  
public class Freemark {  
	private Configuration configuration = null; 
	
    public Freemark() {
        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(),"/com/mfc/templates"); 
        Template t=null; 
        try { 
            //test.ftl为要装载的模板 
            t = configuration.getTemplate("test.ftl","UTF-8"); 
        } 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(); 
        } 
    }    
}

测试类：

package TestDoc;

import java.io.UnsupportedEncodingException;
import java.util.HashMap;
import java.util.Map;

public class Test {

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

	        //创建一个数据集合存入相应的值

	            Map<String, Object> dataMap = new HashMap<String, Object>(); 
	            dataMap.put("name", "下半夜的风"); 
	            dataMap.put("id", "1");

	            dataMap.put("title", "测试");

	            dataMap.put("content", "这个插件WORD的测试工作正在积极测试当中！！！！！！！！！！！！！！！！！！"); 
	            dataMap.put("starttime", "2017年10月26日11:35:06"); 
	            dataMap.put("stoptime", "2017年10月26日11:35:06"); 
	            dataMap.put("state", "1"); 
	            

	            //写入doc创建文件
	            Freemark freemark = new Freemark();
	            freemark.createDoc(dataMap, "d:/test.doc"); 

	            System.out.println("doc创建成功！");

	        }
}

到此，运行测试类，就可以在D盘根目录看到word文档！

本方法可以引用到web项目中去！

注意：将新建的word文档另存为xml文档然后改为ftl文件后，直接运行测试类有时会报错，报错信息如下：

freemarker.core.ParseException: Parsing error in template "test.ftl" in line 3, column 4740:
Encountered "<", but was expecting one of:
    <STRING_LITERAL>
    <RAW_STRING>
    "false"
    "true"
    <INTEGER>
    <DECIMAL>
    "."
    "+"
    "-"
    "!"
    "["
    "("
    "{"
    <ID>
	at freemarker.core.FMParser.generateParseException(FMParser.java:4672)
	at freemarker.core.FMParser.jj_consume_token(FMParser.java:4543)
	at freemarker.core.FMParser.UnaryExpression(FMParser.java:340)
	at freemarker.core.FMParser.MultiplicativeExpression(FMParser.java:452)
	at freemarker.core.FMParser.AdditiveExpression(FMParser.java:402)
	at freemarker.core.FMParser.RangeExpression(FMParser.java:573)
	at freemarker.core.FMParser.RelationalExpression(FMParser.java:528)
	at freemarker.core.FMParser.EqualityExpression(FMParser.java:493)
	at freemarker.core.FMParser.AndExpression(FMParser.java:602)
	at freemarker.core.FMParser.OrExpression(FMParser.java:625)
	at freemarker.core.FMParser.Expression(FMParser.java:238)
	at freemarker.core.FMParser.StringOutput(FMParser.java:1076)
	at freemarker.core.FMParser.Content(FMParser.java:2550)
	at freemarker.core.FMParser.OptionalBlock(FMParser.java:2761)
	at freemarker.core.FMParser.Root(FMParser.java:2933)
	at freemarker.template.Template.<init>(Template.java:193)
	at freemarker.cache.TemplateCache.loadTemplate(TemplateCache.java:419)
	at freemarker.cache.TemplateCache.getTemplate(TemplateCache.java:330)
	at freemarker.cache.TemplateCache.getTemplate(TemplateCache.java:205)
	at freemarker.template.Configuration.getTemplate(Configuration.java:740)
	at freemarker.template.Configuration.getTemplate(Configuration.java:681)
	at TestDoc.Freemark.createDoc(Freemark.java:38)
	at TestDoc.Test.main(Test.java:27)
Exception in thread "main" java.lang.NullPointerException
	at TestDoc.Freemark.createDoc(Freemark.java:57)
	at TestDoc.Test.main(Test.java:27)

解决方法：找到对应的报错位置，比如现在报错的是 ftl 文件的第三行第4740列，按照下图方式处理

使下图中的 ${ 和 } 之间除了word文档中的占位名称之外没有其他代码

</w:rPr><w:t>${content}</w:t></w:r>

补充一下：

创建一个文件夹的方法：

        	File file = new File("D:\\test");
        	file.mkdir();

源码下载：http://download.youkuaiyun.com/download/fancheng614/10040948