springboot整合Freemark模板(详尽版)

2024-07-10 21:39| 来源: 网络整理| 查看: 265

本篇是SpringBoot项目实战（3）：整合Freemark模板一文的修订版，本文使用示例详细介绍、演示了freemarker常用的语法，以及如何通过freemarker生成纯静态的html。

本文知识点：

springboot如何集成freemarker模板引擎详细版：常用的freemarker语法特别篇：如何在springboot中通过freemarker生成静态html（纯静态化）

想了解freemarker？没有比这篇文章更详细的了

springboot如何集成freemarker模板引擎添加依赖 org.springframework.boot spring-boot-starter-web org.springframework.boot spring-boot-starter-freemarker 配置属性文件 # 是否允许HttpServletRequest属性覆盖(隐藏)控制器生成的同名模型属性。 spring.freemarker.allow-request-override=false # 是否允许HttpSession属性覆盖(隐藏)控制器生成的同名模型属性。 spring.freemarker.allow-session-override=false # 是否启用模板缓存。 spring.freemarker.cache=false # 模板编码。 spring.freemarker.charset=UTF-8 # 是否检查模板位置是否存在。 spring.freemarker.check-template-location=true # Content-Type value. spring.freemarker.content-type=text/html # 是否启用freemarker spring.freemarker.enabled=true # 设定所有request的属性在merge到模板的时候，是否要都添加到model中. spring.freemarker.expose-request-attributes=false # 是否在merge模板的时候，将HttpSession属性都添加到model中 spring.freemarker.expose-session-attributes=false # 设定是否以springMacroRequestContext的形式暴露RequestContext给Spring’s macro library使用 spring.freemarker.expose-spring-macro-helpers=true # 是否优先从文件系统加载template，以支持热加载，默认为true spring.freemarker.prefer-file-system-access=true # 设定模板的后缀. spring.freemarker.suffix=.ftl # 设定模板的加载路径，多个以逗号分隔，默认: spring.freemarker.template-loader-path=classpath:/templates/ # 设定FreeMarker keys. spring.freemarker.settings.template_update_delay=0 spring.freemarker.settings.default_encoding=UTF-8 spring.freemarker.settings.classic_compatible=true 编写Controller @Controller public class FreemarkController { @RequestMapping("/") public String index(Model model) { return "index"; } } 页面 SpringBoot + Freemarker Hello boy,

当前时间：${.now?string("yyyy-MM-dd HH:mm:ss.sss")}

常用的freemarker语法

下面详细介绍在ftl模板中如何使用列表、map、字符串、数字、日期、switch以及macro宏指令等语法。

修改下controller，传递一些需要处理的参数

@RequestMapping("/") public String index(Model model) { Map map = new LinkedHashMap(); for (int i = 0; i < 5; i++) { map.put("key" + i, "value" + i); } model.addAttribute("list", Arrays.asList("string1", "string2", "string3", "string4", "string5", "string6")); model.addAttribute("map", map); model.addAttribute("name", " htTps://wWw.zHyD.mE "); model.addAttribute("htmlText", "html内容"); model.addAttribute("num", 123.012); model.addAttribute("null", null); model.addAttribute("dateObj", new Date()); model.addAttribute("bol", true); return "index"; }

重写index.ftl

Freemarker 语法大全 html { font-size: 14px; font-weight: 400; } .exp { font-size: 12px; color: lightgray; }

当前时间：${.now?string("yyyy-MM-dd HH:mm:ss.sss")}

