Spring Boot2篇 - 五、Spring Boot Web开发

我会带着你远行 2023-10-03 08:16 19阅读 0赞

## 五、Spring Boot Web开发 ##

### 5.1 静态资源处理 ###

> 如果我们是一个web应用，我们的main下会有一个webapp，我们以前都是将所有的页面导在这里面的，对吧！但是我们现在的pom呢，打包方式是为jar的方式，那么这种方式SpringBoot能不能来给我们写页面呢？当然是可以的，但是SpringBoot对于静态资源放置的位置，是有规定的 .

**SpringBoot中，SpringMVC的web配置都在 WebMvcAutoConfiguration 这个配置类里面**

有一个方法：addResourceHandlers 添加资源处理

@Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        
        //先判断是否自定义了静态资源路径
        if (!this.resourceProperties.isAddMappings()) {
        
            // 已禁用默认资源处理
            logger.debug("Default resource handling disabled");
            return;
        }
        // webjars 配置
        addResourceHandler(registry, "/webjars/**", "classpath:/META-INF/resources/webjars/");
        // 静态资源配置
        addResourceHandler(registry, this.mvcProperties.getStaticPathPattern(), (registration) -> {
        
            registration.addResourceLocations(this.resourceProperties.getStaticLocations());
            if (this.servletContext != null) {
        
                ServletContextResource resource = new ServletContextResource(this.servletContext, SERVLET_LOCATION);
                registration.addResourceLocations(resource);
            }
        });
    }

**由源码可知有三种静态资源映射规则**

#### 5.1.1 webjars资源映射规则 ####

> Webjars本质就是以jar包的方式引入我们的静态资源 ， 我们以前要导入一个静态资源文件，现在直接导入即可

使用SpringBoot需要使用Webjars，我们可以去搜索一下：

网站：https://www.webjars.org

*  要使用jQuery，我们只要要引入jQuery对应版本的pom依赖即可！

<dependency>
        <groupId>org.webjars</groupId>
        <artifactId>jquery</artifactId>
        <version>3.4.1</version>
    </dependency>

*  导入完毕，查看webjars目录结构  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70]
 *  访问Jquery.js文件

> 访问：只要是静态资源，SpringBoot就会去对应的路径寻找资源，我们这里访问：http://localhost:8080/webjars/jquery/3.4.1/jquery.js  
> ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 1]

#### 5.1.2 第二种静态资源映射规则 ####

> 我们去找staticPathPattern发现第二种映射规则 ：/\*\* , 访问当前的项目任意资源，它会去找 resourceProperties 这个类，我们可以点进去看一下分析：

// 进入方法
    public String[] getStaticLocations() {
        
        return this.staticLocations;
    }
    
    // 找到对应的值
    private String[] staticLocations = CLASSPATH_RESOURCE_LOCATIONS;
    
    // 找到路径
    private static final String[] CLASSPATH_RESOURCE_LOCATIONS = {
         
        "classpath:/META-INF/resources/",
      "classpath:/resources/", 
        "classpath:/static/", 
        "classpath:/public/" 
    };

> ResourceProperties 可以设置和我们静态资源有关的参数；这里面指向了它会去寻找资源的文件夹，即上面数组的内容

结论，以下四个目录存放的静态资源可以被我们识别 :

"classpath:/META-INF/resources/"
    "classpath:/resources/"
    "classpath:/static/"
    "classpath:/public/"
    且优先级别resources>static(默认)>public

> 可以在resources根目录下新建对应的文件夹，都可以存放我们的静态文件
> 
> 访问方式 http://localhost:8080/1.js

#### 5.1.3 自定义静态资源路径 ####

> 可以自己通过配置文件来指定一下，哪些文件夹是需要我们放静态资源文件的，在application.properties中配置；

spring.resources.static-locations=classpath:/coding/,classpath:/cvzhanshi/

一旦自己定义了静态文件夹的路径，原来的自动配置就都会失效了

### 5.2 首页处理 ###

> 静态资源文件夹说完后，我们继续向下看源码！可以看到一个欢迎页的映射，就是我们的首页

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

点击继续查看

private Resource getWelcomePage() {
        
        for (String location : this.resourceProperties.getStaticLocations()) {
        
            Resource indexHtml = getIndexHtml(location);
            if (indexHtml != null) {
        
                return indexHtml;
            }
        }
        ServletContext servletContext = getServletContext();
        if (servletContext != null) {
        
            return getIndexHtml(new ServletContextResource(servletContext, SERVLET_LOCATION));
        }
        return null;
    }
    
    private Resource getIndexHtml(String location) {
        
        return getIndexHtml(this.resourceLoader.getResource(location));
    }

