java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > Spring Boot Starter配置

Spring Boot Starter 的应用场景与自动配置方式

作者:CodeBlogMan

本文介绍了Spring Boot Starter的使用场景,如何自定义Starter以及Spring Boot自动配置原理,Spring Boot Starter解决了依赖导入和配置繁琐的问题,通过自动配置类和xxxProperties类实现组件的自动注入和配置,感兴趣的朋友一起看看吧

前言

一、Spring Boo Starter 简介

在 SpringBoot 出现之前,如果我们想使用 SpringMVC 来构建我们的 web 项目,必须要做的几件事情如下:

以上这几步只是配置好了 SpringMVC,如果我们还需要与数据库进行交互,就要在 application.xml 中配置数据库连接池 DataSource,如果需要数据库事务,还需要配置 TransactionManager… 等等。

以上会带来两个明显的问题:

而使用 Spring Boot 的 starters(场景启动器)解决上述的两个痛点,Spring Boot 通过将我们常用的功能场景抽取出来,做成的一系列场景启动器。

我们只需要在项目中引入这些 starters,相关场景的所有依赖就会全部被导入进来,并且我们仅需要通过配置文件来进行少量的配置就可以使用相应的功能。

二、如何自定义 Starter

一般在企业开发中,会有专门的 git 仓库(组)来统一放置各个系统对应的 Starter 项目,其中会包括一个空的框架,拉取下来后我们就可以自己开发了。

在开发之前,我们需要知道常见的使用场景有哪些:

2.1命名规范

Spring Boot 官方推荐的命名规范如下:

我们自定义开发推荐的命名:

2.2整体结构

一个 starter 的整体实现逻辑主要由两个基本部分组成:

按照 SpringBoot 官方的定义,starer 的作用就是依赖聚合,因此直接在 starter 内部去进行代码实现是不符合规定的,starter 应该只起到依赖导入的作用,而具体的代码实现应该去交给其它服务/模块来实现。

2.3模块开发

2.3.1依赖引入

首先所有的自动配置模块都要引入两个 jar 包依赖:

<dependencies>
     <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-autoconfigure</artifactId> 
        <!-- 包含很多与自动配置相关的注解的定义,必须要引入 -->
     </dependency>
     <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-configuration-processor</artifactId> 
       <!-- 可以通过其它 .properties 文件为相关类进行属性映射,SpringBoot 默认使用 application.yml-->
         <optional>true</optional>
     </dependency>
 <dependencies>

2.3.2xxxAutoConfiguration的实现

xxxAutoconfigure 模块中最重要的就是自动配置类的编写,它为我们实现组件的自动配置与自动注入。在编写自动配置类的时候,我们应该要考虑向容器中注入什么组件,如何去配置它。

@Configuration 
@EnableConfigurationProperties(xxxProperties.class)
public class xxxAutoConfiguration {
 @Resource
 private xxxProperties properties;
    @Bean
    public static BeanYouNeed beanYouNeed() {
     BeanYouNeed bean = new BeanYouNeed()
     bean.setField(properties.get(field));
     bean.setField(properties.get(field));
    }
}

2.3.3 xxxProperties的实现

这是跟配置文件相绑定的类,里边的属性就是我们可以在配置文件中配置的内容,然后通过@ConfigurationProperties将其与配置文件绑定:

//使用 @ConfigurationProperties 注解绑定配置文件
@ConfigurationProperties(prefix = "your properties") 
public class xxxProperties {
    private String url;
    private String key;
    private String secret;
}

2.3.4配置spring.factories文件

在 resource 目录下新建META-INF文件夹,在文件夹下新建spring.factories文件,并添加写好的xxxAutoConfiguration类:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.xx.xx.xx.autoconfigure.xxxAutoConfiguration

三、浅析 Spring Boot 自动配置原理

在这一小节我将分析 Spring Boot 在创建 Stater 时主要帮我们完成的两件最关键的事情:

这两件事情统一称为 SpringBoot 的自动配置。

3.1自动配置原理

我们从主程序入口来探索一下整个过程的原理:

@SpringBootApplication //标注这个类是一个 springboot 的应用
public class MyApplication {
    public static void main(String[] args) {
        //将 springboot 应用启动
        SpringApplication.run(MyApplication.class, args);
    }
}

@SpringBootApplication注解内部结构如下图3-1所示:

图3-1

我们可以去到上边提到的spring.factories文件中去看一下,找到 spring 官方提供的spring-boot-autoconfigure包,再去找一下该文件,如图3-2所示:

图3-2

可以看到这个就是SpringBoot官方为我们提供的所有自动配置类的候选列表。
我们可以在其中找到一个我们比较熟悉的自动配置类去看一下它内部的实现,可以看到这些一个个的都是JavaConfig配置类,而且都通过@Bean注解向容器中注入了一些 Bean,如图3-3所示:

图3-3

小结:

3.2自动配置的过程

SpringBoot 中所有可配置项都集中在一个文件中(application.yml),这个文件中的配置通过@ConfigurationProperties注解来与我们程序内部定义的 POJO

类来产生关联,这些 POJO 类统一命名为xxxProperties,并且这些xxxProperties类中各个属性字段都有自己的默认值。

这也是 SpringBoot 约定大于配置理念的体现,尽可能减少开发人员做选择的次数,但同时又不失灵活性。只要我们想,配置文件中的配置随时可以覆盖默认值,如图3-4所示:

图3-4

小结:

四、文章小结

到这里关于Spring Boot Starter 的应用场景与自动配置就分享完了,stater 的开发和使用并不难,最重要的掌握使用场景和自动配置,这样无论是什么类型的 stater 都可以快速掌握运用在项目里。

到此这篇关于Spring Boot Starter 的应用场景与自动配置的文章就介绍到这了,更多相关Spring Boot Starter配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:
阅读全文