Spring MVC官方文档学习笔记（二）之DispatcherServlet

南七星之家  金牌会员 | 2023-5-31 17:43:13 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 891|帖子 891|积分 2675

1.DispatcherServlet入门
(1) Spring MVC是以前端控制器模式(即围绕着一个中央的Servelt, DispatcherServlet)进行设计的,这个DispatcherServlet为请求的处理提供了一个共用的算法,即它都会将实际的请求处理工作委托给那些可配置的组件进行执行,说白了,DispatcherServlet的作用就是进行统一调度,并控制请求的处理流程,和其他的Servlet一样，DispatcherServlet需要根据Servlet规范，使用基于Java的配置或在web.xml中进行声明,与此同时,DispatcherServlet会使用Spring相关配置来发现它在请求映射、视图解析、异常处理等方面所需要的组件,而实际的工作也会交由这些组件进行执行，下面列出了注册DispatcherServlet的一些方式
  1. @Configuration
  2. @ComponentScan("cn.example.springmvc.boke")
  3. public class WebConfig {
  4. }
  6. //使用基于Java的配置,注册并初始化一个DispatcherServlet
  7. public class MyWebApplicationInitializer implements WebApplicationInitializer {
  9.     @Override
  10.     public void onStartup(ServletContext servletContext) throws ServletException {
  11.         //声明一个Spring-web容器
  12.         AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext();
  13.         ctx.register(WebConfig.class);
  15.         //创建并注册DispatcherServlet
  16.         DispatcherServlet servlet = new DispatcherServlet(ctx);
  17.         //动态的添加Servlet
  18.         ServletRegistration.Dynamic registration = servletContext.addServlet("dispatcherServlet", servlet);
  19.         registration.setLoadOnStartup(1);
  20.         //指定由DispatcherServlet拦截所有请求(包括静态资源，但不拦截.jsp)
  21.         registration.addMapping("/");
  22.     }
  23. }
复制代码
上述是基于Java的配置,我们还可以基于web.xml来配置DispatcherServlet,如下
  1. <web-app ....>
  2.     <servlet>
  3.         <servlet-name>dispatcherServlet</servlet-name>
  4.         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  5.         <init-param>
  6.             <param-name>contextConfigLocation</param-name>
  7.             <param-value>classpath:springmvc.xml</param-value>
  8.         </init-param>
  9.         <load-on-startup>1</load-on-startup>
  10.     </servlet>
  12.     <servlet-mapping>
  13.         <servlet-name>dispatcherServlet</servlet-name>
  14.         <url-pattern>/</url-pattern>
  15.     </servlet-mapping>
  16. </web-app>
复制代码
(2) 现在DispatcherServlet有了,我们还需要@Controller与@RequestMapping注解,来标注某个访问应该由谁进行处理,如下,而到此为止,我们就已经完全不需要编写HttpServlet相关的内容了,可见通过DispatcherServlet帮助我们免去了冗杂的Servlet映射配置
  1. @Controller
  2. public class DemoController {
  3.     @RequestMapping("/demo")
  4.     @ResponseBody
  5.     public String get(HttpServletRequest request) {
  6.         return "aaa";
  7.     }
  8. }
