SpringBoot入门与配置文件

时间:2022-08-26 20:36:52

1、Spring Boot来简化Spring应用开发,约定大于配置,去繁从简,just run就能创建一个独立的,产品级别的应用。

2、Spring Boot ——>J2EE一站式解决方案。
     Spring Cloud——>分布式整体解决方案。

3、优点:①、快速创建独立运行的Spring项目以及与主流框架集成。
             ②、使用嵌入式的Servlet容器,应用无需打包成war包。
             ③、starters自动依赖与版本控制。
             ④、大量的自动配置,简化开发,也可以修改默认值。
             ⑤、无需配置XML,无代码生成,开箱即用。
             ⑥、准生产环境的运行时应用监控。
             ⑦、与云计算的天然集成。

4、微服务:每一个功能元素最终都是一个可独立替换和独立升级的软件单元,可以通过HTTP的方式进行互通。
     单体应用特点:develop、test、deploy、scale(水平扩展)简单方便。

5、解决微服务存在的部署和运维难的问题:Spring Boot
  SpringBoot入门与配置文件

                                                    搭建项目                       构建连接                       批处理

6、Spring Boot HelloWorld
    (1)、创建一个maven工程;(jar)
    (2)、在pom.xml中导入相关依赖:

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.0.RELEASE</version>
</parent>
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>
    (3)、编写一个主程序,启动SpringBoot应用
@SpringBootApplication
public class Hello {
    public static void main(String[] args) throws Exception {
        //启动spring应用
        SpringApplication.run(Hello.class, args);
    }
}
    (4)、编写相关的Controller、Service类
@Controller
public class HelloController {
    @ResponseBody
    @RequestMapping("/hello")
    public String hello(){
        return "hello world!";
    }
}
    (5)运行主测试程序。
    (6)简化部署应用<可以将应用打包成一个可执行的jar包>
<build>
	<plugins>
		<plugin>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-maven-plugin</artifactId>
		</plugin>
	</plugins>
</build>
将应用打成jar包(<Maven Project>窗口-package),通过命令行java -jar jar文件名.jar  即可。

7、Hello World探究---POM文件
    (1)、父项目:

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.0.RELEASE</version>
    </parent>
 它的父项目
 <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-dependencies</artifactId>
        <version>2.0.0.RELEASE</version>
        <relativePath>../../spring-boot-dependencies</relativePath>
    </parent>
它来真正管理Spring Boot应用里面的所有依赖的版本。

Spring Boot的版本仲裁中心
以后我们导入依赖默认是不需要写版本;(没有在dependencies里面管理的依赖,需要声明版本号)

    (2)、启动器
       <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
spring-boot-starter-web:spring-boot-starter:spring-boot场景启动器;帮我们导入了web模块正常运行所依赖的组件;
Spring Boot将所有的功能场景都抽取出来,做成一个个的starters(启动器),只需要在项目里面引入这些starter相关场景的所有依赖都会导入进来。要用什么功能就导入什么场景启动器。
    (3)、主程序类
@SpringBootApplication
public class Hello {
    public static void main(String[] args) {
        SpringApplication.run(Hello.class,args);
    }
}
@SpringBootApplication:Spring Boot应用在某个类上,说明这个类是SpringBoot的主配置类,SpringBoot就应该运行这个类的main方法来启动SpringBoot。
@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的配置类;标注在某个类上,表示这是一个Spring Boot的配置类。
              @Configuration:配置类上来标注这个注解;配置类-------配置文件;配置类也是容器的一个组件;@Component
 ②、EnableAutoConfiguration:开启自动配置功能。
