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

相关文章

Jsoncpp的安装与使用方式

《Jsoncpp的安装与使用方式》JsonCpp是一个用于解析和生成JSON数据的C++库,它支持解析JSON文件或字符串到C++对象,以及将C++对象序列化回JSON格式,安装JsonCpp可以通过... 目录安装jsoncppJsoncpp的使用Value类构造函数检测保存的数据类型提取数据对json数

Redis事务与数据持久化方式

《Redis事务与数据持久化方式》该文档主要介绍了Redis事务和持久化机制,事务通过将多个命令打包执行,而持久化则通过快照(RDB)和追加式文件(AOF)两种方式将内存数据保存到磁盘,以防止数据丢失... 目录一、Redis 事务1.1 事务本质1.2 数据库事务与redis事务1.2.1 数据库事务1.

Linux磁盘分区、格式化和挂载方式

《Linux磁盘分区、格式化和挂载方式》本文详细介绍了Linux系统中磁盘分区、格式化和挂载的基本操作步骤和命令,包括MBR和GPT分区表的区别、fdisk和gdisk命令的使用、常见的文件系统格式以... 目录一、磁盘分区表分类二、fdisk命令创建分区1、交互式的命令2、分区主分区3、创建扩展分区,然后

Linux中chmod权限设置方式

《Linux中chmod权限设置方式》本文介绍了Linux系统中文件和目录权限的设置方法,包括chmod、chown和chgrp命令的使用,以及权限模式和符号模式的详细说明,通过这些命令,用户可以灵活... 目录设置基本权限命令:chmod1、权限介绍2、chmod命令常见用法和示例3、文件权限详解4、ch

Java中的密码加密方式

《Java中的密码加密方式》文章介绍了Java中使用MD5算法对密码进行加密的方法,以及如何通过加盐和多重加密来提高密码的安全性,MD5是一种不可逆的哈希算法,适合用于存储密码,因为其输出的摘要长度固... 目录Java的密码加密方式密码加密一般的应用方式是总结Java的密码加密方式密码加密【这里采用的

Java中ArrayList的8种浅拷贝方式示例代码

《Java中ArrayList的8种浅拷贝方式示例代码》:本文主要介绍Java中ArrayList的8种浅拷贝方式的相关资料,讲解了Java中ArrayList的浅拷贝概念,并详细分享了八种实现浅... 目录引言什么是浅拷贝?ArrayList 浅拷贝的重要性方法一:使用构造函数方法二:使用 addAll(

Mycat搭建分库分表方式

《Mycat搭建分库分表方式》文章介绍了如何使用分库分表架构来解决单表数据量过大带来的性能和存储容量限制的问题,通过在一对主从复制节点上配置数据源,并使用分片算法将数据分配到不同的数据库表中,可以有效... 目录分库分表解决的问题分库分表架构添加数据验证结果 总结分库分表解决的问题单表数据量过大带来的性能

SpringBoot项目引入token设置方式

《SpringBoot项目引入token设置方式》本文详细介绍了JWT(JSONWebToken)的基本概念、结构、应用场景以及工作原理,通过动手实践,展示了如何在SpringBoot项目中实现JWT... 目录一. 先了解熟悉JWT(jsON Web Token)1. JSON Web Token是什么鬼

在C#中合并和解析相对路径方式

《在C#中合并和解析相对路径方式》Path类提供了几个用于操作文件路径的静态方法,其中包括Combine方法和GetFullPath方法,Combine方法将两个路径合并在一起,但不会解析包含相对元素... 目录C#合并和解析相对路径System.IO.Path类幸运的是总结C#合并和解析相对路径对于 C

C语言线程池的常见实现方式详解

《C语言线程池的常见实现方式详解》本文介绍了如何使用C语言实现一个基本的线程池,线程池的实现包括工作线程、任务队列、任务调度、线程池的初始化、任务添加、销毁等步骤,感兴趣的朋友跟随小编一起看看吧... 目录1. 线程池的基本结构2. 线程池的实现步骤3. 线程池的核心数据结构4. 线程池的详细实现4.1 初