SpringBootStarter技术:生产就绪与环境配置、实现自定义Starter

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介: Spring Boot能够迅速地在微服务开发领域流行起来,并影响众多Spring和Java开发社区开发人员,可以说主要原因有两个。

Spring Boot Starter技术


Spring Boot Starter概述


Spring Boot能够迅速地在微服务开发领域流行起来,并影响众多Spring和Java开发社区开发人员,可以说主要原因有两个。

  • 一 是 Spring 的 约 定 优 于 配 置 的 特 性 ( Convention OverConfiguration),这个特性的关键实现机制就是自动装配机制。同时这一特性很好地遵循了简约开发原则,它不仅减少了软件开发人员的开发工作量和需要做的决定数量,获得简单易用的收益,而且方便扩展又不失灵活性。从Spring到Spring Boot,从Ant到Maven,本质上都践行了约定优于配置的原则。
  • 二是Spring Boot基于“Spring Boot Starter技术”,即开箱即用的自动配置模块。在传统Spring应用系统中,我们需要完成众多的烦琐配置和多个jar包的手动引入及代码的初始化工作,才能将所需要的模块引入工程中。而Spring BootStarter的出现,简化了我们的配置,更重要的是将我们带入一种“可插拔”的编程模式。我们只需要在Maven中引入对应的现成Starter依赖,在代码中添加必要的注解,就可以获得开箱即用的对应功能。同时,我们可以结合Spring Boot的自动配置机制,实现自定义Starter组件,从而成为一个自包含的组件和模块,供第三方使用。

从Starter的命名方式我们可以区分出两类Starter。

  • Spring 官 方 Starter : 命 名 应 遵 循 spring-boot-starter-{name} 的 格 式 , 如 spring-boot-starter-web 作 为 SpringBoot Web模块的官方artifactId。
  • Spring 非 官 方 Starter : 命 名 应 遵 循 {name}-spring-boot�starter的格式,如
    mybatis-spring-boot-starter。本章中介绍的自定义Starter属于后者。


Spring官方Starter


对于Spring官方Starter,只需在pom.xml配置文件中增加对于Starter的依赖,这个Starter就能够通过代码配置上下文发现并将所需要jar包进行关联,在自动配置类中可以通过@ConditionalOnClass来决定是否实例化(ConditionalOnClass是指在classpath发现需要的依赖的类时实例化)。

所有的Starter其实都是要通过代码配置被上下文发现的,可以在

spring-boot-autoconfigure-xxx.jar源码包中查看,例如下图所示,我们可以看到Spring Boot自带的Starter实现。

image.png

对 于 Spring Boot 内 置 Web 容 器 来 说 , 只 要 通 过@ConditionalOnClass 发 现 了 Tomcat 这 个 类 ( 配 置 了 spring-boot�starter-web的Maven依赖),Spring Boot就会自动检查项目依赖并启动Tomcat服务,如下代码所示:

image.png

image.png


Spring非官方Starter


原理上基本与官方Starter一致,需要在已经实现的artifactId上再封装一层,这一层只负责包含具体的实现类和配置类,而这个Starter的pom.xml文件相当于一个Facade门面,代码如下:

image.png

进入pom.xml文件,可以发现自包含的依赖关系,代码如下:

image.png

SpringBootStarter技术:生产就绪与环境配置、实现自定义Starter

image.png

在 这 个 pom.xml 文 件 中 , 我 们 发 现 了 mybatis-spring-boot�autoconfigure 自 动 配 置 类 , 通 过 它 我 们 可 以 完 成 MyBatis 配 置JavaConfig的自动配置工作和MyBatis实例化配置。它的配置类代码如下:

image.png

通过MybatisAutoConfiguration自动化配置类,就实现了MyBatis的配置在启动时被Spring Boot程序加载到Spring Boot的Factory工厂并实例化为Bean。


Spring Boot常用开箱即用Starter


开箱即用的Starter组件也遵循Spring约定优于配置的理念,针对企业日常应用开发场景,通过引入这些现成的Starter可以简化开发流程。


spring-boot-starter-web快速开发


