SpringBoot（三）JSR303数据校验/多环境切换/XXXProperties

---

学习视频链接，以示尊重：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: （没有条件的类）