Spring6框架中依赖注入的多种方式(推荐构造器注入)

2024-05-26 21:52

本文主要是介绍Spring6框架中依赖注入的多种方式(推荐构造器注入),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

你好,这里是codetrend专栏“Spring6全攻略”。

一个典型的企业应用程序不是由单个对象(或在Spring术语中称为bean)组成的。

即使是最简单的应用程序也有一些对象一起工作,呈现给最终用户看到的内容形成一个连贯的应用程序。

要实现多个bean的连贯工作,这里就要使用到Spring的核心技术:依赖注入(DI)。

依赖注入(DI)是一种过程,对象通过构造函数参数、工厂方法的参数或在对象实例构建后设置的属性来定义它们的依赖关系(即与其一起工作的其他对象)。

容器在创建bean时注入这些依赖关系。这个过程基本上是bean本身不再通过直接构造类或使用Service Locator模式控制其依赖项的实例化或位置,因此被称为控制反转(Inversion of Control)。

遵循DI原则的代码更加清晰,对象提供其依赖关系时解耦更有效。

该对象不会查找其依赖项,也不知道依赖项的位置或类别。

因此类变得更易于测试,特别是当依赖项是接口或抽象基类时,可以在单元测试中使用存根或模拟实现。

依赖注入有两种主要变体:基于构造函数的依赖注入和基于Setter的依赖注入。

基于构造函数的依赖注入

基于构造函数的依赖注入是Spring6中的一种依赖注入策略,主要用于确保在对象创建时其必需依赖已经得到初始化。

在构造函数注入中,对象的依赖关系明确地通过构造函数的参数传递给对象。

这意味着在实例化一个类时,Spring IoC容器会分析构造函数签名中的参数类型,然后从容器中查找并提供相匹配的bean作为依赖注入的目标对象。

下面的代码是一个完整的示例,展示了基于构造函数的依赖注入:

import lombok.extern.slf4j.Slf4j;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;import java.util.Arrays;
import java.util.List;/*** 基于构造函数的依赖注入* @author nine* @since 1.0*/
public class ConstructorDIDemo {public static void main(String[] args) {// 创建一个基于 Java Config 的应用上下文ApplicationContext context = new AnnotationConfigApplicationContext(ConstructorAppConfig.class);// 从上下文中获取名bean,其类型为PetStoreServiceSimpleMovieLister bean = context.getBean(SimpleMovieLister.class);// 调用获取的bean的方法bean.listMovies();}
}/*** App配置*/
@Configuration
class ConstructorAppConfig{@Beanpublic MovieFinder movieFinder() {return new MovieFinder();}@Beanpublic SimpleMovieLister simpleMovieLister(MovieFinder movieFinder) {return new SimpleMovieLister(movieFinder);}
}/*** 服务代码*/
@Slf4j
class SimpleMovieLister {private final MovieFinder movieFinder;public SimpleMovieLister(MovieFinder movieFinder) {this.movieFinder = movieFinder;}public void listMovies() {log.info("电影列表打印中");movieFinder.findMovies().forEach(log::info);}
}
@Slf4j
class MovieFinder {public List<String> findMovies() {return Arrays.asList("电影1", "电影2", "电影3");}
}

在Spring配置文件或Java配置类中,容器会根据构造函数参数类型找到符合条件的bean,并自动调用带有适当参数的构造函数来实例化SimpleMovieLister。这种方式的优势在于:

