SpringBoot数据校验及多环境配置的问题详解
作者:風栖祈鸢
接上节,本节补充一下数据校验及多环境配置的内容,仍是 SpringBoot-02-Config 项目。
1. 数据校验
使用数据校验,可以在输入不合法数据时抛出异常,首先要添加 validation
的依赖
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency> <dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>2.0.1.Final</version> </dependency>
在之前的 Person 类上使用 @Validated
注解开启数据校验,在 name 属性上添加 @Email
注解,表明这个属性要符合 Email 的格式
@Data @AllArgsConstructor @NoArgsConstructor @Component //注册为 bean @ConfigurationProperties(prefix = "person") // 开启数据校验 @Validated public class Person { // 检查 name 符合邮箱格式 @Email() private String name; private Integer age; private Boolean happy; private Date birth; private Map<String,Object> maps; private List<Object> lists; private Dog dog; }
配置文件中注入的 name 属性为 qiyuan,是不合法的,这时运行测试方法,SpringBoot 会报错
Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'person' to com.qiyuan.entity.Person failed:
Property: person.name
Value: qiyuan
Origin: class path resource [application.yaml] - 2:9
Reason: 不是一个合法的电子邮件地址
查看底层的错误,也可以看到
Caused by: org.springframework.boot.context.properties.bind.validation.BindValidationException: Binding validation errors on person
- Field error in object 'person' on field 'name': rejected value [qiyuan]; codes [Email.person.name,Email.name,Email.java.lang.String,Email]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [person.name,name]; arguments []; default message [name],[Ljavax.validation.constraints.Pattern$Flag;@44f3fe83,.*]; default message [不是一个合法的电子邮件地址]; origin class path resource [application.yaml] - 2:9
总而言之,使用数据校验可以方便地对属性的值进行合法性检测,在 JSR303 规范中( Java Specification Requests,即 Java 规范提案,JSR-303 是 JAVA EE 6 中的一项子规范)还有许多这样的检测注释,用到的时候再查吧!
2. 多环境配置
在 Spring 中可以使用 profile 对不同的环境进行不同的配置设置,通过激活不同的环境版本,实现快速切换环境。
在编写配置文件的时候,文件名可以是 application-{profile}.properties/yml
,通过不同的 profile 指定不同的环境,如 application-test.properties
表示测试环境,application-dev.properties
表示开发环境;但 SpringBoot 不会直接使用这种配置文件,它默认使用的是 application.properties
配置文件,所以需要指定需要使用的环境
spring.profiles.active=dev
若使用 yaml 进行配置,则更加简单了;yaml 提供了多文档块功能,不用创建多个配置文件
server: port: 8081 #选择要激活那个环境块 spring: profiles: active: test --- server: port: 8082 spring: profiles: dev #配置环境的名称 --- server: port: 8083 spring: profiles: prod #配置环境的名称
注意:如果 properties 和 yaml 都进行了端口配置,且没有指定其他配置,会默认使用 properties 配置文件。
3. 配置文件加载位置
SpringBoot 会扫描以下位置的 application.properties
或 application.yml
文件作为默认配置文件,优先级顺序为
- 项目路径下的 config 文件夹中的配置文件:
file:./config/
- 项目路径下的配置文件:
file:./
- 资源路径下的 config 文件夹中的配置文件:
classpath:./config/
- 资源路径下的配置文件:
classpath:./
优先级由高到底,高优先级的配置会覆盖低优先级的配置;若没有冲突,则配置会互补!
4. 总结
到此这篇关于SpringBoot数据校验及多环境配置的文章就介绍到这了,更多相关SpringBoot数据校验多环境配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!