Spring Boot:定制自己的starter
<p>在学习Spring Boot的过程中,接触最多的就是starter。可以认为starter是一种服务——使得使用某个功能的开发者不需要关注各种依赖库的处理,不需要具体的配置信息,由Spring Boot自动通过classpath路径下的类发现需要的Bean,并织入bean。举个例子,<em>spring-boot-starter-jdbc</em>这个starter的存在,使得我们只需要在BookPubApplication下用<code>@Autowired</code>引入DataSource的bean就可以,Spring Boot会自动创建DataSource的实例。</p> <p>这里我们会用一个不太规范的starter展示Spring Boot的自动配置的运行原理。<a href="/misc/goto?guid=4959653371684814273" target="_blank">Spring Boot的自动配置、Command-line Runner</a>一文中曾利用StartupRunner类在程序运行启动后首先查询数据库中书的数目,现在换个需求:<em>在系统启动后打印各个实体的数量</em>。</p> <h2>How Do</h2> <ul> <li>新建一个模块<em>db-count-starter</em>,然后修改db-count-starter模块下的pom文件,增加对应的库。</li> </ul> <pre class="brush:java; toolbar: true; auto-links: false;"><dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot</artifactId> <!-- version继承父模块的--> </dependency> <dependency> <groupId>org.springframework.data</groupId> <artifactId>spring-data-commons</artifactId> <version>1.9.3.RELEASE</version> </dependency></dependencies></pre> <ul> <li>新建包结构<em>com/test/bookpubstarter/dbcount</em>,然后新建DbCountRunner类,实现CommandLineRunner接口,在run方法中输出每个实体的数量。</li> </ul> <pre class="brush:java; toolbar: true; auto-links: false;">package com.test.bookpubstarter.dbcount; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.boot.CommandLineRunner; import org.springframework.data.repository.CrudRepository; import java.util.Collection; public class DbCountRunner implements CommandLineRunner { protected final Logger logger = LoggerFactory.getLogger(DbCountRunner.class); private Collection<CrudRepository> repositories; public DbCountRunner(Collection<CrudRepository> repositories) { this.repositories = repositories; } @Override public void run(String... strings) throws Exception { repositories.forEach(crudRepository -> { logger.info(String.format("%s has %s entries", getRepositoryName(crudRepository.getClass()), crudRepository.count())); }); } private static String getRepositoryName(Class crudRepositoryClass) { for (Class repositoryInterface : crudRepositoryClass.getInterfaces()) { if (repositoryInterface.getName().startsWith("com.test.bookpub.repository")) { return repositoryInterface.getSimpleName(); } } return "UnknownRepository"; } }</pre> <ul> <li>增加自动配置文件<em>DbCountAutoConfiguration</em> </li> </ul> <pre class="brush:java; toolbar: true; auto-links: false;">package com.test.bookpubstarter.dbcount; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.data.repository.CrudRepository; import java.util.Collection; @Configuration public class DbCountAutoConfiguration { @Bean public DbCountRunner dbCountRunner(Collection<CrudRepository> repositories) { return new DbCountRunner(repositories); } }</pre> <ul> <li>在src/main/resources目录下新建META-INF文件夹,然后新建<em>spring.factories</em>文件,这个文件用于告诉Spring Boot去找指定的自动配置文件,因此它的内容是</li> </ul> <pre class="brush:java; toolbar: true; auto-links: false;">org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ com.test.bookpubstarter.dbcount.DbCountAutoConfiguration</pre> <ul> <li>在之前的程序基础上,在顶层pom文件中增加starter的依赖</li> </ul> <pre class="brush:java; toolbar: true; auto-links: false;"><dependency> <groupId>com.test</groupId> <artifactId>db-count-starter</artifactId> <version>0.0.1-SNAPSHOT</version> </dependency></pre> <ul> <li>把StartupRunner相关的注释掉,然后在main函数上右键<em>Run BookPubApplication.main(...)</em>,可以看出我们编写的starter被主程序使用了。</li> </ul> <div class="image-package" href="https://simg.open-open.com/show/0b19a3294a1458c4aedc199f78df0d65.png"> <img src="https://simg.open-open.com/show/0b19a3294a1458c4aedc199f78df0d65.png" width="700" height="117.94670846394983" data-original-src="https://simg.open-open.com/show/9b6bed49ed9f27b322802a61768718bb.png" /> <br /> <div class="image-caption"> 自己的starter简单演示.png </div> </div> <h2>分析</h2> <p>正规的starter是一个独立的工程,然后在maven中新仓库注册发布,其他开发人员就可以使用你的starter了。</p> <p>常见的starter会包括下面几个方面的内容:</p> <ol> <li>自动配置文件,根据classpath是否存在指定的类来决定是否要执行该功能的自动配置。</li> <li>spring.factories,非常重要,指导Spring Boot找到指定的自动配置文件。</li> <li>endpoint:可以理解为一个admin,包含对服务的描述、界面、交互(业务信息的查询)</li> <li>health indicator:该starter提供的服务的健康指标</li> </ol> <p>在应用程序启动过程中,Spring Boot使用<em>SpringFactoriesLoader</em>类加载器查找<em>org.springframework.boot.autoconfigure.EnableAutoConfiguration</em>关键字对应的Java配置文件。Spring Boot会遍历在各个jar包种META-INF目录下的<em>spring.factories</em>文件,构建成一个配置文件链表。除了<em>EnableAutoConfiguration</em>关键字对应的配置文件,还有其他类型的配置文件:</p> <ul> <li>org.springframework.context.ApplicationContextInitializer</li> <li>org.springframework.context.ApplicationListener </li> <li>org.springframework.boot.SpringApplicationRunListener </li> <li>org.springframework.boot.env.PropertySourceLoader </li> <li>org.springframework.boot.autoconfigure.template.TemplateAvailabilityProvider</li> <li>org.springframework.test.contex.TestExecutionListener</li> </ul> <p>Spring Boot的starter在编译时不需要依赖Spring Boot的库。这个例子中依赖spring boot并不是因为自动配置要用spring boot,而仅仅是因为需要实现<em>CommandLineRunner</em>接口。</p> <h2>两个需要注意的点</h2> <ol> <li> <p><em>@ConditionalOnMissingBean</em>的作用是:只有对应的ban在系统中都没有被创建,它修饰的初始化代码块才会执行,<strong>用户自己手动创建的bean优先</strong>;</p> </li> <li> <p>Spring Boot starter如何找到自动配置文件(xxxxAutoConfiguration之类的文件)?</p> <ul> <li>spring.factories:由<em>Spring Boot触发</em>探测classpath目录下的类,进行自动配置;</li> <li>@Enable<em>:有时需要由starter的</em>用户触发*查找自动配置文件的过程。</li> </ul> </li> </ol> <p>来自: <a href="/misc/goto?guid=4959653371775031594" rel="nofollow" target="_blank">http://www.jianshu.com/p/85460c1d835a</a></p>
本文由用户 jopen 自行上传分享,仅供网友学习交流。所有权归原作者,若您的权利被侵害,请联系管理员。
转载本站原创文章,请注明出处,并保留原始链接、图片水印。
本站是一个以用户分享为主的开源技术平台,欢迎各类分享!