Java使用freemarker生成word文件

最新推荐文章于 2025-09-15 15:56:01 发布

原创最新推荐文章于 2025-09-15 15:56:01 发布 · 5.1k 阅读

21 ·

CC 4.0 BY-SA版权

文章标签：

#Java导出word #freemarker

工具类库使用心得专栏收录该内容

5 篇文章

订阅专栏

本文介绍如何使用Freemarker生成Word文档，包括创建模板、动态填充数据、处理图片及表格，适合web项目直接响应Word文件。

该文章已生成可运行项目，

首先声明我的项目是一个web项目，生成的word文件直接通过response响应发送给前端。如果不是web项目的话可以像网上的其他教程一样将生成的word保存在本地。

要利用freemarker生成word文档，首先需要创建word文档模板（即.doc文档），word模板中要动态生成的文字都使用占位符${string}代替，如下图
在这里插入图片描述

将word模板另存为xml文件
在这里插入图片描述
然后将文件的后缀.xml改为.ftl。
将这个模板(.ftl)文件放到我们项目的resource目录下，这里我是新建了一个wordtemp文件夹，用于放word模板。顺便放两张图片在这个wordtemp目录下。

打开这个模板文件。这里有一个坑，在word另存为xml文件的时候很可能会把我们写好的占位符拆分掉，就像下面这样
在这里插入图片描述
我们需要自己手动把占位符${string}恢复，只需把中间多余的标签删除掉就好

然后我们找到<<w:binData>标签，会发现这个标签中有一大堆的英文字符串

这些字符串是图片的base64码。
我们将这些base64码删除掉，用一个占位符替代
在这里插入图片描述
为了实现动态的添加表格行数和图片数量，我们还要用到freemarker的<list>标签。
list标签的语法:<#list 集合名 as 迭代元素临时变量名></#list>

<w:tr></w:tr>标签表示word中的表格的一行记录，我们找到<w:tr></w:tr>标签，并用freemarker的<list>标签将其包起来。
在这里插入图片描述

找到离我们的图片占位符最近的<w:p></w:p>标签,用list标签将他们括起来

模板文件修改完了，接下来我们开始在代码里为这些占位符填充数据。
引入freemarker依赖：

<dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.28</version>
</dependency>

创建一个单例的Configuration对象，真心不推荐像网上的很多教程一样，每次生成word都要重新创建一个Configuration

@org.springframework.context.annotation.Configuration
public class WordConf {
    /**
     * 将freemarker的Configuration对象作为一个单例对象，可以避免重复创建的性能开销
     * 这里我是将Configuration对象作为bean交给spring容器来管理，如果不是spring项目的话可以自己写一个单例模式
     * 从Configuration类上的注释可以找到说明：Configuration是有状态的，线程不安全的，但是它的各种get方法是线程安全的
     * 所以一旦这个单例对象被配置好以后就不该再调用它的set方法
     * @return
     */
    @Bean
    public Configuration wordConfiguration(){
        Configuration result = new Configuration(DEFAULT_INCOMPATIBLE_IMPROVEMENTS);
        result.setDefaultEncoding("utf-8");
        //设置模板加载器
        result.setClassForTemplateLoading(this.getClass(), "/wordtemp");
        return result;
    }
}

书本实体类代码：

@Data
@AllArgsConstructor
public class Book {
    private String name;
    private Double price;
    private Date createTime;
}

controller层代码

@Controller
@Slf4j
public class WordController {
    @Resource(name = "wordConfiguration")
    private Configuration wordConfiguration;

    /**
     * 导出word
     * @param response
     */
    @GetMapping("/getBookWord")
    public void getBookWord(HttpServletResponse response) {
        //书本集合
        List<Book> books = new ArrayList<>();
        books.add(new Book("笑傲江湖", 20.5, new Date()));
        books.add(new Book("倚天屠龙记", 30.8, new Date()));
        try {
            //图片的base64集合
            List<String> bookImages = new ArrayList<>();
            String image1 = encodeBase64File("wordtemp/timg.jpg");
            String image2 = encodeBase64File("wordtemp/timg_2.jpg");
            bookImages.add(image1);
            bookImages.add(image2);
            Map<String, Object> dataModel = new HashMap<>();
            dataModel.put("shopName", "陈大大出版社");
            dataModel.put("books", books);
            dataModel.put("bookImages", bookImages);
            response.setCharacterEncoding("UTF-8");
            response.setHeader("Content-Disposition", "attachment; filename=books.doc");
            //加载模板
            Template template = wordConfiguration.getTemplate("booksTemp.ftl", "utf-8");
            template.process(dataModel, response.getWriter());//response的Writer不需要我们手动关，tomcat会帮我们关的
        } catch (Exception e) {
            log.error("导出word异常：",  e);
        }
    }

    /**
     * 将文件转为base64字符串
     * @param path 文件地址
     * @return
     * @throws IOException
     */
    public String encodeBase64File(String path) throws IOException {
        //读取resource目录下的文件
        try (InputStream inputStream = WordController.class.getClassLoader().getResourceAsStream(path)){
            byte[] buffer = new byte[inputStream.available()];
            inputStream.read(buffer);
            return new BASE64Encoder().encode(buffer);
        }
    }

}