微架构 springcloud-02. springboot-配置文件和模板引擎

springboot-配置文件和模板引擎

配置文件简述

springboot 能在无任何配置文件下，极大的简化了配置，但并不是说springboot 就完全排斥配置，并且，在一些特定的场景，配置也是必不可少的。

配置文件位置及加载顺序

springboot 配置文件位置：通常情况下springboot 会去4个位置加载名为application.properties 的配置文件，根据优先级顺序加载配置中的属性，它们的位置依次是：

1. project/config/application.properties 即项目根目录下config子目录
2. project/application.properties 即项目根目录
3. project/src/main/resource/config/application.properties 即类路径下config子目录
4. project/src/main/resource/application.properties 即类路径(最常用)

代码实测

1. 由以上所述，创建这四份配置文件，并在每一份文件中都赋值一个loc 属性

├─config
   └─application.properties #loc="A"
├─src
│  └─main
│      └─resources
│         └─config
│         │  └─application.properties #loc="C"
│         └─application.properties #loc="D"
└─application.properties #loc="B"

2. 在任意Controller 注入 ApplicationContext

@Autowired
private ApplicationContext ctx;

@ResponseBody
@GetMapping("/readConfig")
public String readConfig(String attr){
    return ctx.getEnvironment().getProperty(attr);
}

3. 浏览器测试： http://localhost:8080/readConfig?attr=loc

# 页面打印
"A"

# 将 project/config/application.properties loc 属性注释，重启服务 刷新
# 页面打印
"B"

# 将 project/application.properties loc 属性注释，重启服务 刷新
# 页面打印
"C"

# 将 project/src/main/resource/config/application.properties loc 属性注释，重启服务 刷新
# 页面打印
"D"

4. 在project/config/application.properties 配置文件中添加一个非loc 属性，如：name="springboot"

#loc="A"
name="springboot"

5. 浏览器访问：http://localhost:8080/readConfig?attr=name ，测试是否能获取name属性：

# 页面打印
"springboot"

6. 总结：springboot 会同时加载该四个配置文件，若低优先级配置中重复添加高优先级配置文件的属性，则低优先级的会被忽略；在开发中第4位置应用最为广泛，通常也只保留该位置的配置文件。

常用配置属性举例

#http端口 默认为：8080
server.port=8081

#Servlet上下文 默认为： /
server.context-path=/springboot

测试：http://localhost:8081/springboot/readConfig?attr=server.port

# 页面打印
8081

模板引擎概述

springboot 使用的默认模板引擎是：thymeleaf，如果对springboot是真爱，请抛弃jsp：

thymeleaf 模板 环境搭建

01 在pom.xml添加如下依赖：

    org.springframework.boot
    spring-boot-starter-thymeleaf

02 在类路径（resources）下新建一个名为：templates 目录，在该目录下新建 htllo.html:

# /resources/templates/htllo.html



    
    


    
Thymeleaf
    # 接收返回值 hello 参数
    

03 创建Controller,返回该模板

@Controller
public class ThymeleafController {

    @RequestMapping("/toHello")
    public String toHello(Map map) {
        //返回传值 htllo 参数
        map.put("hello","Hello,thymeleaf!");
        return "/hello";
    }
}

04 浏览器访问：http://localhost:8081/springboot/toHello

# 页面打印
Thymeleaf

Hello,thymeleaf!

05 Thymeleaf 引擎配置，官网默认配置如下：

# THYMELEAF (ThymeleafAutoConfiguration)
spring.thymeleaf.cache=true # Enable template caching.
spring.thymeleaf.check-template=true # Check that the template exists before rendering it.
spring.thymeleaf.check-template-location=true # Check that the templates location exists.
spring.thymeleaf.content-type=text/html # Content-Type value.
spring.thymeleaf.enabled=true # Enable MVC Thymeleaf view resolution.
spring.thymeleaf.encoding=UTF-8 # Template encoding.
spring.thymeleaf.excluded-view-names= # Comma-separated list of view names that should be excluded from resolution.
spring.thymeleaf.mode=HTML5 # Template mode to be applied to templates. See also StandardTemplateModeHandlers.
spring.thymeleaf.prefix=classpath:/templates/ # Prefix that gets prepended to view names when building a URL.
spring.thymeleaf.suffix=.html # Suffix that gets appended to view names when building a URL.
spring.thymeleaf.template-resolver-order= # Order of the template resolver in the chain.
spring.thymeleaf.view-names= # Comma-separated list of view names that can be resolved.

06 在实际开发中使用默认即可，常改的有以下两项：

#模板位置
spring.thymeleaf.prefix=classpath:/templates/
#是否加入缓存，在开发环境中，通常要改为false
spring.thymeleaf.cache=true

----------更改后---------
spring.thymeleaf.prefix=classpath:/pages/
spring.thymeleaf.cache=false

07 根据[06] 说明，将resources 下templates 目录重命名为：pages，在resources/application.properties 文件中添加配置属性：

spring.thymeleaf.prefix=classpath:/pages/
spring.thymeleaf.cache=false

08 浏览器重新访问：http://localhost:8081/springboot/toHello

# 页面打印
Thymeleaf

Hello,thymeleaf!

#页面不受影响这就达到更改默认模板目录名的目的

09 模板热部署，模板经常改动，比如将 htllo.html 更改：

Thymeleaf
------改为-----
this is the Thymeleaf

#保存-> 刷新-> 页面无变化

若要使更改的页面生效，重新编译: Ctrl+B 或 Ctrl+F9 ,重新刷新页面：

# 页面打印
this is the Thymeleaf

Hello,thymeleaf!

# 故：模板页面更改后，需重新编译程序才会重新加载执行。

10 总结：模板代码现在也是类路径的一部分，其内容发生改变，类加载器也许重新加载方能执行！