list长度：${list?size} 列表 ${item }, 索引：${item_index }，hasNext：${item_has_next} 数字遍历数字${item} map ${map[key]}, 索引：${key_index }，hasNext：${key_has_next} 字符串普通字符串：${name} 非html编码：${htmlText} html编码：${htmlText?html} 首字母大写：${name?cap_first} 首字母小写：${name?uncap_first} 全小写：${name?lower_case} 全大写：${name?upper_case} 去除首位空格：${name?trim} 空字符串：${null?if_exists} 是否包含某个字符串：${name?contains("wWw")?string} 默认值：${null?default("空值默认")} “${name}”字符串长度：${name?length} 定义字符串：str=码一码字符串拼接(1)：${"字符串拼接 + " + str} 字符串拼接(2)：${"字符串拼接 + ${str}"} 字符串截取单个字符(1)：${str[1]} 字符串截取(2)：${str?substring(1)} 字符串截取(3)：${str?substring(1,2)} indexOf：${str?index_of("一")} split分割字符串： ${item} if...elseif...else：匹配if显示匹配elseif显示匹配else显示 switch 匹配“你好” 匹配“码一码” 默认匹配数字普通数字：${num} 数字类型：${num?string.number} 货币类型：${num?string.currency} 百分比类型：${num?string.percent} 格式化数字：${num?string("#.###")} 取数字的整数部分：${num?int} 运算符不等于：!= 例如：${(1 != 2)?string('1 != 2', '1 == 2')} 等于：== 例如：${(1 == 1)?string('1 == 1', '1 != 1')} 大于(1)：> 例如：${(2 > 1)?string('2 > 1', '2 < 1')}。注：使用> 时必须加括号，否则可能会被当成普通的标签闭合符号而引起报错大于(2)：gt 例如：${(2 gt 1)?string('2 gt 1', '2 lte 1')} 大于等于：gte 例如：${(2 gte 2)?string('2 gte 2', '2 lt 2')} 小于(1)：< 例如：${(1 < 2)?string('1 < 2', '1 > 2')}。注：使用< 时必须加括号，否则可能会被当成普通的标签闭合符号而引起报错小于(2)：lt 例如：${(1 lt 2)?string('1 lt 2', '1 gte 2')} 小于等于：lte 例如：${(2 lte 2)?string('2 lte 2', '2 gt 2')} boolean 普通boolean输出：${bol} boolean判断输出：${bol?string('true的时候显示','false的时候显示')} 日期 ${dateObj?date} ${dateObj?time} ${dateObj?string("yyyy-MM-dd HH:mm:ss.SSS")} import

${importObj.importStr}

${importObj.importStr1}

macro宏模板

${title?cap_first}: ${item?cap_first} nested标签表示可以插入自定义的内容 include

freemarker语法大全

通过freemarker生成静态html

首先需要编写一个可以在普通类中获取到springbean的工具类SpringContextHolder

@Component public class SpringContextHolder implements ApplicationContextAware { private static ApplicationContext appContext = null; /** * 通过name获取 Bean. * * @param name * @return */ public static Object getBean(String name) { return appContext.getBean(name); } /** * 通过class获取Bean. * * @param clazz * @param * @return */ public static T getBean(Class clazz) { return appContext.getBean(clazz); } /** * 通过name,以及Clazz返回指定的Bean * * @param name * @param clazz * @param * @return */ public static T getBean(String name, Class clazz) { return appContext.getBean(name, clazz); } @Override public void setApplicationContext(ApplicationContext applicationContext) throws BeansException { if (appContext == null) { appContext = applicationContext; } } }

然后编写一个生成静态html文件的工具类FreemarkerUtil

public class FreemarkerUtil { public static String parseTpl(String viewName, Map params) { Configuration cfg = SpringContextHolder.getBean(Configuration.class); String html = null; Template t = null; try { t = cfg.getTemplate(viewName + ".ftl"); html = FreeMarkerTemplateUtils.processTemplateIntoString(t, params); } catch (IOException | TemplateException e) { e.printStackTrace(); } return html; } }

为了方便查看，添加一个mapping

@RequestMapping("/createHtml") @ResponseBody public String createHtml(Model model){ Map map = new LinkedHashMap(); for (int i = 0; i < 5; i++) { map.put("key" + i, "value" + i); } model.addAttribute("list", Arrays.asList("string1", "string2", "string3", "string4", "string5", "string6")); model.addAttribute("map", map); model.addAttribute("name", " htTps://wWw.zHyD.mE "); model.addAttribute("htmlText", "html内容"); model.addAttribute("num", 123.012); model.addAttribute("null", null); model.addAttribute("dateObj", new Date()); model.addAttribute("bol", true); return FreemarkerUtil.parseTpl("index", model.asMap()); }

ok，访问/createHtml

freemarker

到此为止，本篇已详细介绍了freemarker的使用方法。

源码： https://github.com/zhangyd-c/springboot-learning https://gitee.com/yadong.zhang/springboot

【本文地址】

公司简介

联系我们