20-SpringBoot——核心-运行原理

Spring Boot & Spring Cloud 同时被 2 个专栏收录
43 篇文章 0 订阅
32 篇文章 16 订阅

Spring Boot核心-运行原理


【博文目录>>>】


【项目源码>>>】


【运行原理】


Spring Boot 关于自动配置的源码在spring-boot-autoconfigure-xxx.jar中。可以通过下面三种方式查看当前项目中已启用和未启用的自动配置的报告。

(1) 运行jar 时增加--debug 参数
(2) 在applic剖ion.properties 中设置属性。
(3) 运行时设置JVM启动参数-Ddebug

Spring Boot 的运作原理,它的核心功能是由@EnableAutoConfiguration 注解提供的。

@SuppressWarnings("deprecation")
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import(EnableAutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {
   String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
   Class<?>[] exclude() default {};
   String[] excludeName() default {};
}
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Import(AutoConfigurationPackages.Registrar.class)
public @interface AutoConfigurationPackage {}

@Import 注解导入的配置功能, EnableAutoConfigurationlmportSelector 使用SpringFactoriesLoader.loadFactoryNames方法来扫描具有META-INF/spring.factories文件的jar包,而我们的spring-boot-autoconfigure- xxx.jar 果就有一spring. factories 文件,此文件中声明了有哪些自动配置。

这里写图片描述

这里写图片描述

打开上面任意一个AutoConfiguration 文件,一般都有下面的条件注解,在spring-boot-autoconfigure-xxx.jar 的org.springframwork.boot.autocon figure.condition 包下,条件注解如下。

@ConditionalOnBean :当容器里有指定的Bean 的条件下。
@ConditionalOnClass :当类路径下有指定的类的条件下。
@ConditionalOnCloudPlatform:当指定了云平台的时候
@ConditionalOnExpression :基于SpEL 表达式作为判断条件
@ConditionalOnJava:基于JVM 版本作为判断条件。
@ConditionalOnJndi :在JNDI 存在的条件下查找指定的位置。
@ConditionalOnMissingBean :当容器里没有指定Bean 的情况下。
@ConditionalOnMissingClass :当类路径下没有指定的类的条件下。
@ConditionalOnNotWebApplication :当前项目不是Web 项目的条件下。
@ConditionalOnProperty :指定的属性是否有指定的值。
@ConditionalOnResource :类路径是否有指定的值。
@ConditionalOnSingleCandidate:当指定Bean 在容器中只有一个,或者虽然有多个但是指定首选的Bean
@Conditional On WebApplication:当前项目是Web 项目的条件下。

这些注解都是组合了@Conditional 元注解,只是使用了不同的条件( Condition ),下面我分析一下@ConditionalOn WebApplication 注解。

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnWebApplicationCondition.class)
public @interface ConditionalOnWebApplication {}
@Order(Ordered.HIGHEST_PRECEDENCE + 20)
class OnWebApplicationCondition extends SpringBootCondition {

   private static final String WEB_CONTEXT_CLASS = "org.springframework.web.context." + "support.GenericWebApplicationContext";

   @Override
   public ConditionOutcome getMatchOutcome(ConditionContext context,
         AnnotatedTypeMetadata metadata) {
      boolean required = metadata
            .isAnnotated(ConditionalOnWebApplication.class.getName());
      ConditionOutcome outcome = isWebApplication(context, metadata, required);
      if (required && !outcome.isMatch()) {
         return ConditionOutcome.noMatch(outcome.getConditionMessage());
      }
      if (!required && outcome.isMatch()) {
         return ConditionOutcome.noMatch(outcome.getConditionMessage());
      }
      return ConditionOutcome.match(outcome.getConditionMessage());
   }

   private ConditionOutcome isWebApplication(ConditionContext context,
         AnnotatedTypeMetadata metadata, boolean required) {
      ConditionMessage.Builder message = ConditionMessage.forCondition(
            ConditionalOnWebApplication.class, required ? "(required)" : "");
      if (!ClassUtils.isPresent(WEB_CONTEXT_CLASS, context.getClassLoader())) {
         return ConditionOutcome
               .noMatch(message.didNotFind("web application classes").atAll());
      }
      if (context.getBeanFactory() != null) {
         String[] scopes = context.getBeanFactory().getRegisteredScopeNames();
         if (ObjectUtils.containsElement(scopes, "session")) {
            return ConditionOutcome.match(message.foundExactly("'session' scope"));
         }
      }
      if (context.getEnvironment() instanceof StandardServletEnvironment) {
         return ConditionOutcome
               .match(message.foundExactly("StandardServletEnvironment"));
      }
      if (context.getResourceLoader() instanceof WebApplicationContext) {
         return ConditionOutcome.match(message.foundExactly("WebApplicationContext"));
      }
      return ConditionOutcome.noMatch(message.because("not a web application"));
   }
}

从isWebApplication 方法可以看出,判断条件是:

(1) GenericWebApplicationContext 是否在类路径中:
(2) 容器里是否有名为session 的scope;
(3) 当前容器的Enviroment 是否为StandardServletEnvironment ·
(4) 当前的ResourceLoader 是否为WebApplicationContext ( ResourceLoader 是ApplicationContext 的顶级接口之一):
(5) 我们需要构造ConditionOutcome 类的对象来帮助我们,最终通过ConditionOutcome.isMatch 方法返回布尔值来确定条件。

【案例分析】


在了解了Spring Boot 的运作原理和主要的条件注解后,现在来分析一个简单的Spring Boot 内置的自动配置功能: http 的编码配置。我们在常规的项目中配置http编码时候是在web.xml里配置一个filter