  1. 确保对象实例化时就有所有的必需依赖项,增强了对象状态的完整性。
  2. 由于构造函数私有的强制性依赖无法为null,提高了代码健壮性。
  3. 有利于实现不可变对象,也就是在属性上面加了final修饰符,提升多线程环境下对象的安全性。
  4. 使得依赖关系清晰可见,利于阅读和理解代码。

Spring6推荐优先使用构造函数注入,尤其是对于必需的、不可缺失的依赖。而对于可选依赖或易于变更的配置属性,则更适合使用setter方法注入。

基于Setter的依赖注入

基于Setter方法的依赖注入是Spring6框架中另一种常用的依赖注入策略。

它允许在对象实例化之后通过调用setter方法来设置依赖关系。

这种方法允许对象在构造完成后继续接受依赖注入,这在依赖不是必须的情况下特别有用,因为对象可以先创建一个默认状态,然后再通过setter方法补充注入依赖。

把构造函数注入修改为如下代码,这是一个完整的示例,展示了基于Setter的依赖注入:

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;/*** 基于Setter的依赖注入* @author nine* @since 1.0*/
public class SetterDIDemo {public static void main(String[] args) {// 创建一个基于 Java Config 的应用上下文ApplicationContext context = new AnnotationConfigApplicationContext(SetterAppConfig.class);// 从上下文中获取名bean,其类型为PetStoreServiceSimpleMovieListerSet bean = context.getBean(SimpleMovieListerSet.class);// 调用获取的bean的方法bean.listMovies();}
}/*** App配置*/
@Configuration
class SetterAppConfig{@Beanpublic MovieFinder movieFinder() {return new MovieFinder();}@Beanpublic SimpleMovieListerSet simpleMovieLister() {return new SimpleMovieListerSet();}
}@Slf4j
class SimpleMovieListerSet {private MovieFinder movieFinder;@Autowiredpublic void setMovieFinder(MovieFinder movieFinder) {this.movieFinder = movieFinder;}public void listMovies() {log.info("电影列表打印中");movieFinder.findMovies().forEach(log::info);}
}

在这种情况下,Spring容器会在创建完SimpleMovieListerSet实例后,查找类型匹配的MovieFinder bean,并调用setMovieFinder()方法将其注入。

setter注入的优点包括:

  1. 可以延迟注入可选依赖,允许类在没有所有依赖的情况下也能创建实例。
  2. 更容易适应配置变化,因为可以在运行时重新配置或替换已注入的依赖项。
  3. 有时候对于第三方类库或不能更改源代码的情况,如果只能通过setter暴露依赖,则setter注入可能是唯一可行的DI方式。

然而,相比于构造函数注入,setter注入的一个潜在缺点是可能导致对象在未完全初始化时就被使用,增加了代码理解和维护的难度,以及可能引入运行时错误的风险。

其它依赖注入方式

  • 属性注入(Field Injection)

属性注入是指直接在类的成员变量上使用@Autowired@Inject注解来声明依赖。Spring容器会在bean初始化时自动为这些字段赋值。例如:

public class UserService {@Autowiredprivate UserRepository userRepository;// ...
}
  • 方法注入(Method Injection)

方法注入允许在非构造函数的方法中注入依赖。这包括像Spring Test框架中测试方法的参数注入,以及在方法级别处理依赖,如Spring的@PostConstruct@PreDestroy生命周期回调方法。例如:

@Component
public class MyService {private SomeDependency someDependency;@Autowiredpublic void init(SomeDependency someDependency) {this.someDependency = someDependency;}// ...
}
  • 注解驱动的配置(Annotation-based Configuration)

使用@Configuration@Bean等注解编写Java配置类,以声明式的方式来定义bean及其依赖关系。例如:

@Configuration
public class AppConfig {@Beanpublic UserService userService(UserRepository userRepository) {return new UserService(userRepository);}@Beanpublic UserRepository userRepository() {return new UserRepositoryImpl();}
}
  • JSR-330注解(Java Dependency Injection)

Spring同时支持JSR-330规范中的注解,如@javax.inject.Inject,可以用它代替Spring的@Autowired来实现依赖注入。

Dependency Resolution Process 依赖注入解析过程

Spring框架中的依赖注入解析过程主要包括以下几个步骤:

配置元数据加载

  • 应用程序启动时,Spring IoC容器首先读取和解析配置元数据,这些元数据可以来自于XML配置文件、Java配置类(通过@Configuration注解)或组件类上的注解(如@Component@Service@Repository@Controller等)。

Bean定义注册

  • 容器根据配置元数据创建Bean Definition对象,这些对象包含了如何创建Bean的全部信息,如Bean的类型(类)、构造器参数、属性值、依赖关系和其他生命周期回调方法等。

依赖解析

  • 当Spring容器创建一个Bean时,它会查看Bean Definition中关于依赖的描述。如果是构造器注入,容器会识别并获取构造器参数所需的Bean,通过调用构造器来注入依赖。
  • 如果是Setter注入,容器会在Bean实例化后遍历其setter方法,找到那些带有@Autowired或其他相关注解的setter方法,然后查找并注入相应的依赖Bean。
  • 若是字段注入,容器则会直接找到类中带有@Autowired等注解的字段,为它们注入合适的Bean。

依赖注入

  • 容器根据Bean定义中定义的依赖关系,从IoC容器中查找或创建需要注入的Bean,并将这些依赖注入到目标Bean中。
  • 注入过程中,容器会解决依赖的循环引用问题,保证依赖链的完整性,并可以处理多种作用域的Bean之间的依赖关系。

Bean生命周期管理

