@ConfigurationProperties(prefix = "person")
@Component
@ToString
@Data
public class Person {

    private String userName;
    private Boolean boss;
    private Date birth;
    private Integer age;
    private Pet pet;
    private String[] interests;
    private List<String> animal;
    private Map<String, Object> score;
    private Set<Double> salarys;
    private Map<String, List<Pet>> allPets;
}

@ToString
@Data
public class Pet {
    private String name;
    private Double weight;
}

yaml实现(application.yml，文件后缀名可以是yaml，也可以只写yml)：

# yaml表示以上对象
person:
  userName: zhangsan
  boss: false
  birth: 2019/12/12 20:12:33
  age: 18
  pet:
    name: tomcat
    weight: 23.4
  interests: [篮球,游泳]
  animal:
    - jerry
    - mario
  #  score:
  #    english: 80
  #    math: 90
  score: {english: 80,math: 90}
  salarys: [3999,4999.98,5999.99]
  allPets:
    sick:
      - {name: tom,weight: 24}
      - name: jerry
        weight: 47
    health: [{name: mario,weight: 47}]

6.3 配置提示

自定义的类和配置文件绑定时一般没有提示，此时可以加入依赖：

并且在打包时不要把这个依赖也带上，因为与业务无关：

第七章 Web开发

7.1 SpringMVC自动配置概览

SpringBoot是框架的框架，底层的web开发仍旧是SpringMVC的所有功能，SpringBoot对SpringMVC做了很多自动配置。

SpringBoot对SpringMVC实现了哪些自动配置：Web

Spring Boot provides auto-configuration for Spring MVC that works well with most

applications.(大多场景我们都无需自定义配置)

The auto-configuration adds the following features on top of Spring’s defaults:

Inclusion of ContentNegotiatingViewResolver and BeanNameViewResolver beans.
- 内容协商视图解析器和BeanName视图解析器

Support for serving static resources, including support for WebJars (covered later in this document)).
- 静态资源(包括webjars)
Automatic registration of Converter, GenericConverter, and Formatter beans.
- 自动注册Converter，GenericConverter，Formatter
Support for HttpMessageConverters (covered later in this document).
- 支持HttpMessageConverters(后来我们配合内容协商理解原理)
Automatic registration of MessageCodesResolver (covered later in this document).
- 自动注册MessageCodesResolver(国际化用)
Static index.html support.
- 静态index.html页支持(欢迎页)
Custom Favicon support (covered later in this document).
- 自定义Favicon
Automatic use of a ConfigurableWebBindingInitializer bean (covered later in this document).
- 自动使用ConfigurableWebBindingInitializer(DataBinder负责将请求数据绑定到JavaBean上)

7.2 简单功能分析

7.2.1 静态资源访问

7.2.1.1 静态资源目录

只要把静态资源文件放在类路径下：

①/static

②/public

③/resources

④/META-INF/resources

访问静态资源文件：当前项目根路径/ + 静态资源名

比如：

