「SpringBoot实战」视图技术-Thymeleaf

在一个Web应用中，通常会采用MVC设计模式实现对应的模型、视图和控制器，其中，视图是用户看到并与之交互的界面。对最初的Web应用来说，视图是由HTML元素组成的静态界面；而后期的Web应用更倾向于使用动态模板技术，从而实现前后端分离和页面的动态数据展示。Spring Boot框架为简化项目的整体开发，提供了一些视图技术支持，并主要推荐整合模板引擎技术实现前端页面的动态化内容。本文对SpringBoot常用的Thymeleaf进行整合。

Thymeleaf是一种现代的基于服务器端的Java模板引擎技术，也是一个优秀的面向Java的XML、XHTML、HTML5页面模板，它具有丰富的标签语言、函数和表达式，在使用Spring Boot框架进行页面设计时，一般会选择 Thymeleaf模板。我们在这里学习Thymeleaf 常用的标签、表达式。

Thymeleaf标签

使用标签只需要加上一个命名空间就可以了。 即修改原html的第二行就可以了。

变量表达式${}主要用于获取上下文中的变量值，示例代码如下。

这是标题

- 使用了Thymeleaf模板的变量表达式${}用来动态获取p标签中的内容 - 如果当前程序没有启动或者当前上下文中不存在title变量，该片段会显示标签默认值“这是标题”； - 如果当前上下文中存在title 变量并且程序已经启动，当前p标签中的默认文本内容将会被tite变量的值所替换，从而达到模板引擎页面数据动态替换的效果。

Thymeleaf为变量所在域提供了一些内置对象

结合上述内置对象的说明，假设要在Thymeleaf模板擎页面中动态获取当前国家信息，可以使用#locale内置对象

选择交量表达式和变量表达式用法类似，一般用于从被选定对象而不是上下文中获取属性值，如果没有选定对象，则和变量表达式一样，示例代码如下。

消息表达式#{}主要用于Thymeleaf模板页面国际化内容的动态替换和展示。使用消息表这式#{}进行国际化设置时，还需要提供一些国际化配置文件。关于消息表达式的使用，下文写国际化时会详细说明。

链接表达式@{}一般用于页面跳转或者资源的引入，在Web开发中占据着非常重要的地位，并且使用也非常频繁。

片段表达式~{}是一种用来将标记片段移动到模板中的方法。其中，最常见的用法是使用th:insert或th:replace 属性插入片段

Spring Boot默认设置了静态资源的访问路径，默认将/所有访问映射到以下目录。

我们创建一个springboot项目用于本次实验。项目名为springboot_01_thyme。java8，springboot266

创建一个LoginController类用于数据替换效果测试。

我们写一个loginhtml进行测试。我们导入一个bootstrap的样式到static/login里面，并且自己定义一些css。

最后我们通过访问>

一种可能是你的yml文件没有被ide标注为资源文件，这种的症状就是你的yml文件是个表格状的图标，这时，你只需在你的yml所在的文件夹上（一般是resources文件夹）右键，选择“标记目录为”-》resources root即可，这时你的yml文件就会变成一个绿叶的图标，大功告成！！！

1新建属性class 

    @Component

    @PropertySource({"classpath:applicationproperties"})

    @ConfigurationProperties(prefix="test")

2寻找配置文件classpath:applicationproperties ，过滤前缀“ prefix="test" ”

引用

Springboot 读取配置文件(applicationyaml, applicationproperties)的过程发生在SpringApplication#prepareEnvironment() 阶段，而prepareEnvironment又属于整个Springboot 应用启动的非常前置阶段，因为Environment的准备是后续bean创建的基础。让我们来一探启动是的详细code。除去StopWatch这些code，可以发现prepareEnvironment 发生在SpringApplication#run 这在整个应用启动的多步实质性 *** 作中几乎是第一步。

而prepareEnvironment中最重要的是通过触发listener（EventPublishingRunListener）来通过SimpleApplicationEventMulticaster#multicastEvent发出ApplicationEnvironmentPreparedEvent。

而SimpleApplicationEventMulticaster#multicastEvent的实现其实也很简单，找到相关的监听ApplicationEnvironmentPreparedEvent的listener，然后一个个的调用他们的Listener#onApplicationEvent(event)方法，而这其中就包括了处理configuration文件的listener。

