starter如何设置自动配置注解_java

当前位置：网站建设 > 技术支持

starter如何设置自动配置注解_java

资料来源：网络整理时间：2023/3/9 3:44:33 共计：3565 浏览

starter如何设置自动配置注解？

在了解如何设置自动配置注解之前可以先看看spring-boot的自动配置原理，了解了原理之后，在来看如何配置就很简单了；

SpringBoot自动配置

1.自动配置注解

要想使用自动配置功能，SpringBoot提供了注解@EnableAutoConfiguration，当然不需要我们配置因为在@SpringBootApplication注解中默认以及启用了；

可以看到@SpringBootApplication注解本身也有注解@EnableAutoConfiguration：

在注解@EnableAutoConfiguration中重点看一下@Import注解中使用的AutoConfigurationImportSelector类，此类是自动注解的核心类，会有条件的加载我们默认指定的配置类；这里有两个概念一个是有条件，一个是配置类，分别简单介绍一下：配置类可以简单理解就是相关组件对接SpringBoot的对接类，此类可以做一些初始化的工作；有条件表示并不是有配置类就能被对接上，是有条件的，SpringBoot默认提供了大量配置类，但并不是所有配置类都能被加载初始化的，是有条件的，比如mybatis在没有数据源的情况下，没有mybatis基础包的情况下是不能被对接的；下面首先看一下SpringBoot提供的哪些条件类；

2.条件类

SpringBoot提供了很多条件类，可以在配置中上配置注解条件类，相关条件类可以在spring-boot-autoconfigure包下的org.springframework.boot.autoconfigure.condition下找到，主要包含如下：

ConditionalOnBean：当前容器有指定Bean的条件下；ConditionalOnClass：当前类路径下有指定类的条件下；ConditionalOnCloudPlatform：当指定了云平台的时候；ConditionalOnExpression：SpEL表达式作为判断条件；ConditionalOnJava：JVM版本作为判断条件；ConditionalOnJndi：在JNDI存在的条件下查找指定的位置；ConditionalOnMissingBean：当容器里没有指定Bean的情况下；ConditionalOnMissingClass：当类路径下没有指定的类的条件下；ConditionalOnNotWebApplication：当前项目不是WEB项目的条件下；ConditionalOnProperty：当前应用是否配置了指定属性指定的值；ConditionalOnResource：只有当指定的资源位于类路径下；ConditionalOnSingleCandidate：bean工厂中只有一个或者有多个情况下是主要的候选bean；ConditionalOnWebApplication：当前项目是WEB项目的条件下。

以上是注解类，注解本身没有功能，只是提供标记的功能，具体功能在@Conditional中指定的，比如ConditionalOnBean注解如下所示：

相关功能的实现就在OnBeanCondition类中，同样其他注解类的实现类也在包org.springframework.boot.autoconfigure.condition下找到；

3.自动配置过程

Springboot应用启动过程中使用ConfigurationClassParser分析配置类，此类中有一个processImports方法，此方法用来处理@Import注解，在@EnableAutoConfiguration注解存在@Import注解，这时候会实例化注解中的AutoConfigurationImportSelector，在其内部有一个AutoConfigurationGroup内部类，内部类有两个核心方法分别是：process和selectImports；

此方法主要获取经过条件过滤之后可用的自动配置类，主要调用AutoConfigurationImportSelector中的getAutoConfigurationEntry完成的：

首先获取了所有备选的自动配置类，然后删除了重复和被排除的类，最后通过条件进行筛选出可用的配置类，下面分别看一下，首先看一下如何获取所有备选的配置类：

通过SpringFactoriesLoader获取类路径下META-INF/spring.factories文件中key为org.springframework.boot.autoconfigure.EnableAutoConfiguration的配置类，可以看一下spring-boot-autoconfigure.jar中的spring.factories内容：

当然这里只是截取了其中一个类路径jar下的部分配置，获取所有配置类之后进行去重，去被排除的类，然后进行条件过滤，下面重点看一下：

此方法大致就是首先获取配置的AutoConfigurationImportFilter ，然后对之前获取的所有配置类进行过滤，最后返回过滤之后的配置类；AutoConfigurationImportFilter同样也是通过SpringFactoriesLoader类进行加载类路径下META-INF/spring.factories，只不过当前的key是：org.springframework.boot.autoconfigure.AutoConfigurationImportFilter，可以看一下SpringBoot默认配置的filter：

可以看到Filter其实就是上文介绍的条件类，这里默认了OnBeanCondition，OnClassCondition以及OnWebApplicationCondition，已这里使用的Mybatis为例看一下MybatisAutoConfiguration的注解：

可以看到其中有用到@ConditionalOnClass，表示必须提供SqlSessionFactory和SqlSessionFactoryBean类的情况下才加载此配置类，而整两个是正式Mybatis基础包中提供的；有了基础包还不行，还需要DataSource，而且DataSource必须在MybatisAutoConfiguration实例化之前初始化好，SpringBoot是如何实现，继续看另外一个核心方法selectImports():

首先是对被排除类的一个过滤，然后接下来重点看一下对配置类进行排序的一个方法，具体操作在类AutoConfigurationSorter中进行的，具体方法为getInPriorityOrder():

首先使用order进行排序，然后使用@AutoConfigureBefore和@AutoConfigureAfter就行排序；order其实就是通过注解@AutoConfigureOrder进行排序的，值是一个整数，结构类似如下：

@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE + 10)

@AutoConfigureBefore和@AutoConfigureAfter字面意思也很好理解，指定在其他配置类之前和之后，所以可以看到在MybatisAutoConfiguration中有如下配置：

表示在DataSourceAutoConfiguration配置类加载之后才会加载Mybatis配置类，这样就解决了依赖关系；还有上文提到的Mybatis操作数据库依赖的SqlSessionFactory和SqlSession，都在MybatisAutoConfiguration进行了初始化操作；SpringBoot本身其实以及提供了大量常用组件的自动配置类，我们只需要提供满足的特定条件，SpringBoot自动会帮我加载初始化等操作；

下面用一个简单的实例来看看如何自定义一个自动配置类；

自定义配置类

接下来我们用很简单的实例来看一下自定义的流程，一个格式化大写消息的实例；

1.pom文件引入依赖

Spring 官方 Starter通常命名为spring-boot-starter-{name}如 spring-boot-starter-web，Spring官方建议非官方Starter命名应遵循{name}-spring-boot-starter的格式;

2.服务类和属性配置类

属性类提供了type参数可以在application.properties中配置，可配置值包括：upper，lower；

3.自动配置类和创建spring.factories文件

这个就是自定义的自动配置类，SpringBoot启动的时候会根据条件自动初始化；最后在resources/META-INF/下创建spring.factories文件：

4.测试

在其他SpringBoot中可以引入上面创建的项目，引入方式也很简单：

同时在application.properties配置格式化类型：

启动应用，浏览器访问http://localhost:8888/format?word=hello，结果为：HELLO

以上分析了一下springboot的自动配置原理，并自定义一个自动配置类，并且运行，相信对你有所帮助；

更多可以参考本人之前的文章：https://www.toutiao.com/i6749752249532023309/

版权说明：
本网站凡注明“广州京杭原创”的皆为本站原创文章，如需转载请注明出处！
本网转载皆注明出处，遵循行业规范，如发现作品内容版权或其它问题的，请与我们联系处理！
欢迎扫描右侧微信二维码与我们联系。

·上一条：神乐之真意对神子提升大吗_python | ·下一条：bug单流程是什么_python