复制代码
启动容器,访问 http://localhost:8080/springmvc/demo, 页面显示aaa,说明访问正常,这便是我们的第一个Spring MVC项目
2.Spring容器的层次结构
(1) 根容器与Servlet子容器
[img=30%,30%]https://img2023.cnblogs.com/blog/3062734/202305/3062734-20230518200316411-1840360391.png[/img]通常情况下,一个web应用中有一个唯一的WebApplicationContext容器就足够了,但Spring还允许我们配置具有父子关系的根容器和它的Servlet子容器,来形成一个层次结构,如上图所示,可以很清楚的看到,Spring将表示层相关的组件全部放到了子容器中,而将公共的与基础服务有关的组件全部放到了根容器中,这样的话,当我们需要注册多个DispatcherServlet并共享那些基础服务组件的时候，不必重复注册Service和Dao了，因为每个Servlet子容器都可以从这个根容器中获取到Service和Dao,这便是层次结构的意义
当然，Spring也支持单容器配置，如开头中的示例那样，此外我们可以通过继承AbstractAnnotationConfigDispatcherServletInitializer来配置父子容器，如下
  1. //配置父子容器，其中容器使用基于注解的配置方式
  2. public class IocInit extends AbstractAnnotationConfigDispatcherServletInitializer {
  4.     //配置 DispatcherServlet 拦截的路径
  5.     @Override
  6.     protected String[] getServletMappings() {
  7.         return new String[] {"/"};
  8.     }
  10.     //设置根容器的配置类
  11.     @Override
  12.     protected Class<?>[] getRootConfigClasses() {
  13.         return new Class[] {RootConfig.class};
  14.     }
  16.     //设置子容器的配置类
  17.     //如果不想形成父子容器，那么只需将下面这个getServletConfigClasses()方法返回null即可
  18.     @Override
  19.     protected Class<?>[] getServletConfigClasses() {
  20.         return new Class[] {WebConfig.class};
  21.     }
  22. }
  24. //由于我们采用的是父子容器，因此这就要求我们编写父子容器的配置文件时，根容器的配置文件(RootConfig)配置非web组件的bean，而子容器的配置文件(WebConfig)配置web组件的bean，同时，也要防止同一组件在不同容器中分别注册初始化，从而出现两个相同bean
  25. //根容器配置类，使用excludeFilters排除掉@Controller注解标注的类和@Configuration注解标注的类，这里之所以要排除掉@Configuration注解标注的类，是为了防止根容器扫描到子容器的配置类WebConfig
  26. @Configuration
  27. @ComponentScan(value = "cn.example.springmvc.boke",
  28.                 excludeFilters = {@ComponentScan.Filter(type = FilterType.ANNOTATION, value = Controller.class),
  29.                         @ComponentScan.Filter(type = FilterType.ANNOTATION, value = Configuration.class)
  30.                 })
  31. public class RootConfig {
  32. }
  34. //子容器配置类，使用includeFilters指定只扫描由@Controller注解标注的类
  35. @Configuration
  36. @ComponentScan(value = "cn.example.springmvc.boke",
  37.         includeFilters = @ComponentScan.Filter(value = Controller.class, type = FilterType.ANNOTATION))
  38. public class WebConfig {
  39. }
复制代码
也可以基于web.xml来配置父子容器，如下
  1. <web-app ....>
  2.    
  3.     <listener>
  4.         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  5.     </listener>
  7.    
  8.     <context-param>
  9.         <param-name>contextConfigLocation</param-name>
  10.         <param-value>classpath:springroot.xml</param-value>
  11.     </context-param>
  13.    
  14.     <servlet>
  15.         <servlet-name>dispatcherServlet</servlet-name>
  16.         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  17.         
  18.         <init-param>
  19.             <param-name>contextConfigLocation</param-name>
  20.             <param-value>classpath:springweb.xml</param-value>
  21.         </init-param>
  22.     </servlet>
  23.    
  24.    
  25.     <servlet-mapping>
  26.         <servlet-name>dispatcherServlet</servlet-name>
  27.         <url-pattern>/</url-pattern>
  28.     </servlet-mapping>
  29. </web-app>