> 由此可知 欢迎页就是一个location下的的 index.html 而已， 静态资源文件夹下的所有 index.html 页面；被 /\*\* 映射 比如我访问 http://localhost:8080/ ，就会找静态资源文件夹下的 index.html

*  测试  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 2]

**说明：注意点，所有页面的静态资源都需要使用thymeleaf接管;**

**url用 @\{\}**

**关于网站图标说明**：

与其他静态资源一样，Spring Boot在配置的静态内容位置中查找 favicon.ico。如果存在这样的文件，它将自动用作应用程序的favicon

*  关闭SpringBoot默认图标

#关闭默认图标
    spring.mvc.favicon.enabled=false

*  自己放一个图标在静态资源目录下

> 说明：由于版本的更新，次功能只有旧版有用，最新版已经移除

### 5.3 Thymeleaf模板引擎 ###

#### 5.3.1 模板引擎 ####

前端交给我们的页面，是html页面。如果是我们以前开发，我们需要把他们转成jsp页面，jsp好处就是当我们查出一些数据转发到JSP页面以后，我们可以用jsp轻松实现数据的显示，及交互等。

jsp支持非常强大的功能，包括能写Java代码，但是呢，我们现在的这种情况，SpringBoot这个项目首先是以jar的方式，不是war，像第二，我们用的还是嵌入式的Tomcat，所以呢，**他现在默认是不支持jsp的**。

**SpringBoot推荐你可以来使用模板引擎：**

模板引擎，我们其实大家听到很多，其实jsp就是一个模板引擎，还有用的比较多的freemarker，包括SpringBoot给我们推荐的Thymeleaf，模板引擎有非常多，但再多的模板引擎，他们的思想都是一样的  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 3]

> 模板引擎的作用就是我们来写一个页面模板，比如有些值呢，是动态的，我们写一些表达式。而这些值，从哪来呢，就是我们在后台封装一些数据。然后把这个模板和这个数据交给我们模板引擎，模板引擎按照我们这个数据帮你把这表达式解析、填充到我们指定的位置，然后把这个数据最终生成一个我们想要的内容给我们写出去，这就是我们这个模板引擎，不管是jsp还是其他模板引擎，都是这个思想。

#### 5.3.2 引入Thymeleaf ####

[Thymeleaf官网][Thymeleaf]  
[Thymeleaf 在Github 的主页][Thymeleaf _Github]  
[Spring官方文档：找到我们对应的版本][Spring]

**导入依赖**

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>

![在这里插入图片描述][20210616225922227.png]

#### 5.3.3 Thymeleaf分析 ####

> 根据之前的自动装配原理，我们可以自动Thymeleaf也会有一个 ThymeleafProperties 的配置类，我们可以进去查看一下

@ConfigurationProperties(prefix = "spring.thymeleaf")
    public class ThymeleafProperties {
        
    
        private static final Charset DEFAULT_ENCODING = StandardCharsets.UTF_8;
    
        public static final String DEFAULT_PREFIX = "classpath:/templates/";
    
        public static final String DEFAULT_SUFFIX = ".html";
        ...
    }

> 我们可以在其中看到默认的前缀和后缀 , 我们只需要把我们的html页面放在类路径下的templates下，thymeleaf就可以帮我们自动渲染了 .和springmvc配置的前缀后缀一样。

**测试**

*  编写一个Controller

@Controller
    public class HelloController {
        
        @RequestMapping("/hello")
        public String hello(Model model) {
        
            model.addAttribute("msg","hello1,cvzhanshi");
            return "hello";
        }
    }

*  编写一个测试页面 hello.html 放在 templates 目录下

<!DOCTYPE html>
    <html lang="en" xmlns:th="http://www.thymeleaf.org">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
        <div th:text="${msg}"></div>
    </body>
    </html>

*  启动测试  
    ![在这里插入图片描述][20210616225909633.png]

#### 5.3.4 Thymeleaf 语法学习 ####

*  **我们可以使用任意的 th:attr 来替换Html中原生属性的值**  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 4]
 *  **能写的表达式**

