Java-Freemarker替换模板文件.ftl中的变量,生成Word文档

Java工具 专栏收录该内容
9 篇文章 0 订阅

一、前言

前有java-poi替换模板文件word文档中的变量,生成Word文档,后有Java-Freemarker替换模板文件.ftl中的变量,生成Word文档。

Freemarker是如今最流行的文档处理组件,poi已经相对过时了。

FreeMarker 是一款 模板引擎: 即一种基于模板和要改变的数据,简单点就是替换模板中的变量, 并用来生成输出文本(HTML网页,电子邮件,配置文件,源代码等)的通用工具。 它不是面向最终用户的,而是一个Java类库,是一款程序员可以嵌入他们所开发产品的组件。

相关jar包、以及maven配置、或者gradle配置等等都可以去这个网站找到:mvn仓库

 

二、使用

1、根据需求创建word文档,下图是我想要的word,但是一些值是用了${变量名} 来代替。

 

2、把word另存为xml,不要直接修改尾缀,用word的另存为:

选择xml格式:

保存成xml之后,直接修改模板文件尾缀,把 xml 修改为 ftl 。然后便是检查变量名是否被word的一些标签隔离开了,如果${变量名}不是完整的,就要把那些多余的标签的删掉,并不会影响最后文档显示的格式,不然会报找不到对应的变量exception,如下图:

3、模板已经制作完毕,我把模板放在了  C:\image\freemarker.ftl   路径。然后便是java部分了:

package demo.freemarker_demo;

import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.Version;

import java.io.*;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;

/**
 * @author xch
 * @description freemarker工具
 * @date 2019-10-14
 */
public class FreemarkerDemo {

    public static void test(String path){
        Map<String,Object> dataMap = new HashMap<>();
        try {
            dataMap.put("name", "张三");
            dataMap.put("idnumber", "411322199308302019");
            dataMap.put("result1", "□");
            dataMap.put("result2", (char)8730);// (char)8730 对号
            dataMap.put("result3", "□");
            dataMap.put("result4", "□");
            dataMap.put("result5", "□");
            dataMap.put("date", new SimpleDateFormat("yyyy年MM月dd日").format(new Date()));
            dataMap.put("ipAddress", "110.0.0.1");
            dataMap.put("confirmedBy", "xch");
            dataMap.put("ipAddress", "110.0.0.1");
            dataMap.put("datetime", new SimpleDateFormat("yyyy年MM月dd日 HH:mm:ss").format(new Date()));

            Configuration configuration = new Configuration(new Version("2.3.0"));
            configuration.setDefaultEncoding("utf-8");

            //.ftl配置文件所在路径
            //第一种使用相对一个java文件的相对路径
//          configuration.setClassForTemplateLoading(new FreemarkerDemo().getClass(), "/doc/");

            //第二种使用绝对路径
            configuration.setDirectoryForTemplateLoading(new File("c:/image/"));

            //第三种使用web项目的ServletContext路径
//          configuration.setServletContextForTemplateLoading(null, "/doc/");

            //以utf-8的编码读取ftl模板文件
            Template template = configuration.getTemplate("freemarker.ftl", "utf-8");

            //输出文档路径及名称
            File outFile = new File(path);
            Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile), 
                    "utf-8"), 10240);
            template.process(dataMap, out);
            out.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        String path = "C:\\image\\doc\\"+System.currentTimeMillis()+".doc";
        test(path);

    }
}

是不是很简单,关键代码只有两处,找到模板.ftl,然后用模板template的方法process(),把入参map和输出文件解析出来。map的key就是模板中的${变量值},匹配之后便是替换,然后便是生成最终的文档:

三、后语

很简单的使用,这篇文章之所以写出来,是因为我的那一篇Java-POI替换Word模板文档中的变量,生成Word文档写的不甚明了,而且2019年了,还有很多在使用java-poi的,我没有否认poi的意思,我当年也是使用的它,完成我的第一个word模板的功能。

我只是想让更多的同行(xing)者,认识新的技术,新的技术可能更简单、更易用、更节省我们的time,省出的时间可以去捕获妹子啊什么的动物,毕竟妹子对于程序员来说,是数码宝贝一般的稀有动物。哈哈,不侃了。

注意三点,我使用时遇到的注意点:

1:上面的红字,在由word转到ftl的过程中,一定要核对${变量名} 是否被一些标签拆分开了,那么便会报解析异常:

freemarker.core.ParseException: Syntax error in template "freemarker.ftl"

2:我如果最终导出的word文件尾缀.doc,改为.docx,程序无异常,但是最终的文件就是报:无法打开......:

3:(char)8730 是java中的对勾/对号,别看这个对号,我再网上找了好久。

4:-----------------------------------------------------------------------------------------不关注我“象话”吗?(哈哈,逗比)

 

适应手机端的文件模板生成,我后续会补上......

  • 0
    点赞
  • 6
    评论
  • 9
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

©️2021 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值