【Java教程】Day23-07 Spring Boot开发：使用Conditional实现灵活条件装配

最新推荐文章于 2025-12-16 16:02:25 发布

原创最新推荐文章于 2025-12-16 16:02:25 发布 · 553 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#java #spring boot #开发语言

Java教程专栏收录该内容

280 篇文章

订阅专栏

在Spring Boot开发中，Profile用于根据不同的环境加载不同的配置，但有时我们需要更细粒度的控制。例如，针对不同的存储方案（如本地存储、AWS存储、阿里云存储等），使用Profile的方式可能不够灵活，因为在实际开发中，我们可能会增加更多的存储方案，Profile的控制显得比较粗糙。

为了提供更精细的条件装配，Spring框架提供了@Conditional注解。通过@Conditional，我们可以根据具体条件（如配置项、Bean的存在与否、类的存在与否等）进行灵活的装配。这比单纯依赖Profile更加灵活和高效。

1. Spring Boot的条件装配注解

Spring Boot提供了多个常用的条件装配注解，它们可以帮助我们根据不同的条件来控制Bean的加载。以下是几个常用的条件装配注解：

@ConditionalOnProperty：根据配置文件中是否有指定的属性来决定是否加载Bean。
@ConditionalOnBean：当容器中已经有指定的Bean时，才会加载该Bean。
@ConditionalOnMissingBean：当容器中没有指定的Bean时，才会加载该Bean。
@ConditionalOnMissingClass：当类路径中缺少某个指定的类时，才会加载该Bean。
@ConditionalOnWebApplication：在Web环境中才会加载该Bean。
@ConditionalOnExpression：根据SpEL（Spring表达式语言）判断条件是否满足，进而决定是否加载该Bean。

今天，我们将重点介绍最常用的注解：@ConditionalOnProperty，并通过实际案例展示如何使用它。

2. 使用@ConditionalOnProperty进行条件装配

假设我们需要根据配置文件中指定的存储类型来选择不同的存储服务，例如本地存储（LocalStorageService）、AWS存储（AwsStorageService）和阿里云存储（AliyunStorageService）。通过@ConditionalOnProperty注解，我们可以非常灵活地根据配置选择加载不同的存储服务。

2.1 配置文件（application.yml）

首先，在application.yml中定义一个storage.type属性，用来控制存储服务的选择。默认情况下，我们将存储类型设为local：

yamlstorage:  type: ${STORAGE_TYPE:local}  # 默认为local，若没有设置STORAGE_TYPE，则为local

2.2 本地存储服务（LocalStorageService）

当storage.type为local时，启用本地存储服务。使用@ConditionalOnProperty注解来确保只有在该配置项为local时才会加载LocalStorageService：

java@Component@ConditionalOnProperty(value = "storage.type", havingValue = "local", matchIfMissing = true)  // 默认启用public class LocalStorageService implements StorageService {    // 省略实现...}

2.3 AWS存储服务（AwsStorageService）

当storage.type为aws时，启用AWS存储服务：

java@Component@ConditionalOnProperty(value = "storage.type", havingValue = "aws")public class AwsStorageService implements StorageService {    // 省略实现...}

2.4 阿里云存储服务（AliyunStorageService）

当storage.type为aliyun时，启用阿里云存储服务：

java@Component@ConditionalOnProperty(value = "storage.type", havingValue = "aliyun")public class AliyunStorageService implements StorageService {    // 省略实现...}

2.5 逻辑分析

@ConditionalOnProperty(value = "storage.type", havingValue = "local", matchIfMissing = true)：
- 如果storage.type的值是local，则启用LocalStorageService。
- 如果没有在配置文件中找到storage.type，则默认使用local，因此会启用LocalStorageService。
@ConditionalOnProperty(value = "storage.type", havingValue = "aws")：
- 如果storage.type的值是aws，则启用AwsStorageService。
@ConditionalOnProperty(value = "storage.type", havingValue = "aliyun")：
- 如果storage.type的值是aliyun，则启用AliyunStorageService。