Simple expressions:（表达式语法）
    Variable Expressions: ${
        ...}：获取变量值；OGNL；
        1）、获取对象的属性、调用方法
        2）、使用内置的基本对象：#18
             #ctx : the context object.
             #vars: the context variables.
             #locale : the context locale.
             #request : (only in Web Contexts) the HttpServletRequest object.
             #response : (only in Web Contexts) the HttpServletResponse object.
             #session : (only in Web Contexts) the HttpSession object.
             #servletContext : (only in Web Contexts) the ServletContext object.
    
        3）、内置的一些工具对象：
    　　　　　　#execInfo : information about the template being processed.
    　　　　　　#uris : methods for escaping parts of URLs/URIs
    　　　　　　#conversions : methods for executing the configured conversion service (if any).
    　　　　　　#dates : methods for java.util.Date objects: formatting, component extraction, etc.
    　　　　　　#calendars : analogous to #dates , but for java.util.Calendar objects.
    　　　　　　#numbers : methods for formatting numeric objects.
    　　　　　　#strings : methods for String objects: contains, startsWith, prepending/appending, etc.
    　　　　　　#objects : methods for objects in general.
    　　　　　　#bools : methods for boolean evaluation.
    　　　　　　#arrays : methods for arrays.
    　　　　　　#lists : methods for lists.
    　　　　　　#sets : methods for sets.
    　　　　　　#maps : methods for maps.
    　　　　　　#aggregates : methods for creating aggregates on arrays or collections.
    ==================================================================================
    
      Selection Variable Expressions: *{
        ...}：选择表达式：和${
        }在功能上是一样；
      Message Expressions: #{
        ...}：获取国际化内容
      Link URL Expressions: @{
        ...}：定义URL；
      Fragment Expressions: ~{
        ...}：片段引用表达式
    
    Literals（字面量）
          Text literals: 'one text' , 'Another one!' ,…
          Number literals: 0 , 34 , 3.0 , 12.3 ,…
          Boolean literals: true , false
          Null literal: null
          Literal tokens: one , sometext , main ,…
          
    Text operations:（文本操作）
        String concatenation: +
        Literal substitutions: |The name is ${
        name}|
        
    Arithmetic operations:（数学运算）
        Binary operators: + , - , * , / , %
        Minus sign (unary operator): -
        
    Boolean operations:（布尔运算）
        Binary operators: and , or
        Boolean negation (unary operator): ! , not
        
    Comparisons and equality:（比较运算）
        Comparators: > , < , >= , <= ( gt , lt , ge , le )
        Equality operators: == , != ( eq , ne )
        
    Conditional operators:条件运算（三元运算符）
        If-then: (if) ? (then)
        If-then-else: (if) ? (then) : (else)
        Default: (value) ?: (defaultvalue)
        
    Special tokens:
        No-Operation: _

*  **测试**
    
     *  编写一个Controller，放一些数据
    
        @Controller
        public class HelloController {
              
            @RequestMapping("/hello")
            public String hello(Model model) {
              
                model.addAttribute("msg","<h1>hello1,cvzhanshi</h1>");
                model.addAttribute("users", Arrays.asList("cvzhanshi","ursula"));
                return "hello";
            }
        }
    
     *  测试页面取出数据
    
        <!DOCTYPE html>
        <html lang="en" xmlns:th="http://www.thymeleaf.org">
        <head>
            <meta charset="UTF-8">
            <title>Title</title>
        </head>
        <body>
            <div th:text="${msg}"></div>
            <div th:utext="${msg}"></div>
        
            <hr>
            
            
            <h4 th:each="user:${users}" th:text="${user}">
            </h4>
            <hr>
            <h4>
                
                <span th:each="user:${users}">[[${user}]]</span>
            </h4>
        </body>
        </html>
    
     *  启动项目测试  
        ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 5]

### 5.4 MVC自动配置原理 ###

#### 5.4.1 官网阅读 ####

> 我们想要知道 SpringBoot对SpringMVC还做了哪些配置，包括如何扩展，如何定制，可以进行源码分析或阅读官方文档
> 
> [官方文档][Link 1]

