Spring很常用的@Conditional注解的使用场景和源码解析
你好，我是刘牌！
介绍
今天要分享的是Spring的注解@Conditional，@Conditional是一个条件注解，它的作用是判断Bean是否满足条件，如果满足条件，则将Bean注册进IOC中，如果不满足条件，则不进行注册，这个注解在SpringBoot中衍生出很多注解，比如@ConditionalOnProperty，@ConditionalOnBean，@ConditionalOnClass等等，在SpringBoot中，这些注解用得很多。
文件服务场景
下面我们演示一些@Conditional的使用，在软件开发中，文件系统是必须的，但是系统的特点不一样，有些用户希望将文件保存在自己的服务器上，有些用户则没这种要求，这时候，文件可以保存在云上，也可以保存在自建文件系统上，那么面对不同用户的需求，我们的软件也要能够适配不同的环境，只需要简单的配置即可。
假设我们在开发过程中，我们的文件全部托管在云服务厂商的OSS上，代码逻辑也没有预留扩展，那么当用户需要私有化部署，我们可能就需要更改文件存储这边的逻辑，这样的设计是不合理的。
我们想一想，文件存储的代码逻辑是不同的，各个文件系统的实现方式和使用API各不相同，但是它们有一个共性，那就是能够上传文件，下载文件的，所以我们就应该抽象出一个公共接口，下面有不同的实现，比如Minio的文件上传下载等逻辑就使用Minio API去实现，FastDFS就使用FastDFS，OSS就使用OSS，下面我们就编写对应的代码。
编码实现
以下通过编码实现不同文件系统的逻辑实现隔离，统一提供接口的方案，一般我们都会将配置信息写在配置文件中，在配置文件中，使用storageType代表文件存储类型。
文件上传接口
在StorageService接口中，只简单定义了两个方法init()和put()，init()就是做一些初始化操作，比如参数配置，连接等，put()就是上传文件接口。
/**
* 功能说明： 文件上传接口
* <p>
* Original @Author: steakliu-刘牌, 2023-04-03 09:54
* <p>
*/
public interface StorageService {
/**
* 初始化文件存储
*/
void init();
/**
* 上传文件
* @param file
*/
void put(MultipartFile file);
}
具体文件系统实现
以下是Minio的具体实现，在类上面使用了@Conditional注解，value值为MinioStorageCondition。
@Component
@Conditional(value = MinioStorageCondition.class)
public class MinioStorageService implements StorageService {
@Override
public void init() {
// 初始化操作
}
@Override
public void put(MultipartFile file) {
}
}
MinioStorageCondition条件判断
MinioStorageCondition的作用就是判断条件是否匹配，它实现Condition接口，要使用@Conditional，其判断类必须要实现Condition接口，然后自己实现matches方法逻辑，以下就是判断storageType是否为minio，如果为minio，那么就返回true，就代表要创建MinioStorageService这个bean，为false则不创建。
public class MinioStorageCondition implements Condition {
@Override
public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
String storageType = context.getEnvironment().getProperty("storageType");
return "minio".equals(storageType);
}
}
源码解析
spring在扫描bean的时候，会判断对应的bean是否有@Conditional注解，如果有，则会进入value中的类，进去判断是否符合条件，如果符合，则返回true，就能够注册，实际上如果符合条件，那么就能将BeanDefinition注册进BeanFactory，如果不符合，自然不能注册进。
如下是源码的时序图
从上面的时序图中可以看出，整个过程涉及的类还是挺多的，不过这还不是完整流程，只是从扫描类开始，Spring会扫描工程路径下的类，这个路径可以通过@ComponentScan进行指定，如果是SpringBoot项目，则就为当前工程，然后筛选出需要注册的bean并注册到BeanFactory，对于标注有@Conditional注解的类，会进入@Conditional中value的类中，就是上面的MinioStorageCondition或者FastDFSStorageCondition，然后进行匹配，不满足条件的则不会被注册。
@Conditional的具体流程也比较简单，就不一一赘述，可以看着上面的时序图去看源码实现。
总结
上面对@Conditional的使用，原理等进行简单的介绍，@Conditional注解在SpringBoot中用得还是比较多的，特别是它衍生出来的一些注解，这些注解都是基于它来进行二次封装的，在SpringBoot中，对于很多starter，里面几乎都会有@Conditional和@Conditional衍生注解的使用，我们后续会挑选出一些来说。
今天的分享就到这里，感谢你的观看，我们下期见！