常见的模板引擎有:JSP、Velocity、Freemarker、Thymeleaf
SpringBoot推荐使用Thymeleaf。
Thymeleaf
Thymeleaf是一个用于web和独立环境的现代服务器端Java模板引擎,能够处理HTML、XML、JavaScript、CSS甚至纯文本。
Thymeleaf的主要目标是提供一种优雅且高度可维护的创建模板的方法。为了实现这一点,它基于自然模板的概念,以不影响模板用作设计原型的方式将其逻辑注入到模板文件中。这改善了设计的沟通,缩小了设计团队和开发团队之间的差距Thymeleaf 是一个优秀的、面向Java 的XML庆HTML/HTML5 页面模板,具有丰富的标签语言和函数。
常用属性
th:text :设置当前元素的文本内容,相同功能的还有th:utext,两者的区别在于前者不会转义html标签,后者会。
th:value:设置当前元素的value值,类似修改指定属性的还有th:src,th:href。
th:each:遍历循环元素,和th:text或th:value一起使用。
th:if:条件判断,类似的还有th:unless,th:switch,th:case
th:insert:代码块引入,类似的还有th:replace,th:include。
th:fragment:定义代码块,方便被th:insert引用。
th:object:声明变量,一般和*{}一起配合使用。
th:attr:修改任意属性,实际开发中用的较少,因为有丰富的其他th属性帮忙,类似的还有th:attrappend,th:attrprepend。
示例:
<code>
<title>Thymeleaf 语法/<title>
ITDragon Thymeleaf 语法
ID:
TH:
DE:
/<code>
常用表达式
${...} 变量表达式
@{...} 链接表达式
#{...} 消息表达式
~{...} 代码块表达式
*{...} 选择变量表达式
~{...} 代码块表达式
支持两种语法结构
推荐:~{templatename::fragmentname}
支持:~{templatename::#id}
templatename:模版名,Thymeleaf会根据模版名解析完整路径:/resources/templates/templatename.html,要注意文件的路径。
fragmentname:片段名,Thymeleaf通过th:fragment声明定义代码块,即:th:fragment="fragmentname"
id:HTML的id选择器,使用时要在前面加上#号,不支持class选择器。
代码块表达式的使用
代码块表达式需要配合th属性(th:insert,th:replace,th:include)一起使用。
th:insert:将代码块片段整个插入到使用了th:insert的HTML标签中,
th:replace:将代码块片段整个替换使用了th:replace的HTML标签中,
th:include:将代码块片段包含的内容插入到使用了th:include的HTML标签中,
用一个官方例子来区分三者的不同,第三部分会通过实战再次用到该知识。
<code>
<footer>
© 2011 The Good Thymes Virtual Grocery
/<footer>
<footer>
© 2011 The Good Thymes Virtual Grocery
/<footer>
<footer>
© 2011 The Good Thymes Virtual Grocery
/<footer>/<code>
© 2011 The Good Thymes Virtual Grocery
#{...} 消息表达式
消息表达式一般用于国际化的场景。结构:th:text="#{msg}" 。
@{...} 链接表达式
链接表达式好处
不管是静态资源的引用,form表单的请求,凡是链接都可以用@{...} 。这样可以动态获取项目路径,即便项目名变了,依然可以正常访问
<code>#修改项目名,链接表达式会自动修改路径,避免资源文件找不到
server.context-path=/itdragon/<code>
链接表达式结构
无参:@{/xxx}
有参:@{/xxx(k1=v1,k2=v2)} 对应url结构:xxx?k1=v1&k2=v2
引入本地资源:@{/项目本地的资源路径}
引入外部资源:@{/webjars/资源在jar包中的路径}
列举:第三部分的实战引用会详细使用该表达式
<code><link>
<link>
/<code>
${...}变量表达式
变量表达式有丰富的内置方法,使其更强大,更方便。
变量表达式功能
一、可以获取对象的属性和方法
二、可以使用ctx,vars,locale,request,response,session,servletContext内置对象
三、可以使用dates,numbers,strings,objects,arrays,lists,sets,maps等内置方法(重点介绍)
常用的内置对象
一、ctx :上下文对象。
二、vars :上下文变量。
三、locale:上下文的语言环境。
四、request:(仅在web上下文)的 HttpServletRequest 对象。
五、response:(仅在web上下文)的 HttpServletResponse 对象。
六、session:(仅在web上下文)的 HttpSession 对象。
七、servletContext:(仅在web上下文)的 ServletContext 对象
这里以常用的Session举例,用户刊登成功后,会把用户信息放在Session中,Thymeleaf通过内置对象将值从session中获取。
<code>// java 代码将用户名放在session中
session.setAttribute("userinfo",username);
// Thymeleaf通过内置对象直接获取
th:text="${session.userinfo}"/<code>
常用的内置方法
一、strings:字符串格式化方法,常用的Java方法它都有。比如:equals,equalsIgnoreCase,length,trim,toUpperCase,toLowerCase,indexOf,substring,
replace,startsWith,endsWith,contains,containsIgnoreCase等
二、numbers:数值格式化方法,常用的方法有:formatDecimal等
三、bools:布尔方法,常用的方法有:isTrue,isFalse等
四、arrays:数组方法,常用的方法有:toArray,length,isEmpty,contains,containsAll等
五、lists,sets:集合方法,常用的方法有:toList,size,isEmpty,contains,containsAll,sort等
六、maps:对象方法,常用的方法有:size,isEmpty,containsKey,containsValue等
七、dates:日期方法,常用的方法有:format,year,month,hour,createNow等
SpringBoot集成
依赖:
<code>
<dependency>
<groupid>org.springframework.boot/<groupid>
<artifactid>spring-boot-starter-thymeleaf/<artifactid>
/<dependency>/<code>
配置文件:
<code>###ThymeLeaf配置
spring:
thymeleaf:
#模板的模式,支持 HTML, XML TEXT JAVASCRIPT
mode: HTML5
#编码 可不用配置
encoding: UTF-8
#内容类别,可不用配置
content-type: text/html
#开发配置为false,避免修改模板还要重启服务器
cache: false
#配置模板路径,默认是templates,可以不用配置
prefix: classpath:/templates/<code>
只要我们把HTML页面放在classpath:/templates/,thymeleaf就能自动渲染;
导入thymeleaf的名称空间:
<code>
Controller:
<code> @GetMapping(value = "/test")
\t public ModelAndView test(HttpServletRequest req) {
\t ModelAndView mv = new ModelAndView();
\t mv.addObject("hello", hello);
\t mv.setViewName("/user/show.html");
\t return mv;
\t }
/<code>
页面:
<code>
<title>Title/<title>成功!
这是显示欢迎信息
/<code>
部分示例引入:https://www.cnblogs.com/itdragon/archive/2018/04/13/8724291.html
閱讀更多 代碼接盤俠 的文章