Spring MVC Auto-configuration
    // Spring Boot为Spring MVC提供了自动配置，它可以很好地与大多数应用程序一起工作。
    Spring Boot provides auto-configuration for Spring MVC that works well with most applications.
    // 自动配置在Spring默认设置的基础上添加了以下功能：
    The auto-configuration adds the following features on top of Spring’s defaults:
    // 包含视图解析器
    Inclusion of ContentNegotiatingViewResolver and BeanNameViewResolver beans.
    // 支持静态资源文件夹的路径，以及webjars
    Support for serving static resources, including support for WebJars 
    // 自动注册了Converter：
    // 转换器，这就是我们网页提交数据到后台自动封装成为对象的东西，比如把"1"字符串自动转换为int类型
    // Formatter：【格式化器，比如页面给我们了一个2019-8-10，它会给我们自动格式化为Date对象】
    Automatic registration of Converter, GenericConverter, and Formatter beans.
    // HttpMessageConverters
    // SpringMVC用来转换Http请求和响应的的，比如我们要把一个User对象转换为JSON字符串，可以去看官网文档解释；
    Support for HttpMessageConverters (covered later in this document).
    // 定义错误代码生成规则的
    Automatic registration of MessageCodesResolver (covered later in this document).
    // 首页定制
    Static index.html support.
    // 图标定制
    Custom Favicon support (covered later in this document).
    // 初始化数据绑定器：帮我们把请求数据绑定到JavaBean中！
    Automatic use of a ConfigurableWebBindingInitializer bean (covered later in this document).
    
    /*
    如果您希望保留Spring Boot MVC功能，并且希望添加其他MVC配置（拦截器、格式化程序、视图控制器和其他功能），则可以添加自己
    的@configuration类，类型为webmvcconfiguer，但不添加@EnableWebMvc。如果希望提供
    RequestMappingHandlerMapping、RequestMappingHandlerAdapter或ExceptionHandlerExceptionResolver的自定义
    实例，则可以声明WebMVCregistrationAdapter实例来提供此类组件。
    */
    If you want to keep Spring Boot MVC features and you want to add additional MVC configuration 
    (interceptors, formatters, view controllers, and other features), you can add your own 
    @Configuration class of type WebMvcConfigurer but without @EnableWebMvc. If you wish to provide 
    custom instances of RequestMappingHandlerMapping, RequestMappingHandlerAdapter, or 
    ExceptionHandlerExceptionResolver, you can declare a WebMvcRegistrationsAdapter instance to provide such components.
    
    // 如果您想完全控制Spring MVC，可以添加自己的@Configuration，并用@EnableWebMvc进行注释。
    If you want to take complete control of Spring MVC, you can add your own @Configuration annotated with @EnableWebMvc.

> 通过阅读它告诉我们SpringBoot已经帮我们自动配置好了SpringMVC，然后自动配置了哪些东西呢 ?

#### 5.4.2 **ContentNegotiatingViewResolver 内容协商视图解析器** ####

> 源码分析：我们找到 WebMvcAutoConfiguration ， 然后搜索ContentNegotiatingViewResolver。找到如下方法 ！

@Bean
    @ConditionalOnBean(ViewResolver.class)
    @ConditionalOnMissingBean(name = "viewResolver", value = ContentNegotiatingViewResolver.class)
    public ContentNegotiatingViewResolver viewResolver(BeanFactory beanFactory) {
        
        ContentNegotiatingViewResolver resolver = new ContentNegotiatingViewResolver();
        resolver.setContentNegotiationManager(beanFactory.getBean(ContentNegotiationManager.class));
    // ContentNegotiatingViewResolver使用所有其他视图解析器来定位视图，因此它应该具有较高的优先级
        resolver.setOrder(Ordered.HIGHEST_PRECEDENCE);
        return resolver;
    }

> 进入ContentNegotiatingViewResolver类中, 找到对应的解析视图的代码

