springboot-配置文件和模板引擎
配置文件简述
springboot 能在无任何配置文件下,极大的简化了配置,但并不是说springboot 就完全排斥配置,并且,在一些特定的场景,配置也是必不可少的。
配置文件位置及加载顺序
springboot 配置文件位置:通常情况下springboot 会去4个位置加载名为application.properties 的配置文件,根据优先级顺序加载配置中的属性,它们的位置依次是:
- project/config/application.properties 即项目根目录下config子目录
- project/application.properties 即项目根目录
- project/src/main/resource/config/application.properties 即类路径下config子目录
- project/src/main/resource/application.properties 即类路径(最常用)
代码实测
- 由以上所述,创建这四份配置文件,并在每一份文件中都赋值一个loc 属性
├─config
└─application.properties #loc="A"
├─src
│ └─main
│ └─resources
│ └─config
│ │ └─application.properties #loc="C"
│ └─application.properties #loc="D"
└─application.properties #loc="B"
- 在任意Controller 注入 ApplicationContext
@Autowired
private ApplicationContext ctx;
@ResponseBody
@GetMapping("/readConfig")
public String readConfig(String attr){
return ctx.getEnvironment().getProperty(attr);
}
# 页面打印
"A"
# 将 project/config/application.properties loc 属性注释,重启服务 刷新
# 页面打印
"B"
# 将 project/application.properties loc 属性注释,重启服务 刷新
# 页面打印
"C"
# 将 project/src/main/resource/config/application.properties loc 属性注释,重启服务 刷新
# 页面打印
"D"
- 在project/config/application.properties 配置文件中添加一个非loc 属性,如:name="springboot"
#loc="A"
name="springboot"
- 浏览器访问:http://localhost:8080/readConfig?attr=name ,测试是否能获取name属性:
# 页面打印
"springboot"
- 总结: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:
<html>
<h5 style="color:red">thymeleaf 模板 环境搭建</h1>
</html>
01 在pom.xml添加如下依赖:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
02 在类路径(resources)下新建一个名为:templates 目录,在该目录下新建 htllo.html:
# /resources/templates/htllo.html
<!DOCTYPE html>
<html lang="en" xmlns="http://www.w3.org/1999/xhtml"
xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8" />
<title>Hello</title>
</head>
<body>
<h1>Thymeleaf</h1>
# 接收返回值 hello 参数
<h1 th:text="${hello}"></h1>
</body>
</html>
03 创建Controller,返回该模板
@Controller
public class ThymeleafController {
@RequestMapping("/toHello")
public String toHello(Map map) {
//返回传值 htllo 参数
map.put("hello","Hello,thymeleaf!");
return "/hello";
}
}
# 页面打印
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 更改:
<h1>Thymeleaf</h1>
------改为-----
<h1>this is the Thymeleaf</h1>
#保存-> 刷新-> 页面无变化
若要使更改的页面生效,重新编译: Ctrl+B 或 Ctrl+F9 ,重新刷新页面:
# 页面打印
this is the Thymeleaf
Hello,thymeleaf!
# 故:模板页面更改后,需重新编译程序才会重新加载执行。
10 总结:模板代码现在也是类路径的一部分,其内容发生改变,类加载器也许重新加载方能执行!
网友评论