在Springboot 240 之前这个处理configuration 文件的lister是ConfigFileApplicationListener，在240之后，处理configuration 文件的lister是EnvironmentPostProcessorApplicationListener，并且对configuration文件的加载做了较大的改变，导致一些行为可能出现了变化，这也就是下面要详细讲的内容。

Springboot 240之后，configuration 文件的load顺序按照优先级是如下顺序(序号大的会被小的覆盖）：

和之前版本比较，整体的属性加载顺序并无调整，只有Application properties（14，15）这里有顺序的调整，具体调整为：

如果存在多个active的profiles，例如[Test, Dev], 那么对于同时存在两个profile 配置文件中的配置，后面的profile里的配置（Dev）会覆盖前面profile(Test)里配置的值。

前面讲了这么多，终于要引出Springboot 24之后配置文件加载的行为变化了。

考虑这样的情况，如果我想在跑Springboot test的时候指定特定的profile，那么可以在Test class中加入@ActiveProfile("Test")。 如果我的应用中存在ApplicationEnvironmentPreparedEvent的某个自定义listener中，会根据当前environment 设置profile，如envaddActiveProfile("Dev")。

当前就会有两个active profile，由于springboot-test会在调用application#run 前利用DefaultActiveProfilesResolver把@ActiveProfile注解定义的profile（Test）先加入了active的profile，等test run的时候 envaddActiveProfile("Dev") 又会把"Dev"也作为active profile 加入，这时候当前的active profile便为["Test", "Dev"]。

据上面介绍，后面的profile(Dev)对应的configuration 会覆盖前面的(Test)。可Springboot 240之前的版本为我们做了调整，让Test class中@ActiveProfile内定义的profile所对应的配置文件成为最高优先级。

刚才提到在Springboot 240 之前这个处理configuration 文件的lister是ConfigFileApplicationListener，我们

来看看ConfigFileApplicationListener的相关code。

查看initializeProfiles()，发现此时对profile的顺序做了调整，将activatedViaProperty (Test) 放在最后add，于是profile的顺序就变成了[Dev, Test]。

在profilespoll()时原本profile的顺序已经倒了过来，已经变为[Dev, Test], 在load()方法中由于后置的Test profile，application-Testyaml中的值最终生效了。

可是到了Springboot240之后，ConfigFileApplicationListener被deprecated了，取而代之的是EnvironmentPostProcessorApplicationListener，EnvironmentPostProcessorApplicationListener通过调用ConfigDataEnvironmentPostProcessor来完成configuration加载。

EnvironmentPostProcessorApplicationListenerjava

ConfigDataEnvironmentPostProcessorjava

ConfigDataEnvironmentPostProcessor只是老老实实的set了active profile，并没有调换profile的顺序。最后调用定义在springfactories中的resource loader class来load 配置文件。

YamlPropertySourceLoaderjava

插一句，Springboot为我们提供了很好的yaml文件parse的code，当你需要解析yaml文件时不妨直接参考Springboot的YamlPropertySourceLoader

这样一旦应用升级到Springboot 240之后相同的test code会使用application-Devyaml中配置的值，造成了test结果的改变。

如果要解决这个问题，根据上面介绍的配置文件优先级顺序，可以在@SpringbootTest中设置properties 来作为最终的配置覆盖当前profile对应的配置。

了解一个框架很不容易，一个小小的变化都有可能造成应用的行为变化，唯有刨根问底，不断总结才是framework人解决一切问题的不变的方法论。

在applicationyml或者properties文件中添加：

infoaddress=USA

infocompany=Spring

infodegree=high

激活 @ConfigurationProperties

我们可以通过下面几种方式将其添加到应用上下文中

首先，我们可以通过添加 @Component 注解让 Component Scan 扫描到

资源目录下建立config/db-configproperties:

dbusername=root

dbpassword=123456

@Autowired

private Environment env;

// 获取参数

String getProperty(String key);

@conditionalonproperty(name = "XXX",havingValue = "true")

参考文献

SpringBoot使用一个全局的配置文件，配置文件名是固定的；

配置文件的作用：修改SpringBoot自动配置的默认值；SpringBoot在底层都给我们自动配置好；

YAML 是一个标记语言

标记语言：

以前的配置文件；大多都使用的是xxxxml文件

YAML：以数据为中心，比json、xml等更适合做配置文件

YAML：配置例子

XML:

k:(空格)v ： 表示一对键值对（空格必须有）

以空格的缩进来控制层级关系；只要是左对齐的一列数据，都是同一个层级的

属性和值也是大小写敏感；

k: v :字面直接来写；

字符串默认不用加上单引号或者双引号；

"" :双引号；不会转义字符串里面的特殊字符； 特殊字符会作为本身想表示的意思

name : "zhangsan \n lisi" :输出 ： zhangsan 换行 lisi

'' :单引号；会转义特殊字符，特殊字符最终只是一个普通的字符串数据

name: 'zhangsan \n lisi' : 输出 ； zhangsan \n lisi

k: v : 在下一行来写对象的属性和值的关系 ；注意缩进

对象还是 k: v 的方式

行内写法：

用- 值表示数组中的一个元素

行内写法

配置文件

javaBean:

我们可以导入配置文件处理器，以后编写配置就有提示了

调整 图示：

配置文件yml还是properties他们都能获取到值；

如果说，我们只是在某个业务逻辑中需要获取一下配置文件中的某项值，使用@Value

如果说，我们专门编写一个javaBean来和配置文件进行映射，我们就直接使用@ConfigurationProperties

@ImportResource:导入Spring的配置文件，让配置文件里面的内容生效

SpringBoot里面没有Spring的配置文件，我们自己编写的配置文件，也不能自动识别；

想让Spring的配置文件生效，加载进来；@ImportResource标注在一个配置类上

不来编写Spring的配置文件

Spring Boot推荐给容器添加组件的方式；推荐全注解的方式

1、配置类@Configuration------>Spring配置文件

2、使用@Bean给容器中添加组件

我们在主配置文件编写的时候，文件名可以是application-{profile}properties/yml

默认使用applicationproperties的配置

1、在配置文件中指定springprofilesactive=dev

2、在命令行：

java -jar spring-boot-02-configjar --springprofilesactive=dev;

可以直接在测试的时候，配置传入命令行参数

3虚拟机参数

-Dspringprofilesactive=dev

springboot 启动会扫描以下位置的applicationproperties或者applicationyml文件作为Spring Boot的默认配置文件

-file:/config/

-file:/

-classpath:/config/

-classpath:/

优先级由高到低，高优先级的配置会覆盖低优先级的配置

SpringBoot会从这四个位置加载主配置文件：互补配置

==我们还可以通过springconfiglocation来改变默认的配置文件位置==

项目打包好以后，我们可以使用命令行参数的形式，启动项目的时候来指定配置文件的新位置；指定配置文件和默认加载的这些配置文件共同起作用互补配置；

java -jar spring-boot-02-configjar --springconfiglocation=G:/applicationproperties

==SpringBoot也可以从以下位置加载配置；优先级从高到低；高优先级的配置低优先级的配置，所有的配置会形成互补配置==

1命令行参数

2来自java:comp/env的JNDI属性

3java系统属性

4 *** 作系统环境变量

5RandomValuePropertySource配置的random属性值

==有jar包外箱jar包内进行寻找==

==优先加载带profile==

6jar包外部的application-{profile}properties 或 applicationyml(带springprofile)配置文件

7jar包内部的application-{profile}properties 或 applicationyml(带springprofile)配置文件

==再来加载不带profile==

8jar包外部的applicationproperties或者applicationyml(不带springprofile)配置文件

9jar包内部的applicationproperties或者applicationyml(不带springprofile)配置文件

精髓：

1》springboot启动会加载大量的自动配置类

2》我们看我们需要的功能有没有springboot默认写好的自动配置类

3》我们再来看这个自动配置类中到底配置了那些组件；（只要我们要用的组件有，我们就不需要再来配置了）

4》给容器中自动配置类添加组件的时候，会从properties类中获取某些属性，我们就可以在配置文件中指定这些属性的值

以上就是关于「SpringBoot实战」视图技术-Thymeleaf全部的内容，包括:「SpringBoot实战」视图技术-Thymeleaf、SpringBoot系列之@PropertySource用法简介、springboot 为什么读取不到 yml 属性等相关内容解答，如果想了解更多相关内容，可以关注我们，你们的支持是我们更新的动力！