复制代码
3.特殊类型的bean
(1) 前面已经提过了，DispatcherServlet会将实际的请求处理过程委托给那些特殊的组件来干，而它本身起一个统一分配与调度的作用，这些特殊的组件已经由Spring提供了默认的实现，但同时Spring也允许我们自己实现替换它们，下表列出了由 DispatcherServlet检测到的这些特殊的Bean类型
Bean类型说明HandlerMapping处理器映射器，主要就是将请求路径(uri)映射到能处理该请求的处理器(handler)，DispatcherServlet在接收到请求后，该请求会交由谁来处理?这个匹配查找的工作不是由DispatcherServlet来做的，而是交由HandlerMapping负责的，而至于Handler，我们可以把它理解为在@Controller注解所标注的类中的一个标注了@RequestMapping注解的方法，所谓的匹配本质上就是匹配@RequestMapping注解中所声明的值罢了。注意：HandlerMapping在查找匹配到对应的Handler后，并不是直接返回这个Handler，而是返回这个Handler的包装对象HandlerExecutionChain，而这个HandlerExecutionChain其实就是 Handler + 该请求所涉及到的拦截器 所组合而成的一个对象。
两个主要的HandlerMapping实现类分别是RequestMappingHandlerMapping（标注了@RequestMapping注解的方法）和SimpleUrlHandlerMapping（若在xml中显式的配置了请求路径与Controller的对应关系，则会使用该处理器映射器）HandlerAdapter帮助 DispatcherServlet 调用映射匹配到的HandlerExecutionChain，换句话说，DispatcherServlet获得HandlerExecutionChain后，它不会进行调用执行，而是交由HandlerAdapter来调用执行HandlerExecutionChainHandlerExceptionResolver解决异常的策略，用于定义在请求映射，参数绑定或方法执行时若发生异常，该怎么处理ViewResolverHandler方法执行后，将返回的逻辑视图名(通常为一个String字符串)解析为真正的视图(如.jsp 、.html等)，并进行视图渲染，渲染完成后，将视图返回给DispatcherServletLocaleResolver, LocaleContextResolver用于解析客户的Locale，实现国际化功能ThemeResolver解析你的web应用可使用的主题(theme)，主题是一系列静态资源的集合(比如说css文件，图片等)MultipartResolver专门用于处理文件上传FlashMapManager专门用于保存和管理FlashMap，而这个FlashMap是用来在重定向时传递参数的，因为redirect重定向是不能传递参数的，此时就可以借助FlashMap4.Web MVC配置
(1) 我们可以自定义在上一节中所列出来的那些特殊的bean，DispatcherServlet会检查它们，如果没有，那么它将会使用DispatcherServlet.properties中所列出的默认类型的bean，如下
[img=30%,30%]https://img2023.cnblogs.com/blog/3062734/202305/3062734-20230531173423950-1663623829.png[/img]5.Servlet 配置
(1) 在Servlet环境中，我们可以选择以编程式的方式或基于web.xml的方式来配置Servlet容器，在本篇开头的位置也提到过了，如下是一个基于编程式的例子
  1. public class IocInit implements WebApplicationInitializer {
  2.     @Override
  3.     public void onStartup(ServletContext servletContext) throws ServletException {
  4.         //创建一个基于xml配置的容器
  5.         XmlWebApplicationContext appContext = new XmlWebApplicationContext();
  6.         appContext.setConfigLocation("classpath:springmvc.xml");
  8.         ServletRegistration.Dynamic registration = servletContext.addServlet("dispatcherServlet", new DispatcherServlet(appContext));
  9.         registration.setLoadOnStartup(1);
  10.         registration.addMapping("/");
  11.     }
  12. }
复制代码
WebApplicationInitializer是由Spring MVC提供的一个接口，Spring MVC会确保该接口的实现类们会被正确调用以初始化Servlet容器，WebApplicationInitializer有一个抽象基类为AbstractDispatcherServletInitializer，通过继承该基类可以使得注册DispatcherServlet更加容易
(2) 除了上面的例子之外，还可以使用基于java的Spring配置，如下，前面也提到过了
  1. public class IocInit extends AbstractAnnotationConfigDispatcherServletInitializer {
  2.     @Override
  3.     protected String[] getServletMappings() {
  4.         return new String[] {"/"};
  5.     }
  7.     @Override
  8.     protected Class<?>[] getRootConfigClasses() {
  9.         return null;
  10.     }
  12.     //创建一个基于注解配置的容器
  13.     @Override
  14.     protected Class<?>[] getServletConfigClasses() {
  15.         return new Class[] {WebConfig.class};
  16.     }
  17. }
