使用Freemarker生成Word

作者:袖梨 2026-09-01

使用Freemarker生成Word需要先看清适用场景和关键步骤,避免只记结论却忽略实际限制。

场景:

需要通过模板动态生成word,模板中包括普通字符串和表格

实现方法:

需要:Freemarker 下载

1、将word模板另存为xml格式,将需要替换的地方使用标签和指令替换,具体参照Freemarker开发手册

使用Freemarker生成Word

(1)普通字符串替换为${stringdemo}

(2)表格替换

<#list rows as row>

......

<#list row as item>

....${item}..

</#list>

......

</#list>

2、将修改后的xml模板文件后缀名改为.ftl

3、实例程序

import java.io.BufferedWriter;

import java.io.File;

import java.io.FileOutputStream;

import java.io.OutputStreamWriter;

import java.io.Writer;

import java.util.ArrayList;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import freemarker.template.Configuration;

import freemarker.template.DefaultObjectWrapper;

import freemarker.template.Template;

public class DemoFreemarker {

public static void main(String[] args) {

creatWord();

}

@SuppressWarnings("unchecked")

public static void creatWord() {

try {

//创建配置实例

Configuration cfg = new Configuration();

cfg.setDefaultEncoding("utf-8");

cfg.setDirectoryForTemplateLoading(new File("C://wtt"));

cfg.setObjectWrapper(new DefaultObjectWrapper());

//获取模板

Template temp = cfg.getTemplate("demo.ftl");

temp.setEncoding("utf-8");

//创建数据模型

Map root = new HashMap();

root.put("stringdemo", "字符串测试");

List rows = new ArrayList();

for (int j=1; j<5; j++) {

List row = new ArrayList();

for (int i=1; i<16; i++) {

row.add(j+""+i);

}

rows.add(row);

}

root.put("rows", rows);

//将模板和数据模型合并生成文件

File docFile = new File("C://wtt/demo.doc");

Writer docout = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(docFile)));

temp.process(root, docout);

} catch (Exception e) {

e.printStackTrace();

}

}

}

注:

1、支持word版本为2003及更高版本

2、此种方法优点是跨平台,并且不依赖MS office word

3、如果生成的文件不能打开,用文本编辑器打开生成的word

(1)如果开始为 ?<?xml version="1.0" ,即开头多出个问号,因为ftl模板文件格式有问题,需要将格式设置为“UTF-8无BOM”格式,可使用Notepad++文本编辑器设置

(2)如果生成的word格式为ANSI,则将ftl模板第一行声明编码改为gbk,如:<?xml version="1.0" encoding="gbk" standalone="yes"?>

相关文章

精彩推荐