Spring(尤其是 Spring Boot)提供了多種方式來讓容器創建和管理 Bean。@Component
、@Configuration
+ @Bean
、@EnableConfigurationProperties
都是常見方式。
下面我為你系統地梳理 Spring 創建 Bean 的所有主要方式,并說明它們的使用場景和區別。
? 一、Spring 創建 Bean 的 8 種主要方式
方式 | 注解/方法 | 適用場景 |
---|---|---|
1 | @Component 及其衍生注解 | 掃描普通類為 Bean |
2 | @Configuration + @Bean | 手動配置第三方類或復雜對象 |
3 | @EnableConfigurationProperties + @ConfigurationProperties | 將配置文件映射為 Bean |
4 | @Import | 導入配置類或直接注冊 Bean |
5 | 實現 FactoryBean<T> | 創建復雜或條件性對象 |
6 | 使用 @Conditional 系列注解 | 條件化注冊 Bean |
7 | 編程式注冊:BeanDefinitionRegistryPostProcessor | 動態注冊 Bean(高級) |
8 | XML 配置(傳統方式) | 老項目兼容 |
1. @Component
及其衍生注解(最常用)
@Component
@Service
@Repository
@Controller
@RestController
@Configuration // @Configuration 也是 @Component
- 原理:配合
@ComponentScan
,Spring 會掃描這些類并注冊為 Bean。 - 適用:你自己寫的業務類(Service、DAO、Controller 等)。
@Service
public class UserService {public void save() { ... }
}
? 自動注冊為
userService
Bean。
2. @Configuration
+ @Bean
(手動注冊)
用于注冊不能加 @Component
的類(如第三方庫的類)。
@Configuration
public class RedisConfig {@Beanpublic RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {RedisTemplate<String, Object> template = new RedisTemplate<>();template.setConnectionFactory(factory);return template;}
}
- 適用:數據源、RedisTemplate、RabbitMQ、RocketMQ、OkHttp、HttpClient 等第三方組件。
3. @EnableConfigurationProperties
+ @ConfigurationProperties
將 application.yml
中的配置自動綁定為 Bean。
app:title: MyAppversion: 1.0.0
@Component
@ConfigurationProperties(prefix = "app")
public class AppProperties {private String title;private String version;// getter/setter
}
@Configuration
@EnableConfigurationProperties(AppProperties.class)
public class AppConfig {
}
?
AppProperties
會被 Spring 創建并注入配置值,且可被@Autowired
。
💡 在 Spring Boot 2.2+ 中,
@EnableConfigurationProperties
通常可以省略,只要類加了@ConfigurationProperties
并被掃描到即可。
4. @Import
(導入配置類或直接注冊)
三種用法:
(1) 導入 @Configuration
類
@Import(DatabaseConfig.class)
@SpringBootApplication
public class Application { }
(2) 導入 @Component
類
@Import(UserService.class)
(3) 導入 ImportSelector
或 ImportBeanDefinitionRegistrar
@Import(MyImportSelector.class)
public class Application { }public class MyImportSelector implements ImportSelector {@Overridepublic String[] selectImports(AnnotationMetadata importingClassMetadata) {return new String[]{MyService.class.getName()};}
}
? 用于實現“條件導入”、“SPI 擴展”等高級功能。
5. 實現 FactoryBean<T>
(創建復雜對象)
當你需要復雜的創建邏輯時使用。
public class MyFactoryBean implements FactoryBean<MyService> {@Overridepublic MyService getObject() throws Exception {MyService service = new MyService();service.init(); // 復雜初始化return service;}@Overridepublic Class<?> getObjectType() {return MyService.class;}@Overridepublic boolean isSingleton() {return true;}
}
@Component
public class MyFactoryBean { } // Spring 會調用 getObject() 創建 MyService Bean
? 適合創建代理對象、動態對象、SPI 實現等。
6. @Conditional
系列注解(條件化注冊)
只有滿足條件時才創建 Bean。
@Bean
@ConditionalOnMissingBean(DataSource.class)
public DataSource dataSource() {return new HikariDataSource();
}
常見條件注解:
注解 | 說明 |
---|---|
@ConditionalOnClass | 類路徑存在某個類 |
@ConditionalOnMissingBean | 容器中沒有某個 Bean |
@ConditionalOnProperty | 配置文件中有某個屬性 |
@ConditionalOnWebApplication | 是 Web 應用 |
@ConditionalOnExpression | SpEL 表達式為 true |
? 這是 Spring Boot 自動配置的核心機制。
7. 編程式注冊:BeanDefinitionRegistryPostProcessor
最強大、最靈活的方式,可以在容器啟動時動態注冊 Bean。
@Component
public class DynamicBeanRegistrar implements BeanDefinitionRegistryPostProcessor {@Overridepublic void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {BeanDefinitionBuilder builder = BeanDefinitionBuilder.rootBeanDefinition(UserService.class);AbstractBeanDefinition definition = builder.getBeanDefinition();registry.registerBeanDefinition("userService", definition);}@Overridepublic void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {// do nothing}
}
? 適合插件化、動態加載、AOP 增強等場景。
8. XML 配置(傳統方式)
<bean id="userService" class="com.example.UserService"/>
ApplicationContext context = new ClassPathXmlApplicationContext("beans.xml");
? 現在已不推薦,但在老項目中仍可見。
? 總結對比
方式 | 何時使用 | 推薦度 |
---|---|---|
@Component | 自己寫的類 | ????? |
@Configuration + @Bean | 第三方類、復雜配置 | ????? |
@ConfigurationProperties | 配置文件映射 | ???? |
@Import | 模塊化導入 | ??? |
FactoryBean | 復雜對象創建 | ??? |
@Conditional | 條件注冊 | ????(自動配置核心) |
BeanDefinitionRegistryPostProcessor | 動態注冊 | ??(高級) |
XML | 老項目 | ? |
? 最佳實踐建議
- 優先使用
@Component
和@Bean
,簡單直接; - 配置參數用
@ConfigurationProperties
,類型安全; - 避免重復注冊,善用
@ConditionalOnMissingBean
; - 復雜邏輯用
@Import
或FactoryBean
; - 動態場景用
BeanDefinitionRegistryPostProcessor
(謹慎使用)。