复制代码
(3) 除此之外，还可以继承AbstractDispatcherServletInitializer
  1. public class IocInit extends AbstractDispatcherServletInitializer {
  2.     @Override
  3.     protected WebApplicationContext createServletApplicationContext() {
  4.         XmlWebApplicationContext cxt = new XmlWebApplicationContext();
  5.         cxt.setConfigLocation("classpath:springmvc.xml");
  6.         return cxt;
  7.     }
  9.     @Override
  10.     protected WebApplicationContext createRootApplicationContext() {
  11.         return null;
  12.     }
  14.     @Override
  15.     protected String[] getServletMappings() {
  16.         return new String[] {"/"};
  17.     }
  18. }
复制代码
上面列出了常见的3种创建ioc容器的方式，我们可以根据自己的需要来进行选择
(4) AbstractDispatcherServletInitializer还提供了一种便捷的方式来创建Filter实例，并且这些Filter实例会被自动映射到DispatcherServlet上，如下
  1. public class IocInit extends AbstractDispatcherServletInitializer {
  3.     //...
  4.    
  5.     //这些Filter会被自动映射到DispatcherServlet上，并且会根据它们的类型来为其添加一个默认名称
  6.     @Override
  7.     protected Filter[] getServletFilters() {
  8.         return new Filter[] {
  9.                 new HiddenHttpMethodFilter(), new CharacterEncodingFilter() };
  10.     }
  11. }
复制代码
此外，如果我们希望需要进一步的定制DispatcherServlet，我们可以重写createDispatcherServlet方法
6.请求处理
(1) DispatcherServlet按照如下的方式来处理请求：

  • 搜索WebApplicationContext并将其作为一个属性绑定到请求中，这样在请求的后续处理过程中我们就可以直接从请求中拿到ioc容器，如下
  1. @Controller
  2. public class DemoController {
  3.     @RequestMapping("/demo")
  4.     @ResponseBody
  5.     public String get(HttpServletRequest httpServletRequest) {
  6.         //从请求中获取到WebApplicationContext，这个ioc容器被绑定到了请求的DispatcherServlet.WEB_APPLICATION_CONTEXT_ATTRIBUTE属性上
  7.         WebApplicationContext ctx = (WebApplicationContext)httpServletRequest.getAttribute(DispatcherServlet.WEB_APPLICATION_CONTEXT_ATTRIBUTE);
  8.         Arrays.stream(ctx.getBeanDefinitionNames()).forEach(System.out::println);
  9.         return "aaa";
  10.     }
  11. }
复制代码

  • Locale解析器也被绑定到了请求上，以便后续处理流程中进行使用
  • Theme解析器也被绑定到了请求上，以便后续处理流程中进行使用
  • 如果我们指定了multipart文件解析器，那么Spring会检查请求中是否含有multipart文件，如果有，那么该请求会被包裹在一个MultipartHttpServletRequest中，以便后续处理流程中进行进一步处理
  • 针对请求搜索恰当的handler，如果搜索到的话，与该handler相关的执行链（HandlerExecutionChain）将会被执行，以准备渲染模型（model）
  • 如果有模型返回，那么视图（view）就会被渲染，否则，如果没有模型返回，那么视图就不会被渲染
