学习视频链接,以示尊重:https://www.bilibili.com/video/BV1PE411i7CV
一、JSR303数据校验
Springboot中可以用@validated来校验数据,如果数据异常则会统一抛出异常,方便异常中心统一处理。
举例使用:
写个注解让 name 字段只能支持Email格式:
1、新版本 SpringBoot 需要validation启动器,需要添加依赖:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
2、使用@Validated注解标注实体类,使用@Email(message=“错误信息”) 标注属性:
@Validated
public class Person {
@Email(message="邮箱格式错误") //标注name属性的取值必须是邮箱格式
private String name;
......
}
3、测试:会报错:default message [不是一个合法的电子邮件地址];
常见参数:
@NotNull(message="名字不能为空")
private String userName;
@Max(value=120,message="年龄最大不能查过120")
private int age;
@Email(message="邮箱格式错误")
private String email;
空检查
@Null 验证对象是否为null
@NotNull 验证对象是否不为null, 无法查检长度为0的字符串
@NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.
@NotEmpty 检查约束元素是否为NULL或者是EMPTY.
Booelan检查
@AssertTrue 验证 Boolean 对象是否为 true
@AssertFalse 验证 Boolean 对象是否为 false
长度检查
@Size(min=, max=) 验证对象(Array,Collection,Map,String)长度是否在给定的范围之内 @Length(min=, max=) string is between min and max included.
日期检查
@Past 验证 Date 和 Calendar 对象是否在当前时间之前
@Future 验证 Date 和 Calendar 对象是否在当前时间之后
@Pattern 验证 String 对象是否符合正则表达式的规则
.......等等除此以外,还可以自定义一些数据校验规则
二、多环境切换
profile 是 Spring 对不同环境提供不同配置功能的支持,可以通过激活不同的环境版本,实现快速切换环境。
在主配置文件编写的时候,文件名可以是 application-{profile}.properties/yml , 用来指定多个环境版本。
例如:
- application-test.properties 代表测试环境配置
- application-dev.properties 代表开发环境配置
但是Springboot并不会直接启动这些配置文件,它默认使用application.properties主配置文件。
这时需要通过一个配置来选择需要激活的环境:
#比如在配置文件中指定使用dev环境
#启动SpringBoot,就可以看到已经切换到dev下的配置了;
spring.profiles.active=dev
yaml 的多文档块:
yaml 和 properties配置文件中一样,但是使用yaml去实现不需要创建多个配置文件,更加方便简捷。
server:
port: 8081
#指定要激活那个环境块的名称
spring:
profiles:
active: prod
---
server:
port: 8082
spring:
profiles: dev # 配置环境的名称
---
server:
port: 8083
spring:
profiles: prod # 配置环境的名称
这时启动项目,可以发现,项目启动端口为所指定的prod环境的端口:
Tomcat started on port(s): 8083 (http) with context path ''
注意:如果yaml和properties同时都配置了端口,并且没有激活其他环境,默认会使用properties配置文件的配置信息。
三、配置文件加载位置
外部加载配置文件的方式十分多,选择最常用的即可,在开发的资源文件中进行配置。
springboot 启动会扫描以下位置的application.properties或者application.yml文件作为Spring boot的默认配置文件:
优先级1:项目路径下的config文件夹配置文件
优先级2:项目路径下配置文件
优先级3:资源路径下的config文件夹配置文件
优先级4:资源路径下配置文件
说明:
- 优先级由高到底,高优先级的配置会覆盖低优先级的配置
- SpringBoot会从这四个位置全部加载主配置文件;互补配置
可以配置项目访问路径:
#配置项目的访问路径``
server.servlet.context-path=/xingyu
扩展:指定位置加载配置文件
- 可以通过spring.config.location来改变默认的配置文件位置
- 项目打包好以后,我们可以使用命令行参数的形式,启动项目的时候来指定配置文件的新位置;这种情况下,外部指定的配置文件优先级最高,例如:
java -jar spring-boot-config.jar --spring.config.location=F:/application.properties
四、自动配置原理
@Configuration 注解:表示这是一个配置类,和以前编写的配置文件一样,也可以给容器中添加组件。
@EnableConfigurationProperties({XXXProperties.class}) 注解:启动指定类的ConfigurationProperties功能; 将配置文件中对应的值和XXXProperties绑定起来,并把XXXProperties加入到ioc容器中。
@Conditional注解:根据不同的条件判断,如果满足指定的条件,整个配置类里面的配置就会生效。
一句话总结 :根据当前不同的条件判断,决定这个配置类是否生效:
- 一但这个配置类生效;这个配置类就会给容器中添加各种组件;
- 这些组件的属性是从对应的properties类中获取的,这些类里面的每一个属性又是和配置文件绑定的;
- 所有在配置文件中能配置的属性都是在xxxxProperties类中封装着;
- 配置文件能配置什么就可以参照某个功能对应的这个属性类
例如:
//从配置文件中获取指定的值和bean的属性进行绑定
@ConfigurationProperties(prefix = "spring.http")
public class HttpProperties {
// .....
}
注意:
- SpringBoot启动时会加载大量的自动配置类
- 我们看我们需要的功能有没有在SpringBoot默认写好的自动配置类当中;
- 我们再来看这个自动配置类中到底配置了哪些组件;(只要我们要用的组件存在在其中,我们就不需要再手动配置了)
- 给容器中自动配置类添加组件的时候,会从properties类中获取某些属性。我们只需要在配置文件中指定这些属性的值即可;
**xxxxAutoConfigurartion:自动配置类;**给容器中添加组件
xxxxProperties:封装配置文件中相关属性;
五、@Conditional
自动配置类必须在一定的条件下才能生效;
@Conditional派生注解(Spring注解版原生的@Conditional作用)
作用:必须是@Conditional指定的条件成立,才给容器中添加组件,配置配里面的所有内容才生效;
那么多的自动配置类,必须在一定的条件下才能生效;也就是说,加载了这么多的配置类,但不是所有的都生效。
Q:如何知道哪些自动配置类生效?
A:可以通过启用 debug=true属性;来让控制台打印自动配置报告,这样就可以很方便的知道哪些自动配置类生效;
#开启springboot的调试类
debug=true
输出结果中:
- Positive matches:(自动配置类启用的:正匹配)
- Negative matches:(没有启动,没有匹配成功的自动配置类:负匹配)
- Unconditional classes: (没有条件的类)