除了开发少数的独立应用,大部分情况下,我们都使用SpringMVC组件开发企业Web应用,为了帮助我们快速搭建并开发一个Web项目,Spring Boot提供了spring-boot-starter-web自动配置模块,只要将spring-boot-starter-web加入项目的Maven依赖即可:

image.png

在我们的工程中加入上面的Starter依赖后,就得到了一个可直接执行的Web应用环境,在当前项目下运行mvn spring-boot:run,可以直接启动一个使用了嵌入式Tomcat服务请求的Web应用服务。目前我们还没有提供任何Web请求的Controller,所以访问任何路径都会返回一个Spring Boot默认提供的错误页面,我们可以在当前项目下新建一个服务根路径作为Web请求的Controller实现,如下代码所示:

image.png


spring-boot-starter-jdbc与数据访问


为了使Spring Boot成为我们自动配置数据访问的基础设施,我们需要直接或者间接地依赖spring-jdbc,当spring-jdbc位于SpringBoot应用的classpath路径时,会触发数据访问相关的自动配置行为。

最简单的做法就是把spring-boot-starter-jdbc添到应用的依赖文件中。默认情况下,如果我们没有配置任何DataSource,那么SpringBoot会为我们自动配置一个基于嵌入式数据库的DataSource,这种自动配置行为其实很适合于测试场景,但对实际的开发帮助不大,基本上我们会自己配置一个DataSource实例。下面我们将spring-boot�starter-jdbc加入项目的Maven依赖:

image.png

如果我们的工程只依赖一个数据库,那么使用DataSource自动配置模块提供的参数是最方便的。在本书的7.1.4节中,我们会对“使用spring-boot-starter-jdbc访问MySQL”进行详细讲解。


spring-boot-starter-aop及其使用场景


在Java语言中,AOP(Aspect Oriented Programming,面向切面编程)通过提供另一种思考程序结构的方式来补充OOP(ObjectOriented Programming,面向对象编程)。OOP中模块化的关键单元是类。而在AOP中,模块化单元由“切面”组成。通过预编译方式和运行期动态代理实现程序功能的统一维护。AOP是Spring框架的一个重要特色,它可对既有程序定义一个切入点(Pointcut),然后在切入点前后切入不同的执行任务。常见使用场景有:打开/关闭数据库连接、打开/关闭事务、记录日志等。基于AOP不会破坏原来的程序逻辑,因此它可以很好地对业务逻辑的各个部分进行抽离,从而使得业务逻辑各个部分的耦合度降低,提高程序的复用性,同时提高开发效率。

Spring Boot对AOP提供了Starter组件支持,Maven依赖如下:

image.png

spring-boot-starter-aop主要由两部分组成:

  • org.springframework.boot.autoconfigure.aop.AopAutoConfiguration:提供配置类。
  • 通知:配置类中涉及的通知类型有前置通知、后置最终通知、后置返回通知、后置异常通知和环绕通知。

下面是一个实现了Web Controller调用的日志切面打印Web请求参数及相应结果的实例。

image.png

image.png

注解解释如下:

  • 使用@Aspect注解将一个Java类定义为切面类。
  • 使用@Pointcut定义一个切入点完成切面功能,根据对应参数执行不同的逻辑:

○ 任意公共方法的执行:

image.png

○ 任何一个以“set”开始的方法的执行:

image.png

○ AccountService接口的任意方法的执行:

image.png

○ 定义在service包里的任意方法的执行:

image.png

○ 定义在service包和所有子包里的任意类的任意方法的执行:

image.png

○ 定义在pointcutexp包和所有子包里的JoinPointObjP2类的任意方法的执行:

image.png

注意:根据需要,可在切入点的不同位置切入内容。

  • 使用@Before在切入点开始处切入内容。
  • 使用@After在切入点结尾处切入内容。
  • 使用@AfterReturning在切入点return内容之后切入内容。
  • 使用@Around在入点前后切入内容,并自己控制何时执行切入点自身的内容。
  • 使用@AfterThrowing处理当切入内容部分抛出异常之后的逻辑。

spring-boot-starter-logging日志功能

常见的日志系统大致有Java.util.logging、Log4J、Commons�logging等,