public View resolveViewName(String viewName, Locale locale) throws Exception {
        
        RequestAttributes attrs = RequestContextHolder.getRequestAttributes();
        Assert.state(attrs instanceof ServletRequestAttributes, "No current ServletRequestAttributes");
        List<MediaType> requestedMediaTypes = getMediaTypes(((ServletRequestAttributes) attrs).getRequest());
        if (requestedMediaTypes != null) {
        
            // 获取候选的视图对象
            List<View> candidateViews = getCandidateViews(viewName, locale, requestedMediaTypes);
            // 选择一个最适合的视图对象，然后把这个对象返回
            View bestView = getBestView(candidateViews, requestedMediaTypes, attrs);
            ...
        }

> 查看如何获取候选视图的

//getCandidateViews中看到他是把所有的视图解析器拿来，进行while循环，挨个解析
    for (ViewResolver viewResolver : this.viewResolvers) {
        
        View view = viewResolver.resolveViewName(viewName, locale);
    }

**结论**： **ContentNegotiatingViewResolver 这个视图解析器就是用来组合所有的视图解析器的**

> 我们再去研究下他的组合逻辑，看到有个属性viewResolvers，看看它是在哪里进行赋值的

protected void initServletContext(ServletContext servletContext) {
        
        // 这里它是从beanFactory工具中获取容器中的所有视图解析器
        // ViewRescolver.class 把所有的视图解析器来组合的
        Collection<ViewResolver> matchingBeans = BeanFactoryUtils.beansOfTypeIncludingAncestors(this.obtainApplicationContext(), ViewResolver.class).values();
        ViewResolver viewResolver;
        if (this.viewResolvers == null) {
        
            this.viewResolvers = new ArrayList(matchingBeans.size());
        }
        // ...............
    }

**猜想**：既然它是在容器中去找视图解析器，我们可以自己给容器中去添加一个视图解析器；这个类就会帮我们自动的将它组合进来

验证：

*  我们在我们的主程序中去写一个视图解析器

@Configuration
    public class MyMvcConfig implements WebMvcConfigurer {
        
    
    
        @Bean
        public ViewResolver myViewResolver(){
        
            return new MyViewResolver();
        }
    
        public static class MyViewResolver implements ViewResolver{
        
            @Override
            public View resolveViewName(String viewName, Locale locale) throws Exception {
        
                return null;
            }
        }
    }

*  给 DispatcherServlet 中的 doDispatch方法 加个断点进行调试 ，查看自定义的视图解析器是否被组合了  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 6]

> 组合成功， 所以说，我们如果想要使用自己定制化的东西，我们只需要给容器中添加这个组件就好了！剩下的事情SpringBoot就会帮我们做了

#### 5.4.3 转换器和格式化器 ####

找到格式化转换器

@Bean
    @Override
    public FormattingConversionService mvcConversionService() {
        
        // 拿到配置文件中的格式化规则
        WebConversionService conversionService = 
            new WebConversionService(this.mvcProperties.getDateFormat());
        addFormatters(conversionService);
        return conversionService;
    }

查看getDateFormat方法在WebMvcProperties中

public String getDateFormat() {
        
        return this.dateFormat;
    }
    /**
    * Date format to use. For instance, `dd/MM/yyyy`. 默认的
     */
    private String dateFormat;

> 所以我们可以通过配置文件来修改格式化转换器

#### 5.4.4 修改SpringBoot的默认配置 ####

*  SpringBoot在自动配置很多组件的时候，先看容器中有没有用户自己配置的（如果用户自己配置@bean），如果有就用用户配置的，如果没有就用自动配置的
 *  如果有些组件可以存在多个，比如我们的视图解析器，就将用户配置的和自己默认的组合起来

**扩展使用SpringMVC** 官方文档如下 :

/*
    如果您希望保留Spring Boot MVC功能，并且希望添加其他MVC配置（拦截器、格式化程序、视图控制器和其他功能），则可以添加自己
    的@configuration类，类型为webmvcconfiguer，但不添加@EnableWebMvc。如果希望提供
    RequestMappingHandlerMapping、RequestMappingHandlerAdapter或ExceptionHandlerExceptionResolver的自定义
    实例，则可以声明WebMVCregistrationAdapter实例来提供此类组件。
    */
    If you want to keep Spring Boot MVC features and you want to add additional MVC configuration 
    (interceptors, formatters, view controllers, and other features), you can add your own 
    @Configuration class of type WebMvcConfigurer but without @EnableWebMvc. If you wish to provide 
    custom instances of RequestMappingHandlerMapping, RequestMappingHandlerAdapter, or 
    ExceptionHandlerExceptionResolver, you can declare a WebMvcRegistrationsAdapter instance to provide such components.

**实践：**

@Configuration
    public class MyMvcConfig implements WebMvcConfigurer {
        
        @Override
        public void addViewControllers(ViewControllerRegistry registry) {
        
            registry.addViewController("cvzhanshi").setViewName("hello");
        }
    }

运行，访问localhost:8080/hello  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 7]

**分析原理**

*  WebMvcAutoConfiguration 是 SpringMVC的自动配置类，里面有一个类WebMvcAutoConfigurationAdapter
 *  这个类上有一个注解，在做其他自动配置时会导入：@Import(EnableWebMvcConfiguration.class)
 *  点进EnableWebMvcConfiguration这个类看一下，它继承了一个父类：DelegatingWebMvcConfiguration

父类中有这段代码：

