学习自定义【Spring Boot Starter】这一篇就够了

news/2024/10/17 16:19:57/

目录

  • 1. starter介绍
  • 2. starter原理
    • 2-1. 起步依赖
    • 2-2. 自动配置
      • 基于Java代码的Bean配置
      • 自动配置的条件依赖
      • Bean参数获取
      • Bean的发现
      • Bean的加载
      • 自动配置总结
  • 3. 自定义starter案例
    • 3-1. 开发starter
    • 3-2. 使用starter

1. starter介绍

我们知道Spring Boot大大简化了项目初始搭建以及开发过程，而这些都是通过Spring Boot提供的starter来完成的。

spring boot 在配置上相比spring要简单许多, 其核心在于spring-boot-starter, 在使用spring boot来搭建一个项目时, 只需要引入官方提供的starter, 就可以直接使用, 免去了各种配置。starter简单来讲就是引入了一些相关依赖和一些初始化的配置。

Spring官方提供了很多starter，第三方也可以定义starter。为了加以区分，starter从名称上进行了如下规范：

  1. Spring官方提供的starter名称为：spring-boot-starter-xxx 例如：spring-boot-starter-web
  2. 第三方提供的starter名称为：xxx-spring-boot-starter 例如：mybatis-spring-boot-starter

2. starter原理

Spring Boot之所以能够帮我们简化项目的搭建和开发过程，主要是基于它提供的起步依赖和自动配置。

2-1. 起步依赖

起步依赖，其实就是将具备某种功能的坐标打包到一起，可以简化依赖导入的过程。例如，我们导入spring-boot-starter-web这个starter，则和web开发相关的jar包都一起导入到项目中了。如下图所示：

在这里插入图片描述

2-2. 自动配置

自动配置，就是无须手动配置xml，自动配置并管理bean，可以简化开发过程。那么Spring Boot是如何完成自动配置的呢？

自动配置涉及到如下几个关键步骤：

  • 基于Java代码的Bean配置
  • 自动配置条件依赖
  • Bean参数获取
  • Bean的发现
  • Bean的加载

我们可以通过一个实际的例子mybatis-spring-boot-starter来说明自动配置的实现过程。

基于Java代码的Bean配置

当我们在项目中导入了mybatis-spring-boot-starter这个jar后，可以看到它包括了很多相关的jar包，如下图：
在这里插入图片描述
其中在mybatis-spring-boot-autoconfigure这个jar包中有如下一个MybatisAutoConfiguration自动配置类：

在这里插入图片描述

打开这个类，截取的关键代码如下：

在这里插入图片描述

  • @Configuration 注解的类可以看作是能生产让Spring IOC容器管理的Bean实例的工厂。

  • @Bean 注解的方法返回的对象可以被注册到Spring容器中。

  • @Configuration和 @Bean这两个注解一起使用就可以创建一个基于Java代码的配置类，可以用来替代传统的xml配置文件。

自动配置的条件依赖

从MybatisAutoConfiguration这个类中使用的注解可以看出，要完成自动配置是有依赖条件的。

在这里插入图片描述
所以要完成Mybatis的自动配置，需要在类路径中存在SqlSessionFactory.class、SqlSessionFactoryBean.class这两个类，同时需要存在DataSource这个bean且这个bean完成自动注册。

这些注解是spring boot特有的，常见的条件依赖注解有：

注解功能说明
@ConditionalOnBean仅在当前上下文中存在某个bean时，才会实例化这个Bean
@ConditionalOnClass某个class位于类路径上，才会实例化这个Bean
@ConditionalOnExpression当表达式为true的时候，才会实例化这个Bean
@ConditionalOnMissingBean仅在当前上下文中不存在某个bean时，才会实例化这个Bean
@ConditionalOnMissingClass某个class在类路径上不存在的时候，才会实例化这个Bean
@ConditionalOnNotWebApplication不是web应用时才会实例化这个Bean
@AutoConfigureAfter在某个bean完成自动配置后实例化这个bean
@AutoConfigureBefore在某个bean完成自动配置前实例化这个bean

Bean参数获取

要完成mybatis的自动配置，需要我们在配置文件中提供数据源相关的配置参数，例如数据库驱动、连接url、数据库用户名、密码等。那么spring boot是如何读取yml或者properites配置文件的的属性来创建数据源对象的？

在我们导入mybatis-spring-boot-starter这个jar包后会传递过来一个spring-boot-autoconfigure包，在这个包中有一个自动配置类DataSourceAutoConfiguration，如下所示：

在这里插入图片描述
我们可以看到这个类上加入了EnableConfigurationProperties这个注解，继续跟踪源码DataSourceProperties这个类，如下：

在这里插入图片描述
可以看到这个类上加入了ConfigurationProperties注解，这个注解的作用就是把yml或者properties配置文件中的配置参数信息封装到ConfigurationProperties注解标注的bean(即DataSourceProperties)的相应属性上。

@EnableConfigurationProperties注解的作用是使@ConfigurationProperties注解生效。

Bean的发现

spring boot默认扫描启动类所在的包下的主类与子类的所有组件，但并没有包括依赖包中的类，那么依赖包中的bean是如何被发现和加载的？

我们需要从Spring Boot项目的启动类开始跟踪，在启动类上我们一般会加入SpringBootApplication注解，此注解的源码如下：

在这里插入图片描述
重点介绍如下三个注解：

  • SpringBootConfiguration：作用就相当于Configuration注解，被注解的类将成为一个bean配置类

  • ComponentScan：作用就是自动扫描并加载符合条件的组件，最终将这些bean加载到spring容器中

  • EnableAutoConfiguration ：这个注解很重要，借助@Import的支持，收集和注册依赖包中相关的bean定义

继续跟踪EnableAutoConfiguration注解源码：

在这里插入图片描述
AutoConfigurationImportSelector类源码如下：

在这里插入图片描述
AutoConfigurationImportSelector类的getCandidateConfigurations方法中的调用了SpringFactoriesLoader类的loadFactoryNames方法，继续跟踪源码：

在这里插入图片描述
在这里插入图片描述

SpringFactoriesLoader的loadSpringFactories静态方法可以从所有的jar包中读取META-INF/spring.factories文件，而自动配置的类就在这个文件中进行配置：

在这里插入图片描述

这个文件里面的内容如下：
在这里插入图片描述

这样Spring Boot就可以加载到MybatisAutoConfiguration这个配置类了。

Bean的加载

在Spring Boot应用中要让一个普通类交给Spring容器管理，通常有以下方法：

1、使用 @Configuration与@Bean 注解

2、使用@Controller @Service @Repository @Component 注解标注该类并且启用@ComponentScan自动扫描

3、使用@Import 方法

其中Spring Boot实现自动配置使用的是@Import注解这种方式，AutoConfigurationImportSelector类的selectImports方法返回一组从META-INF/spring.factories文件中读取的bean的全类名，这样Spring Boot就可以加载到这些Bean并完成实例的创建工作。

自动配置总结

我们可以将自动配置的关键几步以及相应的注解总结如下：

1、@Configuration与@Bean：基于Java代码的bean配置

2、@Conditional：设置自动配置条件依赖

3、@EnableConfigurationProperties与@ConfigurationProperties：读取配置文件转换为bean

4、@EnableAutoConfiguration与@Import：实现bean发现与加载

3. 自定义starter案例

3-1. 开发starter

第一步：创建starter工程digest-spring-boot-starter并配置pom.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.iteng</groupId><artifactId>digest-spring-boot-starter</artifactId><version>1.0-SNAPSHOT</version><properties><maven.compiler.source>8</maven.compiler.source><maven.compiler.target>8</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties><dependencies><!--  提供自动装配所依赖的注解  --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-autoconfigure</artifactId><version>2.7.6</version><optional>true</optional>      <!--  不进行依赖传递  --></dependency><!--apache 加密--><dependency><groupId>commons-codec</groupId><artifactId>commons-codec</artifactId><version>1.15</version></dependency></dependencies></project>

第二步：创建配置属性类DigestProperty

package com.iteng.digest.config;import org.springframework.boot.context.properties.ConfigurationProperties;/**读取配置文件转换为bean* */
@ConfigurationProperties(prefix = "digest")
public class DigestProperty {private String type;public String getType() {return type;}public void setType(String type) {this.type = type;}
}

第三步：创建业务类Digest 以及实现类Md5Digest、ShaDigest

service

public interface Digest {String digest(String raw);
}

impl

public class Md5Digest implements Digest {@Overridepublic String digest(String raw) {System.out.println("Md5加密生成摘要");return DigestUtils.md5Hex(raw);}
}

public class ShaDigest implements Digest {@Overridepublic String digest(String raw) {System.out.println("Sha加密生成摘要");return DigestUtils.sha256Hex(raw);}
}

第四步：创建自动配置类DigestAutoConfiguration

@Configuration
// 使@ConfigurationProperties注解生效
@EnableConfigurationProperties(DigestProperty.class)
// 只有类路径下有DigestUtils.class时，DigestConfiguration配置类才配置
@ConditionalOnClass(DigestUtils.class) 
public class DigestAutoConfiguration {private DigestProperty digestProperty;//通过构造方法注入配置属性对象DigestProperty, 也可以使用@Autowired注解注入public DigestAutoConfiguration(DigestProperty digestProperty) {this.digestProperty = digestProperty;}@Bean@ConditionalOnMissingBean // 没有Digest这个Beab时，才装配Digest Bean// 只有当yml中的digest.type == md5时，才装配Digest Bean。// matchIfMissing = true：表示yml没有写digest.type时，也装配Digest Bean@ConditionalOnProperty(prefix = "digest", name = "type", havingValue = "md5", matchIfMissing = true)public Digest md5Digest() {return new Md5Digest();}@Bean@ConditionalOnMissingBean@ConditionalOnProperty(prefix = "digest", name = "type", havingValue = "sha")public Digest shaDigest() {return new ShaDigest();}
}

第五步：(Spring Boot 2.7 及以上）在resources目录下创建META-INF文件夹，在META-INF文件夹里面创建一个spring文件夹。在spring文件夹中创建org.springframework.boot.autoconfigure.AutoConfiguration.imports的文件。文件内容写自动配置类的全限名

com.iteng.digest.config.DigestAutoConfiguration

(Spring Boot 2.7 以下）在resources目录下创建META-INF文件夹，在文件夹中创建spring.factories文件

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.iteng.digest.config.DigestAutoConfiguration

至此starter已经开发完成了，可以将当前starter安装到本地maven仓库供其他应用来使用。

3-2. 使用starter


http://www.ppmy.cn/news/1283248.html

相关文章

SpringBoot-整合MyBatis

SpringBoot-整合MyBatis

依赖 <!--mybatis--> <dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.1.1</version> </dependency> <!--jdbc--> <dependency>…
阅读更多...
推特（Twitter）蓝V

推特（Twitter）蓝V

点击个人订阅 这里需要一张visa卡才可以订阅&#xff0c;点击获取 订阅成功
阅读更多...
rosdep init/update失败（转载）

rosdep init/update失败（转载）

sudo rosdep init rosdep update 如果你直接成功了&#xff0c;可直接跳过当我没说&#xff08;不过90%的几率你都会失败的啦&#xff09; 由于http://raw.githubusercontent.com这个网址墙的很厉害&#xff0c;大概率你是成功不了的&#xff0c;这里推荐一种本地化安装的方法…
阅读更多...
模型树实操

模型树实操

很多时候&#xff0c;数据都是有层级和分类的&#xff0c;使用laravel的Dcat框架&#xff0c;可以快速搭建一个结构清晰、且可以鼠标拖拽排序的后台&#xff1b;先上例子更直观&#xff1a; 这里是Dcat的模型树使用文档&#xff0c;戳一下&#xff1b; 重点注意事项有&#x…
阅读更多...
Docker 创建容器

Docker 创建容器

1、创建MySQL5.7 拉取镜像&#xff1a;docker pull mysql:5.7创建容器&#xff1a;docker run -d --name mysql57001 -p 3306:3306 -v D:\DockerImage\QhData\MySql57:/var/lib/mysql -e MYSQL_ROOT_PASSWORD123456 mysql:5.7进入容器&#xff1a;docker exec -it mysql57001 …
阅读更多...
为什么市场称SoBit 是铭文跨链赛道真正的龙头？

为什么市场称SoBit 是铭文跨链赛道真正的龙头？

跨链桥赛道将是铭文市场长期的发展的刚需 在比特币网络中&#xff0c;Ordinals 铭文铸造的铭文总量已经超过了 5100 万枚&#xff0c;并累计费用收入超 5028 BTC。同时&#xff0c;仅 BRC-20 叙事方向的市值&#xff0c;就已经超过了 30 亿美元&#xff0c;并且随着铭文资产种类…
阅读更多...
Linux下安装Flume

Linux下安装Flume

1 下载Flume Welcome to Apache Flume — Apache Flume 下载1.9.0版本 2 上传服务器并解压安装 3 删除lib目录下的guava-11.0.2.jar &#xff08;如同服务器安装了hadoop&#xff0c;则删除&#xff0c;如没有安装hadoop则保留这个文件&#xff0c;否则无法启动flume&#…
阅读更多...
深入了解 Spring Boot 核心特性、注解和 Bean 作用域

深入了解 Spring Boot 核心特性、注解和 Bean 作用域

Spring Boot 是什么&#xff1f; Spring Boot 是基于 Spring Framework 构建应用程序的框架&#xff0c;Spring Framework 是一个广泛使用的用于构建基于 Java 的企业应用程序的开源框架。Spring Boot 旨在使创建独立的、生产级别的 Spring 应用程序变得容易&#xff0c;您可以…
阅读更多...
最新文章

Copyright @ 2022~2023