springboot整合Freemark模板(详尽版)

2024-06-01 05:38
文章标签 java 模板 springboot spring 整合 详尽 freemark

本文主要是介绍springboot整合Freemark模板(详尽版)，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

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

本文知识点：

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

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

springboot如何集成freemarker模板引擎

添加依赖

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

配置属性文件

# 是否允许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";}
}

页面

<!DOCTYPE html> 
<html lang="en"> 
<head> <title>SpringBoot + Freemarker</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> <h1>Hello boy,</h1><br><p>当前时间：${.now?string("yyyy-MM-dd HH:mm:ss.sss")}</p>
</body> 
</html>

常用的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", "<span style=\"color: red;font-size: 16px;\">html内容</span>");model.addAttribute("num", 123.012);model.addAttribute("null", null);model.addAttribute("dateObj", new Date());model.addAttribute("bol", true);return "index";
}

重写index.ftl

<!DOCTYPE html> 
<html lang="en">
<head><title>Freemarker 语法大全</title><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><style>html {font-size: 14px;font-weight: 400;}.exp {font-size: 12px;color: lightgray;}</style>
</head>
<body>
<p>当前时间：${.now?string("yyyy-MM-dd HH:mm:ss.sss")}</p>
<dl><dt>list长度：<span class="exp">${list?size}</span></dt><dt>列表</dt><#list list as item><dd>${item }, 索引：${item_index }，hasNext：${item_has_next}</dd></#list><dt>数字遍历</dt><#list 1..3 as item><dd>数字${item}</dd></#list><dt>map</dt><#list map?keys as key><dd>${map[key]}, 索引：${key_index }，hasNext：${key_has_next}</dd></#list>
</dl>
<dl><dt>字符串</dt><dd>普通字符串：<span class="exp">${name}</span></dd><dd>非html编码：<span class="exp">${htmlText}</span></dd><dd>html编码：<span class="exp">${htmlText?html}</span></dd><dd>首字母大写：<span class="exp">${name?cap_first}</span></dd><dd>首字母小写：<span class="exp">${name?uncap_first}</span></dd><dd>全小写：<span class="exp">${name?lower_case}</span></dd><dd>全大写：<span class="exp">${name?upper_case}</span></dd><dd>去除首位空格：<span class="exp">${name?trim}</span></dd><dd>空字符串：<span class="exp">${null?if_exists}</span></dd><dd>是否包含某个字符串：<span class="exp">${name?contains("wWw")?string}</span></dd><dd>默认值：<span class="exp">${null?default("空值默认")}</span></dd><dd>“${name}”字符串长度：<span class="exp">${name?length}</span></dd><dd>定义字符串：<span class="exp">str=码一码<#assign str="码一码"/></span></dd><dd>字符串拼接(1)：<span class="exp">${"字符串拼接 + " + str}</span></dd><dd>字符串拼接(2)：<span class="exp">${"字符串拼接 + ${str}"}</span></dd><dd>字符串截取单个字符(1)：<span class="exp">${str[1]}</span></dd><dd>字符串截取(2)：<span class="exp">${str?substring(1)}</span></dd><dd>字符串截取(3)：<span class="exp">${str?substring(1,2)}</span></dd><dd>indexOf：<span class="exp">${str?index_of("一")}</span></dd><dd>split分割字符串：<span class="exp"><#list "a|b|c"?split("|") as item>${item}</#list></span></dd><dd>if...elseif...else：<span class="exp"><#if null == ''>匹配if显示<#elseif null == '1'>匹配elseif显示<#else>匹配else显示</#if></span></dd>
</dl><dl><dt>switch</dt><dd><#switch str><#case "你好">匹配“你好”<#break ><#case "码一码">匹配“码一码”<#break ><#default>默认匹配</#switch></dd>
</dl><dl><dt>数字</dt><dd>普通数字：<span class="exp">${num}</span></dd><dd>数字类型：<span class="exp">${num?string.number}</span></dd><dd>货币类型：<span class="exp">${num?string.currency}</span></dd><dd>百分比类型：<span class="exp">${num?string.percent}</span></dd><dd>格式化数字：<span class="exp">${num?string("#.###")}</span></dd><dd>取数字的整数部分：<span class="exp">${num?int}</span></dd>
</dl><dl><dt>运算符</dt><dd>不等于：!= <span class="exp">例如：${(1 != 2)?string('1 != 2', '1 == 2')}</span></dd><dd>等于：== <span class="exp">例如：${(1 == 1)?string('1 == 1', '1 != 1')}</span></dd><dd>大于(1)：> <spanclass="exp">例如：${(2 > 1)?string('2 > 1', '2 < 1')}。<strong>注：使用> 时必须加括号，否则可能会被当成普通的标签闭合符号而引起报错</strong></span></dd><dd>大于(2)：gt <span class="exp">例如：${(2 gt 1)?string('2 gt 1', '2 lte 1')}</span></dd><dd>大于等于：gte <span class="exp">例如：${(2 gte 2)?string('2 gte 2', '2 lt 2')}</span></dd><dd>小于(1)：< <spanclass="exp">例如：${(1 < 2)?string('1 < 2', '1 > 2')}。<strong>注：使用< 时必须加括号，否则可能会被当成普通的标签闭合符号而引起报错</strong></span></dd><dd>小于(2)：lt <span class="exp">例如：${(1 lt 2)?string('1 lt 2', '1 gte 2')}</span></dd><dd>小于等于：lte <span class="exp">例如：${(2 lte 2)?string('2 lte 2', '2 gt 2')}</span></dd>
</dl><dl><dt>boolean</dt><dd>普通boolean输出：<span class="exp">${bol}</span></dd><dd>boolean判断输出：<span class="exp">${bol?string('true的时候显示','false的时候显示')}</span></dd>
</dl><dl><dt>日期</dt><dd>${dateObj?date}</dd><dd>${dateObj?time}</dd><dd>${dateObj?string("yyyy-MM-dd HH:mm:ss.SSS")}</dd>
</dl><dl><dt>import</dt><dd><#import "import.ftl" as importObj><p>${importObj.importStr}</p><p>${importObj.importStr1}</p></dd>
</dl><dl><dt>macro宏模板</dt><dd><#macro listMacro title items><p>${title?cap_first}:<ul><#list items as item><li>${item?cap_first}</li></#list></ul><#nested ></#macro></dd><dd><@listMacro items=["item1", "item2", "item3"] title="Items">nested标签表示可以插入自定义的内容</@listMacro></dd>
</dl>include 
<#include "eclipse.ftl">
</body>
</html>

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 <T>* @return*/public static <T> T getBean(Class<T> clazz) {return appContext.getBean(clazz);}/*** 通过name,以及Clazz返回指定的Bean** @param name* @param clazz* @param <T>* @return*/public static <T> T getBean(String name, Class<T> clazz) {return appContext.getBean(name, clazz);}@Overridepublic void setApplicationContext(ApplicationContext applicationContext) throws BeansException {if (appContext == null) {appContext = applicationContext;}}
}

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