spring-boot-starter-logging是Spring Boot为日志功能提供的一种默认实现。Maven依赖如下:

image.png

Spring Boot能够使用Logback、Log4J2、java util logging作为日志记录工具,默认使用Logback。日志默认输出到控制台,也能输出到文件中。如果想改变Spring Boot提供的应用日志设定,可以:

  • 遵 循 Logback 的 约 定 , 在 classpath 中 使 用 自 己 定 制 的logback.XML配置文件。
  • 在文件系统的任意一个位置提供自己的logback.xml配置文件,然后通过logging.config配置项指向这个配置文件,再引用它。

spring-boot-starter-security与应用安全

spring-boot-starter-security主要面向的是Web应用开发,对应的Maven依赖如下:

image.png

spring-boot-starter-security默认会提供一个基于HTTP Basic认证的安全防护策略,默认用户为user,访问密码则在当前Web应用启动的时候打印到控制台。要想定制,则在配置文件中进行配置。


Spring Boot生产就绪与环境配置


Spring Boot自带的spring-boot-actuator模块提供的生产就绪(production-ready)特性与运行状况指标检查功能,可以帮助你深入掌握运行中的Spring Boot应用程序,一探Spring Boot程序的内部信息。


Actuator


Actuator指用于移动或控制某物的机械装置的制造业术语,Actuator可以从一个小的变化产生大量的运动。

要将Actuator添加到基于Maven的项目中开启Spring Boot的生产就绪特性,请加载以下依赖项:

image.png

spring-boot-actuator 自 动 配 置 模 块 默 认 为 我 们 提 供 了 很 多Endpoint,根据Spring的官方定义,Endpoint的解释如下。


Endpoint


Endpoint是执行器端点,可用于监控应用及与应用进行交互,Spring Boot包含很多内置的端点,你也可以自己添加。例如,health端点提供了应用的基本健康信息。

Endpoint分成两类:原生端点和自定义端点。自定义端点主要是指扩展性端点,用户可以根据自己的实际应用,定义一些自己比较关心的指标,在运行期进行监控。如下表所示是Endpoint使用ID标识的方式定义的可用监控对象(原生端点)。

image.png

如果你的应用是一个Web应用(Spring MVC、Spring WebFlux或Jersey),你还可以使用如下表所示的Endpoint。

image.png

Actuator的原生API有很多,大体上可以细分为以下三类。

  • 应用配置类:应用配置、环境变量、自动化配置等。

image.png

  • 度量指标类:运行时监控到的指标,如内存、线程池、HTTP统计信息等。

image.png

  • 操作控制类:如关闭应用等操作类。

image.png


启用/禁止端点规则


  • 默认情况下,除shutdown外的所有端点均已启用。要启用单个端点,可使用management.endpoint..enabled属性。以下示例启用shutdown端点:

image.png

  • 可以通过
    management.endpoints.enabled-by-default来修改端点的默认配置,以下示例启用info端点并禁用所有其他端点:

image.png

  • 禁用的端点将从应用程序上下文中完全被删除。如果只想更改端点公开(对外暴露)特性,可使用include和exclude属性,详情见下表。

image.png

说明:include属性列出了公开的端点的ID,exclude属性列出了不应该公开的端点的ID。exclude属性优先于include属性,意思是指同一端点ID同时出现在include属性表和exclude属性表时,exclude属性优先于include属性,即此端点不被暴露。


Endpoint的两种主要访问方式


要实现端点的访问,Spring Boot为我们提供了两种方式。

  • 基于JMX的监控

Java管理扩展(JMX)提供了一种监视和管理应用程序的标准机制 , 默 认 情 况 下 , Spring Boot 将 管 理 端 点 公 开 为org.springframework.boot 域 中 的 JMX Mbean 。 Actuator 通 过

EndpointMBean-ExportAutoConfiguration将所有Endpoint实例以JMXMbean形式对外监控暴露,并默认注册在org.springframework.boot域下,可以使用Jconsole命令启动Java管理及监控控制台查看端点信息。

