freemarker生成excel、word、html、xml实例教程

最新推荐文章于 2025-07-03 17:08:47 发布
原创 最新推荐文章于 2025-07-03 17:08:47 发布 · 2.3w 阅读 · 78 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#freemarker #java #excel #xml #word

本文介绍使用Freemarker模板引擎快速生成Excel、Word、HTML和XML文件的方法。通过实例展示了如何利用Java代码配合Freemarker进行数据填充，并提供了详细的步骤说明。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

对于导出excel我一直以为用poi、jxt的实现就够了，直到接触了freemarker以后，我才发现我错了，原来还有一种实现比前两者都更简单、便捷。

今天研究了一天的freemarker,一口气写了4个例子，分别实现了对excel、word、html、xml的生成操作。


freemarker页面函数语法地址：http://blog.youkuaiyun.com/u010722643/article/details/41720517

工程 及 freemarker.jar 下载地址：http://download.youkuaiyun.com/detail/u010722643/8224995


工程结构为：


1.freemarker的java代码

entity:


OptionQuestions

package entity;

import java.io.Serializable;
/**
 * 选择题试题类
 * @author 李益勇
 *
 */
public class OptionQuestions implements Serializable{
	/**
	 * 
	 */
	private static final long serialVersionUID = -9200292678301275536L;
	private String content;
	private String option1;
	private String option2;
	private String option3;
	private String option4;
	
	public String getContent() {
		return content;
	}
	public void setContent(String content) {
		this.content = content;
	}
	public String getOption1() {
		return option1;
	}
	public void setOption1(String option1) {
		this.option1 = option1;
	}
	public String getOption2() {
		return option2;
	}
	public void setOption2(String option2) {
		this.option2 = option2;
	}
	public String getOption3() {
		return option3;
	}
	public void setOption3(String option3) {
		this.option3 = option3;
	}
	public String getOption4() {
		return option4;
	}
	public void setOption4(String option4) {
		this.option4 = option4;
	}
}

user 

package entity;

import java.io.Serializable;
/**
 * User实体类
 * @author 李益勇
 *
 */
public class User implements Serializable{
	
	/**
	 * 
	 */
	private static final long serialVersionUID = 1L;
	private String userName;
    private String passWord;
    private String age;
    private String addr;
    private String realName;
    
	public String getUserName() {
		return userName;
	}
	public void setUserName(String userName) {
		this.userName = userName;
	}
	public String getPassWord() {
		return passWord;
	}
	public void setPassWord(String passWord) {
		this.passWord = passWord;
	}
	public String getAge() {
		return age;
	}
	public void setAge(String age) {
		this.age = age;
	}
	public String getAddr() {
		return addr;
	}
	public void setAddr(String addr) {
		this.addr = addr;
	}
	public String getRealName() {
		return realName;
	}
	public void setRealName(String realName) {
		this.realName = realName;
	}
}

模板解析Util类：

TemplateParseUtil

package util;
/**
 * 模板解析实体类
 */
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStreamWriter;
import java.io.StringWriter;
import java.io.Writer;
import java.util.Map;
import freemarker.cache.StringTemplateLoader;
import freemarker.template.Configuration;
import freemarker.template.DefaultObjectWrapper;
import freemarker.template.Template;
import freemarker.template.TemplateException;

public class TemplateParseUtil {
	/**
	 * 解析模板生成Excel
	 * @param templateDir  模板目录
	 * @param templateName 模板名称
	 * @param excelPath 生成的Excel文件路径
	 * @param data 数据参数
	 * @throws IOException
	 * @throws TemplateException
	 */
	public static void parse(String templateDir,String templateName,String excelPath,Map<String,Object> data) throws IOException, TemplateException {
		//初始化工作
		Configuration cfg = new Configuration();
		//设置默认编码格式为UTF-8
		cfg.setDefaultEncoding("UTF-8"); 
		//全局数字格式
		cfg.setNumberFormat("0.00");
		//设置模板文件位置
		cfg.setDirectoryForTemplateLoading(new File(templateDir));
		cfg.setObjectWrapper(new DefaultObjectWrapper());
		//加载模板
		Template template = cfg.getTemplate(templateName,"utf-8");
		OutputStreamWriter writer = null;
		try{
			//填充数据至Excel
			writer = new OutputStreamWriter(new FileOutputStream(excelPath),"UTF-8");
			template.process(data, writer);
			writer.flush();
		}finally{
			writer.close();
		}	
	}