@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {
@AutoConfigurationPackage:自动配置包
@Import(AutoConfigurationPackages.Registrar.class)//给容器中导入一个组件;导入的组件由此组建决定。
public @interface AutoConfigurationPackage {
@Import(AutoConfigurationPackages.Registrar.class)作用: 将主配置类的所在包既下边所有子包里面的所有组件扫描到Spring容器中。  
    AutoConfigurationImportSelector:导入那些组件的选择器;将所有需要导入的组件以全类名的方式返回;这些组件就会被添加到容器中。
    会给容器中导入非常多的自动配置类(xxxAutoConfiguration);就是给容器中导入这个场景需要的所有组件,并配置好这些组件。有了自动配置类,免去了我们手动编写配置注入功能组件等的工作;
    SpringFactoriesLoader.loadFactoryNames(EnableAutoConfiguration.class,classLoader);

SpringBoot在启动的时候从类路径下的META-INF/spring.factories中获取EnableAutoConfiguration指定的值,将这些值作为自动配置类导入到容器中,自动配置类就生效,帮我们进行自动配置工作。   
    所有配置的环境都在spring-boot-autoconfigure-2.0.0.RELEASE.jar中
8、使用Spring Initializer快速创建Spring Boot项目

SpringBoot入门与配置文件

注意:Artifact中不能大小写混合使用。
SpringBoot入门与配置文件
添加controller层:@RestController == @ResponseBody与@Controller的合体

/*@ResponseBody
@Controller*/
@RestController
public class HelloWordController {
    @RequestMapping("/hello")
    public String hello(){
        return "hell";
    }
}
默认生成的SpringBoot项目,我们只需要编写自己的逻辑
resources目录结构:
    ①、static:保存所有的静态资源。 《js/css/image》
    ②、templates:保存所有的模板页面;(SpringBoot默认jar包使用嵌入式的Tomcat,默认不支持JSP页面)但可以使用模板引擎(freemarker、thymeleaf)
  ③、application.properties:SpringBoot应用的配置文件。默认的配置都在此文件可以修改。(修改端口:server.port=8081)

9、Spring Boot配置
【1】、配置文件:①、application.properties。②、application.yml
 配置文件的作用:修改SpringBoot自动配置的默认值;SpringBoot在底层都给我们配置好;
 YAML(is not a Markup Language:不仅仅是一个标记语言):以前的配置文件,大多是xx.xml文件,而YAML是以数据为中心,比json、xml等更适合做配置文件。

server:
   port:8081
【2】YML语法:
        基本语法:k:(空格)v--->表示一对键值对。(以空格缩进来控制层级关系;只要是左对齐的一列数据,都是同一层级)属性和值也是大小写敏感。
        值得写法:(1)字面量:普通的值(数字、字符串、布尔)
                                ---字符串默认是不用加上单引号或者双引号
                                ---“”:双引号,不会转义字符串里面的特殊字符;特殊字符会作为本身想表达的意思。

                                      eg:(name:"zhangsan \n lisi"  输出:zhangsan
                                                                                                   lisi)
                                ---'':单引号,会转义字符,特殊字符最终只是一个普通的字符串数据。
                        (2)、对象、Map(属性和值)(键值对)
                               ---k: v
                                ---对象还是k: v的方式
                                     eg: friends:
                                                lastName: zhangsan           
                                                age:20
                                ---行内写法:friends: {lastName: zhangsan,age: 20}
                        (3)、数组(List、Set)
                              ---用- 值表示数组中的一个元素
                                    eg: pets:
                                            - cat
                                            - dog
                              ---行内写法:pets: [cat,dog]

【3】、配置文件注入
  (1)配置文件:application.yml
person:
  lastName: zhangsan
  age: 20
  boss: false
  birth: 2018/8/20
  map: {k1: v1,k2: v2}
  lists: [listi,zhaoliu]
  dog:
    name: gou
    age: 2
 (2)、JavaBean:@ConfigurationProperties(prefix ="person")表示将配置文件中的person的每一个属性映射到这个组件中,但只有这个组件是容器中的组件,才能提供功能。需要使用@Component标注才能成为容器组件。
@Component
@ConfigurationProperties(prefix ="person")
public class Person {
    private String lastName;
    private Integer age;
    private boolean boss;
    private Date birth;
    private Map<String,String> map;
    private List lists;
    private Dog dog;
}
 (3)、会提示我们在pom文件中导入配置文件编辑,以后编写配置就有提示。
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>
【4】、properties中的语句
person.last-name=张三
person.age=18
person.birth=2013/04/23
person.boss=false
person.map.key1=v1
person.map.key2=v2
person.lists=a,b,c
person.dog.name=dog
person.dog.age=2
10、中文乱码设置:
SpringBoot入门与配置文件
11、@ Value(“字面量/${key}从环境变量、配置文件中获取值/#{SpEL}”)---三种传值方式
@Component
//@ConfigurationProperties(prefix ="person")
public class Person {
    @Value("${person.last-name}")
    private String lastName;
    @Value("#{22*3}")
    private Integer age;
    @Value("true")
    private boolean boss;
与@ConfigurationProperties的区别:
  @configuration @value
功能 批量注入配置文件中的属性 每个属性单独配置
松散绑定(松散语法) 支持(大小写不敏感) 不支持(与配置文件保持一致)
SpEL 不支持(不能用于逻辑计算) 支持#{逻辑计算}
JSR303数据校验 支持@validated 不支持
复杂类型封装 支持 不支持(map对象)
配置文件数据校验
@Component
@ConfigurationProperties(prefix ="person")
@Validated
public class Person {
    //@Value("${person.last-name}")
    @Email
    private String lastName;
12、@PropertySource&&@ConfigurationProperties之间的区别

        @ConfigurationProperties:默认从全局配置文件中加载值。
        @PropertySource:指向自己定义的properties配置文件。
    新建person.properties配置文件,并赋值

@PropertySource(value = {"classpath:person.properties"})
@Component
//@ConfigurationProperties(prefix ="person")
//@Validated
public class Person {
    @ImportResource:导入Spring的配置文件,让配置文件里面的内容生效 。
    ①、定义配置文件bean.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.atguigu.Servers.HelloService"></bean>
</beans>
    ②、在主程序中使用@ImportResource
@ImportResource(locations={"classpath:bean.xml"})
@SpringBootApplication
public class HellowordQuickStartApplication {
    SpringBoot中(配置类====配置文件xml)推荐使用配置类,如下创建
@Configuration
public class MyAppConfig {
    //@bean注解就相当于<bean></bean>标签
    @Bean
    //方法名就相当于xml中的id
    public HelloService helloService(){
        System.out.println("@Bean给容器中添加组件");
        return new HelloService();
    }
}
13、配置文件占位符
【1】、随机数
${random.value}、${random.int}、${random.log}、${random.int(10)}
【2】、占位符(当属性不存在时,可以给一个默认值,例如下面的20)
persion.last-name=张三
persion.dog.name=${persion.last_name}_dog
perdion.dog.age=${persion.noexistage:20}
14、Profile:是Spring对不同环境提供不同配置功能的支持,可以通过激活、指定参数等方式快速切换环境
【1】、多profile文件形式:
    我们在编写主配置文件的时候,文件名可以是application-{profile}.properties/yml
    默认使用application.properties的配置。
【2】、yml支持多文档块方式(推荐使用)
     SpringBoot入门与配置文件
    通过“---”来划分文档块,Document表示所处模块的位置/总块 。
【3】、激活指定profile
    (1)、在默认配置application.properties中设置spring.profiles.active属性 
        spring.profiles.active=dev
              SpringBoot入门与配置文件
    (2)、命令行:--spring.profiles.active=dev
SpringBoot入门与配置文件
命令行运行jar包的方式:java -jar xxx.jar --spring.profiles.active=dev;
    (3)、虚拟机参数:-Dspring.profiles.active=prod

SpringBoot入门与配置文件

15、配置文件加载位置:
SpringBoot启动会扫描一下位置的application.properties或者application.yml文件作为SpringBoot的默认配置文件
            (1)、file:./config/
            (3)、file:./
            (4)、classpath:/config/
            (5)、classpath:/
            以上是按照优先级从高到低的顺序,所有位置的文件都会被加载,高优先级配置内容会覆盖低优先级配置的相同内容
            我们也可以通过spring.config.location来改变默认配置(项目打包成功以后,我们可以使用命令行参数的形式,启动项目来指定配置文件的新位置;指定的配置文件会共同起作用,形成互补作用)

java -jar xxx.jar --spring.config.location=d:\xxx.properties
16、自动配置原理:
【1】、SpringBoot启动的时候加载主配置类,开启了主配置功能@EnableAutoConfiguration
【2】、@EnableAutoConfiguration作用:
            ①、利用EnableAutoConfigurationImportSelector给容器导入一些组件。
            ②、可以查看selectImports()方法的内容:
                 List configurations = getCandidateConfigurations(annotationMetadata, attributes);获取候选的配置
                SpringFactoriesLoader.loadFactoryNames()扫描所有jar包类路径下 META‐INF/spring.factories把扫描到的这些文件的内容包装成properties对象从properties中获取到EnableAutoConfiguration.class类(类名)对应的值,然后把他们添加在容器中
【3】、将 类路径下 META-INF/spring.factories 里面配置的所有EnableAutoConfiguration的值加入到了容器中;
# Auto Configure
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
org.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration,\
org.springframework.boot.autoconfigure.aop.AopAutoConfiguration,\
org.springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration,\
org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration,\
org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration,\
org.springframework.boot.autoconfigure.cassandra.CassandraAutoConfiguration,\
org.springframework.boot.autoconfigure.cloud.CloudAutoConfiguration,\
org.springframework.boot.autoconfigure.context.ConfigurationPropertiesAutoConfiguration,\
org.springframework.boot.autoconfigure.context.MessageSourceAutoConfiguration,\
org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration,\
org.springframework.boot.autoconfigure.couchbase.CouchbaseAutoConfiguration,\
org.springframework.boot.autoconfigure.dao.PersistenceExceptionTranslationAutoConfiguration,
每一个这样的 xxxAutoConfiguration类都是容器中的一个组件,都加入到容器中;用他们来做自动配置;
【4】、每一个自动配置类进行自动配置功能,以HttpEncodingAutoConfiguration(Http编码自动配置)为例解释自动配置原理;
@Configuration //表示这是一个配置类,以前编写的配置文件一样,也可以给容器中添加组件
@EnableConfigurationProperties(HttpEncodingProperties.class) //启动指定类的
ConfigurationProperties功能;将配置文件中对应的值和HttpEncodingProperties绑定起来;并把
HttpEncodingProperties加入到ioc容器中
@ConditionalOnWebApplication //Spring底层@Conditional注解(Spring注解版),根据不同的条件,如果
满足指定的条件,整个配置类里面的配置就会生效; 判断当前应用是否是web应用,如果是,当前配置类生效
@ConditionalOnClass(CharacterEncodingFilter.class) //判断当前项目有没有这个类
CharacterEncodingFilter;SpringMVC中进行乱码解决的过滤器;
@ConditionalOnProperty(prefix = "spring.http.encoding", value = "enabled", matchIfMissing =
true) //判断配置文件中是否存在某个配置 spring.http.encoding.enabled;如果不存在,判断也是成立的
//即使我们配置文件中不配置pring.http.encoding.enabled=true,也是默认生效的;
public class HttpEncodingAutoConfiguration {
//他已经和SpringBoot的配置文件映射了
private final HttpEncodingProperties properties;
//只有一个有参构造器的情况下,参数的值就会从容器中拿
public HttpEncodingAutoConfiguration(HttpEncodingProperties properties) {
    this.properties = properties;
}

@Bean //给容器中添加一个组件,这个组件的某些值需要从properties中获取
@ConditionalOnMissingBean(CharacterEncodingFilter.class) //判断容器没有这个组件?
public CharacterEncodingFilter characterEncodingFilter() {
    CharacterEncodingFilter filter = new OrderedCharacterEncodingFilter();
    filter.setEncoding(this.properties.getCharset().name());
    filter.setForceRequestEncoding(this.properties.shouldForce(Type.REQUEST));
    filter.setForceResponseEncoding(this.properties.shouldForce(Type.RESPONSE));
    return filter;
}

根据当前不同的条件判断,决定这个配置类是否生效?一但这个配置类生效;这个配置类就会给容器中添加各种组件;这些组件的属性是从对应的properties类中获取的,这些类里面的每一个属性又是和配置文件绑定的;

【5】、所有在配置文件中能配置的属性都是在xxxxProperties类中封装者;配置文件能配置什么就可以参照某个功能对应的这个属性类
@ConfigurationProperties(prefix = "spring.http.encoding") //从配置文件中获取指定的值和bean的属
性进行绑定
public class HttpEncodingProperties {
public static final Charset DEFAULT_CHARSET = Charset.forName("UTF‐8");

精髓: 1)、SpringBoot启动会加载大量的自动配置类
         2)、我们看我们需要的功能有没有SpringBoot默认写好的自动配置类;
         3)、我们再来看这个自动配置类中到底配置了哪些组件;(只要我们要用的组件有,我们就不需要再来配置了)
         4)、给容器中自动配置类添加组件的时候,会从properties类中获取某些属性。我们就可以在配置文件中指定这些属性的值;
xxxxAutoConfigurartion:自动配置类,给容器中添加组件。
xxxxProperties:封装配置文件中相关属性;

16、@Conditional派生注解(Spring注解版原生的@Conditional作用)作用:必须是@Conditional指定的条件成立,才给容器中添加组件,配置配里面的所有内容才生效;

SpringBoot入门与配置文件

自动配置类必须在一定的条件下才能生效;
我们可以通过在配置文件启用 debug=true属性;

debug=true
通过控制台打印自动配置报告,我们就可以知道哪些自动配置类生效(Positive matches:)
Positive matches:
-----------------

   CodecsAutoConfiguration matched:
      - @ConditionalOnClass found required class 'org.springframework.http.codec.CodecConfigurer'; @ConditionalOnMissingClass did not find unwanted class (OnClassCondition)

   CodecsAutoConfiguration.JacksonCodecConfiguration matched:
      - @ConditionalOnClass found required class 'com.fasterxml.jackson.databind.ObjectMapper'; @ConditionalOnMissingClass did not find unwanted class (OnClassCondition)

   CodecsAutoConfiguration.JacksonCodecConfiguration#jacksonCodecCustomizer matched:
      - @ConditionalOnBean (types: com.fasterxml.jackson.databind.ObjectMapper; SearchStrategy: all) found bean 'jacksonObjectMapper' (OnBeanCondition)

   DispatcherServletAutoConfiguration matched:
      - @ConditionalOnClass found required class 'org.springframework.web.servlet.DispatcherServlet'; @ConditionalOnMissingClass did not find unwanted class (OnClassCondition)
      - found ConfigurableWebEnvironment (OnWebApplicationCondition)

自动配置未生效类(Negative matches:)
Negative matches:
-----------------

   ActiveMQAutoConfiguration:
      Did not match:
         - @ConditionalOnClass did not find required classes 'javax.jms.ConnectionFactory', 'org.apache.activemq.ActiveMQConnectionFactory' (OnClassCondition)

   AopAutoConfiguration:
      Did not match:
         - @ConditionalOnClass did not find required classes 'org.aspectj.lang.annotation.Aspect', 'org.aspectj.lang.reflect.Advice', 'org.aspectj.weaver.AnnotatedElement' (OnClassCondition)

   ArtemisAutoConfiguration:
      Did not match:
         - @ConditionalOnClass did not find required classes 'javax.jms.ConnectionFactory', 'org.apache.activemq.artemis.jms.client.ActiveMQConnectionFactory' (OnClassCondition)