也可以使用使用Jolokia(基于JSR-160规范实现的MBean服务)通过HTTP实现JMX远程管理。Jolokia是一个JMX-HTTP桥,它提供了一种访 问 JMX Beans 的 替 代 方 法 。 想 要 使 用 Jolokia , 只 需 添 加org.jolokia:jolokia-core的依赖。例如,使用Maven添加以下配置,然后在HTTP管理服务器上可以通过/jolokia访问Jolokia。

image.png

另外,如果想要禁用JMX端点,可以使用下面的配置方式:

image.png

  • 基于HTTP的监控

如果你正在开发一个Web应用程序,Actuator会自动配置通过HTTP公开的所有已启用的端点,并通过以“management.”为前缀的配置项对端点进行开放。因为HTTP是标准的协议,对于跨语言、跨平台访问有天然的优势,使用HTTP的方式暴露端点信息有利于与其他监控平台和系统进行对接。

Spring Boot执行器自动将所有启用的端点通过HTTP暴露出去。默认约定使用端点的ID作为URL路径,例如,health暴露为/health。如果不想通过HTTP暴露端点,可以将管理端口设置如下:

image.png


保护HTTP端点


在配置文件中设置

management.security.enabled:false,这样所有的用户都可以用Actuator。但是这样的方式可能会暴露服务的敏感信息,并且在默认情况下,Actuator端点暴露在服务于常规HTTP的同一个端口上。如果你的应用程序是公开部署的,你可能希望添加Spring Security来进行用户身份验证。当添加Spring Security时,默认的“basic”身份验证将被启用。

使用HTTP暴露端点的方式与使用任何敏感网址一样,如果你希望为HTTP端点配置自定义安全性,比方说只允许具有特定角色的用户访问它们,Spring Boot提供了一些方便的RequestMatcher对象,可以与Spring Security结合使用,具体方式如下。


1.引入Security的Maven依赖


image.png


2.在配置文件中修改application.yml


image.png


3.定制Spring Security


我们可以在Security中赋予用户不同的权限,Actuator使用这种权限管理来控制用户的行为。Security可以拦截特定的请求:

image.png

image.png


Actuator的版本差异


注意:Spring Boot 2.0以后对Actuator做了很大的改动,主要变化如下:

  • 2.X比1.X多了一个根路径:/actuator。
  • 2.X的属性发生了变化,如下表所示。

image.png

● 部分端点路径发生了变更:

image.png


自定义健康检查器


在介绍自定义健康检查器前,我们先看一下Spring Boot定义的一套健康检查框架,后面我们根据整个框架定制一个健康检查器。对于健康检查器来说,最重要的接口就是HealthIndicator,代码如下:

image.png

image.png

抽象类AbstractHealthIndicator是健康检查类的骨架,实现了health方法,同时声明了doHealthCheck方法。Spring Boot的健康信息都从ApplicationContext中加载各种HealthIndicator实现,主要实现流程如下:

  • 实例化Health$Builder。
  • 调用抽象方法doHealthCheck进行状态的检查,出现异常则状态变为Status.DOWN。
  • 下面是HealthCheck类的具体业务实现类示例:

image.png

你可以通过

management.health.defaults.enabled配置项将健康检查项全部禁用,也可以通过management.health.xxxx.enabled将其中任意一个禁用。如果我们需要提供自定义的健康检查信息状态,可以 通 过 HealthIndicator 的 接 口 来 实 现 , 并 将 该 实 现 类 注 册 为JavaBean。你需要实现其中的health方法,并返回自定义的健康状态响应信息,该响应信息应该包括一个状态码和要展示的详细信息。例如,下面就是一个自定义的HealthIndicator的实现类:

image.png

image.png


Spring Boot安全管理


Spring Security是一款基于Spring的安全框架,主要包含认证和鉴权两大安全模块。Spring Security能够为基于Spring的企业应用系统提供声明式的安全访问控制解决方案。它提供了一组可以在Spring应用上下文中配置的Bean,充分利用了Spring IoC(控制反转)、DI(依赖注入)和AOP(面向切面编程)。Spring Security本身比较复杂,其中包含众多子项目,如Spring Security OAuth、SpringSecurity JWT、Spring Security CAS等,本节将对Spring Security的核心模块及架构原理进行介绍。


Spring Security核心模块


