Spring学习<四>模板引擎

常见的模板引擎有: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:srcth:href

th:each:遍历循环元素,和th:text或th:value一起使用。

th:if:条件判断,类似的还有th:unlessth:switchth:case

th:insert:代码块引入,类似的还有th:replaceth: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>


© 2011 The Good Thymes Virtual Grocery
/<code>

#{...} 消息表达式

消息表达式一般用于国际化的场景。结构: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等

五、listssets:集合方法,常用的方法有: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


分享到:


相關文章: