java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > springboot中的starter

springboot中的starter及自定义方法详解

作者:一户董

这篇文章主要介绍了springboot中的starter及自定义方法详解,Starter是Spring Boot中的一个非常重要的概念,Starter相当于模块,它能将模块所需的依赖整合起来并对模块内的Bean根据环境(条件)进行自动配置,需要的朋友可以参考下

1:官方提供的starter

在spring-boot-autocongure包中定义了官方提供的一百多个starter,如下:

在这里插入图片描述

2:框架是如何定义starter的?

因为springboot的普及度逐步提高,一些没有被官方实现提供为starter的框架,也会自己实现一个starter供用户使用,这里以shardingsphere ,clone之后使用操作git checkout -b 5.0.0-alpha-local 5.0.0-alpha创建分支,然后在如下目录查看starter配置:

$ pwd
/d/test/sharding-sphere/shardingsphere-jdbc/shardingsphere-jdbc-spring/shardingsphere-jdbc-core-spring/shardingsphere-jdbc-core-spring-boot-starter

截图如下:

在这里插入图片描述

spring.provider内容如下:

provides: shardingsphere-jdbc-spring-boot-starter

additional-spring-configuration-metadata.json内容如下:

{
  "groups": [
    {
      "name": "spring.shardingsphere.datasource",
      "type": "org.apache.shardingsphere.spring.boot.SpringBootConfiguration"
    },
    ...
}

其中比较重要的是spring.factories和自动配置类SpringBootConfiguration,spring.factories如下:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
org.apache.shardingsphere.spring.boot.SpringBootConfiguration

其中只定义了自动配置类,自动配置类如下:

@Configuration // 代表是一个Java config类
@ComponentScan("org.apache.shardingsphere.spring.boot.converter") // 配置扫描路径,会扫描并注册相关spring bean
@EnableConfigurationProperties(SpringBootPropertiesConfiguration.class) // 启用属性类,封装了外部配置文件信息
@ConditionalOnProperty(prefix = "spring.shardingsphere", name = "enabled", havingValue = "true", matchIfMissing = true) // 当spring.shardingsphere.enabled 配置项等于true时,加载该自动配置类
@AutoConfigureBefore(DataSourceAutoConfiguration.class) // 在DataSourceAutoConfiguration自动配置类之前配置
@RequiredArgsConstructor // lombok注解
public class SpringBootConfiguration implements EnvironmentAware {
    // 属性类,会自动注入进来
    private final SpringBootPropertiesConfiguration props;
    
    private final Map<String, DataSource> dataSourceMap = new LinkedHashMap<>();
    
    // 核心,创建shardingsphere
    @Bean
    @Autowired(required = false)
    public DataSource shardingSphereDataSource(final ObjectProvider<List<RuleConfiguration>> rules) throws SQLException {
        Collection<RuleConfiguration> ruleConfigurations = Optional.ofNullable(rules.getIfAvailable()).orElse(Collections.emptyList());
        return ShardingSphereDataSourceFactory.createDataSource(dataSourceMap, ruleConfigurations, props.getProps());
    }
    
    // 创建spring bean ShardingTransactionTypeScanner
    @Bean
    public ShardingTransactionTypeScanner shardingTransactionTypeScanner() {
        return new ShardingTransactionTypeScanner();
    }
    
    // 感知上下文对象,因为自动配置类本身也是一个spring bean,所以这里可以这样子用
    @Override
    public final void setEnvironment(final Environment environment) {
        dataSourceMap.putAll(DataSourceMapSetter.getDataSourceMap(environment));
    }
}

使用也比较简单,和引入普通的jar包相同,在需要的项目里引入其GAV即可,最终springboot会扫描到spring.facatories,并加载其中的组件,当然最重要的自然是自动配置类了,接下来我们仿照shardingsphere 的starter来自定义一个starter。

3:自定义starter

3.1:自定义starter

首先我们来定义属性类,如下:

@ConfigurationProperties(prefix = "info")
@Getter
@Setter
public class HelloProperties {
//    private Properties prop = new Properties();

    private String name;
}

即接收的配置的前缀是info,这里的name属性配置中就可能是info.name=xxxx,接着我们来定义一个我们的starter能够提供的类Spokesman,该类的功能就是会说话,因此,使用了我们starter就能拥有一个会spoke的man,如下:

@AllArgsConstructor
public class Spokesman {
    private String name;

    public String speak() {
        System.out.println("你好,向大家介绍:" + name);
        return name;
    }
}

接着就可以定义最重要的自动配置类了,如下:

@Configuration
@EnableConfigurationProperties(HelloProperties.class)
@ConditionalOnExpression // 默认为true,即默认加载
@AllArgsConstructor
public class HelloAutoConfiguration implements InitializingBean {
    private final HelloProperties props;

    // 创建 Spokesman 的 spring bean
    @Bean
    public Spokesman createSpokesman() {
        return new Spokesman(props.getName());
    }

    // 仅仅为了打印props,没有其他特殊用途
    @Override
    public void afterPropertiesSet() throws Exception {
        System.out.println("props isss: " + props.getName());
    }
}

但此时,我们的自动配置类还不能加入到springboot的体系中,还需要在META-INF下创建spring.factories文件,如下:

在这里插入图片描述

3.2:使用自定义starter

starter其实也就是一个普通的maven依赖,所以我们想要使用的话,首先需要引入其对应的GAV,这里如下:

<dependency>
    <groupId>dongshi.daddy</groupId>
    <artifactId>hello-starter</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

接着我们提供starter需要的配置信息,如下:

info:
  name: 甜甜的葡萄干

接着我们就可以获取starter提供的SpokeMan来spoke了,如下:

@Resource
private Spokesman spokesman;

@RequestMapping("/starter")
@ResponseBody
public String starter() {
    System.out.println("starter ...");
    return spokesman.speak();
}

运行main,如果是在console看到如下输出,则说明starter已经使用成功了:

2023-07-03 21:01:56.508  INFO 3011 --- [           main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 2355 ms
props isss: 甜甜的葡萄干
...

接着我们就可以访问//localhost:8899/my/starter了:

在这里插入图片描述

到此这篇关于springboot中的starter及自定义方法详解的文章就介绍到这了,更多相关springboot中的starter内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

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