public class DelegatingWebMvcConfiguration extends WebMvcConfigurationSupport {
        
        private final WebMvcConfigurerComposite configurers = new WebMvcConfigurerComposite();
        
      // 从容器中获取所有的webmvcConfigurer
        @Autowired(required = false)
        public void setConfigurers(List<WebMvcConfigurer> configurers) {
        
            if (!CollectionUtils.isEmpty(configurers)) {
        
                this.configurers.addWebMvcConfigurers(configurers);
            }
        }
    }

*  我们可以在这个类中去寻找一个我们刚才设置的viewController当做参考，发现它调用了一个

protected void addViewControllers(ViewControllerRegistry registry) {
        
        this.configurers.addViewControllers(registry);
    }

*  查看调用的方法

@Override
    public void addViewControllers(ViewControllerRegistry registry) {
        
        // 将所有的WebMvcConfigurer相关配置来一起调用！包括我们自己配置的和Spring给我们配置的
        for (WebMvcConfigurer delegate : this.delegates) {
        
            delegate.addViewControllers(registry);
        }
    }

**结论： 所有的WebMvcConfiguration都会被作用，不止Spring自己的配置类，我们自己的配置类当然也会被调用**

#### 5.4.5 全面接管SpringMVC ####

官方文档：

If you want to take complete control of Spring MVCyou can add your own @Configuration annotated with @EnableWebMvc.

> 全面接管即：SpringBoot对SpringMVC的自动配置不需要了，所有都是我们自己去配置！
> 
> 只需在我们的配置类中要加一个@EnableWebMvc

**如果我们全面接管了SpringMVC了，我们之前SpringBoot给我们配置的静态资源映射一定会无效**

测试：

不加注解之前，访问首页

![在这里插入图片描述][20210616225727696.png]

给配置类加上注解：@EnableWebMvc  
![在这里插入图片描述][20210616225719885.png]

> 所有的SpringMVC自动配置都失效了！回归到了最初的样子

**原因：**

*  查看@EnableWebMvc 源码

@Retention(RetentionPolicy.RUNTIME)
    @Target(ElementType.TYPE)
    @Documented
    //这里发现它是导入了一个类
    @Import(DelegatingWebMvcConfiguration.class)
    public @interface EnableWebMvc {
        
    }

*  继续查看DelegatingWebMvcConfiguration源码

继承了一个父类 WebMvcConfigurationSupport
    public class DelegatingWebMvcConfiguration extends WebMvcConfigurationSupport {
        
    }

*  查看WebMvcAutoConfiguration类源码

@Configuration(proxyBeanMethods = false)
    @ConditionalOnWebApplication(type = Type.SERVLET)
    @ConditionalOnClass({
         Servlet.class, DispatcherServlet.class, WebMvcConfigurer.class })
    //不是WebMvcConfigurationSupport类，自动装配才生效
    @ConditionalOnMissingBean(WebMvcConfigurationSupport.class)
    @AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE + 10)
    @AutoConfigureAfter({
         DispatcherServletAutoConfiguration.class, TaskExecutionAutoConfiguration.class,
                         ValidationAutoConfiguration.class })
    public class WebMvcAutoConfiguration {
        
        ...
    }

> 所以加了@EnableWebMvc会导致 springboot的自动装配失效
> 
> @EnableWebMvc将WebMvcConfigurationSupport组件导入进来了；而导入的WebMvcConfigurationSupport只是SpringMVC最基本的功能

### 5.5 页面国际化 ###

#### 5.5.1 准备工作 ####

> 先在IDEA中统一设置properties的编码问题 ,防止出现乱码

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 8]

#### 5.5.2 配置文件编写 ####

*  在resources资源文件下新建一个i18n目录，存放国际化配置文件
 *  立一个login.properties文件，还有一个login\_en\_US.properties；IDEA自动识别了我们要做国际化操作；文件夹变了  
    ![在这里插入图片描述][20210616225634115.png]
 *  新建一个文件 login\_zh\_CN.properties

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 9]

*  idea还提供了可视化视图  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 10]

最后得到配置文件：

#英文
    login.btn=Sign in
    login.password=Password
    login.remember=Remember me
    login.tip=Please sign in
    login.username=Username

#中文
    login.btn=登 录
    login.password=密码
    login.remember=记住我
    login.tip=请登录
    login.username=用户名

#### 5.5.3 配置文件生效探究 ####