权限系统一般包含两大核心模块:Authentication(认证)和Authorization(鉴权)。

  • Authentication模块负责验证用户身份的合法性,生成认证令牌,并保存到服务端会话中(如TLS)。
  • Authorization模块负责从服务端会话中获取用户身份信息,与访问的资源进行权限比对。

官方给出的Spring Security的核心架构如下图所示。

image.png

核心架构解读如下。

  • Authentication Manager:负责认证管理,解析用户登录信息(封装在Authentication模块中),读取用户、角色、权限信息并进行认证,认证结果被回填到Authentication,保存在Security Context中。
  • AccessDecision Manager:负责投票表决,通过投票器的结果实现一票通过(默认)、多票通过、一票否决策略。
  • Security Interceptor:负责权限拦截,包括Web URL拦截和方法调用拦截。通过Config Attributes获取资源的描述信息,借助AccessDecision Manager进行鉴权拦截。
  • Security Context:安全上下文,保存认证结果。提供了全局上下文、线程继承上下文、线程独立上下文(默认)三种策略。
  • Authentication:认证信息,保存用户的身份标识、权限列表、证书、认证通过标记等信息。
  • Secured Resource:被安全管控的资源,如Web URL、用户、角色、自定义领域对象等。
  • Config Attributes:资源属性配置,描述安全管控资源的信息,为Security Interceptor提供拦截逻辑的输入。

Spring Boot进行集成,需要引入Maven依赖:

image.png

在 Spring Security 的 框 架 设 计 中 , 关 键 是

AbstractSecurityInterceptor类,它是一个抽象类,安全认证流程的具体实现逻辑都贯穿在AbstractSecurityInterceptor类中,可以把AbstractSecurityInterceptor当成为一个模板类,它的实际执行流程都 由 具 体 子 类 所 实 现 , 每 种 受 保 护 资 源 或 者 对 象 都 由AbstractSecurityInterceptor的实现类拦截实现。Spring Security提供了两个具体实现类,Method-SecurityInterceptor用于受保护的方法,FilterSecurityInterceptor用于受保护的Web请求:

public class FilterSecurityInterceptor extends AbstractSecurityInterceptor implements Filter{...}

public class MethodSecurityInterceptor extends

AbstractSecurityInterceptor

implements

Method�

Interceptor{...}

上述两个继承

AbstractSecurityInterceptor的实现类具有一致的执行逻辑:

(1)将正在请求调用的受保护对象传递给beforeInvocation方法进行权限鉴定。

(2)如果权限鉴定失败,则直接抛出异常。

(3)如果鉴定成功,则将尝试调用受保护对象,调用完成后,不管是成功调用,还是抛出异常,都将执行finallyInvocation方法。

( 4 ) 如 果 在 调 用 受 保 护 对 象 后 没 有 抛 出 异 常 , 则 调 用afterInvocation方法。

Spring Security核心源码

Spring Security默认使用的过滤器是FilterSecurityInterceptor,它的认证及鉴权流程和主要源码如下:

image.png

从 源 码 来 看 , AuthenticationManager 负 责 制 定 规 则 ,

AbstractSecurityInterceptor负责执行。并且,Spring Security的Web安全方案基于Java的Servlet规范进行构建,所以如果你的开发框架是脱离Servlet规范实现的Web框架,则无法使用Spring Security提供的默认Web安全方案。在Servlet规范中,实现关卡功能的特性就是Filter组件,Spring框架使用将GenericFilterBean注入Spring容器的方式来让Filter可以享受依赖注入的好处。

WebSecurity 会 初 始 化 FilterChainProxy , 它 通 过 扩 展GenericFilterBean 间 接 实 现 了 Filter 接 口 , 同 时 持 有 一 组SecurityFilterChain,真正执行防护任务的SecurityFilterChain中定义的一系列Filter的代码如下:

image.png

Spring Security为SecurityFilterChain中的Filter设定了优先级顺序。下面的代码是Security的Filter实现逻辑。

image.png

image.png

