《SpringBoot篇》24.SpringBoot整合Freemarker
👨💻本文简述:本文讲一下SpringBoot整合Freemarker的整合教程超详细教程。
👨💻上一篇文章: 《SpringBoot篇》23.SpringBoot整合JavaMail实现发送邮件详解
👨💻有任何问题,都可以私聊我,我能帮得上的一定帮忙,感谢大佬们支持。
🦹如果喜欢可以投个票吗?在文章最后,感谢感谢!
一、Freemarker简介
说明:FreeMarker 是一款 免费的模板引擎: 即一种基于模板和要改变的数据, 并用来生成输出文本(HTML网页,电子邮件,配置文件,源代码等)的通用工具。 它不是面向最终用户的,而是一个Java类库,是一款程序员可以嵌入他们所开发产品的组件。(我所接触到的是用Freemarker来导出excel、word、pdf)
模板编写为FreeMarker Template Language (FTL)。它是简单的,专用的语言. 那就意味着要准备数据在真实编程语言中来显示,比如数据库查询和业务运算, 之后模板显示已经准备好的数据。在模板中,你可以专注于如何展现数据, 而在模板之外可以专注于要展示什么数据。
二、Freemarker语法:
说明:这里给大家展示一些常用的语法,这些就足以完成复杂的语法功能。
(1)if elseif,条件判断语句
说明:你可以使用 if, elseif 和 else 指令来条件判断是否越过模板的一个部分。 condition 必须计算成布尔值, 否则错误将会中止模板处理。elseif 和 else 必须出现在 if 内部 (也就是,在 if 的开始标签和结束标签之间)。 if 中可以包含任意数量的 elseif(包括0个) 而且结束时 else 是可选的。比如:
只有 if 没有 elseif 和 else:
x is 1
只有 if 没有 elseif 但是有 else:
x is 1 x is not 1
有 if 和两个 elseif 但是没有 else:
x is 1 x is 2 x is 3
有 if 和三个 elseif 还有 else:
x is 1 x is 2 x is 3 x is 4 x is not 1 nor 2 nor 3 nor 4
(2)list 遍历
说明:list 指令执行在 list 开始标签和 list 结束标签 ( list 中间的部分) 之间的代码, 对于在序列(或集合)中每个值指定为它的第一个参数。 对于每次迭代,循环变量(本例中的 user)将会存储当前项的值。
循环变量(user) 仅仅存在于 list 标签体内。 而且从循环中调用的宏/函数不会看到它(就像它只是局部变量一样)。
假设 users 包含 ['Joe', 'Kate', 'Fred'] 序列:
${user}
输出:
Joe
Kate
Fred
(3)assign 在模板中定义变量
说明:在模板中可以定义三种类型的变量:(我们最多就能使用到简单的使用assign就可以了)
-
'‘简单’'变量: 它能从模板中的任何位置来访问,或者从使用 include 指令引入的模板访问。可以使用 assign 指令来创建或替换这些变量。因为宏和方法只是变量,那么 macro 指令 和 function 指令 也可以用来设置变量,就像 assign 那样。
-
局部变量:它们只能被设置在 宏定义体内, 而且只在宏内可见。一个局部变量的生命周期只是宏的调用过程。可以使用 local指令 在宏定义体内创建或替换局部变量。
-
循环变量:循环变量是由如 list 指令自动创建的,而且它们只在指令的开始和结束标记内有效。宏 的参数是局部变量而不是循环变量。
-
全局变量:这是一个高级话题了, 并且这种变量最好别用。即便它们属于不同的命名空间, 全局变量也被所有模板共享,因为它们是被 import进来的, 不同于 include 进来的。那么它们的可见度就像数据模型那样。 全局变量通过 global指令来定义。
${x} ${x}
输出:
1 4
(4)字符串切分 (子串)
说明:前面的是对字符串进行分割,后面的在进行遍历的时候需要进行字符串分割。
-
降序域不允许进行字符串切分。 (因为不像序列那样,很少情况下会想反转字符串。 如果真要这样做了,那就是疏忽。)
-
如果变量的值既是字符串又是序列(多类型值), 那么切分将会对序列进行,而不是字符串。当处理XML时, 这样的值就是普通的了。此时,可以使用 someXMLnode?string[range]。
-
一个遗留的bug:值域 包含 结尾时, 结尾小于开始索引并且是是非负的(就像在 “abc”[1…0] 中), 会返回空字符串而不是错误。(在降序域中这应该是个错误。) 现在这个bug已经向后兼容,但是不应该使用它,否在就会埋下一个错误。
${s[2..3]} ${s[2.. private Integer id; private String name; } //生成数据方法 public List /** * 解析模板生成Excel * @param templateDir 模板目录 * @param templateName 模板名称 * @param excelPath 生成的Excel文件路径 * @param data 数据参数 */ public void parse(String templateDir,String templateName,String excelPath,Map //初始化工作 1.12日更改注意这里最新版需要加上版本号,如果不知道版本号就这样写,如果知道就直接写Configuration.VERSION_2_3_20对应版本即可 (感谢阿浩吖兄弟纠正) Configuration cfg = new Configuration(Configuration.DEFAULT_INCOMPATIBLE_IMPROVEMENTS); //设置默认编码格式为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(); } } // 生成数据方式 public List ArrayList Student fillData = new Student(); fillData.setId(i); fillData.setName("0123456789="+ i); fillDatas.add(fillData); } return fillDatas; } } @Autowired private StudentService studentService; @Test public void excelTest(){ List //这里前面是模板位置,后面是生成的excel位置 studentService.parse("D:\study\projecct\freemarker\src\main\resources\templates\", "Freemark.xml", "E:\excel\excelTest30.xls", data); } catch (IOException e) { e.printStackTrace(); } catch (TemplateException e) { e.printStackTrace(); } } }
-
还没有评论,来说两句吧...