SpringBoot入口类和@SpringBootApplication讲解
作者:程序新视界
入口类和@SpringBootApplication
SpringBoot项目创建完成之后默认会生成一个*Application的入口类,通过该类的main方法即可启动SpringBoot项目。
@SpringBootApplication(exclude = DataSourceAutoConfiguration.class) public class SpringbootRunApplication { public static void main(String[] args) { SpringApplication.run(SpringbootRunApplication.class, args); } }
在此入口类中,我们可以看到SpringBoot创建的业务代码中(除单元测试)唯一的一个注解——@SpringBootApplication,这也是SpringBoot的核心注解。
源代码如下:
@Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Documented @Inherited @SpringBootConfiguration @EnableAutoConfiguration @ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class), @Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) }) public @interface SpringBootApplication { /** * 根据类排除不使用的自动配置 */ @AliasFor(annotation = EnableAutoConfiguration.class) Class<?>[] exclude() default {}; /** * 根据类名排除不使用的自动配置 */ @AliasFor(annotation = EnableAutoConfiguration.class) String[] excludeName() default {}; /** * 指定扫描的包 */ @AliasFor(annotation = ComponentScan.class, attribute = "basePackages") String[] scanBasePackages() default {}; /** * 指定扫描的类 */ @AliasFor(annotation = ComponentScan.class, attribute = "basePackageClasses") Class<?>[] scanBasePackageClasses() default {}; }
该注解自身为我们提供了四个可配置项:
exclude
:根据类排除不使用的自动配置;excludeName
:根据类名排除不使用的自动配置;scanBasePackages
:扫描指定的包;scanBasePackageClasses
:扫描指定的类;
@SpringBootApplication组合了@SpringBootConfiguration、@EnableAutoConfiguration、@ComponentScan,因此我们也可以直接使用这三个注解来替代它。
在早期版本并没有@SpringBootConfiguration,之后使用了@SpringBootConfiguration并在其中组合了@Configuration注解。在@EnableAutoConfiguration注解中组合了@AutoConfigurationPackage。
@ComponentScan相关使用
@ComponentScan用来指定扫描的组建所在的包路径或class文件。在不指定参数的时候,SpringBoot的@ComponentScan默认会扫描同目录及同目录下级目录的类文件。通过部分源码我们可以明确的看到。
@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.TYPE}) @Documented @Repeatable(ComponentScans.class) public @interface ComponentScan { @AliasFor("basePackages") String[] value() default {}; @AliasFor("value") String[] basePackages() default {}; ScopedProxyMode scopedProxy() default ScopedProxyMode.DEFAULT; String resourcePattern() default “**/*.class"; // 省略掉部分源码 }
上面的源码重点看一下属性resourcePattern的默认值“**/*.class”,可以看出,如果不指定其他参数的话,默认会去寻找同级目录下的class。
在构造SpringBoot项目时,往往会出现这样一种情况:因为忘记或不知道SpringBoot默认扫描的路径,随意创建包和类的位置,导致项目启动之后,无法实例化对应的组建,无法正确访问接口。
当然,如果是有意为之,那么我们就可以使用@SpringBootApplication或@ComponentScan来指定一些特殊的需要实例化的包或类。
@SpringBootApplication(scanBasePackages = “com.secbro2.controller") // 或 @ComponentScan(basePackages = "com.secbro2.controller")
@EnableAutoConfiguration
@EnableAutoConfiguration让SpringBoot可以根据类路径中的jar包依赖可以为项目进行一些自动配置。这也是SpringBoot最核心的功能。当然,前提条件是依赖需要按照starter的规则来构建。
比如,我们添加了web的starter,那么SpringBoot就会自动添加Tomcat和SpringMVC的依赖,然后又会进行一些相应的默认配置。但有些依赖需要我们自己去配置一些内容,比如虽然引入了data-jpa的starter,但是如果我们不配置对应的数据源,程序肯定没办法正常启动。
关闭自动配置
自动配置有它的便捷之处,但在某些情况下,我们可能并不需要一些自动配置。比如,虽然引入了data-jpa的依赖,但此刻并不需要连接数据库。那么,就可以通过注解将此自动配置进行关闭。@SpringBootApplication为我们提供了相应的功能。
@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
为什么是SpringBoot
面试中可能会被问到:为什么我们要使用SpringBoot?
你可能会说:因为SpringBoot用java配置替代了xml配置,或因为它内置Tomcat,可以直接打成jar包,通过java -jar快速启动等;但这都不是重点,重点是刚刚说的@EnableAutoConfiguration实现的功能:自动配置。基于编程的一个共识:约定优于配置。这也正是SpringBoot的核心。
回想一下,在使用SpringBoot的过程中,当用到某个组件,只需引入相应的依赖(starter)。此时SpringBoot已经帮我们把相关的依赖引入,配置好最基本的参数。然后我们根据需要再在application.yml文件中配置一些明确的参数(比如:数据库地址、用户名等),就完成了一个组件的集成,可以专注业务代码的编写了。
SpringBoot主程序类,主入口类
主程序类,主入口类
/** * @SpringBootApplication 来标注一个主程序类,说明这是一个Spring Boot应用 */ @SpringBootApplication public class HelloWorldMainApplication { public static void main(String[] args) { SpringApplication.run(HelloWorldMainApplication.class,args); } }
@SpringBootApplication
:Spring Boot应用标注在某个雷尚说明这个类是Spring Boot的主配置类,Spring Boot就应该允许这个类的main方法来启动SpringBoot应用;@SpringBootConfiguration
:SpringBoot的配置类;表追在某个类上,标识这是一个SpringBoot的配置类@Configuration: 配置雷尚来标注这个注解
配置类----配置文件;配置类也是容器中的一个组件;@Component
@EnableAutoConfiguration
:开启自动配置功能,以前我们需要配置的东西,SpringBoot开启自动配置功能;这样自动配置才能生效;@AutoConfigurationPackage
:自动配置包
@Import(AutoConfigurationPackages.Registrar.class);
Spring的底层注解@import,给容器中导入一个组件;导入 的组件由AutoConfigurationPackages.Registrar.class
将主配置类(@SpringBootApplication标注的类)的所有包及下面所有组件扫描到Spring容器;
@Import(AutoConfigurationPackages.Registrar.class);
给容器中导入组件
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。