虽然Filter很多,但可以简单划分为几类,除个别Filter在每个SecurityFilterChain中都有,其他可以根据需要选用:

  • 信道与状态管理类,比如ChannelProcessingFilter用于处理HTTP或者HTTPS之间的切换,而
    SecurityContextPersistenceFilter用于重建或者销毁必要的SecurityContext状态。
  • 常见Web安全防护类,比如CsrfFilter。
  • 认 证 和 授 权 类 , 比 如 BasicAuthenticationFilter 、CasAuthenticationFilter等。


HttpSecurity


Spring通过HttpSecurity完成定制化Filter的加载,拦截顺序及Filter的初始化存在于

WebSecurityConfigurerAdapter的初始化方法init中,通过getHttp方法可以获得HttpSecurity的对象。下面是WebSecurityConfigurerAdapter的初始化方法:

image.png

这个方法先构建HttpSecurity对象,然后通过WebSecurity对象的

addSecurityFilterChainBuilder方法添加到securityFilterChainBuilders的List中,最后完成组件过滤器链。我们可以通过返回的HttpSecurity对象重写addFilter方法,加入定制化的Filter对象。

定制实现


spring-boot-starter-security


我们可以通过给出一个继承了

WebSecurityConfigurerAdapter的JavaConfig配置类的行为,进行更深一级的对spring-boot-starter�security组件的定制化改造。通过前面的Spring Security的源码分析,我们知道主要的方式就是继承WebSecurityConfigurerAdapter,这 样 做 的 好 处 在 于 , 我 们 依 然 可 以 使 用 spring-boot-starter�security默认的一些行为,只需要对必要的行为进行调整,比如:

  • 配置多个AuthenticationManager实例。
  • 对HttpSecurity定义的默认资源访问规则进行重新定义。
  • 对提供的默认WebSecurity行为进行调整。

为 了 能 够 让 这 些 调 整 生 效 , 我 们 定 义 的

WebSecurityConfigurerAdapter实现类一般在顺序上需要先于spring�boot-starter-security默认提供的配置,所以一般需要配合@Order注解进行标注,代码如下:

image.png

总之,

WebSecurityConfigurerAdapter是Spring Security框架为我们预先设定的一个安全框架,它允许我们对Web安全相关的功能进行定制化开发,但是在某些场景下我们还是会感觉不方便,此时我们可以直接实现并注册一个标注了@EnableWebSecurity的JavaConfig配置类到IoC容器,从而实现一种“颠覆性”的定制,示例代码如下:

image.png

image.png


Spring Boot实现自定义Starter


下面我们通过介绍在一个微服务网关项目(Sia-Gateway已在GitHub开源)中自定义Starter,了解自定义Starter的关键步骤,以及实现一个自定义注解的完整步骤,如下图所示。

image.png

使用到的关键注解和功能的对应关系如下。

  • @Configuration与@Bean的作用:基于Java代码的Bean配置。
  • @Conditional的作用:设置自动配置条件依赖。
  • @EnableConfigurationProperties与@ConfigurationProperties的作用:读取配置文件并将其转换为Bean。
  • @EnableAutoConfiguration 、 @AutoConfigurationPackage 与@Import的作用:Bean的发现与加载。


准备工作


在开始实现自定义Starter之前,我们需要手动创建两个工程。前文中已有介绍,第一个工程更像一个门面(Facade)工程,也可以通过引入第一个自定义的Starter工程验证自定义Starter的功能;第二个工程则是实现自定义Starter的实际业务功能部分,完成自动化配置定义、发现配置及实现特定的业务功能。

  • sag-spring-boot-starter(pom.xml)

image.png

  • sag-spring-boot-starter-autoconfigurer(pom.xml)

image.png

image.png


基于Java代码的Bean配置


下面是自定义Starter的详细配置加载过程,首先使用自动配置AutoConfiguration初始化Bean对象实例,代码如下:

image.png

从上面的代码中可以看到@Configuration、@Bean,这两个注解一起使用可以创建一个基于Java代码的配置类,它可以用来替代加载相应XML配置文件的过程。@Configuration注解的类可以看作让Spring容器管理的Bean实例的工厂。@Bean注解代表准备注册到Spring容器的对象实例,也就是一个带有@Bean的注解方法将返回的对象,该对象应该被注册到Spring容器中。自动配置类SagProxyAutoConfiguration的作用是自动生成微服务网关需要的Bean实例ThirdPartyComponent,并将这个Bean实例交给Spring容器管理,从而完成Bean的自动注册。