	/**
	 * 解析模板返回字节数组
	 * @param templateDir  模板目录
	 * @param templateName 模板名称
	 * @param data 数据参数
	 * @throws IOException
	 * @throws TemplateException
	 */
	public static byte[] parse(String templateDir,String templateName,Map<String,Object> data) throws TemplateException, IOException{
		Configuration cfg = new Configuration();
		cfg.setDefaultEncoding("UTF-8");
		cfg.setNumberFormat("0.00");
		cfg.setDirectoryForTemplateLoading(new File(templateDir));
		cfg.setObjectWrapper(new DefaultObjectWrapper());
		Template template = cfg.getTemplate(templateName,"utf-8");
		ByteArrayOutputStream outStream = new ByteArrayOutputStream();
		Writer out = new OutputStreamWriter(outStream,"UTF-8");
		template.process(data, out);
		return outStream.toByteArray();
	}
	
	/**
	 * 自定义模板字符串解析
	 * @param templateStr  模板字符串
	 * @param data 数据  
	 * @return 解析后的字符串
	 * @throws IOException
	 * @throws TemplateException
	 */
	public static String parse(String templateStr, Map<String, Object> data)
			throws IOException, TemplateException {
		Configuration cfg = new Configuration();
		cfg.setNumberFormat("#.##");
		//设置装载模板
		StringTemplateLoader stringLoader = new StringTemplateLoader();	
		stringLoader.putTemplate("myTemplate", templateStr);	
		cfg.setTemplateLoader(stringLoader);
		//加载装载的模板
		Template temp = cfg.getTemplate("myTemplate", "utf-8");
		Writer out = new StringWriter();
		temp.process(data, out);
		return out.toString();
	}
}


2.xml生成

创建模板：

新建一个文件xml文件：

内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<xml>
    <userList>
        <#list userList as user>
            <user>
                <userName>${user.userName!}</userName>
                <passWord>${user.passWord!}</passWord>
                <realName>${user.realName!}</realName>
                <age>${user.age!}</age>
                <addr>${user.addr!}</addr>
            </user>
        </#list>
    </userList>
</xml>
然后再将文件后缀改为ft l格式

注：

        <#list userList as user>标签为循环遍历List集合（遍历userList,得到元素命名为user），其语法为<#list list as item>。

        这里我将 ${user.userName}等 改为了 ${user.userName!} ，在后面加了" ! "，这里是为了防止userName为null保错（这里是freemarker的验证机制，有点恶心)，解决办法就是：在后面加上 " ! " ，就可以防止字段为null报错这个问题了。

测试：