(2) 在WebApplicationContext中的HandlerExceptionResolver类型的bean将被用来解决请求处理过程中抛出的异常，这些异常解析器允许自定义处理异常的逻辑
(3) 我们可以在web.xml中的标签使用标签来添加Servlet初始化参数，这样就能达到定制DispatcherServlet的目的，下面列出了DispatcherServlet常见的初始化参数
参数说明contextClass设置web容器，该容器必须是ConfigurableWebApplicationContext的实现类，默认为XmlWebApplicationContextcontextConfigLocation该参数值将会被传递至由上面contextClass指定的容器，通常用于指明配置文件（xml文件，@Configuration注解标注的类）的路径，容器会到指定位置加载配置文件namespace容器的命名空间，默认为[servlet-name]-servletthrowExceptionIfNoHandlerFound决定当一个请求没有找到其对应的handler时，是否会抛出NoHandlerFoundException异常，若设置为true，则表示抛出异常，然后我们就可以用HandlerExceptionResolver来捕获该异常，并像处理其他异常一样进行该处理。在默认情况下，该值被设置为false，因此在默认情况下，如果一个请求没有找到其对应的handler，那么DispatcherServlet会将响应状态码设置为404（NOT_FOUND）而不会引发异常，因此我们会在页面上看到一个 "404 - 未找到" 页面，最后注意，如果defaultServletHandling也被配置了，那么这些不正常的请求会被转发到defaultServlet进行处理，且永远不会出现404具体的配置例子如下
  1. <web-app ....>
  3.     <servlet>
  4.         <servlet-name>dispatcherServlet</servlet-name>
  5.         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  6.         
  7.         <init-param>
  8.             <param-name>contextClass</param-name>
  9.             <param-value>org.springframework.web.context.support.XmlWebApplicationContext</param-value>
  10.         </init-param>
  12.         
  13.         <init-param>
  14.             <param-name>contextConfigLocation</param-name>
  15.             <param-value>classpath:springweb.xml</param-value>
  16.         </init-param>
  18.         
  23.         
  29.         
  30.         <init-param>
  31.             <param-name>namespace</param-name>
  32.             <param-value>app</param-value>
  33.         </init-param>
  35.         
  36.         <init-param>
  37.             <param-name>throwExceptionIfNoHandlerFound</param-name>
  38.             <param-value>true</param-value>
  39.         </init-param>
  40.     </servlet>
  42.    
  43.     <servlet-mapping>
  44.         <servlet-name>dispatcherServlet</servlet-name>
  45.         <url-pattern>/</url-pattern>
  46.     </servlet-mapping>
  47. </web-app>
复制代码
7.拦截器
(1) 拦截器必须实现HandlerInterceptor接口，该接口提供了3个方法，分别为

  • preHandle(..): 在handler执行之前执行
  • postHandle(..): 在handler执行之后执行
  • afterCompletion(..): 在整个请求完成后执行
preHandle方法返回一个boolean值，通过该方法我们可以决定是继续还是中断执行链的执行，若返回true，则执行链继续执行，若返回false，则DispatcherServlet会认为拦截器本身已经处理了该请求，因此会中断执行链中其他的拦截器以及handler的执行
postHandle方法在有@ResponseBody和ResponseEntity的方法中用处不大，因为这种方法在postHandle方法执行前已经在写入response了，等待postHandle方法执行时已经太迟了，而针对这种情况，我们可以使用ResponseBodyAdvice
8.异常
(1) 如果在请求映射处理过程中发生异常，DispatcherServlet会委托一个由HandlerExceptionResolver构成的异常处理链来处理这个异常，下面列出一些可用的HandlerExceptionResolver实现类
HandlerExceptionResolver说明SimpleMappingExceptionResolver提供异常类名称与异常视图名称之间的一个映射，即针对不同类型的异常响应不同的错误视图DefaultHandlerExceptionResolver解析由Spring MVC引发的标准异常，并将它们映射成对应的HTTP状态码，它是作为“缺省”使用的，如果其他HandlerExceptionResolver不能处理某些异常，最后会使用DefaultHandlerExceptionResolver来统一处理ResponseStatusExceptionResolver解析被@ResponseStatus注解标注的异常，并根据注解中的值将异常映射到对应的HTTP状态码ExceptionHandlerExceptionResolver通过调用@ControllerAdvice类或@Controller类中合适的@ExceptionHandler方法来解析异常(2) 我们可以在容器中配置多个HandlerExceptionResolver类型的bean并根据需要设置它们的order属性来形成一个异常处理器链，其中order属性值越高，它在异常处理器链中的位置就越靠后，通常情况下，HandlerExceptionResolver返回

  • 一个指向错误视图的ModelAndView
  • 若异常在处理器中被处理，返回一个空的ModelAndView
  • 若异常未被解决，则返回null，以便让后续的处理器尝试解决，如果到最后异常仍未解决，则允许将异常冒泡到Servlet容器中