自动配置条件依赖


从SagProxyAutoConfiguration类中使用的注解可以看出,要完成自动配置是有依赖条件的,即@ConditionalOnBean (

SagProxyMarkerConfiguration.Marker.class)。

根据条件(ConditionalOnBean),要完成SagProxy的自动化配置 , 我 们 需 要 在 类 路 径 中 判 断 声 明 类SagProxyMarkerConfiguration.mark.class,当这个Bean存在时才会完成Bean的自动注册。

Bean参数的获取至此我们已经知道了Bean的配置过程,但是还没有看到SpringBoot是如何读取YAML或者Properites配置文件的属性来创建数据源的,在SagProxyAutoConfiguration类里使用了@EnableConfigurationProperties注解:

image.png

SagProxyProperties中封装了Proxy配置的各个属性,并且使用Spring自带的注解ConfigurationProperties指定了配置文件的前缀为“sag”,相关配置代码如下:

image.png

通过以上分析我们可以得知:@ConfigurationProperties注解的作 用 是 把 YAML 或 者 Properties 配 置 文 件 转 化 为 Bean 对 象 ,@EnableConfigurationProperties注解的作用是使@ConfigurationProperties 注 解 生 效 , 如 果 只 配 置@ConfigurationProperties注解,在Spring容器中获取不到YAML或者Properties配置文件转化的Bean。

Bean的发现

Spring Boot默认扫描启动类所在的包下的主类与子类的所有组件,但并没有包括依赖包中的类,那么依赖包中的Bean是如何被发现和加载的?这还要从启动类中的@SpringBootApplication注解说起,源码如下:

image.png

image.png

  • @Configuration:其作用前面我们已经讲过了,被注解的类将成为一个Bean配置类。
  • @EnableAutoConfiguration : 其 功 能 很 重 要 , 可 以 借 助@Import的支持,收集和注册依赖包中相关的Bean定义。
  • @ComponentScan:其作用就是自动扫描并加载符合条件的组件,比如@Component和@Repository等,最终将这些Bean定义加载到Spring容器中。

@EnableAutoConfiguration注解引入了@AutoConfigurationPackage 和 @Import 这 两 个 注 解 。

@AutoConfigurationPackage的作用就是对自动配置package进行自动管理,而注解@Import主要完成需要自动配置的包的导入,源码如下:

image.png

要搜集并注册到Spring容器的那些Bean来自哪里呢?如下代码所示:

image.png

image.png

Registrar类的作用是扫描主配置类的同级目录及子包,并将相应的组件导入Spring Boot创建管理容器中,源码如下:

image.png

如 果 进 入

AutoConfigurationImportSelector 类 , 可 以 发 现SpringFactoriesLoader 的 loadFactoryNames 方 法 会 调 用loadSpringFactories 从 所 有 的 jar 包 中 读 取 META�INF/spring.factories文件信息。

下 面 是 spring-boot-autoconfigure 这 个 jar 包 中 的spring.factories 文 件 的 部 分 内 容 , 其 中 有 一 个 Key 为

org.springframework.boot.autoconfigure.EnableAutoConfiguration的值定义了需要自动配置的Bean,通过读取这个配置可以获取一组@Configuration类。

image.png

每个xxxAutoConfiguration都是一个基于Java的Bean配置类。不是 所 有 的 xxxAutoConfiguration 都 会 被 加 载 , 会 根 据xxxAutoConfiguration上@ConditionalOnClass等条件判断是否加载;

最后,通过反射机制将spring.factories中@Configuration类实例化为对应的Java实例。至此,我们已经知道Spring Boot是通过怎样的机制发现准备自动配置的Bean的,接下来就要考虑怎样将这些Bean加载到Spring容器。


Bean的加载