> 探究SpringBoot对国际化的自动装配 ----> MessageSourceAutoConfiguration 里面有一个方法，这里发现SpringBoot已经自动配置好了管理我们国际化资源文件的组件 ResourceBundleMessageSource

// 获取 properties 传递过来的值进行判断
    @Bean
    public MessageSource messageSource(MessageSourceProperties properties) {
        
        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
        if (StringUtils.hasText(properties.getBasename())) {
        
            // 设置国际化文件的基础名（去掉语言国家代码的）
            messageSource.setBasenames(
                StringUtils.commaDelimitedListToStringArray(
                                           StringUtils.trimAllWhitespace(properties.getBasename())));
        }
        if (properties.getEncoding() != null) {
        
            messageSource.setDefaultEncoding(properties.getEncoding().name());
        }
        messageSource.setFallbackToSystemLocale(properties.isFallbackToSystemLocale());
        Duration cacheDuration = properties.getCacheDuration();
        if (cacheDuration != null) {
        
            messageSource.setCacheMillis(cacheDuration.toMillis());
        }
        messageSource.setAlwaysUseMessageFormat(properties.isAlwaysUseMessageFormat());
        messageSource.setUseCodeAsDefaultMessage(properties.isUseCodeAsDefaultMessage());
        return messageSource;
    }

> 查看MessageSourceProperties可知可以通过修改basename来指定国际化的配置文件的映射

public class MessageSourceProperties {
        
    
        private String basename = "messages";
    }

所以

spring.messages.basename=i18n.login

#### 5.5.4 配置页面国际化值 ####

> 去页面获取国际化的值，查看Thymeleaf的文档，找到message取值操作为：\#\{…\} ,然后对页面进行修改

