徒手撸了一个Starter,同事直夸我666~
Spring Boot starter原理
Spring Boot 将常见的徒手r同开发功能,分成了一个个的事直starter,这样我们开发功能的徒手r同时候只需要引入对应的starter,而不需要去引入一堆依赖了!starter可以理解为一个依赖组,事直其主要功能就是徒手r同完成引入依赖和初始化配置。Spring 官方提供的事直starter 命名规范为 spring-boot-starter-xxx ,第三方提供的徒手r同starter命名规范为 xxx-spring-boot-starter 。
这里我们以 RocketMQ 的事直依赖 rocketmq-spring-boot-starter 来学习 starter的原理。
在项目中引入 rocketmq-spring-boot-starter 之后,徒手r同实际上就引入了 rocketmq 的事直一些相关依赖。
在 rocketmq-spring-boot 中有一个自动装配的徒手r同类RocketMQAutoConfiguration ,我截取了其中的事直一小段代码,一起来看看。徒手r同
@Configuration @EnableConfigurationProperties(RocketMQProperties.class) @ConditionalOnClass({ MQAdmin.class}) @ConditionalOnProperty(prefix = "rocketmq",事直 value = "name-server", matchIfMissing = true) @Import({ MessageConverterConfiguration.class, ListenerContainerConfiguration.class, ExtProducerResetConfiguration.class, RocketMQTransactionConfiguration.class}) @AutoConfigureAfter({ MessageConverterConfiguration.class}) @AutoConfigureBefore({ RocketMQTransactionConfiguration.class}) public class RocketMQAutoConfiguration { private static final Logger log = LoggerFactory.getLogger(RocketMQAutoConfiguration.class); public static final String ROCKETMQ_TEMPLATE_DEFAULT_GLOBAL_NAME = "rocketMQTemplate"; @Autowired private Environment environment; @Bean(destroyMethod = "destroy") @ConditionalOnBean(DefaultMQProducer.class) @ConditionalOnMissingBean(name = ROCKETMQ_TEMPLATE_DEFAULT_GLOBAL_NAME) public RocketMQTemplate rocketMQTemplate(DefaultMQProducer mqProducer, RocketMQMessageConverter rocketMQMessageConverter) { RocketMQTemplate rocketMQTemplate = new RocketMQTemplate(); rocketMQTemplate.setProducer(mqProducer); rocketMQTemplate.setMessageConverter(rocketMQMessageConverter.getMessageConverter()); return rocketMQTemplate; } } @Configuration 说明这是一个配置类,类中被@Bean注解了的徒手r同方法,就是spring的一个bean,例如rocketMQTemplate。亿华云计算 @EnableConfigurationProperties,启用被@ConfigurationProperties的bean,这里引入了 RocketMQProperties 。RocketMQProperties 就是需要在yml文件中写入的属性。
@ConfigurationProperties(prefix = "rocketmq") public class RocketMQProperties { private String nameServer; private String accessChannel; private Producer producer; private Consumer consumer = new Consumer(); }在Spring Boot项目启动的时候默认只会扫描下级目录下带 @Configuration 注解的类,那么像本文中提到的 RocketMQAutoConfiguration 是如何扫描的呢?其实项目启动的时候会去加载项目中所有的 spring.factories 文件,然后加载对应的配置类,因此我们就需要在 spring.factories 中只指定需要扫描的类。
原理搞明白了,接下来我们就简单实现一个自己的starter!这个starter的主要作用就是给一个对象尾部拼接一个字符串!
一、新建项目
新建一个名为 javatip-spring-boot-starter 的项目,并且引入下面的依赖
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency>二、新增配置类
配置类对应的properties文件中的属性为javatip.name;
@ConfigurationProperties(prefix = "javatip") public class JavatipPorperties { private String name; public String getName() { return name; } public void setName(String name) { this.name = name; } }三、云南idc服务商新增拼接字符串的方法
此方法主要就是为对象拼接一个固定的字符串
public class StrUt { private String name; public String strTo(Object object){ return object +"---"+ getName(); } public String getName() { return name; } public void setName(String name) { this.name = name; } }四、新增自动配置类
使用注解 @EnableConfigurationProperties 启用 JavatipProperties 配置类
使用注解 @Configuration 配合 @Bean 注册一个拼接字符串的bean对象。
@Configuration @EnableConfigurationProperties(JavatipPorperties.class) public class JavatipAutoConfiguration { @Autowired private JavatipPorperties javatipPorperties; @Bean public StrUt strut(){ StrUt strut = new StrUt(); strut.setName(javatipPorperties.getName()); return strut; } }五、新增配置发现文件
在resources文件夹中新建 META-INF 文件夹,在 META-INF 文件夹中新建配置发现文件 spring.factories,并且将自动配置类写到文件里。
org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.javatip.str.configuration.JavatipAutoConfiguration六、打包测试
使用 mvn install 命令将项目打包推送到本地maven仓库,然后新建一个测试项目,引入打包好的依赖。
<dependency> <groupId>com.javatip</groupId> <artifactId>javatip-spring-boot-starter</artifactId> <version>0.0.1-SNAPSHOT</version> </dependency>在 application.yml 文件中写入自动拼接的字符串对应的属性 javatip.name 。
javatip: name: Java旅途然后手写一个测试类:
@RestController public class Test { @Autowired private StrUt strUt; @GetMapping("test") public String test(){ String str = strUt.strTo("who are you?"); return str; } }运行测试类后,页面返回了
who are you?---Java旅途这样,一个简单的starter就写好了,只要理解了starter的原理,实现起来就很简单,第一点就是starter相当于一个依赖组,另一点就是starter可以完成初始化配置。
本文转载自微信公众号「Java旅途」,可以通过以下二维码关注。转载本文请联系Java旅途公众号。网站模板