如果要将一个普通类交给Spring容器管理,Spring Boot通常使用下面两种方式实现Bean的加载。大多数情况下我们会使用第一种方式,而对于自定义Starter,显然我们使用了第二种方式。

  • 方式一:在配置类(@Configuration)中增加方法级别注解( @Bean ) 或 者 使 用 类 级 别 注 解 , 使 用 @Controller 、@Service、@Repository、@Component注解标注该类的方式注入Bean,然后确保@ComponentScan自动扫描路径包含上述注解类。
  • 方 式 二 : 从 Spring Boot 的 自 动 化 配 置 过 程 可 以 发 现 ,@EnableAutoConfiguratio注解中使用了@Import ( {
    AutoConfigurationImportSelector.class} ) 注解。

而@Import注解中的类

AutoConfigurationImportSelector实现了DeferredImportSelector 等 一 系 列 接 口 , 该 接 口 是ImportSelector 的 子 接 口 , 通 常 我 们 可 以 直 接 实 现ImportSelector接口并实现selectImports方法。当我们通过@Import注解向实现了ImportSelector接口的选择器添加相应的 自 动 化 配 置 注 解 , 并 在 启 动 类 中 使 用 该 注 解 时 ,selectImports方法将会交给容器调用,从而实现Bean的自动化加载,Spring Boot正是通过这种机制来将Bean注入容器的。此外,还可以通过BeanDefinitionRegistry动态注入Bean,详细逻辑这里就不赘述了。


相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
相关文章
|
传感器 JSON 监控
Springboot + oshi 实现对服务器硬件的监控
OSHI是一个免费的基于JNA的(本机)Java操作系统和硬件信息库。它不需要安装任何额外的本地库,旨在提供跨平台实现来检索系统信息,如操作系统版本、进程、内存和CPU使用情况、磁盘和分区、设备、传感器等。
797 0
|
4天前
|
存储 运维 安全
Spring运维之boot项目多环境(yaml 多文件 proerties)及分组管理与开发控制
通过以上措施,可以保证Spring Boot项目的配置管理在专业水准上,并且易于维护和管理,符合搜索引擎收录标准。
15 2
|
4月前
|
Java 持续交付 Maven
Spring Boot程序的打包与运行:构建高效部署流程
构建高效的Spring Boot部署流程对于保障应用的快速、稳定上线至关重要。通过采用上述策略,您可以确保部署过程的自动化、可靠性和高效性,从而将专注点放在开发上面。无论是通过Maven的生命周期命令进行打包,还是通过容器技术对部署过程进行优化,选择正确的工具与实践是成功实现这一目标的关键。
199 2
|
Java
自动执行任务:SpringBoot启动期间的最佳实践
自动执行任务:SpringBoot启动期间的最佳实践
65 0
|
6月前
|
Java 测试技术 Maven
【SpringBoot】多环境开发、分组管理、开发控制
【SpringBoot】多环境开发、分组管理、开发控制
60 0
|
设计模式 Java 调度
SpringBoot 事件发布监听机制使用、分析、注意点 (一篇到位)
SpringBoot 事件发布监听机制使用、分析、注意点 (一篇到位)
1597 1
SpringBoot 事件发布监听机制使用、分析、注意点 (一篇到位)
|
缓存 Cloud Native Java
SpringBoot 3.0 五种热部署方式,提高生产效率
SpringBoot 3.0 五种热部署方式,提高生产效率
130 0
|
传感器 存储 Prometheus
【SpringBoot系列】- 四大核心之actuator(程序监控器)
【SpringBoot系列】- 四大核心之actuator(程序监控器)
675 0
|
监控 安全 Java
什么?Spring官方推荐的@Transational还能导致生产事故?
在Spring中进行事务管理非常简单,只需要在方法上加上注解@Transactional,Spring就可以自动帮我们进行事务的开启、提交、回滚操作。甚至很多人心里已经将Spring事务与@Transactional划上了等号,只要有数据库相关操作就直接给方法加上@Transactional注解。
495 0
什么?Spring官方推荐的@Transational还能导致生产事故?
|
Java Unix API
Quarkus项目配置方式详解
Quarkus 可以从多个地方获取项目的配置,它读取配置优先级入下图,在下面的优先级中,一旦读取到某个配置,就不会再继续读取后面配置中的这个配置了。
942 0