JSR303数据校验

使用方式

  • 使用场景
    • 可以用在后端校验前端传来的数据，一个合格的后端程序员要对前端传来的一切参数保持怀疑态度。
  • springboot中可以使用@validated来校验数据，如果数据异常则会统一抛出异常，方便异常中心统一处理。写一个注解让name属性只支持Email格式
  • 依赖导入 ```java org.springframework.boot spring-boot-starter-validation 
  1. ```java
  2. @Component
  3. // 方式1
  4. // 通过这个注解，吧yml中配置的属性加载进来
  5. // 但是需要注意的是设置prefix = yml中配置的对象名
  6. // 爆红的话需要添加依赖进去
  7. // 这个特性可以吧一些配置存放在配置类中，然后通过yml进行注入
  8. // yml 中有封装的若干方法，比如randomInt uuid 等等,配置相当灵活，比properties的配置功能更强
  9. @ConfigurationProperties(prefix = "person")
  10. // 方式2
  11. // 加载指定的配置文件
  12. // javaConfig 绑定配置文件的值可以采取上面这些方式。
  13. //@PropertySource(value="classpath:addicated.properties")
  14. @Validated // 数据校验
  15. public class Person {
  17.     // SPEL 表达式取出配置文件中的配置
  18. //    @Value("${name}")
  21.     // JSR303 提供的验证注解，message可指定验证错误时返回的文本
  22.     @Email(message="邮箱格式错误")
  23.     private String name;
  • 运行结果
  • image.png
  • 此时如果在使用注解的时候没有标注message信息的化，会弹出默认的 不是一个合法的电子邮件地址。

    常见参数

    ```java @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 对象是否符合正则表达式的规则

…….等等 除此以外，我们还可以自定义一些数据校验规则

  1. <a name="WTdwK"></a>
  2. # 多环境切换
  4. - profile 是spring对不同环境提供不同配置功能的支持，可以通过激活不同的环境版本，实现快速切换环境。
  5. <a name="Uiy83"></a>
  6. ## 多配置文件
  8. - 在写祝配置文件的时候，文件名是可以按照 application-{profile}.properties/yml 用来指定多个环境版本
  9.    - 例如
  10.       - application-test.properties 代表测试环境
  11.       - application-dev.properties 代表开发环境
  12. - springboot不会直接启动这些配置文件，默认使用application.properties主配置文件。
  13. - 然后需要做一个配置来选择需要激活的环境。
  15. ![image.png](https://cdn.nlark.com/yuque/0/2021/png/1608527/1617276595421-9d3d18bf-6b7f-40b5-ab17-0a5b8ef4ebb1.png#align=left&display=inline&height=425&margin=%5Bobject%20Object%5D&name=image.png&originHeight=850&originWidth=1574&size=550645&status=done&style=none&width=787)
  17. - 当然是要在主配置文件中进行环境的选择，上面这种方式是properties文件格式的方法。
  18. <a name="W0Lby"></a>
  19. ## yaml的多文档块
  21. - 和properties配置文件中一样，但是使用yml实现不需要创建多个文件，相较之下比较方便。
  22. ```yaml
  23. server:
  24.   port: 8081
  25. #选择要激活那个环境块
  26. spring:
  27.   profiles:
  28.     active: prod
  30. ---
  31. server:
  32.   port: 8083
  33. spring:
  34.   profiles: dev #配置环境的名称
  36. ---
  38. server:
  39.   port: 8084
  40. spring:
  41.   profiles: prod  #配置环境的名称

注意点

  • 如果yml和properties同时配置了端口，并且没有激活其他环境，默认会优先使用properties配置文件。

    配置文件加载位置

  • 外部加载配置文件的方式十分多，选择最长用的即可，在开发的资源文件中进行配置

  • 官方的外部配置文件说明参考文档
  • image.png

  • springboot 启动会扫描以下位置的application.properties或者application.yml文件作为Spring boot的默认配置文件：

    1. 优先级1：项目路径下的config文件夹配置文件
    2. 优先级2：项目路径下配置文件
    3. 优先级3：资源路径下的config文件夹配置文件
    4. 优先级4：资源路径下配置文件

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

    springboot会从这4个位置全部加载主配置文件，互补配置

    拓展

  • 指定位置加载配置文件

  • 可以通过spring.config.location来改变默认的配置文件位置
  • 项目打包好以后，可以使用命令行参数的形式，启动项目的时候来指定配置文件的新位置，相同配置，外部指定的配置文件优先级最高。
    1. java -jar spring-boot-config.jar --spring.config.location=F:/application.properties