探究Spring Boot核心技术 1.0
POM 文件
1.父项目
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.1.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
他的父项目是
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.1.1.RELEASE</version>
<relativePath>../../spring-boot-dependencies</relativePath>
</parent>
这个父项目是真正管理Spring Boot应用里面所有依赖版本,
因为里面有一个dependency version, 为各种jar包定义了默认的版本号
Spring Boot的版本仲裁中心;
以后我们导入依赖默认是不需要写版本的, (在没有dependencies里面管理的依赖自然要声明版本号)
2.起步依赖
- Spring-boot-starter 场景启动器
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
- 举个例子,spring-boot-starter-web,帮我们导入web应用开发所需要的所有依赖
- Spring boot 把所有的功能场景都抽取出来,做成一个个starters(启动器), 只需要在项目里面导入这些starters, 所有相关的依赖都会导入进来
- 一般需要什么功能就导入什么场景的启动器
主程序类,主入口类
/**
* SpringBootApplication 来标注一个主程序类, 说明这是一个Spring Boot 应用
*/
@SpringBootApplication
public class SpringbootSampleApplication {
public static void main(String[] args) {
SpringApplication.run(SpringbootSampleApplication.class, args);
}
}
- @SpringBootApplication: Spring Boot应用标注在某个类上来说明这个类是Spring Boot的主配置类, Spring Boot就应该运行这个类的main方法来启动Spring Boot应用
/**
*SpringBootApplication 部分源码
*/
@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 {
- @SpringBootConfiguration : Spring Boot的配置类
- @EnableAutoConfiguration: 开启自动配置功能
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import({AutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {
- @AutoConfiguraPackage:将主配置类(@SpringBootApplication标注的类)的所在包以及下面所有子包里面的所有组件都扫描到Spring容器中, 这一点要特别注意!!!
- 举个例子
Spring Boot 目录结构
- 这里主要说resources文件夹下面的结构
- static: 保存所以静态资源, 如js css images等等
- templates: 保存所以模板页面, Spring Boot默认jar包使用嵌入式tomcat, 默认不支持JSP页面, 可以使用模板引擎(freemarker, 或者Spring Boot推荐的thymeleaf)
- application.properties : Spring Boot 的配置文件, 可以修改一些默认配置
Spring Boot配置文件
1.配置文件
Spring Boot 使用一个全局的配置文件, 配置文件名是固定的
- application.properties
- application.yml (推荐使用)
配置文件的作用在于: 修改Spring Boot自动配置的默认值
2.YAML基本语法
- 键值对的形式, 以空格来控制层级关系
- k:(空格)v
- 空格不能省, 大小写敏感
- 推荐使用YMAL来做配置文件, 例子
server:
port: 8081
- YAML value的写法值得需要注意的地方
- 字符串默认不用加上单引号或者双引号
- 如果加上双引号, 则不会转义字符串里面的特殊字符, 如 "wt \n wt" 输出的是 "wt \n wt"
- 如果加上单引号, 则会转义字符串里面的特殊字符, 如 "wt \n wt" 输出的是 "wt 换行 wt"
- 数组, 使用-值表示数组中的一个元素
pets: - cats - dog - pig
3. YAML配置文件值注入
- 此处举例子进行说明
- 首先编写YAML文件
person:
name: wt
age: 22
maps: {k1: v1, k2: v2}
dog:
name: my_dog
age: 2
- 导入依赖
<!--导入配置文件处理器-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>
- JAVABean
/**
* 将配置文件中配置的每一个属性的值,映射到这个组件中
* @ConfigurationProperties 告诉Spring Boot 将本类中的所有属性和配置文件中的相关配置进行绑定
* prefix = "person" 配置文件中哪一个属性进行绑定, 以person开头的值
*
* 只有这个组件是容器中的组件,才能使用容器提供的@ConfigurationProperties功能
*/
@Component
@ConfigurationProperties(prefix = "person")
public class Person {
private String name;
private Integer age;
private Map<String, Object> maps;
private Dog dog;
---
}
- JAVABean
public class Dog {
private String name;
private Integer age;
---
}
- 测试
@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringbootSampleApplicationTests {
@Autowired
Person person;
@Test
public void contextLoads() {
System.out.println(person);
}
}
输出 Person{name='wt', age=22, maps={k1=v1, k2=v2}, dog=Dog{name='my_dog', age=2}}
4. @Value 和 @ConfigurationProperties的区别
如果说, 我们只是需要在某个业务逻辑中获取一下配置文件的某个值, 则使用@Value, 可读取YAML文件
@RestController
public class HelloController {
@Value("${person.name}")
private String name;
@RequestMapping("/sayHello")
public String sayHello() {
return "hello " + name;
}
}
如果需要与一个JAVABean进行映射,则使用@ConfigurationProperties来批量注入
5.介绍两个有用且相关的注解, @PropertySource 和 @ImportResource
首先先介绍@PropertySource, 此处有一点值得注意的是,官网里面有这样一句话:YAML files cannot be loaded by using the @PropertySource annotation. So, in the case that you need to load values that way, you need to use a properties file. 意思就是说, @PropertySource只能用于.properties文件而不能用于YMAL文件, 所以, 此处我们还是举个例子来进行说明.
- 创建person.properties 文件
person.name=wt
person.age=22
person.maps.k1=v1
person.maps.k2=v2
person.dog.name=my_dog
person.dog.age=2
- 修改Person类, 添加@PropertySource(value = {"classpath:person.properties"})
/**
* 将配置文件中配置的每一个属性的值,映射到这个组件中
* @ConfigurationProperties 告诉Spring Boot 将本类中的所有属性和配置文件中的相关配置进行绑定
* prefix = "person" 配置文件中哪一个属性进行绑定 默认从全局配置获取值, 以person开头的值
*
* 只有这个组件是容器中的组件,才能使用容器提供的@ConfigurationProperties功能
*/
@PropertySource(value = {"classpath:person.properties"})
@Component
@ConfigurationProperties(prefix = "person")
public class Person {
private String name;
private Integer age;
private Map<String, Object> maps;
private Dog dog;
---
接下来, 介绍@ImportResource, 它的作用是引入Spring 配置文件, Spring Boot里面没有Spring的配置文件, 我们自己写的配置文件是不能被自动识别的, 此时, 便要使用@ImportResource, 放在一个配置类上
举个例子
- 创建一个XML文件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="helloService" class="com.example.springbootsample.service.HelloService"></bean>
</beans>
- 添加@ImportResource到主配置类中
/**
* SpringBootApplication 来标注一个主程序类, 说明这是一个Spring Boot 应用
*/
@ImportResource(locations = {"classpath:beans.xml"})
@SpringBootApplication
public class SpringbootSampleApplication {
public static void main(String[] args) {
SpringApplication.run(SpringbootSampleApplication.class, args);
}
}
- 测试
@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringbootSampleApplicationTests {
@Autowired
Person person;
@Autowired
ApplicationContext ioc;
@Test
public void testHelloService() {
boolean b = ioc.containsBean("helloService");
System.out.println(b);
}
}
输出true
然而, Spring Boot 不推荐使用XML, 而是使用全注解的方式来为容器添加组件
- 创建一个配置类
- 使用@Bean来给容器添加组件
package com.example.springbootsample.config;
import com.example.springbootsample.service.HelloService;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* @Configuration 指明当前类是一个配置类, 来替代之前的Spring配置文件
*
* 在Spring配置文件中, 这是用<bean></bean>标签来添加组件的
*
*/
@Configuration
public class MyAppConfiguration {
// 将方法的返回值添加到容器中, 容器中默认的组件id就是这个方法名helloService01
@Bean
public HelloService helloService01() {
System.out.println("添加组件");
return new HelloService();
}
}
6.配置文件占位符
- 随机数
${random.value} ${random.int} ${random.long} ${random.int[1024, 65536]}
- 使用占位符获取之前配置的值, 如果没有, 则使用 : 指定默认值
person.name=wt${random.uuid}
person.age=22
person.maps.k1=v1
person.maps.k2=${person.hello:hello}
person.dog.name=my_dog
person.dog.age=2
7.Profile
Profile 是 Spring 对不同环境提供不同配置功能的支持, 可以通过激活或者指定参数等方式快速切换环境, 默认使用application.properties
- 多Profile文件形式:
- 格式: application-{profile}.properties/yml
- 如: application-dev.properties
- 激活指定的profile
- 在默认的配置文件中, 指定spring.profiles.ative=dev, 则会使用application-dev.properties
- 命令行的方式: --spring.profiles.ative=dev, 可以在java -jar 命令后面写入, 可以在idea tomcat那里配置
- 虚拟机参数-Dspring.profile.active=dev
- YAML可以用文档块来指定不同的环境, 如
server:
port: 8081
spring:
profiles:
active: dev #激活dev环境, 如果不指明, 则使用默认的8081端口
---
server:
port: 8082
spring:
profiles: dev
---
server:
port: 8083
spring:
profiles: prod
8.配置文件的加载位置
Spring Boot 启动会扫描以下位置的application.properties 或 application.yml文件作为spring boot 的配置文件, 优先级从高到底, 高优先级的内容会覆盖低优先级内容
- file:./config/
- file:./
- classpath:/config/
- classpath:/
值得注意的是, Spring Boot会从这四个位置全部加载主配置文件, 且互补配置, 即, 高优先级有的, 使用高优先级, 高优先级没有的而低优先级有的, 则使用低优先级
9.外部配置文件的加载位置
此处内容较多, 建议参考 官方文档中的Externalized Configuration
10.配置原理
配置文件的配置内容, 参考官方文档附录Common application properties
11、@Conditional派生注解(Spring注解版原生的@Conditional作用)
作用:必须是@Conditional指定的条件成立,才给容器中添加组件,配置配里面的所有内容才生效;
@Conditional扩展注解 | 作用(判断是否满足当前指定条件) |
---|---|
@ConditionalOnJava | 系统的java版本是否符合要求 |
@ConditionalOnBean | 容器中存在指定Bean; |
@ConditionalOnMissingBean | 容器中不存在指定Bean; |
@ConditionalOnExpression | 满足SpEL表达式指定 |
@ConditionalOnClass | 系统中有指定的类 |
@ConditionalOnMissingClass | 系统中没有指定的类 |
@ConditionalOnSingleCandidate | 容器中只有一个指定的Bean,或者这个Bean是首选Bean |
@ConditionalOnProperty | 系统中指定的属性是否有指定的值 |
@ConditionalOnResource | 类路径下是否存在指定资源文件 |
@ConditionalOnWebApplication | 当前是web环境 |
@ConditionalOnNotWebApplication | 当前不是web环境 |
@ConditionalOnJndi | JNDI存在指定项 |
12, 打印自动配置类启用报告
在配置文件中加上debug=true属性
控制台便会打印相关的信息
============================
CONDITIONS EVALUATION REPORT
============================
Positive matches: (自动配置类启用的)
-----------------
AopAutoConfiguration matched:
- @ConditionalOnClass found required classes 'org.springframework.context.annotation.EnableAspectJAutoProxy', 'org.aspectj.lang.annotation.Aspect', 'org.aspectj.lang.reflect.Advice', 'org.aspectj.weaver.AnnotatedElement' (OnClassCondition)
- @ConditionalOnProperty (spring.aop.auto=true) matched (OnPropertyCondition)
AopAutoConfiguration.CglibAutoProxyConfiguration matched:
- @ConditionalOnProperty (spring.aop.proxy-target-class=true) matched (OnPropertyCondition)
---
Negative matches: (自动配置类未启用的, 没有匹配成功)
----------------
ActiveMQAutoConfiguration:
Did not match:
- @ConditionalOnClass did not find required class 'javax.jms.ConnectionFactory' (OnClassCondition)
AopAutoConfiguration.JdkDynamicAutoProxyConfiguration:
Did not match:
- @ConditionalOnProperty (spring.aop.proxy-target-class=false) did not find property 'proxy-target-class' (OnPropertyCondition)
---