原理：静态映射/**。(**表示根路径下的所有文件夹及其子文件夹)

请求进来，先去找Controller看能不能处理，不能处理的所有请求又都交给静态资源处理器。

静态资源也找不到则响应404页面。

改变默认的静态资源路径：再yaml文件中修改属性。让其不在这四个默认路径下找静态资源文件。

7.2.1.2 静态资源访问前缀

默认情况下是无前缀的。因为后续的拦截器等功能，为了防止静态资源也被拦截，一般都会修改这个默认的静态映射/**，给静态资源访问加一个前缀。

在yaml文件中修改：

当前项目 + static-path-pattern + 静态资源名 = 静态资源文件夹下找：

7.2.1.3 webjar

自动映射/webjars/**。

webjar官网：WebJars - Web Libraries in Jars

比如jquery，有依赖：

访问地址：http://localhost:8080/webjars/jquery/3.5.1/jquery.js 后面地址要按照依赖里面的包

路径。

7.2.2 欢迎页支持

两种方式：

静态资源路径下index.html
- 可以配置静态资源路径
- 但是不可以配置静态资源路径的访问前缀，否则导致index.html不能被默认访问

创建能处理/index请求的controller

7.2.3 自定义Favicon

favicon即网站的图标。

favicon.ico 放在静态资源目录下即可，但是也不可以配置前缀。

7.2.4 静态资源配置原理

SpringBoot启动默认加载 xxxAutoConfiguration 类(自动配置类)
SpringMVC功能的自动配置类 WebMvcAutoConfiguration 生效

@Configuration(
    proxyBeanMethods = false
)
@ConditionalOnWebApplication(
    type = Type.SERVLET
)
@ConditionalOnClass({Servlet.class, DispatcherServlet.class, WebMvcConfigurer.class})
@ConditionalOnMissingBean({WebMvcConfigurationSupport.class})
@AutoConfigureOrder(-2147483638)
@AutoConfigureAfter({DispatcherServletAutoConfiguration.class, TaskExecutionAutoConfiguration.class, ValidationAutoConfiguration.class})
public class WebMvcAutoConfiguration {
}

给容器中配置的重要内容：WebMvcAutoConfiguration中的一个静态类WebMvcAutoConfigurationAdapter

@Configuration(
        proxyBeanMethods = false
)
@Import({WebMvcAutoConfiguration.EnableWebMvcConfiguration.class})
@EnableConfigurationProperties({WebMvcProperties.class, WebProperties.class})
@Order(0)
public static class WebMvcAutoConfigurationAdapter implements WebMvcConfigurer, ServletContextAware {}

配置文件的相关属性和xxx进行了绑定。WebMvcProperties==spring.mvc、WebProperties==spring.web

@ConfigurationProperties(
    prefix = "spring.mvc"
)
public class WebMvcProperties {}

@ConfigurationProperties("spring.web")
public class WebProperties {}

这个配置类WebMvcAutoConfigurationAdapter只有一个有参构造器。

//有参构造器所有参数的值都会从容器中确定
//WebProperties webProperties 获取和spring.web绑定的所有的值的对象
//WebMvcProperties mvcProperties 获取和spring.mvc绑定的所有的值的对象
//ListableBeanFactory beanFactory Spring的beanFactory
//HttpMessageConverters 找到所有的HttpMessageConverters
//ResourceHandlerRegistrationCustomizer 找到 资源处理器的自定义器。
//DispatcherServletPath  
//ServletRegistrationBean   给应用注册Servlet、Filter
public WebMvcAutoConfigurationAdapter(WebProperties webProperties, WebMvcProperties mvcProperties, ListableBeanFactory beanFactory, ObjectProvider<HttpMessageConverters> messageConvertersProvider, ObjectProvider<WebMvcAutoConfiguration.ResourceHandlerRegistrationCustomizer> resourceHandlerRegistrationCustomizerProvider, ObjectProvider<DispatcherServletPath> dispatcherServletPath, ObjectProvider<ServletRegistrationBean<?>> servletRegistrations) {
    this.resourceProperties = webProperties.getResources();
    this.mvcProperties = mvcProperties;
    this.beanFactory = beanFactory;
    this.messageConvertersProvider = messageConvertersProvider;
    this.resourceHandlerRegistrationCustomizer = (WebMvcAutoConfiguration.ResourceHandlerRegistrationCustomizer)resourceHandlerRegistrationCustomizerProvider.getIfAvailable();
    this.dispatcherServletPath = dispatcherServletPath;
    this.servletRegistrations = servletRegistrations;
    this.mvcProperties.checkConfiguration();
}

WebMvcAutoConfiguration中的关键方法addResourceHandler，静态资源处理的默认规则：

public void addResourceHandlers(ResourceHandlerRegistry registry) {
    if (!this.resourceProperties.isAddMappings()) {
        logger.debug("Default resource handling disabled");
    } else {
        //访问webjars静态文件的规则
        this.addResourceHandler(registry, "/webjars/**", "classpath:/META-INF/resources/webjars/");
        //访问静态资源
        this.addResourceHandler(registry, this.mvcProperties.getStaticPathPattern(), (registration) -> {
            registration.addResourceLocations(this.resourceProperties.getStaticLocations());
            if (this.servletContext != null) {
                ServletContextResource resource = new ServletContextResource(this.servletContext, "/");
                registration.addResourceLocations(new Resource[]{resource});
            }
        });
    }
}

上面代码中的isAddMappings方法就通过一个boolean属性值的设置，如果设置为false，那么

就不会进入else，即会禁用所有静态资源规则。

this.mvcProperties.getStaticPathPattern()方法中得到的是静态映射/**：

this.resourceProperties.getStaticLocations()方法中得到的是四种静态资源默认路径：

WebMvcAutoConfiguration中的一个静态类EnableWebMvcConfiguration中的一个方法welcomePageHandlerMapping()定义了欢迎页的处理规则：

//HandlerMapping：处理器映射。保存了每一个Handler能处理哪些请求。	 

public WelcomePageHandlerMapping welcomePageHandlerMapping(ApplicationContext applicationContext, FormattingConversionService mvcConversionService, ResourceUrlProvider mvcResourceUrlProvider) {
    WelcomePageHandlerMapping welcomePageHandlerMapping = new WelcomePageHandlerMapping(new TemplateAvailabilityProviders(applicationContext), applicationContext, this.getWelcomePage(), this.mvcProperties.getStaticPathPattern());
    welcomePageHandlerMapping.setInterceptors(this.getInterceptors(mvcConversionService, mvcResourceUrlProvider));
    welcomePageHandlerMapping.setCorsConfigurations(this.getCorsConfigurations());
    return welcomePageHandlerMapping;
}

WelcomePageHandlerMapping(TemplateAvailabilityProviders templateAvailabilityProviders, ApplicationContext applicationContext, Resource welcomePage, String staticPathPattern) {
    if (welcomePage != null && "/**".equals(staticPathPattern)) {
        logger.info("Adding welcome page: " + welcomePage);
        this.setRootViewName("forward:index.html");
    } else if (this.welcomeTemplateExists(templateAvailabilityProviders, applicationContext)) {
        logger.info("Adding welcome page template: index");
        this.setRootViewName("index");
    }
}

可以看出必须是/**，因此手动加了前缀的话，欢迎页功能就会失效。

PS：根据尚硅谷课程整理，如有侵权，联系删除