基础

版本支持时间：https://spring.io/projects/spring-boot#support

springboot 3.x 要求 JDK 17

配置

文件加载顺序

SpringBoot 启动会扫描以下位置的 application.yml 或者 application.properties 文件作为SpringBoot的默认配置文件。

# 优先级由高到低
-file:./config/
-file:./
-classpath:/config/
-classpath:/

还可以通过spring.config.location来改变默认的配置文件位置。

java -jar spring-boot-02-config-02.0.0.1-SNAPSHOT.jar  --spring.config.location=G:/application.properties

内置Tomcat配置

# 最大工作线程数，默认200。
# 线程数的经验值为：1核2G内存，线程数经验值200；4核8G内存， 线程数经验值800。
server.tomcat.max-threads=200

# 最大连接数默认是10000
server.tomcat.max-connections=10000

# 等待队列长度，默认100。
server.tomcat.accept-count=100

# 最小工作空闲线程数，默认10。
server.tomcat.min-spare-threads=100

注解

常用注解

@Controller，@RestController

@GetMapping，@PostMapping

@RequestBody，@ResponseBody

@ControllerAdvice

和@ExceptionHandler、@InitBinder以及@ModelAttribute注解搭配使用，主要是用来处理控制器所抛出的异常信息；

@ExceptionHandler

@RequestParam，@PathVariable

@CrossOrigin

@Component，@ComponentScan

Spring DI注解：

@DependsOn

@Bean

@Scope

singleton、prototype、request、session、globalSession

@Autowired

@Primary

定义这些Bean的优先级

SpringBoot注解

@SpringBootApplication

@EnableAutoConfiguration

@ConditionalOnClass与@ConditionalOnMissingClass

@ConditionalOnMissingBean，@ConditionalOnMissingBean

@ConditionalOnProperty，@ConditionalOnResource

第三方包的注解生效

@ComponentScan

@SpringBootApplication注解默认扫描只是当前项目的本包和它的子包，@ComponentScan主要就是定义扫描的路径从中找出标识了需要装配的类自动装配到spring的bean容器中。

@Import

@ComponentScan是扫描整个包,但其实你可能只需注入一个或者几个指定的Bean，那我们可以考虑用 @Import 注解。

可以通过注解，表明是否需要引入；

@Retention(value = RetentionPolicy.RUNTIME)
@Target(value = {ElementType.TYPE})
@Documented
// 按实际引入
@Import(XXX.class)
public @interface EnableDataPermission {
}

在 Application中添加，即可开启

@EnableDataPermission
@SpringBootApplication
public class Main {
    public static void main(String[] args) {
        SpringApplication.run(Main.class, args);
    }
}

@EnableAutoConfiguration

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
// 自动配置包
@AutoConfigurationPackage
// 给IOC容器导入组件
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {
    String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
    Class<?>[] exclude() default {};

    String[] excludeName() default {};
}

上面两种注入方式都有个很明显缺点，就是如果我需要引用外部jar包的Bean的时候，都需要在当前项目配置 @ComponentScan 或者 @Import 去扫描才能注入当前Bean，这样显然不够友好。

只需要在将配置放在第三方jar指定的文件中即可，使用者会自动加载，从而避免的代码的侵入

在资源目录下新建目录 META-INF
在 META-INF 目录下新建文件 spring.factories
在文件中添加下面配置

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.third.bean.ConfigurationBean

Spring Boot 3将移除对/META-INF/spring.factories的支持。

新的写法是创建一个新的文件：

/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

内容直接放配置类即可，如：

com.example.swagger.SwaggerAutoConfiguration

Spring 全局资源的加载

实现CommandLIneRunner 或者 ApplicationRunner，实现 run 方法

Runner

项目启动后立马执行一些逻辑：

@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
public class Agent {
    public static void main(String[] args) {
        SpringApplication.run(Agent.class, args);
        // Want to execute other logic
    }
}

如果采用tomcat服务，则运行的时候，run后面的逻辑不会执行。

解决方法：

CommandLineRunner 是 Spring Boot 提供的一个接口，当你实现该接口并将之注入Spring IoC容器后，Spring Boot应用启动后就会执行其run方法。

ApplicationRunner 接收一个封装好的对象参数ApplicationArguments。除此之外它们功能完全一样

@Slf4j
@Component
public class HighOrderCommandLineRunner implements CommandLineRunner, Ordered {
    @Override
    public void run(String... args) throws Exception {
        // 不应该阻塞，如果需要阻塞，则另起线程
        for (String arg : args) {
            log.info("arg = " + arg);
        }
        log.info("i am highOrderRunner");
    }

    @Override
    public int getOrder() {
        return Integer.MIN_VALUE+1;
    }
}