  • 容器除了注入依赖外,还会执行Bean生命周期的相关回调方法,如@PostConstruct@PreDestroy等,以确保Bean在初始化和销毁时能正确执行相应操作。

整个过程体现了控制反转(IoC)的原则,Spring容器扮演了协调者角色,负责创建、装配和管理应用程序中的所有对象,使得对象之间相互解耦,提高了代码的可测试性和可维护性。

整个过程都包含在 BeanFactory 中,这里的代码示例就是这行代码 ApplicationContext context = new AnnotationConfigApplicationContext(SetterAppConfig.class);

// 构造函数分为3个步骤
public AnnotationConfigApplicationContext(Class<?>... componentClasses) {this();register(componentClasses);refresh();
}
//在this()初始化Spring相关的工具库,一个reader和一个scanner
public AnnotationConfigApplicationContext() {StartupStep createAnnotatedBeanDefReader = getApplicationStartup().start("spring.context.annotated-bean-reader.create");this.reader = new AnnotatedBeanDefinitionReader(this);createAnnotatedBeanDefReader.end();this.scanner = new ClassPathBeanDefinitionScanner(this);
}
// register(componentClasses); 是代码的核心,注册配置类里面的相关信息,主要调用了私有方法doRegisterBean

doRegisterBean的核心代码如下:

// 1. 加载配置元数据
// 此方法负责将给定的类转换为AnnotatedGenericBeanDefinition,从而提取类上的元数据信息
private <T> void doRegisterBean(Class<T> beanClass, @Nullable String name,@Nullable Class<? extends Annotation>[] qualifiers, @Nullable Supplier<T> supplier,@Nullable BeanDefinitionCustomizer[] customizers) {// 创建一个基于给定类的AnnotatedGenericBeanDefinition对象AnnotatedGenericBeanDefinition abd = new AnnotatedGenericBeanDefinition(beanClass);// 2. 判断是否需要跳过此Bean的注册(条件评估)if (this.conditionEvaluator.shouldSkip(abd.getMetadata())) {return;}// 标记候选Bean属性abd.setAttribute(ConfigurationClassUtils.CANDIDATE_ATTRIBUTE, Boolean.TRUE);// 设置实例供应商,用于懒加载或延迟初始化abd.setInstanceSupplier(supplier);// 3. 解析作用域元数据并设置Bean的作用域ScopeMetadata scopeMetadata = this.scopeMetadataResolver.resolveScopeMetadata(abd);abd.setScope(scopeMetadata.getScopeName());// 生成或使用指定的Bean名称String beanName = (name != null ? name : this.beanNameGenerator.generateBeanName(abd, this.registry));// 处理通用定义注解(如@Component, @Service等)AnnotationConfigUtils.processCommonDefinitionAnnotations(abd);// 处理限定符注解(如@Primary, @Lazy等)if (qualifiers != null) {for (Class<? extends Annotation> qualifier : qualifiers) {if (Primary.class == qualifier) {abd.setPrimary(true); // 设置为主Bean} else if (Lazy.class == qualifier) {abd.setLazyInit(true); // 设置为懒加载} else {abd.addQualifier(new AutowireCandidateQualifier(qualifier)); // 添加自定义限定符}}}// 4. 应用自定义Bean定义配置if (customizers != null) {for (BeanDefinitionCustomizer customizer : customizers) {customizer.customize(abd); // 根据用户提供的定制器调整Bean定义}}// 创建BeanDefinitionHolder对象,封装了最终的Bean定义和名称BeanDefinitionHolder definitionHolder = new BeanDefinitionHolder(abd, beanName);// 根据作用域元数据应用代理模式(如果需要)definitionHolder = AnnotationConfigUtils.applyScopedProxyMode(scopeMetadata, definitionHolder, this.registry);// 5. 注册Bean定义到BeanDefinitionRegistry中BeanDefinitionReaderUtils.registerBeanDefinition(definitionHolder, this.registry);
}

doRegisterBean主要执行以下逻辑:

  1. 配置元数据加载:从给定的类beanClass中提取元数据,并封装成AnnotatedGenericBeanDefinition对象。
  2. Bean定义注册前的准备工作:判断Bean是否满足注册条件,设置候选属性、作用域元数据和Bean名称,处理通用定义注解和限定符注解,以及应用用户自定义的Bean定义配置。
  3. 依赖解析和注入:这部分主要是通过设置作用域、限定符和自定义配置来预备Bean的依赖解析和注入过程,但具体的依赖注入发生在后续的Bean实例化阶段。在这里,Bean定义已经被完善并准备注册到BeanDefinitionRegistry中,后续容器在初始化Bean时会根据这些定义信息完成依赖注入。

关于作者

来自全栈程序员nine的探索与实践,持续迭代中。

欢迎关注或者点个小红心~

这篇关于Spring6框架中依赖注入的多种方式(推荐构造器注入)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1005689

相关文章

Debezium 与 Apache Kafka 的集成方式步骤详解

《Debezium与ApacheKafka的集成方式步骤详解》本文详细介绍了如何将Debezium与ApacheKafka集成,包括集成概述、步骤、注意事项等,通过KafkaConnect,D... 目录一、集成概述二、集成步骤1. 准备 Kafka 环境2. 配置 Kafka Connect3. 安装 D

Springboot中分析SQL性能的两种方式详解

《Springboot中分析SQL性能的两种方式详解》文章介绍了SQL性能分析的两种方式:MyBatis-Plus性能分析插件和p6spy框架,MyBatis-Plus插件配置简单,适用于开发和测试环... 目录SQL性能分析的两种方式:功能介绍实现方式:实现步骤:SQL性能分析的两种方式:功能介绍记录

SQL 中多表查询的常见连接方式详解

《SQL中多表查询的常见连接方式详解》本文介绍SQL中多表查询的常见连接方式,包括内连接(INNERJOIN)、左连接(LEFTJOIN)、右连接(RIGHTJOIN)、全外连接(FULLOUTER... 目录一、连接类型图表(ASCII 形式)二、前置代码(创建示例表)三、连接方式代码示例1. 内连接(I

Android里面的Service种类以及启动方式

《Android里面的Service种类以及启动方式》Android中的Service分为前台服务和后台服务,前台服务需要亮身份牌并显示通知,后台服务则有启动方式选择,包括startService和b... 目录一句话总结:一、Service 的两种类型:1. 前台服务(必须亮身份牌)2. 后台服务(偷偷干

Java深度学习库DJL实现Python的NumPy方式

《Java深度学习库DJL实现Python的NumPy方式》本文介绍了DJL库的背景和基本功能,包括NDArray的创建、数学运算、数据获取和设置等,同时,还展示了如何使用NDArray进行数据预处理... 目录1 NDArray 的背景介绍1.1 架构2 JavaDJL使用2.1 安装DJL2.2 基本操

最长公共子序列问题的深度分析与Java实现方式

《最长公共子序列问题的深度分析与Java实现方式》本文详细介绍了最长公共子序列(LCS)问题,包括其概念、暴力解法、动态规划解法,并提供了Java代码实现,暴力解法虽然简单,但在大数据处理中效率较低,... 目录最长公共子序列问题概述问题理解与示例分析暴力解法思路与示例代码动态规划解法DP 表的构建与意义动

Spring AI Alibaba接入大模型时的依赖问题小结

《SpringAIAlibaba接入大模型时的依赖问题小结》文章介绍了如何在pom.xml文件中配置SpringAIAlibaba依赖,并提供了一个示例pom.xml文件,同时,建议将Maven仓... 目录(一)pom.XML文件:(二)application.yml配置文件(一)pom.xml文件:首

JS 实现复制到剪贴板的几种方式小结

《JS实现复制到剪贴板的几种方式小结》本文主要介绍了JS实现复制到剪贴板的几种方式小结,包括ClipboardAPI和document.execCommand这两种方法,具有一定的参考价值,感兴趣的... 目录一、Clipboard API相关属性方法二、document.execCommand优点:缺点:

Python创建Excel的4种方式小结

《Python创建Excel的4种方式小结》这篇文章主要为大家详细介绍了Python中创建Excel的4种常见方式,文中的示例代码简洁易懂,具有一定的参考价值,感兴趣的小伙伴可以学习一下... 目录库的安装代码1——pandas代码2——openpyxl代码3——xlsxwriterwww.cppcns.c

Deepseek使用指南与提问优化策略方式

《Deepseek使用指南与提问优化策略方式》本文介绍了DeepSeek语义搜索引擎的核心功能、集成方法及优化提问策略,通过自然语言处理和机器学习提供精准搜索结果,适用于智能客服、知识库检索等领域... 目录序言1. DeepSeek 概述2. DeepSeek 的集成与使用2.1 DeepSeek API