1.Spring4.3官方文档整理之DispatcherServlet

短命女 2022-05-24 13:12 123阅读 0赞

Spring的web MVC框架与其他许多web MVC框架一样，是由请求驱动的，围绕一个中央Servlet设计，它将请求分派给控制器，并提供其他功能促进web应用程序的开发。然而，Spring的DispatcherServlet却做得更多，不仅仅是这一点它与Spring IoC容器完全集成，因此允许您使用它spring的其他特征。

介绍了Spring Web MVC DispatcherServlet的请求处理工作流如下图。可以认识到DispatcherServlet是一个“前端控制器”。

![70][]

官方图解

DispatcherServlet是一个实际的Servlet(它从HttpServlet基类继承)，正如在web应用程序中声明的那样。您需要映射您想要的请求。DispatcherServlet处理，通过使用URL映射。这是一个标准的Java EE Servlet。Servlet 3.0+环境中的配置如下：

public class MyWebApplicationInitializer implements WebApplicationInitializer {
    @Override
    public void onStartup(ServletContext container) {
         ServletRegistration.Dynamic registration = container.addServlet("example", new
          DispatcherServlet());
          registration.setLoadOnStartup(1);
            registration.addMapping("/example/*");
    }
    }

## WebApplicationInitializer 介绍 ##

在Servlet 3.0+环境中实现的接口，以便以编程方式配置ServletContext——而不是(或可能与)传统web相结合基于xml的方法。

基于xml的配置：

构建web应用程序的大多数Spring用户都需要注册Spring的DispatcherServlet

<servlet>
       <servlet-name>dispatcher</servlet-name>
       <servlet-class>
         org.springframework.web.servlet.DispatcherServlet
       </servlet-class>
       <init-param>
         <param-name>contextConfigLocation</param-name>
         <param-value>/WEB-INF/spring/dispatcher-config.xml</param-value>
       </init-param>
       <load-on-startup>1</load-on-startup>
     </servlet>
    
    
     <servlet-mapping>
       <servlet-name>dispatcher</servlet-name>
       <url-pattern>/</url-pattern>
     </servlet-mapping>

**编程式配置：**

基于代码的方法与WebApplicationInitializer这里是等效的DispatcherServlet注册逻辑

public class MyWebAppInitializer implements WebApplicationInitializer {
    
        @Override
        public void onStartup(ServletContext container) {
          XmlWebApplicationContext appContext = new XmlWebApplicationContext();
          appContext.setConfigLocation("/WEB-INF/spring/dispatcher-config.xml");
    
          ServletRegistration.Dynamic dispatcher =
            container.addServlet("dispatcher", new DispatcherServlet(appContext));
          dispatcher.setLoadOnStartup(1);
          dispatcher.addMapping("/");
        }
    
     }

### 100%基于代码的配置方法 ###

在上面的例子中，WEB-INF /web.xml成功地以WebApplicationInitializer的形式替换了代码，但是实际的dispatcher-config.xml Spring配置仍然是基于xml的。WebApplicationInitializer是一个非常适合使用Spring的基于代码的@Configuration类。下面的示例演示了重构，以使用Spring的AnnotationConfigWebApplicationContext代替XmlWebApplicationContext，以及用户定义的@Configuration类AppConfig和DispatcherConfig，而不是Spring XML文件。这个示例也超出了上面的部分，以演示“根”应用程序上下文的典型配置和ContextLoaderListener的注册

public class MyWebAppInitializer implements WebApplicationInitializer {
    
    
        @Override
        public void onStartup(ServletContext container) {
          // Create the 'root' Spring application context  创建根上下文
          AnnotationConfigWebApplicationContext rootContext =
            new AnnotationConfigWebApplicationContext();
          rootContext.register(AppConfig.class);
    
    
          // Manage the lifecycle of the root application context
          container.addListener(new ContextLoaderListener(rootContext));
    
    
    
         // Create the dispatcher servlet's Spring application context
    
        //创建DispatcherServlet上下文，即web上下文 
    
          AnnotationConfigWebApplicationContext dispatcherContext =
            new AnnotationConfigWebApplicationContext();
          dispatcherContext.register(DispatcherConfig.class);
    
    
          // Register and map the dispatcher servlet
    
          //注册映射
    
          ServletRegistration.Dynamic dispatcher =
            container.addServlet("dispatcher", new DispatcherServlet(dispatcherContext));
          dispatcher.setLoadOnStartup(1);
          dispatcher.addMapping("/");
        }
    
    
     }

WebApplicationInitializer是由Spring MVC提供的一个接口。基于代码的配置被检测到并自动用于初始化任何Servlet3.0容器。这个接口的一个抽象基类实现命名。**AbstractAnnotationConfigDispatcherServletInitializer**使得注册更容易。通过简单地指定它的servlet映射和列出配置类，DispatcherServlet甚至是设置Spring MVC应用程序的推荐方法,建议配置如下。

public class GolfingWebAppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
    @Override
    protected Class<?>[] getRootConfigClasses() {
         // GolfingAppConfig defines beans that would be in root-context.xml
    
       //配置root
    
           return new Class[] { GolfingAppConfig.class };
      }
    @Override
    protected Class<?>[] getServletConfigClasses() {
          // GolfingWebConfig defines beans that would be in golfing-servlet.xml
    
         //配置web
    
          return new Class[] { GolfingWebConfig.class };
    }
    @Override
    protected String[] getServletMappings() {
         return new String[] { "/golfing/*" };
    }
    }

Spring的ApplicationContext实例可以作用域范围。在Web MVC框架中，每个DispatcherServlet都有自己的WebApplicationContext，它继承了在根WebApplicationContext中定义的所有bean。根WebApplicationContext应该包含应该在其他上下文和Servlet实例之间共享的所有基础结构bean。这些继承的bean可以在Servlet特定的范围内被覆盖，并且您可以在给定的Servlet实例中定义新的特定于范围的bean。

![70 1][]

从上图可以看到Servlet WebApplicationContext 主要是配置web相关的，如controller 、视图解析器、处理器映射。Root WebApplicationContext主要是来配置service和repsoitories.这就是我们常用的分开配置.

<param-name>contextConfigLocation</param-name>
    <param-value>classpath*:root-context.xml</param-value>
    </context-param>
    <servlet>
        <servlet-name>dispatcher</servlet-name>
         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
    
        <param-value>
                    classpath*:dispatcher-servlet.xml
    </param-value>
    </init-param>
      <load-on-startup>1</load-on-startup>
    </servlet>
       <servlet-mapping>
       <servlet-name>dispatcher</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>
    <listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

![70 2][]

上图这种是Root WebApplicationContext承担了所有的配置

<param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
    </context-param>
    <servlet>
        <servlet-name>dispatcher</servlet-name>
         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
      <load-on-startup>1</load-on-startup>
    </servlet>
       <servlet-mapping>
       <servlet-name>dispatcher</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>
    <listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

**       微信公众号： **

![20180403143416927][]

JAVA程序猿成长之路

分享资源，记录程序猿成长点滴。专注于Java,Spring,SpringBoot,SpringCloud，分布式，微服务。

[70]: /images/20220524/0ad6dc2b2b39415a9281c4db29f06efb.png
[70 1]: /images/20220524/92d59a94866145a9bc7ea05c621ade5a.png
[70 2]: /images/20220524/6a37cf901d724bf0998c4e5806406cf0.png
[20180403143416927]: /images/20220524/cf2a337296ea41568b68dae13860ac17.png