java

	/**
	 * 测试XML文件的生成
	 */
	@Test
	public void xmlTest(){
		List<User> userList = new ArrayList<User>(); 
		for(int i = 1 ; i <= 3;i ++){
			User user = new User();
			user.setUserName("狗娃" + i);
			user.setRealName("许文强");
			user.setPassWord("123456");
			user.setAddr("上海虎头帮总舵");
			user.setAge("28");
			userList.add(user);
		}
		//测试Excel文件生成
		Map<String,Object> data = new HashMap<String, Object>();
		data.put("userList", userList);
		try {
			TemplateParseUtil.parse("template", "xml.ftl", "tempFile/xmlTest.xml", data);
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} catch (TemplateException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
        }


结果：

生成了：

内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<xml>
	<userList>
			<user>
				<userName>狗娃1</userName>
				<passWord>123456</passWord>
				<realName>许文强</realName>
				<age>28</age>
				<addr>上海虎头帮总舵</addr>
			</user>
			<user>
				<userName>狗娃2</userName>
				<passWord>123456</passWord>
				<realName>许文强</realName>
				<age>28</age>
				<addr>上海虎头帮总舵</addr>
			</user>
			<user>
				<userName>狗娃3</userName>
				<passWord>123456</passWord>
				<realName>许文强</realName>
				<age>28</age>
				<addr>上海虎头帮总舵</addr>
			</user>
	</userList>
</xml>

3.html生成

创建模板：

新建一个文件html文件：

内容如下：

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
    <body>
        <table border='1' width="99%">
            <tr>
                <td colspan="5" align="center"><font color="red" size="6">user用户列表〃</font></td>
            </tr>
            <#list userList as user>
                <tr>
                    <td>${user.userName}</td>
                    <td>${user.passWord}</td>
                    <td>${user.realName}</td>
                    <td>${user.age}</td>
                    <td>${user.addr}</td>
                </tr>
            </#list>
        </table>
     </body>
</html>

然后再将文件后缀改为ftl格式


测试：

java

	/**
	 * 测试HTML文件的生成
	 */
	@Test
	public void htmlTest(){
		List<User> userList = new ArrayList<User>(); 
		for(int i = 1 ; i <= 3;i ++){
			User user = new User();
			user.setUserName("狗娃" + i);
			user.setRealName("许文强");
			user.setPassWord("123456");
			user.setAddr("上海虎头帮总舵");
			user.setAge("28");
			userList.add(user);
		}
		//测试Excel文件生成
		Map<String,Object> data = new HashMap<String, Object>();
		data.put("userList", userList);
		try {
			TemplateParseUtil.parse("template", "html.ftl", "tempFile/htmlTest.html", data);
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} catch (TemplateException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}

结果：

生成了：

内容如下：

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
	<body>
		<table border='1' width="99%">
			<tr> 
				<td colspan="5" align="center"><font color="red" size="6">user用户列表</font></td>
			</tr>
							<tr>
					<td>狗娃1</td>
					<td>123456</td>
					<td>许文强</td>
					<td>28</td>
					<td>上海虎头帮总舵</td>
				</tr>
				<tr>
					<td>狗娃2</td>
					<td>123456</td>
					<td>许文强</td>
					<td>28</td>
					<td>上海虎头帮总舵</td>
				</tr>
				<tr>
					<td>狗娃3</td>
					<td>123456</td>
					<td>许文强</td>
					<td>28</td>
					<td>上海虎头帮总舵</td>
				</tr>
		</table>
	 </body>
</html>

效果：


4.excel生成

创建模板：


新建excel




然后另存为xml格式



用EditPlus打开




将选中的改为：


注：这里一定要改，因为这里设置的是excel的行数，要动态的加载数据，则行数也要跟着改变（设置的行数必须>=实际的行数，不然生成的excel会打不开），${userList?size + 6}是得到userList的大小加上原来标题格式所占的6行，${list？size}可以得到list的大小。


接着继续




在<row>上添加<#list userList as user>循环遍历 userList 的标签



OK,然后再将文件后缀改为ftl格式


测试：

java


	/**
	 * 测试Excel文件的生成
	 */
	@Test
	public void excelTest(){
		List<User> userList = new ArrayList<User>(); 
		for(int i = 1 ; i < 10;i ++){
			User user = new User();
			user.setUserName("狗娃" + i);
			user.setRealName("许文强");
			user.setPassWord("123456");
			user.setAddr("上海虎头帮总舵");
			user.setAge("28");
			userList.add(user);
		}
		//测试Excel文件生成
		Map<String,Object> data = new HashMap<String, Object>();
		data.put("userList", userList);
		try {
			TemplateParseUtil.parse("template", "excel.ftl", "tempFile/excelTest.xls", data);
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} catch (TemplateException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
        }


结果：

生成了：


打开：




打开excel文件，会出现上面的弹框，这个问题一直不好解决，因为我们生成的是xml标记语言，只是将后缀改为xls显示而已，但实际上不是xls文件，希望有大神帮忙解决这个问题，如果有好的解决方案（不是修改注册表的掩耳盗铃的方式），期待留言！


内容如下：




5.word生成

创建模板：

新建word




然后另存为xml格式




用EditPlus打开



将选中的改为：




添加<#list list as item>标签，动态循环遍历数据（标签加在</w:p>标签后，</w:p>是换行）。


OK,然后再将文件后缀改为ftl格式


测试：

	/**
	 * 测试Word文件的生成
	 */
	@Test
	public void wordTest(){
		Map<String,Object> data = new HashMap<String,Object>();
		List<OptionQuestions> options = new ArrayList<OptionQuestions>();
		for(int i = 1;i <= 10; i++){
			OptionQuestions option = new OptionQuestions();
			option.setContent(i + "." + "“给力”这个词出自以下哪本名著？");
			option.setOption1("A." + "《不给力啊，老湿》");
			option.setOption2("B." + "《这货不是宿敌》");
			option.setOption3("C." + "《西游记：旅程的终点》");
			option.setOption4("D." + "《屌丝也有春天》");
			options.add(option);
		}
		List<String> judges = new ArrayList<String>();
		for(int i = 1;i <= 5; i++){
			judges.add(i + "." + "正方形、长方形、平行四边形和梯形都是特殊四边形");
		}
		data.put("title", "全国人大代表考试题");
		data.put("options", options);
		data.put("judges",judges);
		try {
			TemplateParseUtil.parse("template", "word.ftl", "tempFile/wordTest.doc", data);
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} catch (TemplateException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}


结果：

生成了：



内容如下：



6.下载地址

freemarker页面函数语法地址：http://blog.youkuaiyun.com/u010722643/article/details/41720517

工程 及 freemarker.jar 下载地址：http://download.youkuaiyun.com/detail/u010722643/8224995


java freemarker 动态生成excel文件
Swallow的博客
12-28 1275
怎么动态给excel填入数据呢
Freemarker实现excel导出功能
02-13
Freemarker实现excel导出功能，有例子
自写FreeMarker导出数据为EXcel实例
09-10
自己用servlet+freemarker写的，非常容易运行，代码解压之后，需要您自己修改下数据源配置并且建表就可以用
freemarker生成excel
qb170217的博客
07-22 1731
1.做个excel模板 2.把excel后缀改为xml 3.取消数据，把xml改为ftl,适当修改 4.用工具类生成excel package com.demo.util; import com.demo.controller.User; import freemarker.cache.StringTemplateLoader; import freemarker.template.Configuration; import freemarker.template.DefaultObject..
Spring Boot 最佳实践（三）模板引擎FreeMarker集成
最新发布
2501_92669908的博客
07-03 823
FreeMarker是一款免费的Java模板引擎，是一种基于模板和数据生成文本（HMLT、电子邮件、配置文件、源代码等）的工具，它不是面向最终用户的，而是一款程序员使用的组件。FreeMarker最初设计是用来在MVC模式的Web开发中生成HTML页面的，所以没有绑定Servlet或任意Web相关的东西上，所以它可以运行在非Web应用环境中。代码如下：体验AI代码助手代码解读复制代码n_has_next> 最后一项 </#if> </#list>1 2 3 最后一项。
【freemarker】动态生成Excel表单
weixin_35332034的博客
08-15 3108
根据freemarker 生成Excel报表
实用方便freemarker.jar freemarker架包 freemarker生成excel、word、html、xml例子
12-05
4. FreeMarker生成Word和Excel： 对于生成Word（.doc或.docx）和Excel（.xls或.xlsx）文档，FreeMarker不能直接操作，因为它们不是纯文本格式。通常，我们需要借助第三方库，如Apache POI，先将FreeMarker模板转换...
FreeMarker生成Word文档的简易教程实例
标题中的“freemarker生成word的一个简单例子”所涉及的知识点是关于如何使用FreeMarker模板引擎来生成Word文档。FreeMarker是一个模板引擎，也就是说，它是一个基于模板来生成文本输出的工具。它不是用来生成Word...
JSP技术实现表格数据自动生成Word文档教程
在这里，可能是指在JSP中使用FreeMarker生成Word文档的HTML结构，然后通过其他方法转换为Word格式。 ### Document 这里的“Document”可能是一个占位符，表示与Apache POI相关的类，比如`XWPFDocument`类，它是...
Freemarker 2.3.28导出数据实现及示例教程
本资源中包含的demo是一个实例演示，它展示了如何使用FreeMarker和Apache POI共同工作，将数据填充到预先设计好的Word模板中。开发者可以参考demo中的代码，了解模板的定义、数据模型的准备以及如何使用FreeMarker...
word文档生成工具
05-25
对于熟悉 Java 编程语言的开发者而言，可以通过 FreeMarker 结合 Office 提供的支持 XML 格式的特性来创建高度定制化的 Word 文档。这种方法的优势在于可以精确控制文档样式，并且最终输出的结果严格遵循 Microsoft ...
freemarker生成复杂excel，带换行
10-31
用freemarker 来导出Excel 会简单很多。并且可以导出各种复杂表格，本示例带单元格内换行功能，项目中亲测可以使用，欢迎大家下载使用！
freemarker生成xml示例
10-16
给初学者一个简单的利用freemarker生成xml文件的例子
Freemarker代码生成器实体映射xml的ftl模板文件
07-03
基于Freemarker模板的代码生成器实体映射xml的ftl模板文件
Freemarker中遍历list集合实例
10-24
Freemarker中遍历list集合实例
使用freemarker生成xml模板
weixin_30361753的博客
05-30 1177
今天在java交流群里有个人问我如何用freemarker生成xml模板文件，可以手动配置参数，于是我到网上百度了一下。发现有一位同行的博文写的很nice，于是我就照着他的代码敲了一遍，最后实现了，本想贴出他的uri的，但是找不到了。网上这样的例子很多，大家可以自己到网上看看，我的建议是一个问题多看几个解决方案，这样才能找到正确的或者是最优解。 其实要实现的功...
Java利用freemarker生成xml
tbb414的专栏
09-15 1754
准备 1.准备依赖包 <dependency> <groupId>org.freemarker</groupId> <artifactId>freemarker</artifactId> <version>2.3.30</version> </dependency> 2. freemarker模板 <?
生成xml_freemarker快速生成xml文件
weixin_39753213的博客
01-13 506
记录一次用freeMarker生成xml文件importfreemarker.template.Configuration;importfreemarker.template.Template;/**uiName 要生成xml文件的名称*xmlName 模板ftl的名称*/publicstaticvoidcreateXml(StringuiName,StringxmlNam...
FreeMarker入门 生成xml模板
KKK哥
12-01 7374
第一次写这个，只是按着自己想的来写，没有什么思路。。。。 https://blog.youkuaiyun.com/kangcool_sn/article/details/85096386   先建一个Person对象，也可以不用，只是为了封装数据好处理   public class Person { private String name; private String age;...
评论 11
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值