使用MVC Config(通过@EnableWebMvc注解)后，会自动的向容器中添加Spring MVC异常，由@ResponseStatus注解标注的异常等异常的处理器，我们可以对它们进行替换
(3) 如果一个异常没有被任何HandlerExceptionResolver处理或者请求的http响应被设置为错误状态（即4xx，5xx），那么Servlet容器使用HTML来渲染一个默认的错误页面，而为了自定义容器的默认错误页面，我们可以在web.xml中配置错误页面映射url，如下
  1. <error-page>
  2.     <location>/error</location>
  3. </error-page>
复制代码
当配置好错误页面映射url后，如果此时有一个异常没有被任何HandlerExceptionResolver处理或者请求的http响应被设置为错误状态，那么Servlet容器将会请求我们所配置的这个url，此时，我们就可以返回一个自定义的错误视图或像下面这样直接返回一个字符串
  1. @RequestMapping("/error")
  2. @ResponseBody
  3. public String error() {
  4.     return "error";
  5. }
复制代码
9. view，locale，theme和logging这四节的内容略过，如果有需要可查看官方文档
10. Multipart解析器
(1) org.springframework.web.multipart包中的MultipartResolver可用于解析multipart类型(例如：文件上传)的请求，为了使用Multipart解析器，我们需要配置一个MultipartResolver类型的bean，并且这个bean的名称必须是multipartResolver，配置好之后，DispatcherServlet会检测到它并将其应用于后续的请求，当我们接收到一个类型为multipart/form-data的post请求时，Multipart解析器会解析请求内容并将当前这个HttpServletRequest包装成MultipartHttpServletRequest以便访问解析的内容，Spring MVC已为我们提供了两个MultipartResolver的实现类，如下

  • CommonsMultipartResolver：基于Apache Commons FileUpload的MultipartResolver实现类，为了使用它，需要添加commons-fileupload依赖
  • StandardServletMultipartResolver：基于Servlet 3.0 multipart请求解析的MultipartResolver实现类，为了使用它，我们需要在或Servlet registration中进行一些配置:
  1. <servlet>
  2.     <servlet-name>dispatcherServlet</servlet-name>
  3.     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  5.     <multipart-config>
  6.         <location>/</location>
  7.         <max-file-size>2097152</max-file-size>
  8.         <max-request-size>419304</max-request-size>
  9.     </multipart-config>
  10. </servlet>
复制代码
也可在Servlet registration中进行配置
  1. public class IocInit extends AbstractAnnotationConfigDispatcherServletInitializer {
  2.     @Override
  3.     protected String[] getServletMappings() {
  4.         return new String[] {"/"};
  5.     }
  7.     @Override
  8.     protected Class<?>[] getRootConfigClasses() {
  9.         return new Class[] {RootConfig.class};
  10.     }
  12.     @Override
  13.     protected Class<?>[] getServletConfigClasses() {
  14.         return new Class[] {WebConfig.class};
  15.     }
  17.     //使用ServletRegistration配置上传文件大小等信息
  18.     @Override
  19.     protected void customizeRegistration(ServletRegistration.Dynamic registration) {
  20.         registration.setMultipartConfig(new MultipartConfigElement("/", 2097152, 419304, 0));
  21.     }
  22. }
复制代码
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
回复

使用道具 举报

0 个回复

倒序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

南七星之家

金牌会员
这个人很懒什么都没写!

楼主热帖

标签云

存储 挺好的 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表