<filter>  
    <filter-name>characterEncodingFilter</filter-name>  
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>  
    <init-param>  
        <param-name>encoding</param-name>  
        <param-value>UTF-8</param-value>  
    </init-param>  
    <init-param>  
        <param-name>forceEncoding</param-name>  
        <param-value>true</param-value>  
    </init-param>  
</filter>  
<filter-mapping>  
    <filter-name>characterEncodingFilter</filter-name>  
    <url-pattern>/*</url-pattern>  
</filter-mapping>

自动配置要满足两个条件:

(1) 能自己置CharacterEncodingFilter 这个Bean;
(2) 能自己置encoding 和forceEncoding 这两个参数。

Spring Boot 的自动配置是类型安全的配置,可以在application.properties 中直接设置。

@ConfigurationProperties(prefix = "spring.http.encoding")
public class HttpEncodingProperties {
   public static final Charset DEFAULT_CHARSET = Charset.forName("UTF-8");
   private Charset charset = DEFAULT_CHARSET;
   private Boolean force;
   private Boolean forceRequest;
   private Boolean forceResponse;
   private Map<Locale, Charset> mapping;
}

说明:

(1) 在application.properties 配置的时候前缀是spring.http.encoding;
(2) 默认编码方式为UTF芯,若修改可使用spring.http.encoding.charset=编码;
(3) 设置forceEncoding ,默认为true ,若修改可使用spring. http.encoding. force=false
@Configuration
@EnableConfigurationProperties(HttpEncodingProperties.class) // 1
@ConditionalOnWebApplication // 6
@ConditionalOnClass(CharacterEncodingFilter.class) // 2
@ConditionalOnProperty(prefix = "spring.http.encoding", value = "enabled", matchIfMissing = true) // 3
public class HttpEncodingAutoConfiguration {

   private final HttpEncodingProperties properties; // 4

   public HttpEncodingAutoConfiguration(HttpEncodingProperties properties) {
      this.properties = properties;
   }

   @Bean // 5
   @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;
   }

说明:

(1) 开启属性注入,通过@EnableConfigurationProperties 声明,使用@Autowired 注入;
(2) 当CharacterEncodingFilter 在类路径的条件下;
(3) 当设置spring.http.encoding=enabled 的情况下,如果没有设置则默认为true ,即条件符合;
(4) 像使用Java 配置的方式配置CharacterEncodingFilter 这个Bean。
(5) 当容器中没有这个Bean 的时候新建Beane
(6) 在web环境下才创建Bean

【代码示例】


ch0603-SpringBoot-核心-运行原理


这里写图片描述

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example.spring.boot</groupId>
    <artifactId>ch0603-spring-boot-core-autoconfig</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.4.RELEASE</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
        </dependency>
    </dependencies>


</project>
package com.example.spring.boot.autoconfig;

/**
 * Author: 王俊超
 * Date: 2017-07-16 09:19
 * All Rights Reserved !!!
 */
public class HelloService {
    private String msg;

    public String sayHello() {
        return "Hello " + msg;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }
}
package com.example.spring.boot.autoconfig;

import org.springframework.boot.context.properties.ConfigurationProperties;

/**
 * 在application. properties 中通过hello.msg=来设置,若不设置,默认为hello.msg=world
 * Author: 王俊超
 * Date: 2017-07-16 09:17
 * All Rights Reserved !!!
 */
@ConfigurationProperties(prefix = "hello")
public class HelloServiceProperties {
    private static final String MSG = "world";

    private String msg = MSG;

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }
}
package com.example.spring.boot.autoconfig;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * 根据HelloServiceProperties 提供的参数,并通过@ConditionalOnClass 判断HelloService 这个类在类路径中是否存在,且当容器中没有这个Bean 的情况下自动配置这个Bean
 *  * Author: 王俊超
 * Date: 2017-07-16 09:19
 * All Rights Reserved !!!
 */
@Configuration
@EnableConfigurationProperties(HelloServiceProperties.class)
@ConditionalOnClass(HelloService.class)
@ConditionalOnProperty(prefix = "hello", value = "enabled", matchIfMissing = true)
public class HelloServiceAutoConfiguration {
    @Autowired
    private HelloServiceProperties helloServiceProperties;

    @Bean
    @ConditionalOnMissingBean(HelloService.class)
    public HelloService helloService() {
        HelloService helloService = new HelloService();
        helloService.setMsg(helloServiceProperties.getMsg());

        return helloService;

    }
}

spring.factories

# 若想、自动自己置生效,需要注册自动配置类。在src/main/resources 下新建META-INF/spring.factories
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
  com.example.spring.boot.autoconfig.HelloServiceAutoConfiguration

ch0603-SpringBoot-核心-运行原理-Hello


<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example.spring.boot</groupId>
    <artifactId>ch0603-spring-boot-core-autoconfig-hello</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.4.RELEASE</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>com.example.spring.boot</groupId>
            <artifactId>ch0603-spring-boot-core-autoconfig</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
        </dependency>
    </dependencies>
</project>

application.properties

hello=enable
hello.msg=wangjunchao
debug=true
package com.example.spring.boot.autoconfig.hello;

import com.example.spring.boot.autoconfig.HelloService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * Author: 王俊超
 * Date: 2017-07-14 21:35
 * All Rights Reserved !!!
 */
@RestController
@SpringBootApplication
public class SampleApplication {

    @Autowired
    private HelloService helloService;

    @RequestMapping("/")
    public String index() {
        return helloService.sayHello();
    }

    public static void main(String[] args) {
        SpringApplication.run(SampleApplication.class, args);
    }

}
  • 2
    点赞
  • 0
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

打赏
文章很值,打赏犒劳作者一下
相关推荐
©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页

打赏

Wang-Junchao

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值