<form class="form-signin" action="dashboard.html">
        <img class="mb-4" th:src="@{/img/bootstrap-solid.svg}" alt="" width="72" height="72">
        <h1 class="h3 mb-3 font-weight-normal" th:text="#{login.tip}">Please sign in</h1>
        <input type="text" class="form-control" name="username" th:placeholder="#{login.username}" required="" autofocus="">
        <input type="password" class="form-control" name="password" th:placeholder="#{login.password}" required="">
        <div class="checkbox mb-3">
            <label>
                <input type="checkbox" value="remember-me" > [[#{login.remember}]]
            </label>
        </div>
        <button class="btn btn-lg btn-primary btn-block" type="submit">[[#{login.btn}]]</button>
        <p class="mt-5 mb-3 text-muted">© 2021-2022</p>
        <a class="btn btn-sm" th:href="@{/index.html(l='zh_cn')}">中文</a>
        <a class="btn btn-sm" th:href="@{/index.html(l='en_US')}">English</a>
    </form>

测试：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 11]

#### 5.5.5 配置国际化解析 ####

> 方便进行按钮控制页面语言

--------------------

> 在Spring中有一个国际化的Locale （区域信息对象）；里面有一个叫做LocaleResolver （获取区域信息对象）的解析器

*  查看webmvc自动配置文件，看到SpringBoot默认配置：

@Override
    @Bean
    @ConditionalOnMissingBean(name = DispatcherServlet.LOCALE_RESOLVER_BEAN_NAME)
    @SuppressWarnings("deprecation")
    public LocaleResolver localeResolver() {
        
        // 容器中没有就自己配，有的话就用用户配置的
        if (this.webProperties.getLocaleResolver() == WebProperties.LocaleResolver.FIXED) {
        
            return new FixedLocaleResolver(this.webProperties.getLocale());
        }
        if (this.mvcProperties.getLocaleResolver() == WebMvcProperties.LocaleResolver.FIXED) {
        
            return new FixedLocaleResolver(this.mvcProperties.getLocale());
        }
        // 接收头国际化分解
        AcceptHeaderLocaleResolver localeResolver = new AcceptHeaderLocaleResolver();
        Locale locale = (this.webProperties.getLocale() != null) ? this.webProperties.getLocale()
            : this.mvcProperties.getLocale();
        localeResolver.setDefaultLocale(locale);
        return localeResolver;
    }

*  继续查看 AcceptHeaderLocaleResolver， 这个类中有一个方法

@Override
    public Locale resolveLocale(HttpServletRequest request) {
        
        Locale defaultLocale = getDefaultLocale();
        // 默认的就是根据请求头带来的区域信息获取Locale进行国际化
        if (defaultLocale != null && request.getHeader("Accept-Language") == null) {
        
            return defaultLocale;
        }
        Locale requestLocale = request.getLocale();
        List<Locale> supportedLocales = getSupportedLocales();
        if (supportedLocales.isEmpty() || supportedLocales.contains(requestLocale)) {
        
            return requestLocale;
        }
        Locale supportedLocale = findSupportedLocale(request, supportedLocales);
        if (supportedLocale != null) {
        
            return supportedLocale;
        }
        return (defaultLocale != null ? defaultLocale : requestLocale);
    }

--------------------

> 那假如我们现在想点击链接让我们的国际化资源生效，就需要让我们自己的Locale生效 ,我们需要编写 自己的LocaleResolver并在按钮跳转链接带上区域信息

*  修改一下前端页面的跳转连接

<a class="btn btn-sm" th:href="@{/index.html(l='zh_CN')}">中文</a>
    <a class="btn btn-sm" th:href="@{/index.html(l='en_US')}">English</a>

*  编写一个自己的LocaleResolver

/**
     * @author cVzhanshi
     * @create 2021-06-15 11:22
     */
    public class MyLocalResolver implements LocaleResolver {
        
        //解析请求
        @Override
        public Locale resolveLocale(HttpServletRequest request) {
        
            //请求语言中的参数
            String language = request.getParameter("l");
            Locale locale = Locale.getDefault();//没有就用默认的
    
            //如果参数携带了国际化的参数
            if (!StringUtils.isEmpty(language)){
        
                //zh_CN
                String[] split = language.split("_");
                //国家，地区
                locale = new Locale(split[0],split[1]);
            }
            return locale;
        }
    
        @Override
        public void setLocale(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Locale locale) {
        
    
        }
    }

*  为了让我们的区域化信息能够生效，我们需要再配置一下这个组件，把他交给Spring的ioc容器，在我们自己的MvcConofig下添加bean

@Bean
        public LocaleResolver localeResolver(){
        
            return new MyLocalResolver();
        }

*  测试  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 12]

#### 5.5.6 总结 ####

*  需要配置i18n文件
 *  如果需要在项目中进行按钮自动切换，我们需要自定义一个组件LocaleResolver
 *  记得将自己写的组件配置到spring容器@Bean
 *  用\#\{\}替换页面中的值

### 5.6 扩展：编写一个网站的基本步骤 ###

**1.前端搞定: 页面长什么样子:数据**  
**2.设计数据库(数据库设计难点! )**  
**3.前端让他能够自动运行，独立化工程**  
**4.数据接口如何对接: json，对象all in one !**  
**5.前后端联调测试!**

--------------------

**1.有一套自己熟悉的后台模板:工作必要! x-admin**  
**2.前端界面:至少自己能够通过前端框架，组合出来-个网站页 面**

*  **index**
 *  **about**
 *  **blog**
 *  **post**
 *  **user**

**3.让这个网站能够独立运行!**

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20210616230050338.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20210616230042135.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20210616230020849.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20210616225931617.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[Thymeleaf]: https://www.thymeleaf.org/
[Thymeleaf _Github]: https://github.com/thymeleaf/thymeleaf
[Spring]: https://docs.spring.io/spring-boot/docs/2.2.5.RELEASE/reference/htmlsingle/#using-boot-starter
[20210616225922227.png]: https://img-blog.csdnimg.cn/20210616225922227.png
[20210616225909633.png]: https://img-blog.csdnimg.cn/20210616225909633.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20210616225902237.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20210616225837838.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[Link 1]: https://docs.spring.io/spring-boot/docs/2.2.5.RELEASE/reference/htmlsingle/#boot-features-spring-mvc-auto-configuration
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20210616225753990.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 7]: https://img-blog.csdnimg.cn/20210616225738986.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[20210616225727696.png]: https://img-blog.csdnimg.cn/20210616225727696.png
[20210616225719885.png]: https://img-blog.csdnimg.cn/20210616225719885.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 8]: https://img-blog.csdnimg.cn/20210616225700937.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[20210616225634115.png]: https://img-blog.csdnimg.cn/20210616225634115.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 9]: https://img-blog.csdnimg.cn/20210616225624875.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 10]: https://img-blog.csdnimg.cn/20210616225614442.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 11]: https://img-blog.csdnimg.cn/20210616225556470.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw_size_16_color_FFFFFF_t_70 12]: https://img-blog.csdnimg.cn/20210616225538418.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ1NDA4Mzkw,size_16,color_FFFFFF,t_70