Java使用freemarker生成word文件

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

要利用freemarker生成word文档,首先需要创建word文档模板(即.doc文档),word模板中要动态生成的文字都使用占位符${string}代替,如下图
Java使用freemarker生成word文件_第1张图片

将word模板另存为xml文件
在这里插入图片描述
然后将文件的后缀.xml改为.ftl。
将这个模板(.ftl)文件放到我们项目的resource目录下,这里我是新建了一个wordtemp文件夹,用于放word模板。顺便放两张图片在这个wordtemp目录下。
Java使用freemarker生成word文件_第2张图片
打开这个模板文件。这里有一个坑,在word另存为xml文件的时候很可能会把我们写好的占位符拆分掉,就像下面这样
Java使用freemarker生成word文件_第3张图片
我们需要自己手动把占位符${string}恢复,只需把中间多余的标签删除掉就好
Java使用freemarker生成word文件_第4张图片
然后我们找到<标签,会发现这个标签中有一大堆的英文字符串
Java使用freemarker生成word文件_第5张图片
这些字符串是图片的base64码。
我们将这些base64码删除掉,用一个占位符替代
Java使用freemarker生成word文件_第6张图片
为了实现动态的添加表格行数和图片数量,我们还要用到freemarker的标签。
list标签的语法:<#list 集合名 as 迭代元素临时变量名>

标签表示word中的表格的一行记录,我们找到标签,并用freemarker的标签将其包起来。
Java使用freemarker生成word文件_第7张图片
在这里插入图片描述
Java使用freemarker生成word文件_第8张图片
找到离我们的图片占位符最近的标签,用list标签将他们括起来
在这里插入图片描述
Java使用freemarker生成word文件_第9张图片

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

<dependency>
            <groupId>org.freemarkergroupId>
            <artifactId>freemarkerartifactId>
            <version>2.3.28version>
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);
        }
    }

}

启动项目,用浏览器测试一下,成功下载了word
Java使用freemarker生成word文件_第10张图片
Java使用freemarker生成word文件_第11张图片
总结一下用freemarker生成word的几个步骤:

  1. 创建word,在word中设计排版,要动态生成的文字使用占位符${string}
  2. 将word另存为xml文件。将保存好的xml文件后缀修改为.ftl
  3. 将模板文件(.ftl)放到项目中,打开文件看看占位符是否被拆分了。
  4. 编写Java代码,给占位符赋值。

PS,由于freemarker每次生成word都要从磁盘中读取.ftl文件,相比于其他纯内存生成word的工具包,freemarker多了一次IO操作,所以性能稍弱,不适用于大并发的场景。

你可能感兴趣的:(工具类库使用心得)