chapter05_构建Spring Web应用程序_1_Spring MVC起步

• SpringMVC中请求和响应的过程

  (1) 浏览器 --请求–> DispatcherServlet

  (2) DispatcherServlet: 查询 处理器映射

  (3) DispatcherServlet --请求–> 某个具体的控制器

  (4) 控制器 --模型、视图名–> DispatcherServlet

  (5) DispatcherServlet调用__视图解析器__，查找__视图__

  (6) 视图(响应) —> 浏览器

• DispatcherServlet是一个__单例__的__前端控制器__

• DispatcherServlet是一个 Servlet，可以使用__web.xml__配置，3.1以后推荐使用__Java配置__

• 使用Java配置 DispatcherServlet

  (1) 扩展 AbstractAnnotationConfigDispatcherServletInitializer的任意类都会__自动配置__ DispatcherServlet和Spring应用上下文

  (2) Spring应用上下文会位于Web应用的应用上下文中

  (3) 配置DispatcherServlet的类应该覆盖3个方法：getServletMappings, getRootConfigClasses和getServletConfigClasses（无需担心配置的时候漏掉哪个方法, 因为除非写成抽象类，否则这3个方法必须要实现（继承的基类中没有这三个方法的默认实现））

  示例

    import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
  
    public class SpitterWebInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
  
        @Override
        protected Class<?>[] getRootConfigClasses() {
  
            return new Class<?>[]{RootConfig.class};
        }
  
        @Override
        protected Class<?>[] getServletConfigClasses() {
  
            return new Class<?>[]{WebConfig.class};
        }
  
        @Override
        protected String[] getServletMappings() {
  
            return new String[]{"/"};
        }
    }
  

  (4) getServletMappings用于将一个或多个路径映射到DispatcherServlet上

  (5) Spring Web应用一般有__两个__应用上下文：DispatcherServlet和ContextLoaderListener。

  DispatcherServlet的应用上下文用来加载配置bean（各种Controller），对应getServletConfigClasses()方法；

  ContextLoaderListener用来加载后端的中间层bean和数据层组件，对应的方法是getRootConfigClasses()

  （源码中是通过一系列操作，通过一层层的创建、注册机制让WebConfig的内容注册进DispatcherServlet，让RootConfig的内容注册进ContextLoaderListener）

  (6) 无论是 getServletConfigClasses()方法还是getRootConfigClasses()方法，返回的都是带有@Configuration的配置类

  示例 WebConfig.class(部分)

    @Configuration
    @EnableWebMvc
    @ComponentScan("spittr.web")
    public class WebConfig extends WebMvcConfigurerAdapter {
  
        @Bean
        ...
    }
  

• 扩展AbstractAnnotationConfigDispatcherServletInitializer就会自动配置DispatcherServlet和Spring应用上下文的原理

  (1) Servlet3.0环境中，容器会在类路径中查找javax.servlet.ServletContainerInitializer接口的实现类，如果有的话就用它来配置Servlet容器

  (2) SpringServletContainerInitializer实现了ServletContainerInitializer接口，所以会用SpringServletContainerInitializer来配置Servlet容器

  (3) SpringServletContainerInitializer（只）有一个onStartup()方法，需要传入WebApplicationInitializer对象，并且把配置Servlet容器的任务__委托__给WebApplicationInitializer

  (4) AbstractDispatcherServletInitializer是WebApplicationInitializer接口的抽象实现类，AbstractAnnotationConfigDispatcherServletInitializer抽象类又继承了AbstractDispatcherServletInitializer类，现在如果要继承AbstractAnnotationConfigDispatcherServletInitializer且不是抽象类的话，必须实现getRootConfigClasses()、getServletConfigClasses()和getServletMappings()三个方法

  (5) 图示关系

    ServletContainerInitializer<interface>
                     ^
                     |
                     |
    SpringServletContainerInitializer<class> ----需要(委托)-->  WebApplicationInitializer<interface>
                                                                        ^                                                    
                                                                        |
                                                                        |
  
                                                               AbstractDispatcherServletInitializer<abstract class>
                                                                        ^                                                    
                                                                        |
                                                                        |
                                                              AbstractAnnotationConfigDispatcherServletInitializer<abstract class>                     
  

• @EnableWebMvc 注解会创建一个Spring MVC配置(必须)

• 配置视图解析器ViewResolver

  (1) 示例

    @Configuration
    @EnableWebMvc
    @ComponentScan("spittr.web")
    public class WebConfig extends WebMvcConfigurerAdapter {
  
        @Bean
        public ViewResolver viewResolver() {
  
            InternalResourceViewResolver resolver = new InternalResourceViewResolver();
     
            resolver.setPrefix("/WEB-INF/views/");
            resolver.setSuffix(".jsp");
  
            return resolver;
       }
  
       ...
    }
  

  (2) 视图解析器用于查找合适的视图，示例中的视图解析器当收到视图名称为xxx时，会返回 /WEB-INF/views/xxx.jsp的视图(根目录为 src/main/webapp)

• @Controller注解

  (1) 代表该类是一个控制器

  (2) @Controller注解是@Component的子注解，所以会被 @Configuration + @ComponentScan的配置类扫描到

• 静态资源的请求

  (1) 一般的，静态资源的请求应该转发到Servlet容器中默认的Servlet上，而不是使用DispatcherServlet

  (2) 因此，在WebConfig类中应该再添加2个方法configureDefaultServletHandling()和addResourceHandlers()，用于处理静态资源

  示例：完整版 WebConfig.class

    @Configuration
    @EnableWebMvc
    @ComponentScan("spittr.web")
    public class WebConfig extends WebMvcConfigurerAdapter {
  
        @Bean
        public ViewResolver viewResolver() {
  
            InternalResourceViewResolver resolver = new InternalResourceViewResolver();
    
            resolver.setPrefix("/WEB-INF/views/");
            resolver.setSuffix(".jsp");
  
            return resolver;
        }
  
        @Override
        public void configureDefaultServletHandling(    
            DefaultServletHandlerConfigurer configurer) {
  
            configurer.enable();
        }
  
        @Override
        public void addResourceHandlers(ResourceHandlerRegistry registry) {
  
            // TODO Auto-generated method stub
            super.addResourceHandlers(registry);
        }
    }