public class FreemarkerUtil {public static String parseTpl(String viewName, Map<String, Object> 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", "<span style=\"color: red;font-size: 16px;\">html内容</span>");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

这篇关于springboot整合Freemark模板(详尽版)的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1020130。

相关文章

Java实现检查多个时间段是否有重合

Java实现检查多个时间段是否有重合

《Java实现检查多个时间段是否有重合》这篇文章主要为大家详细介绍了如何使用Java实现检查多个时间段是否有重合,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录流程概述步骤详解China编程步骤1：定义时间段类步骤2：添加时间段步骤3：检查时间段是否有重合步骤4：输出结果示例代码结语作
阅读更多...
Java中String字符串使用避坑指南

Java中String字符串使用避坑指南

《Java中String字符串使用避坑指南》Java中的String字符串是我们日常编程中用得最多的类之一,看似简单的String使用,却隐藏着不少“坑”,如果不注意,可能会导致性能问题、意外的错误容... 目录8个避坑点如下：1. 字符串的不可变性：每次修改都创建新对象2. 使用 == 比较字符串，陷阱满
阅读更多...
Java判断多个时间段是否重合的方法小结

Java判断多个时间段是否重合的方法小结

《Java判断多个时间段是否重合的方法小结》这篇文章主要为大家详细介绍了Java中判断多个时间段是否重合的方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录判断多个时间段是否有间隔判断时间段集合是否与某时间段重合判断多个时间段是否有间隔实体类内容public class D
阅读更多...
IDEA编译报错“java: 常量字符串过长”的原因及解决方法

IDEA编译报错“java: 常量字符串过长”的原因及解决方法

《IDEA编译报错“java:常量字符串过长”的原因及解决方法》今天在开发过程中,由于尝试将一个文件的Base64字符串设置为常量,结果导致IDEA编译的时候出现了如下报错java:常量字符串过长,... 目录一、问题描述二、问题原因2.1 理论角度2.2 源码角度三、解决方案解决方案①：StringBui
阅读更多...
Java覆盖第三方jar包中的某一个类的实现方法

Java覆盖第三方jar包中的某一个类的实现方法

《Java覆盖第三方jar包中的某一个类的实现方法》在我们日常的开发中,经常需要使用第三方的jar包,有时候我们会发现第三方的jar包中的某一个类有问题,或者我们需要定制化修改其中的逻辑,那么应该如何... 目录一、需求描述二、示例描述三、操作步骤四、验证结果五、实现原理一、需求描述需求描述如下：需要在
阅读更多...
Java中ArrayList和LinkedList有什么区别举例详解

Java中ArrayList和LinkedList有什么区别举例详解

《Java中ArrayList和LinkedList有什么区别举例详解》：本文主要介绍Java中ArrayList和LinkedList区别的相关资料,包括数据结构特性、核心操作性能、内存与GC影... 目录一、底层数据结构二、核心操作性能对比三、内存与 GC 影响四、扩容机制五、线程安全与并发方案六、工程
阅读更多...
JavaScript中的reduce方法执行过程、使用场景及进阶用法

JavaScript中的reduce方法执行过程、使用场景及进阶用法

《JavaScript中的reduce方法执行过程、使用场景及进阶用法》：本文主要介绍JavaScript中的reduce方法执行过程、使用场景及进阶用法的相关资料,reduce是JavaScri... 目录1. 什么是reduce2. reduce语法2.1 语法2.2 参数说明3. reduce执行过程
阅读更多...
如何使用Java实现请求deepseek

如何使用Java实现请求deepseek

《如何使用Java实现请求deepseek》这篇文章主要为大家详细介绍了如何使用Java实现请求deepseek功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1.deepseek的api创建2.Java实现请求deepseek2.1 pom文件2.2 json转化文件2.2
阅读更多...
Java调用DeepSeek API的最佳实践及详细代码示例

Java调用DeepSeek API的最佳实践及详细代码示例

《Java调用DeepSeekAPI的最佳实践及详细代码示例》：本文主要介绍如何使用Java调用DeepSeekAPI,包括获取API密钥、添加HTTP客户端依赖、创建HTTP请求、处理响应、... 目录1. 获取API密钥2. 添加HTTP客户端依赖3. 创建HTTP请求4. 处理响应5. 错误处理6.
阅读更多...
Spring AI集成DeepSeek的详细步骤

Spring AI集成DeepSeek的详细步骤

《SpringAI集成DeepSeek的详细步骤》DeepSeek作为一款卓越的国产AI模型,越来越多的公司考虑在自己的应用中集成,对于Java应用来说,我们可以借助SpringAI集成DeepSe... 目录DeepSeek 介绍Spring AI 是什么？1、环境准备2、构建项目2.1、pom依赖2.2
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2